Sys Maintenance: Change IP Address or Hostname of a Host

Document created by RSA Information Design and Development on Nov 23, 2016•Last modified by RSA Information Design and Development on Aug 2, 2017
Version 10Show Document
  • Comment • 0
  • View in full screen mode
  

Introduction

You use the changePuppetMaster.py Python script to change the IP Address or host name of the Security Analytics server host, or the IP address of any other host in your Security Analytics deployment. You run this script from the command line on the Security Analytics server host system.

Prerequisites

You need to apply the latest 10.6 update package before you can run the changePuppetMaster.py script. Verify that the following files exist on the Security Analytics Server Host before you attempt to run the changePuppetMaster.py script. 

  • /etc/init.d/sa_addrd
  • /etc/rc.d/rc.local

Syntax

The following table describes the changePuppetMaster.py Python script options.

                     
OptionsDescription
-h or --help

Displays the following help message and exits.

-a ADDRESS, --address=ADDRESS
Enter the [non-]SA node's [current IP address and] new IP address

-n NAME, --name=NAME  Enter the [non-]SA node's [current hostname and] new hostname

[root@someSAserver sysSetRPC]# 

-a or --address  

If you want to change the IP address for:

  • Security Analytics server host, specify a single IP address that replaces the existing Security Analytics server host IP address with this option.  For example: -a ip-address
  • Any host other than the Security Analytics server host, specify two IP addresses with this option.  The first address identifies the current address and the second address identifies the replacement address.  For example: -a ip-address ip-address

-n or --name    

If you want to change the host name for the Security Analytics server host system, specify a single host name that replaces the existing Security Analytics server host host name with this option.  For example: -n hostname

Procedure

Complete the following procedure to change the IP address or host name of a host.

  1. SSH to the Security Analytics server host system.

  2. Go to the /etc/puppet/scripts/sysSetRPC directory.
    cd /etc/puppet/scripts/sysSetRPC

  3. Specify one of the following command strings to change the Security Analytics server host name or IP address, or the IP address of a non- Security Analytics server host system.

Note: You must enter a case-sensitive hostname (for current-hostname and newhostname) that matches the corresponding database record. See the case-sensitive hostname displayed in the Hosts view for the case-sensitive current-hostname. 

  • To change the Security Analytics Server Host host name:
    python changePuppetMaster.py -n newhostname

  • To change the Security Analytics server host IP address:
    python changePuppetMaster.py -a new-ip-address

    Note: Before you attempt to change the IP address of a Security Analytics server host, ensure that all the other hosts are available by checking Administration > Hosts. If any host system is not available, the Security Analytics server system's IP address will not be updated in the configurations of the hosts that are unavailable.

  • To change any other host IP address:
    python changePuppetMaster.py -a current-ip-address new-ip-address

You are here
Table of Contents > Change IP Address or Hostname of a Host

Attachments

    Outcomes