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.