Work with host alias properties

Use virtual host properties files to create or change host alias properties.

Determine the changes to make to the host alias configuration.

From the server profile bin directory, run wsadmin -lang jython

Use a virtual host properties file, we can create, modify, or delete a host alias. Run administrative commands using wsadmin to configure or delete a host alias.

Action	Procedure
create	Set properties and then run the applyConfigProperties command.
modify	Edit the properties and then run the applyConfigProperties command.
delete	Specify the host aliases to delete in the Properties section and then run the deleteConfigProperties command.

Optionally, we can use interactive mode with the commands:

AdminTask.command_name('-interactive')

• Create a host alias.

  1. Edit a VirtualHost properties file so that it specifies a host alias property.

     Open an editor on a virtual host properties file. We can copy an example properties file in this step into an editor and modify the properties as needed for the situation.

     The following example defines a host alias inside a virtual host named default_host at the cell scope with host name newHost and port 5555:

     #
     # Header
     #
     ResourceType=VirtualHost
     ImplementingResourceType=VirtualHost
     ResourceId=Cell=!{cellName}:VirtualHost=default_host
     AttributeInfo=aliases(port,hostname)
     #
      #  #Properties
     #
     5555=newHost
      EnvironmentVariablesSection
     #
     #
     #Environment Variables
     cellName=WASCell06

  2. Run the applyConfigProperties command to create a host alias.

     Running the applyConfigProperties command applies the properties file to the configuration. In this Jython example, the optional -reportFileName parameter produces a report named report.txt:

     AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt'])

• Modify an existing host alias.

  1. Obtain a virtual host properties file that defines the host alias to change.

     We can extract a properties file for a VirtualHost object using the extractConfigProperties command.

  2. Open the properties file in an editor and change the host alias properties as needed.

     Ensure that the environment variables in the properties file match the system.

  3. Run the applyConfigProperties command to change a host alias.

• Delete an existing host alias.

  If we no longer need one or more host aliases, list the host aliases we want removed in the Properties section of the virtual host properties file and then run the deleteConfigProperties command:

  AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')

Results

Use the properties file to configure and manage the host alias.

What to do next

Save the changes to the configuration.

Related tasks

Extracting properties files

Create server, cluster, application, or authorization group objects using properties files and wsadmin scripting

Delete server, cluster, application, or authorization group objects using properties files

PropertiesBasedConfiguration (AdminTask)