Prerequisites

The following conditions are a prerequisite for updating the internal HTTP Connector Configuration using ActiveMatrix Administrator CLI:

  • A TIBCO_HOME with ActiveMatrix 3.4.1 installed.
  • An instance of the remote_props.properties file (containing the information for connecting to ActiveMatrix Administrator) from CONFIG_HOME/admin/<enterprise-name>/samples, must be copied to TIBCO_HOME/administrator/<version>/samples.
  • Apache Ant 1.9.9 or higher. You can use Ant available as part of the TIBCO ActiveMatrix installation located in TIBCO_HOME/amx/<version>/bin/ant/.
  • The machine from where the internal HTTP Connector Configuration update will be executed needs network access to the ActiveMatrix Administrator on which the internal HTTP Connector Configuration update is being run.
  • If a Load Balancer is in use while accessing the web interface (UI) of ActiveMatrix Administrator, the Load Balancer URL must be used in the remote_props.properties file for accurate results.
  • If ActiveMatrix Administrator is secured via SSL, specify trust store information in the remote_props.properties file. For example:
    # Admin trust store setting for SSL, variable is not allowed
    javax.net.ssl.trustStore=C:/tibco341/tibco/data/admin/amxadmin01/samples/adminCliTruststore.jks
    javax.net.ssl.trustStoreType=jks
    javax.net.ssl.trustStorePassword=#!feiKaElawZazJ+xNFJeyd/67OD8P6feU
  • The user specified in the remote_props.properties file must be a super user in ActiveMatrix Administrator.
Important: It is critical that there be no on-going, active deployments in the ActiveMatrix enterprise when the internal HTTP Connector Configuration update is in progress.

During the internal HTTP Connector Configuration update, nodes or applications are not restarted. Therefore, the update does not cause any business outage.

In a large scale setup, the internal HTTP Connector Configuration update takes a considerable amount of time. It is recommended that the update be launched accordingly, for example, on a weekend.