Changing the IP address of a Messaging Gateway system

Products

• Messaging Gateway
• Messaging Gateway for Service Providers

Issue/Introduction

You need to change the IP address assigned to one or more network interfaces on a Messaging Gateway system.

Resolution

Changing the IP address of a Scanner only system

Changing the IP address of a Messaging Gateway system with the "Scanner Only" role is relatively straightforward. Care should be taken to ensure that the IP and network information is correct when making the change as setting improper IP and network information may result in the system being unable to communicate on the network following the change.

1. Go to Administration > Hosts > Configuration 
2. Click on the host to be modified
3. Select the Ethernet tab.
4. Set the new values for IP Address, Netmask, Broadcast, Network, and Default Gateway
5. Click the Save button.

It may take a few minutes to push the new configuration to the scanner and configure the system with the new network information. Following the change

1. Go to Status > Hosts > Software and Services
2. Select the Scanner in the Scanners list

This will cause the Control Center system to connect to the scanner using the new IP address and confirm that the connection to port 41002 can be established and the scanner can communicate with the Control Center using the new network configuration

Changing the IP address of a Control Center system

Changing the Control Center requires some additional steps in addition to those outlined above:

1. Update the trusted IP list on any scanner hosts
2. Update the IP address of the Control Center host
3. Restart the Control Center web application service or the entire system

Updating the Scanner hosts

For each Scanner Only host managed by the Control Center

1. Log into the Scanner host command line as the admin account
2. Update the agent trust list to include the new Control Center IP address
   agent-config --add [new control center ip]

Updating the Control Center IP address

1. Go to Administration > Hosts > Configuration 
2. Click on the Control Center host
3. Select the Ethernet tab.
4. Set the new values for IP Address, Netmask, Broadcast, Network, and Default Gateway
5. Click the Save button.

After a few moments the following message will display: (Perform the instructions noted in this message.)

The Control Center is being assigned a new IP address. This may take several minutes. The process is complete when you can access the Control Center in your browser using the new IP address. After that, log into the command line interface and restart the Control Center by typing service controlcenter restart. If you are already connected via ssh then do not expect the message of the controlcenter restarted since the destination IP is unreachable due to the change of IP configuration. You might ping the old and new IP to see which one is up. Then close ssh client and the browser to log in to the Control Center using the new IP address.

Restarting the the Control Center web application

The Control Center web application service can be restarted from the command line using the service controlcenter restart command. Alternately, the Control Center system can be fully restarted as follows:

1. Go to Administration > Shutdown
2. Select the control center host in the Host pulldown menu
3. Click the Reboot button