Change Liberator and Transformer port numbers

The Deployment Framework comes with a set of default port numbers for Liberator and Transformer. You can often use these port numbers unchanged on the machines where these components run, onto which the Frameworks will be copied, but if they're not suitable, here's how to update them...

Tip: Consult your system administrator if you don't know what port numbers are available on a particular server machine.

The default Liberator and Transformer port numbers are defined as macros in <Framework-root>/global_config/environment-defaults.conf  For example (this isn't the complete list):

define LIBERATOR${THIS_LEG}_HTTPPORT          ${THIS_LEG}8080
define LIBERATOR${THIS_LEG}_DATASRCPORT       ${THIS_LEG}5001
define LIBERATOR${OTHER_LEG}_DATASRCPORT      ${OTHER_LEG}5001
define TRANSFORMER${THIS_LEG}_DATASRCPORT     ${THIS_LEG}5002
define TRANSFORMER${OTHER_LEG}_DATASRCPORT    ${OTHER_LEG}5002

To change a port number:

  1. Copy the relevant macro definitions to the file <Framework-root>/global_config/environment.conf

    Insert them at the end of the section headed "Add updated configuration after this point"

  2. Change the port number following ${THIS_LEG}, and ${OTHER_LEG} if there is a pair of macros.

    For example:

    define LIBERATOR${THIS_LEG}_DATASRCPORT       ${THIS_LEG}5301
    define LIBERATOR${OTHER_LEG}_DATASRCPORT      ${OTHER_LEG}5301
    

Where macros are defined in pairs for failover purposes, as in the example above, make sure you use the same base port number for each macro of the pair. In the example, when the THIS_LEG and OTHER_LEG macros are evaluated, the DataSource port number used for the main Liberator would be 15301, and the Liberator in the failover leg would use DataSource port number 25301.

(For more about failover legs, see How can I... Set up server failover capability.)

Note: Don't change the port numbers in the defaults file environment-defaults.conf. Always define any changed port numbers in environment.conf

See also: