Is it possible to change it IP Address of a DataMiner Agent?
What's the procedure to perform that change?
Additionally, what's required on DataMiner if the Agent is on a Failover pair and if is part of a cluster (DMS)?
Hi Bruno,
I'll try to summarize an approach of what I believe would be good approach to deal with this change.
Non Failover DMA in a DMS:
Stop the DataMiner software on the agent in question and modify the ip address on Windows OS level.
Go into the "C:\Skyline DataMiner" folder and open the dms.xml file --> see if you can locate the old ip address in this file and if so, replace it with the newly configured one. If changes were applied to the dms.xml file, save them
Go into the "C:\Skyline DataMiner" folder and open the db.xml file --> see if you can locate the old ip address in this file and if so, replace it with the newly configured one. If changes were applied to the db.xml file, save them and move to restart the DataMiner SW.
Once DataMiner software is operating again, open system center, go to the agents page and remove the old ip address from the list of agents in the cluster, after which you should be good to go.
Failover DMA in a DMS:
Stop the DataMiner software on both agents in the failover pair and modify the ip address on Windows OS level on the one which you modify the IP address.
Go into the "C:\Skyline DataMiner" folder and open the db.xml file --> see if you can locate the old ip address in this file and if so, replace it with the newly configured one. If changes were applied to the db.xml file, save them.
Go into the "C:\Skyline DataMiner" folder and open the dms.xml file --> see if you can locate the old ip address in this file and if so, replace it with the newly configured one. If changes were applied to the dbs.xml file, save them.
Go into the "C:\Skyline DataMiner" folder of the other agent of the failover pair and open the dms.xml file --> see if you can locate the old ip address in this file and if so, replace it with the newly configured one. If changes were applied to the dms.xml file, save them.
Move back to the DMA of which you modified the IP address and start the DataMiner SW. Once this one has fully restarted, access the failover counterpart and start DataMiner SW again on this one. It should then start into offline mode again.
On the online agent, open system center, go to the agents page and remove the old ip address from the list of agents in the cluster.
Finally, open the failover configuration status window on the online DMA of the failover pair and validate if the failover status is indicating a correct and healthy status.
I think that the above should do the trick but would love to see you validate it and confirming back in this thread if anything would be missing in this procedure or not.
Hope this helps.
I had some Cassandra issues during the process. After having a look, I spotted some references to the old IP address in the cassandra.yaml file.
Given this, I would add the step (after checking the db.xml and dms.xml):
(if you are hosting a Cassandra node in the same server) Go to the file “C:Program FilesCassandraconfcassandra.yaml“ and replace the references to the old IP address by the new IP address. Save the file and restart Cassandra service.
Perfect Bruno, The same would apply for when you would also be hosting an elasticnode on the same server. –> In that case you would also have to search for any references in the yaml file for the old IP and replace that one with the new IP, save and restart the elasticsearch service.
The path to the Cassandra YAML file would be:
“C:Program FilesCassandraconfcassandra.yaml”
The path to the Elasticsearch YAML file would be:
“C:Program FilesElasticsearchconfigelasticsearch.yml”
For both the procedure would be exactly the same:
Browse to the file location, open the file and search for the old IP –> replace any occurrence of the old IP in this file with the new IP address and save the file upon exiting.
Open the windows task manager and open the Services tab in there. Locate the corresponding service name (elasticsearch-service-x64 or cassandra) and right click –> choose Restart.
This action should be done on the DMA of which you are changing the IP address in both scenario’s (Failover or no Failover) right before you start DataMiner software again.
That should do the trick.
Procedure added to DataMiner Help: https://help.dataminer.services/dataminer/#t=DataMinerUserGuidepart_3DataminerAgentsGeneral_DMA_configuration.htm
Hey Jeroen, I will give it a try. Thanks !