When a Netscape Application Server machine address changes, such as when the machine is moved, you must update the registry of that machine with the new address. If the machine participates in data synchronization, you must also update the registry of the other machines in the same cluster. Rather than locate every instance of the IP address in the registry and change each instance manually, you can run a single command on a machine that updates its entire registry with the new IP address.
UNIX users only
The following two items apply to UNIX users:
Changing the IP address
At the prompt, run the following command:
ipadmin <old address> <new address>
Where <old address> represents the IP address being changed, and <new
address> represents the new IP address.
For example, the following command replaces every instance in the registry of the IP address 193.168.100.10 with the new address of 214.29.186.211:
ipadmin 193.168.100.10 214.29.186.211
Obtaining a list of IP address instances and port numbers
At the prompt, run the following command to obtain a list of every instance in the registry of the current IP address and the corresponding port number:
ipadmin -list
Changing the IP address and obtaining a list of all changes to the registry
At the prompt, run the following command to change the IP address and obtain a list, after the command runs, of all address instances that were changed:
ipadmin -verbose <old address> <new address>
For example, the following command replaces every instance in the registry of the IP address 193.168.100.10 with the new address of 214.29.186.211 and produces a list of all instances where the address was changed:
ipadmin -verbose 193.168.100.10 214.29.186.211
Note: After you run the ipadmin command to change IP address references in the registry, you must restart the machine to apply the changes.
UNIX users only
Changing the IP address in a user-specified file and creating a temporary registry file
At the prompt, run the following command to read the file named oldreg.dat, replace all instances of the current IP address with the new address, and output the new version of the file to reg.dat.temp:
ipadmin -verbose -input oldreg.dat <old address> <new address>
Where <old address> represents the IP address being changed, and <new
address> represents the new IP address.
For example, the following command reads through the file called oldreg.dat and replaces every instance of the IP address 193.168.100.10 with the new address of 214.29.186.211, and creates a new copy of the file called reg.dat.temp:
ipadmin -verbose -input oldreg.dat 193.168.100.10 214.29.186.211
You can then rename or copy reg.dat.temp to reg.dat.
UNIX users only
Changing the IP address in reg.dat and outputting to a user-named file
At the prompt, run the following command to read the registry file, reg.dat, replace all instances of the current IP address with the new address, and output to a file named newreg.dat:
ipadmin -output newreg.dat <old address> <new address>
Where <old address> represents the IP address being changed, and <new
address> represents the new IP address.
For example, the following command reads through the registry file, reg.dat, replaces every instance of the IP address 193.168.100.10 with the new address of 214.29.186.211, and creates a new copy of the file called newreg.dat.
ipadmin -output newreg.dat 193.168.100.10 214.29.186.211
Then rename or copy newreg.dat to reg.dat.
Note that whether you specify an output file or not, you must rename the output file (either reg.dat.temp or your own user-defined name) to reg.dat.
|