Table of Contents

Changing the IP of a DMA

The way you can change the IP of a DMA depends on how your DataMiner System is set up. It is different for a standalone DMA, a DMA in a DMS, a Failover DMA in a DMS, and a DMA in a DMS using a Cassandra cluster.

Standalone DMA

For a standalone DMA, i.e. a DMA that is not combined with other DMAs in a cluster:

  1. Stop the DataMiner software on the DMA.

  2. Change the IP address of the DMA server in Windows.

  3. Go to the folder C:\Skyline DataMiner and open the file DB.xml.

  4. Locate the old IP address in this file, replace it with the newly configured one wherever necessary, and save the file.

  5. If the server hosts a Cassandra database:

    1. Open the cassandra.yaml file (typically located in the folder C:\Program Files\Cassandra\conf\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the cassandra service.

  6. If the server hosts an OpenSearch database:

    1. Open the opensearch.yml file (typically located in the folder C:\Program Files\opensearch\config\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the Java.exe service located under the Details tab in the Task Manager.

  7. If the server hosts an Elasticsearch database:

    1. Open the elasticsearch.yml file (typically located in the folder C:\Program Files\Elasticsearch\config\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the elasticsearch-service-x64 service.

  8. If the server has the NATS service installed:

    1. Open the file SLCloud.xml, located in the folder C:\Skyline DataMiner\.

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Uninstall NAS and NATS:

      1. Go to C:\Skyline DataMiner\Files and double-click SLEndpointTool_Console.exe.

      2. Press U to confirm that you want to uninstall NAS and NATS.

      3. Press Enter twice, enter NAS, and press Y.

    4. Install NAS and NATS again:

      1. Go to C:\Skyline DataMiner\Files and double-click SLEndpointTool_Console.exe.

      2. Press I to confirm that you want to install NAS and NATS

      3. Press Enter twice, enter NATS, and press Y.

  9. If the server has the nats-server service installed:

    1. Open the appsettings.runtime.json file, located in the folder C:\Program Files\Skyline Communications\DataMiner BrokerGateway\.

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the DataMiner BrokerGateway service.

  10. If your DataMiner Agent is connected to dataminer.services, restart all DataMiner Extension Modules.

  11. Restart DataMiner.

Note

If the DataMiner System uses a remote database, the database configuration changes detailed above are not needed. In such a case, the IPs are not affected, because the remote server remains the same in the .yml file and in DB.xml. However, you must make sure that all the necessary ports are open and accessible. See Configuring the IP network ports.

Single DMA in a DMS

For a single DMA within a cluster that does not use the Cassandra cluster feature (i.e. one Cassandra cluster for the entire DMS):

  1. Stop the DataMiner software on the DMA for which you want to change the IP.

  2. Change the IP address of the DMA server in Windows.

  3. Go to the folder C:\Skyline DataMiner and open the file DMS.xml.

  4. Locate the old IP address in this file, replace it with the newly configured one wherever necessary, and save the file.

  5. Go to the folder C:\Skyline DataMiner and open the file DB.xml.

  6. Locate the old IP address in this file, replace it with the newly configured one wherever necessary, and save the file.

  7. If the server hosts a Cassandra database:

    1. Open the cassandra.yaml file (typically located in the folder C:\Program Files\Cassandra\conf\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the cassandra service.

  8. If the server hosts an OpenSearch database:

    1. Open the opensearch.yml file (typically located in the folder C:\Program Files\opensearch\config\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the Java.exe service located under the Details tab in the Task Manager.

  9. If the server hosts an Elasticsearch database:

    1. Open the elasticsearch.yml file (typically located in the folder C:\Program Files\Elasticsearch\config\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the elasticsearch-service-x64 service.

  10. If the server has the NATS service installed:

    1. Open the file SLCloud.xml, located in the folder C:\Skyline DataMiner\.

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Uninstall NAS and NATS:

      1. Go to C:\Skyline DataMiner\Files and double-click SLEndpointTool_Console.exe.

      2. Press U to confirm that you want to uninstall NAS and NATS.

      3. Press Enter twice, enter NAS, and press Y. (This will uninstall both NATS and NAS)

    4. Install NAS and NATS again:

      1. Go to C:\Skyline DataMiner\Files and double-click SLEndpointTool_Console.exe.

      2. Press I to confirm that you want to install NAS and NATS.

      3. Press Enter twice, enter NATS, and press Y.

        This will install both NAS and NATS.

  11. If the server has the nats-server service installed:

    1. Open the appsettings.runtime.json file, located in the folder C:\Program Files\Skyline Communications\DataMiner BrokerGateway\.

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the DataMiner BrokerGateway service.

  12. If your DataMiner Agent is connected to dataminer.services, restart all DataMiner Extension Modules.

  13. Restart DataMiner.

  14. In System Center, go to the Agents page and remove the old IP address from the list of DMAs in the cluster.

  15. From DataMiner 10.1.1 onwards, the following additional steps are required in order to reset NATS:

    Note

    The steps below are only needed when the NATS service is installed. They are not needed with the nats-server service.

    1. Open the SLNetClientTest tool. See Opening the SLNetClientTest tool.

      Warning

      Always be extremely careful when using this tool, as it can have far-reaching consequences on the functionality of your DataMiner System.

    2. Connect to the DMA with the changed IP address. See Connecting to a DMA with the SLNetClientTest tool.

    3. Go to the Build Message tab of the main window of the SLNetClientTest tool.

    4. In the Message Type drop-down list, select Skyline.DataMiner.Net.Apps.NATSCustodian.NATSCustodianResetNatsRequest and click Send Message.

    5. Close the SLNetClientTest tool.

Note

If the DataMiner System uses a remote database, the database configuration changes detailed above are not needed. In such a case, the IPs are not affected, because the remote server remains the same in the .yml file and in DB.xml. However, you must make sure that all the necessary ports are open and accessible. See Configuring the IP network ports.

Failover DMA in a DMS

For a Failover DMA within a cluster that does not use the Cassandra cluster feature (i.e. one Cassandra cluster for the entire DMS):

  1. Stop the DataMiner software on both Failover DMAs.

  2. Change the IP address of the DMA server in Windows.

  3. On the DMA of which you have changed the IP, go to the folder C:\Skyline DataMiner and open the file DB.xml.

  4. Locate the old IP address in this file, replace it with the newly configured one wherever necessary, and save the file.

  5. On the DMA of which you have changed the IP, go to the folder C:\Skyline DataMiner and open the file DMS.xml.

  6. Locate the old IP address in this file, replace it with the newly configured one wherever necessary, and save the file.

  7. On the other DMA of the Failover pair, go to the folder C:\Skyline DataMiner and open the file DMS.xml.

  8. Locate the old IP address in this file, replace it with the newly configured one wherever necessary, and save the file.

  9. If the DMAs host a Cassandra database, do the following on both DMAs:

    1. Open the cassandra.yaml file (typically located in the folder C:\Program Files\Cassandra\conf\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the cassandra service.

    Note

    If the IP of both DMAs in the Failover pair is changed, replace both IP addresses in both cassandra.yaml files.

  10. If the server hosts an OpenSearch database, do the following on both DMAs:

    1. Open the opensearch.yml file (typically located in the folder C:\Program Files\opensearch\config\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the Java.exe service located under the Details tab in the Task Manager.

  11. If the DMAs hosts an Elasticsearch database, do the following on both DMAs:

    1. Open the elasticsearch.yml file (typically located in the folder C:\Program Files\Elasticsearch\config\).

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the elasticsearch-service-x64 service.

  12. If the server has the nats-server service installed, do the following on both DMAs:

    1. Open the appsettings.runtime.json file, located in the folder C:\Program Files\Skyline Communications\DataMiner BrokerGateway\.

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the DataMiner BrokerGateway service.

  13. If your DataMiner Agent is connected to dataminer.services, restart all DataMiner Extension Modules.

  14. Restart DataMiner on the DMA with the changed IP address.

  15. Restart DataMiner on the other Failover DMA. It should start up in offline mode.

  16. On the online DMA, go to System Center > Agents, and remove the old IP address from the list of DMAs in the cluster.

  17. Still on the Agents page in System Center, make sure the online Failover DMA is selected in the list on the left, and click the Failover button in the lower right corner to check the Failover status. For more information, see Viewing the current Failover DMA status.

  18. In case the Failover status is not green and there are heartbeat errors, stop DataMiner, and double-check the DMS.xml files of both DMAs to make sure all references to the old IP address have been correctly replaced.

  19. From DataMiner 10.1.1 onwards, the following additional step is required in order to reset NATS.

    Note

    This step is only required when the NATS service is installed, not when the nats-server service is installed.

    1. Open the SLNetClientTest tool. See Opening the SLNetClientTest tool.

      Warning

      Always be extremely careful when using this tool, as it can have far-reaching consequences on the functionality of your DataMiner System.

    2. Connect to the DMA with the changed IP address. See Connecting to a DMA with the SLNetClientTest tool.

    3. Go to the Build Message tab of the main window of the SLNetClientTest tool.

    4. In the Message Type drop-down list, select Skyline.DataMiner.Net.Apps.NATSCustodian.NATSCustodianResetNatsRequest and click Send Message.

    5. Close the SLNetClientTest tool.

Note

If the DataMiner System uses a remote database, the database configuration changes detailed above are not needed. In such a case, the IPs are not affected, because the remote server remains the same in the .yml file and in DB.xml. However, you must make sure that all the necessary ports are open and accessible. See Configuring the IP network ports.

DMA in a DMS using a Cassandra cluster locally

If your DataMiner System uses the Cassandra cluster feature for its general database (i.e. one Cassandra cluster for the entire DMS), but Cassandra is hosted on the same machine as DataMiner (which is not recommended), follow the procedure below to change the IP of one of the DMAs in the DMS:

  1. Stop the DMA of which you want to change the IP.

  2. Stop the Cassandra and OpenSearch/Elasticsearch services on the DMA server.

  3. Change the IP address of the DMA server in Windows.

  4. Locate the file cassandra.yaml on the DMA. By default, it is located in the folder C:\Program Files\Cassandra\conf.

  5. Open cassandra.yaml in a text editor (as Administrator) and replace the IP address in the following lines with the IP of the server:

    listen_address: new IP
- seeds: "new IP (, IP Cassandra node 2, IP Cassandra node 3, ...)"
 broadcast_rpc_address: new IP

  6. Restart the Cassandra service.

  7. In a command window, execute nodetool status (from the directory C:\Program Files\Cassandra\bin), in order to check the status of the cluster. this should result in a list with your new IP, your old IP and all other Cassandra nodes on the server. For example:

    Example of the nodetool status resuls

  8. In the same command window, execute nodetool removenode [host ID of the old IP], e.g. nodetool removenode 35506039-0f03-4a1e-8642-94484d440116.

  9. Locate the cassandra.yaml files on the other DMAs in the DMS, as described above, and replace any occurrences of the old IP address in the seeds list in these files with the new IP address.

  10. If OpenSearch is used as the indexing database:

    1. Locate the file opensearch.yml on the DMA of which you have changed the IP. By default, it is located in the folder C:\Program Files\opensearch\conf.

    2. Open opensearch.yml in a text editor (as Administrator) and replace the IP address in the following lines with the IP of the server:

      discovery.zen.ping.unicast.hosts: ["new IP (, IP Cassandra node 2, IP Cassandra node 3, ...)"]
network.publish_host: new IP

    3. Restart the Java.exe service located under the Details tab in the Task Manager.

    4. Locate the opensearch.yml files on the other DMAs in the DMS, as described above, and replace any occurrences of the old IP address in the discovery.zen.ping.unicast.hosts field of these files with the new IP address.

  11. If Elasticsearch is used as the indexing database:

    1. Locate the file Elasticsearch.yml on the DMA of which you have changed the IP. By default, it is located in the folder C:\Program Files\Elasticsearch\conf.

    2. Open Elasticsearch.yml in a text editor (as Administrator) and replace the IP address in the following lines with the IP of the server:

      discovery.zen.ping.unicast.hosts: ["new IP (, IP Cassandra node 2, IP Cassandra node 3, ...)"]
network.publish_host: new IP

    3. Restart the Elasticsearch service.

    4. Locate the Elasticsearch.yml files on the other DMAs in the DMS, as described above, and replace any occurrences of the old IP address in the discovery.zen.ping.unicast.hosts field of these files with the new IP address.

  12. Open the file DB.xml from the Skyline DataMiner folder of the DMA with the new IP, and replace the old IP in the DB tags for the Cassandra and OpenSearch/Elasticsearch databases with the new IP address.

    Tip

    See also: DB.xml

  13. Open the file DB.xml for all other DMAs in the DMS, and replace the old IP address with the new IP address for both Cassandra and OpenSearch/Elasticsearch.

  14. If the server has the nats-server service installed:

    1. Open the appsettings.runtime.json file, located in the folder C:\Program Files\Skyline Communications\DataMiner BrokerGateway\.

    2. Replace any references to the old IP address with the new IP address, and save the file.

    3. Restart the DataMiner BrokerGateway service.

  15. If your DataMiner Agent is connected to dataminer.services, restart all DataMiner Extension Modules.

  16. Restart DataMiner.

  17. Reset NATS.

    Note

    This step is only required when the NATS service is installed, not when the nats-server service is installed.

    1. Open the SLNetClientTest tool. See Opening the SLNetClientTest tool.

      Warning

      Always be extremely careful when using this tool, as it can have far-reaching consequences on the functionality of your DataMiner System.

    2. Connect to the DMA with the changed IP address. See Connecting to a DMA with the SLNetClientTest tool.

    3. Go to the Build Message tab of the main window of the SLNetClientTest tool.

    4. In the Message Type drop-down list, select Skyline.DataMiner.Net.Apps.NATSCustodian.NATSCustodianResetNatsRequest and click Send Message.

    5. Close the SLNetClientTest tool.

Tip

See also: Migrating the general database to a DMS Cassandra cluster

Propose changes