The updwashost script

The updwashost script updates a profile if the host name of the server is changed.

Product

The updwashost script is available in WebSphere Application Server.

Authority

To run this script, your user profile must have *ALLOBJ authority.

Syntax

The syntax of the script is:

updwashost -profileName profile [ -newhost new_host ]
  [ -changenode -oldhost old_host ] [ -regenplugin ] [ -verbose ] [ -help ]

Parameters

The parameters of the script are:

• -profileName
  This is a required parameter. The value profile specifies the name of the profile that you want to update. To update the host name for all profiles, specify ALL.

• -newhost
  This is an optional parameter. The value new_host specifies the new host name to use for the profile. The default value is the current host name of the server.

• -changenode
  This is an optional parameter. If you specify this parameter, the script changes the node name in the profile. If you specify this parameter, the -oldhost parameter is required.

  Note: If the profile's node is federated into a deployment manager, it is recommended that you not include this parameter, as it might break references to the node name.

• -oldhost
  This parameter is required if the -changenode parameter is specified, and not valid otherwise. The value specifies the old host name to use when changing the node name for the profile(s). The value specified will be replaced in the node name with the value specified in the -newhost parameter.

• -regenplugin
  This optional parameter will call the GenPluginCfg script after updating the host for the profile(s) to regenerate the HTTP server plugin configuration.

• -verbose
  This optional parameter turns on verbose messages, which can be helpful if you need to debug the script.

• -help
  This optional parameter displays the help message. If you specify this parameter, the script ignores all other parameters.