Changing the default Harvest communication port number

Products

• CA Harvest Software Change Manager - OpenMake Meister
• CA Harvest Software Change Manager

Issue/Introduction

The steps below describe how this can be accomplished.

Environment

Harvest Software Change Manager all versions and platforms

Resolution

To accomplish this, all components (rtserver, broker and hservers, and all clients) must be configured to use the new port number.

Note: Before making the changes below, Harvest broker, Harvest servers, Harvest client and RTserver must all be stopped.

RTserver Setup

The RTserver startup command file (rtserver.cm) must specify the Conn_Names option with the logical connection names value. The Conn_Names option specifies a list of logical connection names used by RTclient (the Harvest client) to find this RTserver. Each logical connection name has the form protocal:node:address.

Note: The RTserver startup command file, rtserver.cm, is found in the "<pec installation>/standard" directory. 

Port number 5101 (default) represents the address portion of protocol:node:address.  To specify a different port, define the Conn_Names option in the rtserver.cm file.  For example, add this to the end of the rtserver.cm file:

setopt conn_names tcp:harvest:5202

where the "harvest" is the machine node name, and 5202 is the desired new port number. The RTserver must be restarted for the changes to take effect.

Harvest Server and Clients Setup

The Harvest client, broker and server need to specify the new network port number using the "-rtserver=" option in the following argument files: HBroker.arg, HServer.arg and HClient.arg. The argument files are located in the %CA_SCM_HOME% directory ($CA_SCM_HOME on Linux and Unix).

Note: The argument file, HClient.arg, is not created by the Harvest installation and must be created manually in the %CA_SCM_HOME% directory. Other than specifying non-default port numbers, the HClient.arg file is not necessary.

Add the -rtserver option to the HBroker.arg, HServer.arg and HClient.arg files using the following syntax:

-rtserver=tcp:node:address 

For example:

-rtserver=tcp:harvest:5202 

The Rtserver, Harvest broker and all client must be restarted for the changes to take effect.

 

Additional Information

More information about this configuration option and others can be found here: Configure Enterprise Communicator (PEC)