BrokerWorkstation.properties file

If you need to make configuration changes to the broker server after the installation has completed, you can edit the BrokerWorkstation.properties file. The BrokerWorkstation.properties file contains the following configuration properties:
Broker.AuthorizedCNs
The list of prefixes of common names authorized to communicate with the broker server.
Broker.CertificateExpirationInterval
The number of days before the certificate on the agent expires. During this interval, the certificate is set in expiring status and the agent tries to download a new version of the certificate from the master domain manager, if available. Supported values are any integer greater than zero. The default value is 15 days.
Broker.fileproxy.urls
If you defined a stand-alone file proxy using the fileproxyinst command, you can optionally use this property to specify the URL of an alternate stand-alone file proxy for high availability configuration. You can implement one of the following configurations:
  • Specify one or more proxy servers, separated by commas. If one of the file proxies stops unexpectedly, the other file proxy takes over.
  • Specify a load balancer. If one of the file proxies stops unexpectedly, the load balancer switches the workload to one of the available file proxies.
Use the following syntax:
[http/https]://[fileproxy host]:[file proxy port]
This procedure does not apply if you use the default file proxy installed with each master domain manager.

For more information about the File Transfer integration, see File Transfer integration.

For more information about installing the file proxy as a stand-alone component, see File Proxy installation - fileproxyinst script.

Broker.jobLog.corePoolSize
The size of the thread pool that serves core services and job log requests. The maximum supported number of concurrent job log requests corresponds to the value set for Broker.jobLog.corePoolSize minus 5. For example, if Broker.jobLog.corePoolSize is set to 20, the maximum supported number of concurrent job log requests is 15. Issuing a number of concurrent job log requests higher than this value (15 in the example) causes the dynamic domain manager to hang and requires a restart of the application server. The default value, when the property is not specified in the BrokerWorkstation.properties file or empty, is 50.
Broker.Workstation.CpuType
The workstation type assigned to the broker server. Supported values are:
  • master domain manager (master)
  • backup master domain manager (fta)
  • dynamic domain manager (fta, broker, agent)
  • backup dynamic domain manager (fta, broker, agent)
Broker.Workstation.Enable
A switch that enables or disables the broker server. The value can be true or false. The default value is true.

Set this value to false if you decide not to use a broker server. Not using the broker server means that you can submit jobs dynamically on the dynamic workload broker directly (using either the Dynamic Workload Console or the dynamic workload broker command line) without using the scheduling facilities of HCL Workload Automation.

Broker.Workstation.Name
The name of the broker server in the HCL Workload Automation production plan. This name is first assigned at installation time.
Broker.Workstation.PortSSL
The port used by the broker server to listen to the incoming traffic (equivalent to the Netman port) in SSL mode. It is first assigned at installation time. This port number must always be the same for all the broker servers that you define in your HCL Workload Automation network (one with the master domain manager and one with every backup master you install) to ensure consistency when you switch masters. For more information, see Upgrading your dynamic domain manager in SSL mode.
Broker.Workstation.Port
The port used by the broker server to listen to the incoming traffic (equivalent to the Netman port). It is first assigned at installation time. This port number must always be the same for all the broker servers that you define in your HCL Workload Automation network (one with the master domain manager and one with every backup master you install) to ensure consistency when you switch masters.
Broker.Workstation.RetryLink
The number of seconds between consecutive attempts to link to the broker server. The default is 600.
DomainManager.Workstation.Domain
The name of the domain where the broker server is registered.
DomainManager.Workstation.Name
The name of the domain manager workstation.
DomainManager.Workstation.Port
The port of the domain manager workstation.
MasterDomainManager.HostName
The host name of the master domain manager workstation.
MasterDomainManager.HttpsPort
The HTTPS port of the master domain manager workstation.
MasterDomainManager.Name
The name of the master domain manager workstation.
If you need to modify the event processor server, for example to use a load balancer, add the following two keywords in the file:
Broker.Workstation.evtproc.previous_hostname=new_hostname
Specify the previous hostname and the new hostname of the event processor.
Broker.Workstation.evtproc.previous_port=new_port
Specify the previous and new port of the event processor.

After stopping and restarting WebSphere Application Server Liberty Base, the dynamic domain manager sends the updated information to the dynamic agents.