Contents

Introduction

Prerequisites

Requirements

Components Used

Background Information

SSM On-Prem 7.x Cerberus Network IP Modification

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.