Valid for versions 82 through the latest version
Last modified: January 25, 2021
Overview
Use this script to update a domains IP address in the zone file. It will update the domains source IP address with the destination servers IP address.
This script is useful for cPanel account transfers. When you transfer an account to a new server, you must update the accounts DNS records to match. You should also use this script if you did not select the Express Transfer option in WHMs Transfer Tool interface (WHM » Home » Transfers » Transfer Tool).
Run the script
To run this script on the command line, use the following format:
/usr/local/cpanel/bin/swapip [sourceip] [destip] [ftpip] [domains]
Options
Use the following options with this script:
Options | Description | Example |
---|---|---|
sourceip |
Required. The source IP address. This is the original IP address that you want to change a DNS record from. |
10.0.0.0 |
destip |
Required. The destination IP address. This is the IP address that you want to update a DNS record to. |
172.16.0.0 |
ftpip |
Required. The destination servers FTP IP address. |
172.16.0.0 |
domains |
Required. The associated domain name. For multiple domains, separate each with a comma. Important:
You must pass this option last.
|
example.com |
The --help
option will not provide help documentation. Instead, the script will return an error message.
Example
The following example changes the IP address (A record) in the DNS zone file for the example.com
domain. It uses the 10.0.0.0
IPv4 address to point HTTP and FTP requests to the 172.16.0.0
IPv4 address:
/usr/local/cpanel/bin/swapip 10.0.0.0 172.16.0.0 172.16.0.0 example.com
If the script succeeds, the output will look like the following:
The system updated entry.
If the script fails, it returns an error message that looks like the following:
|
|
The error message may not return an accurate assessment of the error that occurs.