9.4 Changing the IP address and host name

If the configuration of a network is changed (for example, for regular maintenance), you can change the IP address or the host name of a computer on which Application Server is installed. To change the IP address or host name, stop Application Server that is running in advance. If you change the IP address or host name of the domain administration server (DAS), you also need to stop the DAS. After that, change the IP address and host name of the target host by following the operating system (OS) procedure. In addition, update the node configuration information by using the update-node-config and update-node-dcom subcommands of the asadmin utility command.

Prerequisites

Application Server is running.
The domain administration server (DAS) is running.

Intended users

System engineers

Procedure

To stop all performance tracers, server instances, and web servers at the same time, execute the stop-servers subcommand of the asadmin utility command.
```
asadmin stop-servers
```
When this command is run, the result is displayed as follows:
```
Command stop-servers executed successfully.
```
To display a list of performance tracers, run the list-prfs subcommand of the asadmin utility command.
```
asadmin list-prfs
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the performance tracers are not running.
```
performance_tracer_name not running
Command list-prfs executed successfully.
```
To display a list of server instances, run the list-instances subcommand of the asadmin utility command with the --long option specified.
```
asadmin list-instances --long=true
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the server instances are not running.
```
server_instance_name host_name port_number process_ID cluster_name not running
Command list-instances executed successfully.
```
- cluster_name is displayed only for cluster configurations that contain multiple Java EE servers.
To display a list of web servers, run the list-webservers subcommand of the asadmin utility command.
```
asadmin list-webservers
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the web servers are not running.
```
web_server_name not running
Command list-webservers executed successfully.
```
If you change the IP address or the host name of the DAS, do the following:

Go to step 6 when you change the IP address or host name of the remote host.
1. To stop the DAS, run the stop-domain subcommand of the asadmin utility command.
```
asadmin stop-domain
```
  When this command is run, the result is displayed as follows:
```
Command stop-domain executed successfully.
```
2. Change the IP address or host name of the DAS host by following the operating system (OS) procedure.
  
  Restart the computer, if required.
3. To start the DAS, run the start-domain subcommand of the asadmin utility command.
```
asadmin start-domain
```
  When this command is run, the result is displayed as follows:
```
Command start-domain executed successfully.
```
4. To display a list of nodes, run the list-nodes subcommand of the asadmin utility command.
```
asadmin list-nodes
```
  When this command is run, the result is displayed as follows:
```
node_name CONFIG IP_address_or_host name
node_name DCOM IP_address_or_host name
Command list-nodes executed successfully.
```
5. If the node and the DAS are on the same host, run the update-node-config subcommand of the asadmin utility command to update the node configuration information.
  
  This operation is not required if a node, such as the default node (localhost-domain1), is registered in the localhost, because the host name can be resolved in the localhost.
```
asadmin update-node-config --nodehost changed_IP_address_or_host_name node_name
```
  When this command is run, the result is displayed as follows:
```
Command update-node-config executed successfully.
```
6. If the node is on the remote host (if a node whose type is DCOM is shown in the list of nodes that was checked in sub-step d), configure the settings for the remote host to resolve the host name of the DAS (localhost).
  
  Edit the hosts file on the remote host.
7. If a node is configured on the remote host, edit the das.properties configuration file in the remote host.
  
  Specify the new IP address or host name for the parameter (agent.das.host) in the configuration file (das.properties). The configuration file (das.properties) is stored in the following location: installation_directory_for_Java_EE_Server/glassfish/nodes/node_name/agent/config/das.properties.
If you change the IP address or host name of a remote host, do the following:
1. Change the IP address or host name of the remote host by following the operating system (OS) procedure.
  
  Restart the computer, if required.
2. To display a list of nodes, run the list-nodes subcommand of the asadmin utility command.
```
asadmin list-nodes
```
  When this command is run, the result is displayed as follows:
```
node_name CONFIG IP_address_or_host name
node_name DCOM IP_address_or_host name
Command list-nodes executed successfully.
```
3. To update the node configuration information, run the update-node-dcom subcommand of the asadmin utility command for the remote host node (nodes whose type shown in the list of nodes that was checked in step b is DCOM ).
```
asadmin --user user_name_for_domain_administration_server --passwordfile password_file_path 
update-node-dcom --windowsuser user_name_for_remote_host 
--nodehost changed_IP_address_or_host_name 
--windowsdomain domain_name_to_which_the_user_specified_for_the_remote_host_belongs node_name
```
  When this command is run, the result is displayed as follows:
```
Command update-node-dcom executed successfully.
```
To start Application Server at once, run the start-servers subcommand of the asadmin utility command.
```
asadmin start-servers
```
When this command is run, the result is displayed as follows:
```
Command start-servers executed successfully.
```
To display a list of performance tracers, run the list-prfs subcommand of the asadmin utility command.
```
asadmin list-prfs
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the performance tracers are running.
```
performance_tracer_name running
Command list-prfs executed successfully.
```
To display a list of server instances, run the list-instances subcommand of the asadmin utility command with the --long option specified.
```
asadmin list-instances --long=true
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the server instances are running.
```
server_instance_name host_name port_number process_ID cluster_name running
Command list-instances executed successfully.
```
- cluster_name is displayed only for cluster configurations that contain multiple Java EE servers.
To display a list of web servers, run the list-webservers subcommand of the asadmin utility command.
```
asadmin list-webservers
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the web servers are running.
```
web_server_name   running
Command list-webservers executed successfully.
```

To Page Top