Updating ports in an existing profile

Use the updatePorts.ant script to change ports in an installed profile.

Before you begin

Each profile template has its own updatePorts.ant script.

The updatePorts.ant script for application server profiles is in the app_server_root/profileTemplates/template_name/actions directory. To use the script, you have to identify which profile to update.

Avoid trouble Avoid trouble: You should only run this script if the profile is unfederated and if the configuration is the same structure as it was when the profile was created. For example, this script is ideal for changing ports for an unfederated application server profile after you created the profile but before you altered its configuration. For all other situations, use the techniques described in "Setting port numbers kept in the serverindex.xml file using scripting".gotcha

About this task

Use the following procedure to become familiar with using the updatePorts.ant script. Each step is an exercise that results in reassigning ports using a particular method that the updatePorts.ant script supports.

Look at steps for all of the operating systems mentioned. The differences are mainly in the extension of the script file and the direction of the directory delimiters. For example, Linux shell scripts (*.sh) and other commands require a ./ before the command to tell the operating system that the command is in the current working directory.

Procedure

Results

This procedure results in four different methods of port assignments with the updatePorts.ant script.

What to do next

You can change port values in a variety of ways. The install command and the silent installation response file also support setting port values in the same manner as described in this article. In fact, the two installation methods use the same options:
  • -OPT PROF_defaultPorts=

    No value is required. The equal sign is a standardization misnomer.

  • -OPT PROF_startingPort="nnnn"
  • -OPT PROF_portsFile="path_to_portsdef.props file"
  • If you omit one of the preceding arguments when calling the install command or leave one of the preceding arguments out of your silent response file, the default action is to assign nonconflicting port values.

The use of the exact same options for a graphical user interface installation and a silent installation is no coincidence. Most WebSphere® Application Server component installation programs are implementations of the Common Install Engine for WebSphere Application Server. The use of the exact same actions for the ANT script is also because of the same pervading design theme, which is to simplify your installation experience.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 4:28:44 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-mp&topic=tins_updatePorts
File name: tins_updatePorts.html