Pivotal Knowledge Base


How to Change the IP Address of the Greenplum Server


  • Pivotal Greenplum (GPDB)
  • Operating System- Red Hat Enterprise Linux 6.x


This article describes how to change the IP Address of a Greenplum Server.


Most Greenplum installations use the /etc/hosts file on all the hosts to manage the DNS resolution. If you are updating the IP address of the public or private network, follow this process:

  1. Stop the Greenplum Server ( gpstop )
  2. Update the host files on the Master ( /etc/hosts )
  3. Distribute the new file to all the segments ( gpscp -f <gpssh hostfile> /etc/hosts =: /etc )
  4. Update Host IP addresses
  5. Restart Greenplum ( gpstart )


  • The gpscp command uses a hosts file (hostnames only) to distribute file(s) to all hosts listed.
  • To avoid complications, it is recommended that you distribute a new host file with the new IP addresses included before making the change. Then, if desired, you can redistribute removing the old IP address.
  • Then, follow the OS Vendor documentation to update the IP addresses of the interfaces on the hosts, using your preferred method (Command line, Configuration Files stored in /etc/sysconfig/network-scripts/, ...).

Additional Information

If you are using a DCA (Dell | EMC Computing Appliance), there are administrative scripts in the DCA Setup Utility to manage these tasks.


Powered by Zendesk