Updating the Workspace ONE Access Connector Host Name

If you change the Workspace ONE 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 Workspace ONE 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\Workspace ONE Access\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\Workspace ONE Access\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 Workspace ONE 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 Workspace ONE Access service with the new host name.
6. In the Workspace ONE Access service console, associate the new host name with authentication methods and directories.
   1. Log into the Workspace ONE Access service.
   2. Navigate to the Connectors page.
      In a Workspace ONE Access cloud tenant with the New Navigation toggle turned on, go to Integrations > Connectors. In a Workspace ONE Access 21.08 virtual appliance, or a cloud tenant with the New Navigation toggle turned off, go to Identity & Access Management > Setup > Connectors.
   3. Verify that the new connector host name appears in the connectors list.
   4. Navigate to the Connector Authentication Methods page.
      In a Workspace ONE Access cloud tenant with the New Navigation toggle turned on, go to Integrations > Connector Authentication Methods. In a Workspace ONE Access 21.08 virtual appliance, or a cloud tenant with the New Navigation toggle turned off, go to Identity & Access Management > Manage > Connector Authentication Methods.

      Note: In the Workspace ONE Access 21.08 on-premises virtual appliance, the page is named Enterprise Authentication Methods.
   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 Directories page.

      In a Workspace ONE Access cloud tenant with the New Navigation toggle turned on, go to Integrations > Directories. In a Workspace ONE Access 21.08 virtual appliance, or a cloud tenant with the New Navigation toggle turned off, go to Identity & Access Management > Manage > Directories.

   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 Virtual Apps Collections page.

       In a Workspace ONE Access cloud tenant with the New Navigation toggle turned on, go to Resources > Virtual Apps Collections. In a Workspace ONE Access 21.08 virtual appliance, or a cloud tenant with the New Navigation toggle turned off, go to Catalog > Virtual Apps Collections.

       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.
   12. Navigate to the Connectors page, select the connector entry with the old host name, click Manage, and delete all the services.