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
DataMiner uses the IP Address assigned to Windows Server.
In case your server has a static IP address you can change it by running the following command:
netsh interface ipv4 set address name="YOUR INTERFACE NAME" static YOUR_NEW_IP YOUR_NEW_SUBNET_MASK YOUR_NEW_GATEWAY
In case your server has a dynamic IP address (assigned by a DHCP server), you can try to release/renew your IP address by running the following commands (in this order):
ipconfig /release ipconfig /renew
If you have multiple network interfaces and would like to configure a different one in DataMiner, you can use the NIC order feature. For more information see DataMiner.NetworkAdapters
This will require a DataMiner restart.
Or you can also just use the UI of Windows to change the IP of your NIC. And indeed of course restart DataMiner after changing the IP address.
Thank you Jens and Bert!
I’ve added a second part of my question that I forgot:
Additionally, what’s required on DataMiner if the Agent is on a Failover pair and if is part of a cluster (DMS)?
Hey Jeroen, I will give it a try. Thanks !