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, and Kerberos Auth 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, or Kerberos Auth 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. 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).
  4. Restart the enterprise services.
    The enterprise services start and register with the Workspace ONE Access service with the new host name.
  5. 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. Go to the Identity & Access Management > Setup > Connectors page and verify that the new connector host name appears in the list.
    3. Click the Identity & Access Management > Manage > Enterprise Authentication Methods tab.
    4. Select the authentication method associated with the old host name and click Edit.
    5. In the Directory and Hosts page of the wizard, under Select Service Hosts, select the new host name and deselect the old host name.
    6. Click Next and save your changes.
    7. Repeat steps d. to f. for each authentication method that is associated with the old host name.
    8. Click the Directories tab.
    9. 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.
    10. Go to the Identity & Access Management > Setup > Connectors page, select the connector entry with the old host name, click Manage, and delete all the services.