How can I change the IP address or hostname of my DXmanager Server or CA Directory hosts?

book

Article ID: 52536

calendar_today

Updated On:

Products

DIRECTORY SECURITY MISC CODES SINGLE SIGN ON - LEGACY CA Data Protection (DataMinder) CA User Activity Reporting

Issue/Introduction

Description:

What should I do if I need to change the IP address or hostname(s) for my DXmanager server or my CA Directory hosts?

Solution:

If you are in need to change the IP address and/or hostname for your DXmanager Server and/or your CA Directory hosts, the following needs to be performed.

Note: Please make sure to test this in your pre-production environment exclusively before doing it in actual production environment.

There are two main considerations:

  1. Non-DXmanager Deployments that use knowledge reference configuration files.

  2. DXmanager Deployments using the XML configuration file.

Non-DXmanager Deployments

In a non-DXmanager deployment, the knowledge configuration is still the same as in CA Directory r8.1. In this kind of deployment the IP address/hostname(s) are referenced within the KNOWLEDGE ".dxc" files. (%DXHOME%\config\knowledge on Windows and $DXHOME/config/knowledge on UNIX/LINUX).

The steps required to reconfigure the IP address/hostname is:

  1. Stop all DSAs on your CA Directory host(s).

  2. Update the KNOWLEDGE .dxc files to match the new IP address or hostname. Example:

    Old Knowledge
    set dsa "democorp" ={    prefix        = <c AU><o Democorp>    dsa-name      = <c AU><cn "democorp">    dsa-password  = "secret"    address       = tcp "old-host-name" port 19389    disp-psap     = DISP    snmp-port     = 19389    console-port  = 19390    auth-levels   = anonymous, clear-password};
    New Knowledge
    set dsa "democorp" ={    prefix        = <c AU><o Democorp>    dsa-name      = <c AU><cn "democorp">    dsa-password  = "secret"    address       = tcp "new-host-name" port 19389    disp-psap     = DISP    snmp-port     = 19389    console-port  = 19390    auth-levels   = anonymous, clear-password};
  3. Restart all DSAs on your CA Directory hosts.

Please note: If you have deployed CA Directory on multiple hosts and have configured load-sharing/replication, then all CA Directory hosts will need to have their knowledge updated to reflect the hostname/IP address changes for the specific host being changed, otherwise connectivity issues will be experienced.

DXmanager Deployments

In a DXmanager deployment, there are two main considerations when a hostname is being changed:

  1. If the DXmanager Server itself is having its hostname/IP address changed.

  2. If the CA Directory host(s) are getting their IP address/hostname changed.

The steps involved in each scenario are:

DXmanager Server hostname/IP Address change

  1. Shutdown the DSAs on remote CA Directory hosts via DXmanager or on the command line at each CA Directory host.

  2. Stop DXmanager

  3. Change the hostname/IP address of the DXmanager host

  4. Re-configure the DXadmind process so it can trust the new IP address or hostname of the DXmanager Server. Remember, this is the only way DXmanager communicates to CA Directory hosts. Otherwise, the DXadmind process will still trust the "old" IP address of DXmanager Server. All directory hosts will need to have their DXadmind processes re-configured to trust the new DXmanager IP address.

  5. Reboot the DXmanager as required in order to refresh the IP address.

  6. When DXmanager restarts, it should communicate with each Directory host to ensure that all hosts have the current configuration.

CA Directory host IP Address/hostname change

When a CA Directory host is configured using DXmanager, and the Directory host needs to have its IP address/hostname changed, the following steps need to occur:

  1. Stop all DSA's running on the Directory host.

  2. Edit the DXmanager configuration, switch to the topology map, and right click on the Directory host icon.

  3. Remove the old network address details, and add the new network address details.

  4. Separately, on the CA Directory host itself, change the hostname/IP address reboot the server (if required) in order to refresh the address change.

  5. From DXmanager, save the configuration and deploy it.

  6. Once DXmanager has confirmed the connection to the Directory host, re-start the DSAs using DXmanager GUI from DXmanager Server.

Environment

Release:
Component: ETRDIR