HCL Workload Automation, Version 9.4

Changing host properties

You use the changeHostProperties script to change the workstation host name in the WebSphere® Application Server configuration files, or the TCP/IP ports used by WebSphere Application Server. To change or disable TCP/IP Ports see Disabling TCP/IP ports.

The procedure for running the script is described in detail in Application server - using the utilities that change the properties, but in summary you do the following:
  • Run showHostProperties.sh (.bat) > my_file_name to obtain the current properties
  • Edit my_file_name
  • Run changeHostProperties.sh (.bat) my_file_name
Note: my_file_name must be the fully qualified path of the file.

The change utility calls the wsadmin utility by running
ChangeHostProperties.jacl with the properties file as input.

Only the WebSphere Application Server serverindex.xml configuration file is affected by this script. The path of the file is:
WAS_profile_path/config/cells/TWSNodeCell/nodes/TWSNode/servers/server1/server.xml
where the default value of <WAS_profile_path> is <TWA_home>/WAS/TWSprofile for the master domain manager, and <JazzSM_profile_dir> for the z/OS® connector and Dynamic Workload Console where, the default value of <JazzSM_profile_dir> is /opt/HCL/JazzSM/profile.
The following is a list of the properties that can be changed with this utility:
################################################################
# Host Configuration Panel
################################################################

# Old Hostname
oldHostname=myoldhost.romelab.ibm.it.com

# New Hostname
newHostname=mynewhost.romelab.ibm.it.com
             
################################################################
Ports Configuration Panel
################################################################
bootPort=41117
bootHost=myhost.mydomain.com
soapPort=41118
soapHost=myhost.mydomain.com
httpPort=41115
httpHost=*
httpsPort=41116
httpsHost=*
adminPort=41123
adminHost=*
adminSecurePort=41124
adminSecureHost=*
sasPort=41119
sasHost=myhost.mydomain.com
csiServerAuthPort=41120
csiServerAuthHost=myhost.mydomain.com
csiMuthualAuthPort=41121
csiMuthualAuthHost=myhost.mydomain.com
orbPort=41122
orbHost=myhost.mydomain.com
All of the properties in the properties file are optional. When you are modifying the properties file you should be aware of the following:
  • When oldHostname and newHostname are provided (these settings must be provided together), the host property related to each port is updated when it has not been provided in the properties file and the current value matches oldHostname.
  • Port settings are updated only if they are provided in the properties file.
  • A port-specific host setting, such as httpHost is not updated if not specified except when its current setting matches oldHostname.
  • An empty setting is considered as not provided.