Change Ports Using the Utility

Use the Port Change Utility to alter the configurable external and internal ports used by STA.

Prerequisites

• STA version 2.3.0 or above

• You must be logged in as the Oracle user.

• The STA application and all STA services must be running.

  See Display the Status of the STA Application to verify.

• You must know the Weblogic administrator username and password.

• STA port numbers must be unique and dedicated to the specified STA process. To prevent port conflicts, you should verify that the port numbers you want to use are not already registered or in use by another process on the STA server.

• The Oracle user path must be correctly configured.

  See Configure the Correct Oracle User Path.

Procedures

1. Verify all prerequisites listed above.

2. The utility will stop and restart all STA processes to implement the new ports. Therefore, you should back up the STA database before using the utility.

3. On the STA server, open a terminal session. Log in as the Oracle user.

4. Verify that the STA application is running:

   $ STA status all
   

   It may take a few minutes. Once complete, you should see:
   staui service is running
.... and the deployed application for staui is in an ACTIVE state

   If the application is not running, restart it. See Restart the STA Application.

5. Start the Port Change Utility.

   $ changeSTAPorts.sh
   

6. At the prompts, enter the WebLogic administrator username and password.

   Enter WebLogic Administrator username         : weblogic
   Enter current WebLogic Administrator password :
    
   

7. The utility main menu appears.

   Select port numbers to change
    
     1) WebLogic Administrator console port numbers
     2) STA Engine port numbers
     3) STA Adapter port numbers
     4) STA UI port numbers
     5) SNMP Trap Port Number
     6) Exit
    
   

8. Select an option and follow the prompts to update the ports. See Configurable Ports for default values.

9. Once you confirm the change, the utility automatically restarts the WebLogic server and all STA managed servers, and then stops and restarts all STA processes. Some library transactions may not be recorded during this process.

Port Change Utility Logs

The logs for the Port Change Utility track all updates made by the utility. You can use the logs to help troubleshoot issues with the utility or the ports.

The logs are located in the following directory:

/var/log/tbi/changeutility

The following is a sample directory listing showing the files.

$ ls -l /var/log/tbi/changeutility
-rw-r--r-- 1 oracle oinstall  126 Feb 22 09:44 STAChangeUtility-0.log

There may be up to 10 different log files in the directory, each with a sequential number, 0 to 9. Log "0" is always the active log, and logs "1" through "9" are historical. Log files have a 1.0 MB size limit, and when log "0" reaches the limit, the logs are rotated. Log "0" becomes log "1", log "1" becomes log "2", and so on. Any existing log "9" is overwritten by log "8".