This manual page is for Mac OS X Server version 10.6.3

Reading manual pages

changeip(8)                              BSD System Manager's Manual                             changeip(8)

NAME
     changeip -- Change service configuration files with hard-coded IP addresses

SYNOPSIS
     changeip [-v] [-d path] old-ip new-ip [old-hostname new-hostname]

     changeip -checkhostname

     changeip -h

DESCRIPTION
     changeip is used to manually update configuration records when a server's IP address or hostname
     changed in a way that affected services were unable to properly process, for example when the server is
     behind a NAT device and the WAN identity changed.

     In typical usage, this command is used by an administrator to correct affected services when a server's
     network information changes.  changeip can be invoked before the change is applied; in such an invoca-tion, invocation,
     tion, the arguments consist of the server's current and pending IP addresses, and optionally the exist-ing existing
     ing and new host name.  Their usage and valid values include:
     old-ip        If the IP address has not yet been changed, this is the existing IP address of the
                   server. If the IP has already been changed, this is the previous address. (This is the
                   value that will be replaced in the server's relevant configuration files.)
     new-ip        If the IP address has not yet been changed, this is the IP address that will be assigned
                   to the server. If the IP has already been changed, this is the existing IP address. This
                   value will replace old-ip in the machine's configuration.
     old-hostname  As with old-ip, the existing or previous fully qualified domain name ("FQDN" or sometimes
                   "DNS name") for this server. If only the IP address was affected, this argument and the
                   next may be omitted.
     new-hostname  If old-hostname was provided, this argument must also be provided. The machine's fully
                   qualified domain name and related service configuration will be set to this value.

     Once the tool has successfully completed, the administrator must change the machine's network settings
     in the Network Control Panel to match new-ip (if new-ip is not the current IP) and immediately reboot
     the server.

     The second invocation, -checkhostname, provides a diagnostic tool that compares the current IP address
     and hostname to the information returned by DNS.

     The final invocation prints usage information.

     changeip must be run as root.

OPTIONS
     The following options are available:
     -d path      Iterate over the executables in path instead of the default /usr/libexec/changeip.

     -h           Print usage summary and exit.

     -v           Run verbosely, that is with additional diagnostic output.

FILES & FOLDERS
     /usr/sbin/changeip
           -   daemon
     /usr/libexec/changeip/
           -   directory containing service-specific tools

EXAMPLES
     This would be a typical invocation for a server redeployment:
           changeip 192.0.0.12 192.0.1.10 old.example.com new.example.com

     It is also possible to leave the host name intact and only change the IP address:
           changeip 192.0.0.12 192.0.1.10

     Its complement could be used to change only the host names, perhaps because the DNS tables have been
     changed:
           changeip 192.0.0.12 192.0.0.12 old.example.com new.example.com
     Note how the IP addresses are required, but that they are identical.

DIAGNOSTICS
     The changeip utility exits 0 on success, and >0 if an error occurs.

     changeip must be run as root.  Because changeip modifies system-wide resources, it must be executed by
     the root user.

     Invalid IP Address:  One of the IP address arguments was invalid.

SEE ALSO
     dscl(1), DirectoryServiceAttributes(7), DirectoryService(8), scutil(8)

KNOWN ISSUES
     The script does not perform the actual change of IP address; this is by design.

HISTORY
     A version of changeip has been present in Mac OS X Server since at least version 10.3 (Panther).

     In 10.6 (Snow Leopard), changeip no longer manipulates the directory and therefore no longer takes a
     directory URL as an argument.

Mac OS X Server 10.6                         September 17, 2008                         Mac OS X Server 10.6