Internal documentation only

This page has been marked as draft.

Changing IP address for Orchestrator and Database Server

While it’s not a routine operation, there may be times when you need to reconfigure the IP address for the orchestrator or database server.

Process Copied

• Update your files within /opt/opsview/deploy/etc/* that reference your old IP address, ensure you update all entries to use the new IP address.

#grep -i "<OLD IP ADDRESS>" /opt/opsview/deploy/etc/*
grep: /opt/opsview/deploy/etc/examples: Is a directory
/opt/opsview/deploy/etc/opsview_deploy.yml:    ip: <OLD IP ADDRESS>

#vim /opt/opsview/deploy/etc/opsview_deploy.yml

• Update your /etc/hosts files on the servers to reflect the IP change

#vim /etc/hosts

• Remove all entries within /opt/opsview/deploy/var/fact_cache/ or /opt/opsview/deploy/var/cache/facts/ as these will be rebuilt (you may also just remove the database hostname, but either option is OK)
  • eg.

#ll /opt/opsview/deploy/var/cache/facts/
total 112
drwxr-x--- 2 root root  4096 Feb 20 07:17 ./
drwxr-x--- 3 root root  4096 Jun  5  2025 ../
-rw-r--r-- 1 root root 50639 Jan 30 04:10 localhost
-rw-r--r-- 1 root root 50650 Feb 13 02:23 mge103

• Ensure connectivity to that server is OK
  • i.e. you may ssh as the deployment user, which may be not set, so this would be root
    • Test 1: ssh from your orchestrator to your database as root, it should be passwordless and log you straight in - if it doesn’t, setup passwordless ssh access
    • Test 2: run the check_deploy.yml playbook and ensure this shows “PLAYBOOK EXECUTION SUCCESS” output (not failure)

cd /opt/opsview/deploy
./bin/opsview-deploy lib/playbooks/check-deploy.yml

• Finally run you will need to run the deployment playbook(s) to push out this configuration

cd /opt/opsview/deploy
./bin/opsview-deploy lib/playbooks/setup-everything.yml

• If you do not wish to upgrade your Opsview at the same time to a later version if available, ensure the your repository is set against your current version within your /opt/opsview/deploy/etc/user_vars.yml

#vim /opt/opsview/deploy/etc/user_vars.yml

• Add the following line opsview_repository_version:

opsview_repository_version: <opsview version>

Related article(s) Copied

• Opsview - Changing Collector Cluster Hostname or IP – Support - ITRS Group