Installing on Azure Portal

<< Click to Display Table of Contents >>

RayManageSoft Unified Endpoint Manager > 3.1 > Installation Guide > Installation 

Installing on Azure Portal

1. Create an SQL Server

Create a simple MS SQL Server using the Azure Portal or use an existing MS SQL Server which is accessible over the internet.

 

2. Install RayManageSoft Unified Endpoint Manager Backend

Create a new container instance using the following suggested parameters:

 

Basics:

Image source: Docker Hub or another registry

Image Type: Public

Image: raynetgmbh/raymanagesoft-uem-backend:stable

OS type: Linux

 

finger1

Be aware:

It is possible to look up the latest images at https://hub.docker.com/r/raynetgmbh/raymanagesoft-uem-backend.

 

Networking:

Networking type: Public

DNS name label: yourDnsName

Ports: 80 TCP

 

Advanced:

Restart Policy: Always

Environment variables

ConnectionStrings__System="server=myServer;database=myRMSUEMDb;uid=myUser;password=myPass;"

ConnectionStrings__ResultDatabase="server=myServer;database=master;uid
=myUser;password=myPass;"

 

finger1

Be aware:

Refer to Appendix A: Environment variables to find out more about these values.

 

Once the container is up and running, make sure to note the DNS name of the instance. You will need this value in the next step.

 

3. Install RayManageSoft Unified Endpoint Manager Web UI

Create a new container instance, using the following suggested parameters:

 

Basics:

Image source: Docker Hub or another registry

Image Type: Public

Image: raynetgmbh/raymanagesoft-uem-frontend:stable

OS type: Linux
 

finger1

Be aware:

It is possible to look up the latest images at https://hub.docker.com/r/raynetgmbh/raymanagesoft-uem-frontend.

 

Networking:

Networking type: Public

DNS name label: yourDnsName

Ports: 80 TCP

 

Advanced:

Restart Policy: Always

Environment variables:

ConnectionStrings__System="server=myServer;database=myRMSUEMDb;uid=myUser;password=myPass;"

ConnectionStrings__ResultDatabase="server=myServer;database=master;uid
=myUser;password=myPass;"

BackendConfig__Endpoint:yourBackendDnsName
This should be the DNS name of your backend component.

BackendConfig__Port:80
For a production environment a more advanced setup using the 443 Port and HTTPS is highly recommended.

BackendConfig__Protocol:http

BackendConfig__Authentication:false
After all managed devices have been upgraded and user/password for download and upload have been configured, BackendConfig_Authentication can be set to true.

 

finger1

Be aware:

After changing an environment variable, it is necessary to restart the container.

 

Package Store:

Integration__PackageStore__Endpoint=
"http://packages.packagestore.com/RayPackageService"

Integration__PackageStore__Url=
"https://packaging.packagestore.com"

Integration__PackageStore__ParallelProcessing=3

 

finger1

Be aware:

Do not change this configuration. It is possible to adjust these settings with the assistance of a Raynet consultant. These settings will be used during the creation of the integration and will be permanently saved during the creation of the integration.

 

Changes of the environment variables do not change the already saved settings of an already created integration.

 

Catalog:

Integration__Catalog__Url="https://rayventorycatalog.raynet.de"

Integration__Catalog__ConfidenceRange = 90

Integration__Catalog__Timeout = 200000

Integration__Catalog__MaxAttempts = 3

Integration__Catalog__DevicesBatchSize = 10

Integration__Catalog__FingerprintBatchSize = 100

Integration__Catalog__TotalNumberOfDevices = 0

 

finger1

Be aware:

Do not change this configuration. It is possible to adjust these settings with the assistance of a Raynet consultant. These settings will be used during the creation of the integration and will be permanently saved during the creation of the integration.

 

Changes of the environment variables do not change the already saved settings of an already created integration.

 

Azure AD Import

Integration__Azure__AzureApiUrl="https://graph.microsoft.com/"

Integration__Azure__AzureInstance="https://login.microsoftonline.com/{0}"

 

Database Cleanup:

DbMaintenanceConfig__FileStorageCleanupJob="0 0 3 1/1 * ?"

DbMaintenanceConfig__SystemLogCleanupJob="0 0 4 1/1 * ?"

DbMaintenanceConfig__ActivityLogCleanupJob="0 0 5 1/1 * ?"

DbMaintenanceConfig__DeviceInventoryCleanupJob="0 0 6 1/1 * ?"

DbMaintenanceConfig__UpdateInstallStatesJob="0 0 0/4 ? * * *"

 

The following parameters depend on the chosen storage hoster:

 

Azure:

StorageConfig__Default:Azure

StorageConfig__Azure__StorageEndpoint:yourStorageEndpoint
This is the connection string property of Azure Storage. It can be found in the Azure Portal > Storage Accounts > Security + Networking > Access Keys > Connection String (key1 or key2).

StorageConfig__Azure__EndpointUrl:yourStorageEndpointUrl
This is the primary endpoint property of your Azure Storage. It can be found in the Azure Portal > Storage Accounts > Settings > Endpoints > Blob Service.

StorageConfig__Azure__TokenTimeout:60

 

AWS:

StorageConfig__Default:AWS

StorageConfig__AWS__AccessKey=yourAWSAccessKey
This is the access key received during the setup of the AWS IAM user.

StorageConfig__AWS__SecretKey=yourAWSSecretKey
This is the secret key received during the setup of the AWS IAM user.

StorageConfig__AWS__Region=eu-central-1
This is the region which should be used to host the storage.
A full list of the regions can be found here: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html.

 

MinIO:

StorageConfig__Default:MinIO

StorageConfig__MinIO__Endpoint=yourMinIOEndpoint (e.g. play.min.io:80)
The endpoint of the used MinIO instance (ip:port) or (fqdn:port)

StorageConfig__MinIO__AccessKey=yourMinIOAccessKey
The access key/user that has been configured during the MinIO setup.

StorageConfig__MinIO__SecretKey=yourMinIOSecretKey
The secret key/password that has been configured during the MinIO setup.

StorageConfig__MinIO__SSL=true
A boolean value indictating whether the MinIO server requires/uses an https connection or not (the usage of an https connection is recommended).

 

finger1

Be aware:

Refer to Appendix A: Environment variables to find out more about these values.

 

papercliper

Note:

Using the provided connection string, all necessary databases will be automatically set up, once RayManageSoft Unified Endpoint Manager is launched for the first time. Each tenant in RayManageSoft Unified Endpoint Manager will receive its own database. It is necessary to ensure, that the user that is used on the backend has access to the database and permissions for the creation of new databases.