Updating the Omnissa Access Connector Host Name

If you change the Omnissa Access connector server host name after installing the connector, you must also update the Directory Sync service, User Auth service, Kerberos Auth service, and Virtual App service installed on the connector to use the new host name.

Procedure

1. Log into the Omnissa Access connector server.

2. For each enterprise service (Directory Sync service, User Auth service, Kerberos Auth service, or Virtual App service) that is installed on the server, edit the INSTALL_DIR\Access Connector\enterpriseService\conf\hostname.properties file and update the host name.

   Use the following format:

   {"hostName":"hostname"}
   

   Specify hostname as a fully-qualified domain name, for example, myhost.example.com.

3. (Kerberos Auth service only) After updating the host name in the Kerberos Auth service hostname.properties file, also update it in the application.properties file.

   1. Open the INSTALL_DIR\Access Connector\Kerberos Auth Service\conf\application.properties file for editing.

   2. Update the eks.hostname value to the new host name. Specify the host name as a fully-qualified domain name, without an http or https prefix. For example, myhost.example.com.

4. If you are using the Omnissa Access generated self-signed certificate for the Kerberos Auth service, regenerate the certificate by using the createCertificate.bat script.

   In a command window, run the following command:

   INSTALL_DIR\support\scripts\createCertificate.bat -force -install -host "hostname"
   

   For hostname, specify the new host name of the connector as a fully-qualified domain name (FQDN).

5. Restart the enterprise services.

   The enterprise services start and register with the Omnissa Access service with the new host name.

6. In the Omnissa Access service console, associate the new host name with authentication methods and directories.

   1. Log into the Omnissa Access service.

   2. Navigate to the Integrations > Connectors page.

   3. Verify that the new connector host name appears in the connectors list.

   4. Navigate to the Integrations > Connector Authentication Methods page.

   5. Select the authentication method associated with the old host name, and click Edit.

   6. In the Directory and Hosts page of the wizard, under Select Service Hosts, select the new host name and deselect the old host name.

   7. Click Next and save your changes.

   8. Repeat steps d. to f. for each authentication method that is associated with the old host name.

   9. Navigate to the Integrations > Directories page.

   10. For each directory that is associated with the Directory Sync service whose host name you changed, make the following changes.

       1. Click the directory.
       2. Click Sync Settings.
       3. Click the Sync Service tab.
       4. Add the new host name to the Sync Services list and delete the old host name from the list.
       5. Click Save.

   11. Navigate to the Resources > Virtual Apps Collections page.

   12. Make the following changes for each virtual apps collection.

       1. Select the virtual apps collection, and click Edit.
       2. On the Connector page of the Edit wizard, add the new host name to the Connector list and remove the old host name.
       3. Save your changes.

   13. Navigate to the Integrations > Connectors page, select the connector entry with the old host name, click Manage, and delete all the services.