Sys Maintenance: Change IP Address or Hostname of a Host

Document created by RSA Information Design and Development on May 12, 2016Last modified by RSA Information Design and Development on May 12, 2016
Version 2Show Document
  • View in full screen mode
 
  

Introduction

You use the changePuppetMaster.py Python script to change the IP Address or hostname of the Security Analytics Server Host or any other host in your Security Analytics deployment. You run this script from the command line on the Security Analytics Server Host.

Prerequisites

You need to apply the 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 hostname for:

  • Security Analytics Server Host, specify a single hostname that replaces the existing Security Analytics Server Host hostname with this option.  For example: -n hostname
  • Any host other than the Security Analytics Server Host, specify two hostnames with this option.  The first name identifies the current name and the second name identifies the replacement name.   For example: -n hostname hostname 

Procedure

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

  1. SSH to the Security Analytics Server host.

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

  3. Specify one of the following command strings to change a host IP address or hostname.

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 IP address:
    python changePuppetMaster.py -a new-ip-address

  • To change the Security Analytics Server Host hostname:
    python changePuppetMaster.py -a newhostname

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

  • To change the any other host hostname:
    python changePuppetMaster.py -n current-hostname new-hostname

You are here: Change IP Address or Hostname of a Host

Attachments

    Outcomes