Platform install

Adaptiva provides the installation files in a compressed (.zip) file. The compressed file includes three folders: Documentation, Installers, and Tools folder. The OneSite Platform installation requires two files from the Installer\Windows folder:

adaptiva-server-<version>-windows.exe

adaptiva-client-<version>-windows.exe

The <version> placeholder refers to the downloaded version of the executable.

All components require local administrator privileges to install.

Prerequisites

Review the Planning Guide prior to installation.

Verify connectivity

Please refer to the Communication port requirements and ensure your server has proper communication with cloud services.

In the case of a SQL Server Express Edition installation, your server will need to connect to *.adaptivacdn.cloud to download SQL Express.

Verify user permissions

When using an existing SQL Server installation, the user performing the server installation MUST have sysadmin permissions in the SQL Server that will host the Adaptiva database.

When integrating with Configuration Manager, the user must have permission to the Configuration Manager Site and file server, as well as sysadmin permissions in the SQL Server hosting the ConfigMgr database.

These permissions are only required for the setup and can be reduced after successful installation. You can review the Account Permissions section of the Planning guide for additional information.

Installation Types

To proceed, select one of the following options:

Option 1: Quick Install

This is the best option for most environments. Quick Install will automatically download and configure SQL Server 2022 Express Edition and then install the Adaptiva Server with default options and a self-signed certificate.

To perform a Quick Install, go to Option 1: Quick Install.

Option 2: Advanced Install

If you are using an existing SQL Server Standard / Enterprise Edition or need to use a CA-based certificate, then perform an advanced install. This will allow you to customize all server installation settings.

You will also need to pre-create an account used for reporting access on the Adaptiva SQL database.

To perform an Advanced Install, go to Option 2: Advanced Install

Answer File

If you need to create an Answer File to automate a later new installation, see Create Silent Installation Answer File.

Option 1: Quick Install

The Quick Install option will install the Adaptiva Server using default settings and SQL Server Express Edition. Configure your installation settings and add your license key to begin the OneSite Platform server installation.

1. Right click adaptiva-server-<version>-windows.exe, and then select Run as administrator.

   
2. Change the drive letter of the installation folder to a drive other than C. Click Browse to navigate to and select the installation folder.

   IMPORTANT: Do not install Adaptiva Server on the Operating System (OS) C: drive. The OneSite product log files and the Adaptiva Content Library installed with the Adaptiva Server grow over time, which impacts storage and performance on the OS C: drive. The installer will prompt you to change the destination drive if you continue to install on the boot drive.

3. If you continue with installation on the C: drive, you will see a warning dialog. Click Yes to ignore this warning.

   
4. Configure your Superadmin Login ID and Password. You can:

   Use Windows Login: This option will use either your current logged in account or one that you specify. This account will be added to the superadmin role.

   Use Custom Login: This option allows you to supply an email address and password to create a server login. The email address is a username and does not need to be a valid email address.

5. Enter one or more license keys, separated by semicolons.

   The following items are checked by default:

   Create an Add/Remove Programs Entry: The Adaptiva Server Installer will create an entry for OneSite Platform in Settings | Apps.

   Add a Windows Firewall Exception for Server Application: The Adaptiva Server Installer will add local exceptions in the Windows firewall for the default server ports (See Communication Ports).

   IMPORTANT: Review any existing domain-based group policies (GPO) that configure or restrict Windows firewall rules or rule creation as they can prevent or override these Adaptiva-created firewall exceptions.

6. Click Quick Install.

   
7. Read the Quick Install Behavior prompt and click Proceed.

   The wizard will download and install SQL Server 2022 Express Edition. SQL Express will be installed and configured to use a SQL native reporting account. The Adaptiva Server will then be installed with default options using port 443 and a self-signed certificate for access to the Admin Portal.

   
8. When the installation is completed, click Next.

   

   The wizard will perform a series of Post-Installation Verifications to validate the installation. The installation will skip some checks when not integrated with Microsoft Configuration Manager.

9. Click Done.

   After the installation of the OneSite Platform server, you must install the Adaptiva client on this machine as well. Continue with Client Installation on the Server.

Option 2: Advanced Install

The advanced install option will allow you to customize the installation options for OneSite Platform, including using an existing SQL Server instance.

Configure Installation settings

Configure your installation settings and add your license key to begin the Adaptiva Server setup process.

1. Right click adaptiva-server-<version>-windows.exe, and then select Run as administrator.

   
2. Change the drive letter of the installation folder to a drive other than C. Click Browse to navigate to and select the installation folder.

   IMPORTANT: Do not install Adaptiva Server on the Operating System (OS) C: drive. The OneSite product log files and the Adaptiva Content Library installed with the Adaptiva Server grow over time, which impacts storage and performance on the OS C: drive. The installer will prompt you to change the destination drive if you continue to install on the boot drive.

3. If you continue with installation on the C: drive, you will see a warning dialog. Click Yes to ignore this warning.

   
4. Configure your Superadmin Login ID and Password. You can:

   Use Windows Login: This option will use either your current logged in account or one that you specify. This account will be added to the superadmin role.

   Use Custom Login: This option allows you to supply an email address and password to create a server login. The email address is a username and does not need to be a valid email address.

5. Enter your license key, this is required to install OneSite Platform.

   The following items are checked by default:

   Create an Add/Remove Programs Entry: The Adaptiva Server Installer will create an entry for OneSite Platform in Settings | Apps.

   Add a Windows Firewall Exception for Server Application: The Adaptiva Server Installer will add local exceptions in the Windows firewall for the default server ports (See Communication Ports).

   IMPORTANT: Review any existing domain-based group policies (GPO) that configure or restrict Windows firewall rules or rule creation as they can prevent or override these Adaptiva-created firewall exceptions.

6. Click Advanced Install.

Configure TLS Security Settings

TLS Security Settings will be used to secure the Admin Portal. The Deployment Planning Installation Guide provides details about Certificates.

1. Select one of the following TLS security Settings:

   TLS Using A Certificate Authority (CA): use a certificate you exported from a Certificate Authority:

   1. Click to select Install A CA-Issued X.509 Certificate.

   2. Click Browse and navigate to the location of the exported Certificate PEM File.

   3. Click Browse and navigate to the location of the exported Private Key PEM File.

   TLS Using Self-signed Certificate (default): use a self-signed certificate.

   1. Click to select Create A Self-signed X.509 Certificate.

   2. Enter the names or IP address associated with the Adaptiva server that will host the Adaptiva Admin Portal. Include any server details for NETBIOS, FQDN, DNS Alias or IP Address. Separate each entry with a comma.

2. Set the Web UI Port used by the Admin Portal. This defaults to port 443, but if other services are using that port, we suggest that you use port 9678.

   IMPORTANT: Be sure to share this port with all OneSite Administrators. It is required to access the Admin Portal.

Optional: Configure HTTP Proxy Configuration

If you are using an HTTP Proxy to route internet traffic, click HTTP Proxy Configuration. Select your proxy configuration.

Don't Use an HTTP Proxy: no proxy settings will be configured.

Prefer User Proxy Configured on the System: a locally configured proxy will be configured.

User a Proxy Auto-Configuration (PAC) File: supply the URL to your PAC file.

Use an HTTP Proxy Server: supply the protocol, FQDN/IP of the proxy server, the port configured and a bypass list of semi-colon separated host names or IP addresses.

Click OK.

Expected Client Count

1. Set the expected Adaptiva Client Count. Use the number determined from the Design Planning. The Expected Total Number Of Adaptiva Clients defaults to 5000, which automatically sets the Maximum Data Memory Buffer Size to 2048 MB.

2. Click Next.

(Optional) Integrate 3rd party products

This installation dialog box provides third-party integration options for Microsoft ConfigMgr and Omnissa Workspace ONE.

• If you select Integrate an Existing Microsoft ConfigMgr Site, continue with (Optional) Integrate with ConfigMgr.

• If you select Integrate With Workspace One, continue with Optional - Integrate with Workspace ONE.

• If you do NOT select an integration, continue with the Configure the SQL Database.

(Optional) Integrate with ConfigMgr

On the Site Server Information screen, provide the information for the ConfigMgr Site Server that will integrate with the Adaptiva Server. This integration requires access to the SMS Provider, ConfigMgr database, Site Server inboxes, and the Content Library file system hosted by the Site Server.

1. Click to select Integration with an existing Microsoft ConfigMgr Site and click Next.

2. Enter the Site Server details using the information gathered during Deployment Planning:

   
3. Enter the Machine Name (FQDN) and 3-character Site Code of the ConfigMgr site server.

4. Enter the ConfigMgr Site Login details gathered during Deployment Planning.

   We recommend using the default Use Adaptiva Server's Local System Account login. This is the simplest method of authentication of an Adaptiva Server connection with ConfigMgr.

   Note: If the Adaptiva Server is not co-located with the ConfigMgr Site Server you must grant the Adaptiva Server's computer object the necessary permissions in Configuration Manager.

   If you choose not to use the Local System Account, enter the Domain (NETBIOS Domain name), User Name and Password for the domain account that has been granted the necessary permissions in Configuration Manager

5. Click Next.

ConfigMgr Site Database Information

On the Site Database information screen, provide the database information for the ConfigMgr Site Server that will integrate with the Adaptiva Server.

1. The Site Database fields will auto-populate from the settings obtained by the logged in user's permissions to the ConfigMgr Site Server. You can update the SQL Login information that you gathered during Deployment Planning.

   
2. Review the Site Database details and configure any additional settings:

   Machine Name: the FQDN of the ConfigMgr SQL Server.

   Database Name: the ConfigMgr database name.

   If the SQL Server Instance is using encryption, click to select SQL Instance Is Encrypted.

   SQL Instance Name: the SQL instance name.

   SQL Port: the SQL port.

3. Review the SQL Login details and configure any additional settings:

   Reuse Login Settings That Were Specified For Site Server Login is selected by default.

   If you choose not to use the Local System Account, uncheck this box and uncheck Use Adaptiva Server's Local System Account.

   Enter the Domain (NETBIOS Domain name), User Name and Password for the domain account that has been granted the sysadmin permissions in SQL Server hosting the ConfigMgr database.

   If the account specified is a SQL account, uncheck Use Windows Authentication.

4. Click Next.

   If the account specified is different from the login account used for the service SQL Server (MSSQLSERVER | InstanceName) a warning will be displayed showing the account used by the SQL Service.

   
5. Review the warning and if the settings are correct, click Yes, otherwise, click No and update the settings.

6. At the SQL Authentication Protocols dialog, select the authentication method that will be used to connect to the ConfigMgr Site database.

   

   NTLM v2 is selected by default when the ConfigMgr and Adaptiva databases are hosted on the same SQL server.

   Select Kerberos (Requires SQL SPN) when the ConfigMgr and Adaptiva databases are hosted on different SQL servers or additional security is required. To support Kerberos authentication, Service Principal Names (SPNs) must be created and delegated properly in Active Directory. See Appendix B in this document.

7. Click OK.

Specify Login Information for Accessing Site Server Files

The Login Information For Access To the Site Server's File System screen allows you to specify an account that has the necessary permissions to access the Site Server's file system. Specifically, this account must be able to access the inboxes and the Content Library. Review the table of permissions required in the Deployment Planning Guide for ConfigMgr for potential actions required for this account.

1. At the Login Information screen, enter information to access the ConfigMgr file system.

   

   Reuse Login Settings That Were Specified For Site Server Login is the default. Uncheck this box to specify an account.

   If you choose not to use the Local System Account, enter the Domain (NETBIOS Domain name), User Name and Password for the domain account that has been granted the necessary permissions in Configuration Manager.

2. Click Next.

3. Continue with Configure the SQL Database.

Optional - Integrate with Workspace ONE

1. Click to select Integrate with Workspace ONE and click Next.

2. At the Please Specify Workspace ONE Settings screen complete the following information:

   

   Certificate Location: enter the path or browse to the location of the downloaded ACC certificate.

3. Record the location where the Adaptiva Server Certificate For Workspace ONE will be located after a successful installation: By default, this is %InstallPath%\Adaptiva\AdaptivaServer\data\security. The file will be called AdaptivaServer.cer.

4. Click Next.

Configure the SQL Database

You can choose to install the SQL database on a new instance of SQL Express or an existing instance on a SQL 2017 or later server.

• If you select Download and install free Microsoft SQL Express and auto-create database, continue with Option 1: SQL Express Installation.

• If you select either Create the database in ana existing SQL Server Instance or Create the database in the same SQL instance as ConfigMgr Site Database, click Option 2: Existing SQL Instance.

Option 1: SQL Express Installation

1. Select Download And Install Free Microsoft SQL Express And Auto-create Database and click Next.

   
2. Click Next.

3. At the SQL Express Settings screen enter where the SQL Server Express installer should be downloaded to and where SQL Server Express will be installed

   

   Download Folder: the folder where the SQLExpr_x64_ENU.exe will be downloaded.

   You can pre-download SQLExpr_x64_ENU.exe. Click Browse and navigate to the executable.

   Installation Folder: the folder where SQL Server 2022 Express Edition will be installed.

   Change the drive letter of the Installation Folder to a drive other than C.

   NOTE: It is recommended not to install SQL Server 2022 Express Edition on the C drive. Log files and database files can have high I/O and may cause performance issues if installed on the Operating System drive.

   Once the setup wizard is completed, the installer will download and install SQL Express.

4. Click Next.

5. Continue with Read-Only SQL Login For Reporting.

Option 2: Existing SQL Instance

1. Select either Create The Adaptiva Database In An Existing SQL Server Instance or Create the Database in the same SQL Instance as ConfigMgr Site Database and click Next.

   
2. You will be prompted to confirm that your system meets the SQL Server pre-requisites:

   
3. Click Continue.

4. On the Database Information page, enter your SQL Server information.

   

Database Information

If the SQL Server Instance is using encryption select SQL Instance Is Encrypted.

If the Default SQL Instance is not used, uncheck the box and enter the SQL Instance name.

If the Default SQL Port is not used, uncheck the box and enter the SQL Port.

SQL Login

1. Enter the SQL Server Machine Name FQDN.

2. Select or enter a SQL account.

   (Recommended) Select Use Adaptiva Server's Local System Account.

   If you choose not to use the Local System Account, enter the NETBIOS Domain name, User Name and Password of the account with sysadmin permission in the SQL Server that will host the Adaptiva database.

   If the account specified is a SQL account, uncheck Use Windows Authentication.

3. Click Next.

4. If the account specified is different from the login account used for the service SQL Server (MSSQLSERVER | InstanceName) a dialog box will prompt you to verify the account used by the SQL Service.

   

   If the settings are correct, click Yes, otherwise, click No and update the settings.

5. At the Windows Authentication Protocol for SQL dialog, select the authentication method that will be used to connect to the SQL database.

   

   NTLM v2 is selected by default.

   If you require additional security, you can select Kerberos (Requires SQL SPN). To support Kerberos authentication, Service Principal Names (SPNs) must be created and delegated properly in Active Directory.

6. Click OK.

7. When the SQL Server hosting the Adaptiva database is different from the SQL Server hosting the ConfigMgr database, a message will be displayed.

   

   Be sure the Linked Servers are created before continuing and then click OK. For more information see Create the Linked Servers.

Read-Only SQL Login For Adaptiva Reporting

Provide a SQL login for reporting.

1. Enter the account information to be used for reporting:

   Use Windows Authentication -- This box will be checked and greyed out Windows Authentication mode has been specified in the local SQL Server.

   Domain Name -- Enter the NETBIOS domain name used for the reporting account. Leave blank if Use Windows Authentication is unchecked and a SQL Login account is to be used.

   User Name -- Enter the account name created for use as the reporting account.

   Password -- Enter the password for the reporting account.

   Confirm Password -- Confirm the password that you entered above.

   IMPORTANT: When SQL Server is remote from the Adaptiva Server, the installation will only be able to use Windows authentication. New Installations using SQL Express that did not use Quick Install will also be required to create an account and use Windows Authentication.

2. Click Next.

Completing the Installation

1. The installation will begin.

   
2. When the installation is complete, click Next.

   

   The wizard performs a series of Post-Installation Verifications to validate the installation. The installation will skip some checks when not integrated with Microsoft Configuration Manager.

   NOTE: There is a known issue when the Kerberos authentication protocol is selected for the Adaptiva database: The Read-Only Account Write Access Denied will report Failed. This can be ignored.

3. Click Done.

Client Installation on the Server

1. After the Adaptiva Server is installed, the Adaptiva Client must be installed on the server. At the Launch Adaptiva Client Installer dialog, the Client Installer Path will be displayed based on the relative path the server component was installed from.

2. Click Launch to begin the Client installation.

   
3. At the Adaptiva Client Installer dialog, complete the following

   

   Adaptiva Install Path: Update the path as required. We recommend installing the Adaptiva client in the same parent folder as the Adaptiva Server (%drive%:\Program Files\Adaptiva\AdaptivaClient).

   The installer will auto-populate the Server Host Name or IP Address and Server GUID fields.

4. Click Install.

5. When the installation is completed, the Client Validation Checks application will confirm the connectivity requirements for the Adaptiva client.

   

   The Client to Client and Cloud Relay Connection check is not applicable for a server installation.

6. Click OK.

Server Installation Logs

In the case where an administrator needs to troubleshoot an Adaptiva Server installation, the following table contains the installation log locations. Other logs exist in the installation folder.

(Optional) Create a Silent Installation Answer file

An answer file can be created to automate the installation of the OneSite Platform server. The executable must be run with administrative privileges. The answer file can only be created when the Adaptiva Server has not been previously installed.

1. Right click adaptiva-server-<version>-windows.exe, and then select Run as administrator.

2. Change the drive letter of the installation folder to a drive other than C. Click Browse to navigate to and select the installation folder.

   IMPORTANT: Do not install Adaptiva Server on the Operating System (OS) C: drive. The OneSite product log files and the Adaptiva Content Library installed with the Adaptiva Server grow over time, which impacts storage and performance on the OS C: drive. The installer will prompt you to change the destination drive if you continue to install on the boot drive.

3. Configure your Superadmin Login ID and Password. You can:

Use Windows Login: This option will use either your current logged in account or one that you specify. This account will be added to the superadmin role.

Use Custom Login: This option allows you to supply an email address and password to create a server login. The email address is a username and does not need to be a valid email address.

1. Enter one or more license keys, separated by semicolons.

2. Click Answer File.

3. At the Generate Installation Answer File dialog, enter or Browse to a location where the file will be created. Click OK. The answer file will be named AdaptivaAnswerFile.txt in the folder selected.

   

   The installation screens will proceed as described in the Server Installation section. Each answer will be saved in the Answer file. The installation will NOT install the product. Use the Server Installation section below to learn about each screen during the installation process.

4. When all the prompting screens are complete the answer file is created. Click OK.

   

   The installation process will end.

   NOTE: If passwords were entered for the SuperAdmin ID or Service accounts, these passwords will be stored in clear text in the Answer File. Delete or secure the answer file after the installation has been completed.

Install using the Answer File

If you have created an answer file, follow these steps to use the answer file to install the Adaptiva OneSite Server.

1. Open a Command Prompt as Administrator.

2. Navigate to the installation source folder.

3. Enter the following command:

   adaptiva-server-<version>-windows.exe -InstallOrUpgrade %path%:\\<AnswerFileName>

4. There is no progress bar during the installation. The installation can be monitored using the Task Manager, monitoring the adaptiva-server.exe process and by monitoring the log file C:\Windows\AdaptivaSetupLogs\Server\AdaptivaServerSetup.log.

5. Upon successful installation the adaptiva-server-<version>-windows.exe process will be replaced with AdaptivaServerService and the AdaptivaServerSetup.log will show:

   ~performSilentServerInstall(): 2C58: Line: 160: Server installation was successful

   NOTE: The server installation normally launches adaptiva-client-<version>-windows.exe to install the Adaptiva Client. The silent installation does not do this. Be sure to install the Adaptiva Client on the server as well.

Post-install instructions

Add certificate to the root store

If a self-signed certificate was selected, you should import the certificate into the Trusted Root Certification Authorities container on every device where the Adaptiva Admin Portal will be accessed. Each OneSite Administrator who will use the Admin Portal from a remote device will need to import the certificate. Alternatively, the certificate can be deployed using a GPO or Intune policy.

Download and install the certificate

1. In your browser, navigate to your Adaptiva Server name with optional :port - https://servername[:port].

   Example: https://cm.onelab.com:9678

2. You will see the message Your connection isn't private.

3. Click on the text Not secure next to the Address URL.

4. Click on Your connection to this site isn't secure.

   
5. Click on the certificate icon to view the certificate.

   
6. Select the Details tab.

7. Click on Export.

8. Select a destination (your Downloads folder) - leave the default filename of adaptiva.crt.

9. Close your browser.

10. In File Explorer, browse to the saved certificate and double-click it.

11. Select Install Certificate....

12. Select Local Machine (recommended) and click Next.

13. Select Place all certificates in the following store.

14. Click Browse, select Trusted Root Certification Authorities and click OK.

15. Click Next and then click Finish.

Alternatively

1. The certificate is stored in the registry at HKLM\SOFTWARE\Adaptiva\server\certificates.cloudui_public_cert

2. The data can be saved into a UTF-8 formatted text file with a .crt extension.

3. You can then run the following command to import the certificate:

   Certutil.exe -addstore root "<path>\adaptiva.crt"

Test the certificate

1. In your browser, enter the Adaptiva Server name with optional :port - https://adaptivaservername[:port].

2. You will now see the Admin Portal login page.

3. There will now be a lock icon next to the URL

   

Content Library Location

The Content Library will default to Adaptiva Server installation folder %Path%\Adaptiva\AdaptivaServer\Data\ContentLibrary. Consider moving the Content Library to a dedicated drive. Review this How-To article.

IMPORTANT: Ensure this drive is backed up or replicated.

Configure SQL Database Best Practices

By default, the installation account is assigned as the owner of the Adaptiva database. SQL best practice is to set the SA account to the owner.

1. In SQL Management Studio, right-click on the adaptiva database and select Properties.

2. Select the Files page. Change the Owner to SA.

3. Select the Options page. Verify the Recovery model is set to Simple.

   NOTE: If the Adaptiva database will be part of a SQL Always On Availability Group, the Recovery model should be set to Full.

Finalize the Workspace ONE Integration

This is only applicable if the Workspace ONE integration was selected.

After a successful installation, return to the Workspace ONE UEM console to complete the integration of the two platforms.

1. Navigate to the Adaptiva settings page (Groups & Settings | All Settings | System | Enterprise Integration | Peer Distribution | Adaptiva) and enter either the name or the internal IP address of the Adaptiva server. This will allow the ACC to communicate with the Adaptiva server on the internal network.

2. Upload the Adaptiva Server certificate so the authentication between the ACC and Adaptiva services is secure. Recall the certificate was saved here: %InstallPath%\Program Files\Adaptiva\AdaptivaServer\data\security\AdaptivaServer.cer.

   
3. Click Save. The system will save the settings and immediately perform a health check to validate communications and then initiate publication of application metadata to the Adaptiva Server.

   

(Optional) Reduce SQL permissions

To remove SQL sysadmin access from the account

1. Stop the AdaptivaServer service.

2. In SQL Management Studio, select the ConfigMgr database and click New Query, enter the following command:

   Copy

   CREATE ROLE db_executer\
   GRANT EXECUTE TO db_executer

3. Click Execute.

4. Repeat the above step against the Adaptiva database.

5. Expand Security | Logins folder, right-click the account used for installation and select Properties.

6. Select the Server Roles page and uncheck the server role: sysadmin.

7. Select User Mapping.

8. In the Users mapped to this login section, select the adaptiva database, and under the database role membership, select the following roles:

   Copy

   db_datareader
   db_datawriter
   db_ddladmin
   db_executer

9. In the Users mapped to this login section, select the ConfigMgr database, and under the database role membership, de-select the db_owner role, and select the following roles:

   Copy

   db_datareader
   db_datawriter
   db_ddladmin
   db_executer

   
10. Click OK when complete.

11. Start the AdaptivaServer service.

Add A License Key

After the Adaptiva Server setup is complete, enable one of the evaluation licenses or install your Adaptiva-provided license key to enable the product. This will activate the product and prepare to license clients. License keys can only be added via the Adaptiva Admin Portal.

1. In a web browser, enter the Adaptiva Server Admin Portal URL: https://AdaptivaServerFQDN[:Port].

2. At the Adaptiva Web Portal, click Log in with Active Directory. If an Adaptiva login account was created, enter the email address and password created during installation and click Log in.

   
3. After logging in, the Adaptiva Web Portal will be displayed. A license must be added to activate the features of that product in the Adaptiva Web Portal.

   
4. Click Manage Licenses.

   
5. Click Add Key, enter your license key, and click OK.

6. Optionally, click Start Free Trial, select the product you wish to preview and click OK.

7. You will be prompted to Accept an End User License Agreement. Click Accept.

8. Your Adaptiva products will be listed on the left, with license details in the right pane.

9. Select an Adaptiva product to review the current license status.

   

   Notice the License Count, Expiration Date and specific Licensed Collections of devices targeted to receive the license.

Target Clients for Licensing

1. In the Target Collections pane, target which clients will receive this license.

2. Toggle Use All Clients. In the confirmation window, click OK.

3. Optionally, click Browse and select a collection or group of clients, then click OK.

Server Activation (OneSite Anywhere only)

Once the activation code is received continue with the next step.

If you have not requested the Activation Code, see the section Server Activation in the Installation Prerequisites.

1. In a web browser connect to the Admin Portal -- http://AdaptivaServerFQDN[:port]

2. Enter the appropriate credentials or click on Login with Active Directory.

3. Click on the with the drop-down on the far right and select Settings | Server Activation.

   
4. On the Server Activation page, click Activate Server.

5. Enter the activation code provided by Adaptiva Support and click OK.

   
6. The Adaptiva Server Service will attempt to contact the Adaptiva Cloud Relay Server at http://services.adaptiva.cloud.

   If it cannot reach the service using port 80 you will the following error:

   

   If it successfully registers with the Adaptiva Cloud Relay Service, the Server activated slider will be slid to the right

   

Note the other information available in the Cloud Connect Adaptiva Server settings screen:

Customer name: This is initially the FQDN of the Adaptiva server. After activation, it will display the name that was entered at the Cloud Relay Server.

Global ID: Unique ID of the Adaptiva Server assigned at registration time

Tenant ID: Unique ID of the Adaptiva Server. Also, part of the certificate issued to the server and make up the server's identity

Server GUID: This uniquely identifies your Adaptiva Server and can be used for client installations. It is required if the client is being installed without connectivity to the Adaptiva Server, requiring the client to validate through the Adaptiva Cloud Relay Service.