Introduction
This document describes a set of instructions on how to change Cerberus IP address in On-Prem Server.
Prerequisites
Requirements
There are no specific requirements for this document.
Components Used
The information in this document is based on these software and hardware versions:
- Platform: Keyboard/Video/Mouse (KVM), Open Virtual Appliance (OVA), ISO-based deployment
- Software: Smart Software Manager On-Prem Release 7 Release
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.
Background Information
Cerberus runs on the host and exposes an API to the backend container to provide host-functionality. Docker containers do not have access to the host network information out of the box, so to make this communication work, several pieces are implemented by hardcoding 10.x.x.x address.
SSM On-Prem 7.x Cerberus Network IP Modification
Step 1. Change IP alias added to the loopback (lo) interface on the host.
# ip addr show lo
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet 10.x.x.x/32 scope global lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
# cat /sbin/ifup-local
#!/bin/sh
if [[ "$1" == "lo" ]]
then
ip addr add 10.x.x.x dev lo
fi
Edit this script and change references of 10.x.x.x to 11.x.x.x, and restart the network service.
systemctl restart network
Step 2. Cerberus service only listens to 10.x.x.x. Inspect Cerberus configuration and validate IP address configured.
# cerberus config:get BIND
10.x.x.x
Change the Cerberus IP configuration and restart the Cerberus service.
cerberus config:set BIND=11.x.x.x
cerberus restart
Step 3. References for 10.x.x.x in docker-compose-up.yml.
docker-compose-up.yml file passes the Cerberus IP address to respective containers so they can communicate with the host.
Edit the docker-compose-up.yml file with newly modified Cerberus IP address.
backend:
extra_hosts:
- "dockerhost:11.x.x.x"
environment:
- CERBERUS_URL=http://11.x.x.x:6000
Step 4. Restart satellite service.
systemctl restart satellite
Post all services are online, verify User Interface (UI) access to Smart Software Manager On-Prem 7.x.
Change the IP address to network interface ens192 of Smart Software Manager On-Prem 7.x now.
Note: This procedure is not recommended if Smart Software Manager On-Prem Release 7 deploys as High Availability (HA) pair since SSH_HOST_TUNNEL is established with the Cerberus old IP address.