How to change the IP address of Aria Operations for Logs

Products

• VMware Aria Suite

Issue/Introduction

This article provides steps on how to change the IP address of Aria Operations for Logs (formerly vRealize Log Insight) 8.10 and higher.

 

Environment

VMware vRealize Log Insight 8.x
VMware vRealize Log Insight 8.1.x
VMware vRealize Log Insight 8.8.x
VMware vRealize Log Insight 8.10.x
VMware vRealize Log Insight 8.4.x
VMware vRealize Log Insight 8.3.x
VMware vRealize Log Insight 8.2.x
VMware vRealize Log Insight 8.6.x
VMware vRealize Log Insight 8.5.x

Resolution

Please note there are different steps depending on the version you are running:

Aria Operations for Logs (formerly vRealize Log Insight) versions up until 8.12
Aria Operations for Logs (formerly vRealize Log Insight) versions 8.14+

Aria Operations for Logs (formerly vRealize Log Insight) versions up until 8.12:

Important: Before applying the Resolution steps below, ensure that you update the IP address of the appliance if one has been specified in the vSphere Client under the vRealize Log Insight VM's Configure > Settings > vApp Options > Properties page. Please note the vApp options cannot be edited while the node is powered on.

Update the VM vApp configuration

1. In the vSphere Web Client, select the VMware Aria Operations for Logs VM and navigate to Actions > Power > Shut Down Guest OS to shut down the guest OS gracefully
2. Go to the Configure tab and choose vApp Options from Settings drop down
3. Under Properties, select the key starting with vami.ip0 that describes Network 1 IP Address
4. Click SET VALUE, enter the new IP address and click OK.
5. Power on the VM from  Actions > Power > Power On

Change the IP address of the node

1. SSH to the vRealize Log Insight nodes as root
2. Stop the Log Insight service

service loginsight stop

3. Using a text editor, open the network configuration file located at /etc/systemd/network/10-eth0.network
4. Replace the old IP with the desired address
5. Save and exit the file
6. Restart the network service

systemctl restart systemd-networkd

7. SSH to the vRealize Log Insight node, using the new IP address
8. Ensure the Log Insight service is not running

service loginsight status

Note: If the status output returned indicates that the service is running, stop it with service loginsight stop 

9. Copy the latest loginsight-config.xml# file (with the highest index number value) located in /storage/core/loginsight/config/, and increment the index number

Example:  cp /storage/core/loginsight/config/loginsight-config.xml#11 /storage/core/loginsight/config/loginsight-config.xml#12

10. Using a text editor, open the newly created xml file
11. Update the IP address accordingly
12. Save and exit the file
13. Restart the VM from the vSphere Web Client to update the vCenter value with the new IP

 

Aria Operations for Logs (formerly vRealize Log Insight) version 8.14+:

Change the IP address of the node

1. SSH to the Aria Operations for Logs node you wish to change the IP of, as root
2. Stop the Log Insight service

 

systemctl stop loginsight

3. List the contents of the config directory.  In the output, note the file with the highest index number value at the end of its name

ls /storage/core/loginsight/config/

4. Copy the latest loginsight-config.xml# file (with the highest index number value) and increment the index number in the new file

Example: cp /storage/core/loginsight/config/loginsight-config.xml#11 /storage/core/loginsight/config/loginsight-config.xml#12

Note: Replace loginsight-config.xml#11 in the above command with the filename of the highest index number you observed in step 3, and replace loginsight-config.xml#12 in the above command with the incremented index number (+1) of the number observed in step 3.

5. Using a text editor, open the newly created xml file with the incremented index number, and update the IP address accordingly
6. Save and exit the file
7. Using a text editor, open the network configuration file located at /etc/systemd/network/10-eth0.network
8. Replace the old IP address with the new one
9. Save and exit the file

Update the VM configuration

1. In the vSphere Web Client, select the VMware Aria Operations for Logs VM and navigate to Actions > Power > Shut Down Guest OS to shut down the guest OS gracefully
2. Go to the Configure tab and choose vApp Options from Settings drop down
3. Under Properties, select the key starting with vami.ip0 that describes Network 1 IP Address
4. Click SET VALUE, enter the new IP address and click OK.
5. Power on the VM from  Actions > Power > Power On

Update and verify on other nodes

1. SSH to the next node in the Aria Operations for Logs cluster as root
2. Stop the Log Insight service:

systemctl stop loginsight

3. Copy the new loginsight-config.xml# file (with the incremented index number) from the node with the changed IP address to /storage/core/loginsight/config directory on the current node

 Example: scp root@nodeWithNewIP:/storage/core/loginsight/config/loginsight-config.xml#latest_number /storage/core/loginsight/config/

Note: Replace nodeWithNewIP in the above command with the IP address of the node which you have changed earlier in this article

4. Start the Log Insight service

systemctl start loginsight

5. Verify that the latest loginsight-config.xml# file contains the updated hosts

grep "daemon host=" "$(ls -1v /storage/core/loginsight/config/loginsight-config.xml* | tail -n 1)"

6. restart Log Insight service on all remaining nodes one at a time to update Cassandra seeds:

systemctl restart loginsight

7. Verify that the seeds are updated with the correct IPs:

grep "seeds" /storage/core/loginsight/cidata/cassandra/config/cassandra.yaml

8. Repeat steps 5-7 on all nodes in the Aria Operations for Logs cluster.

Additional Information

Impact/Risks:
It is advised to take snapshots of all nodes prior to running through this process. Please remember to remove the snapshots promptly after the change is confirmed to be successful.