Knowledgebase

Linux & Unix Servers - How to change the primary IP address of a WHM/cPanel Server

This is for CentOS/RHEL based servers.

Steps in WHM:

• Log into WHM and go to Basic cPanel & WHM Setup
• Change the Primary IP here with the option that says "The IP address (only one address) that will be used for setting up shared IP virtual hosts"
• Note: This might not actually be necessary.

Log in to SSH, and do the following:

1. Edit /etc/sysconfig/network-scripts/ifcfg-eth0
• Change the IPADDR and GATEWAY lines to match the new IP and Gateway for the new ip
2. Edit /etc/sysconfig/network
• Change the GATEWAY line here if it does not exist in the ifcfg-* file.
3. Edit /etc/ips
• Remove the new primary IP from this file if it is present
• Add the old primary IP to this file with the format ::
4. Edit /var/cpanel/mainip
• Replace the old primary IP with the new primary IP
5. Edit /etc/hosts
• Replace the old primary IP with the new one if needed. The hostname's dns will need to be updated too
6. Restart the network service to make the new IP the primary
• service network restart
• Note: You're probably going to be disconnected at this point, and have to log in to ssh using the new primary ip.
7. Restart the ipaliases script to bring up the additional IPs
• service ipaliases restart
8. Run ifconfig and make sure all IPs show up correctly
9. Update the cpanel license to the new primary IP
10. Verify you can still log in to WHM and there is no license warning
• http://verify.cpanel.net/index.cgi