Skip to main content

Reconfiguring Access Control and CxEngine

Environment variables can be reconfigured either by using the Reconfigure command or by entering the Environment Variables section under Windows Properties. Some parameters can be configured either via Silent Reconfigure or via the Environment Variables. In addition, the Environment Variables include parameters that are not related to Reconfigure such as the hostname and the IP address of the relevant host, and database parameters such as TLS.

Once you install ActiveMQ, you have to reconfigure Access Control as mentioned here. In addition, you may reconfigure the CxEngine parameters as mentioned here.

Reconfiguring Access Control

Once you complete installing ActiveMQ, you have to return to the CxManager installation and run Reconfigure to update Access Control.

To reconfigure Access Control:

Run the following command:

CxSetup.exe /install /quiet RECONFIGURE_ACCESS_CONTROL=1 

Access Control parameters can be viewed and edited in the Environment Variables section that is available under Windows Properties.

Reconfiguring CxEngine

After installing the CxEngine, you have to run Reconfigure to set the CxEngine parameters as illustrated and explained below. These parameters are available as Environment Variables for editing from the Windows Properties once they are set.

To reconfigure the CxEngine parameters to the default parameters:

CxSetup.exe /install /quiet RECONFIGURE_ENGINE=1

The default settings can be viewed in the Reconfigure Parameter table below.

To reconfigure selected settings to customized parameters and leave the remaining parameters at their default:

Use the syntax to reconfigure the CxEngine parameters to their default and list the ENGINE parameters with a different setting than the default. The example below illustrates setting the Engine settings to default, but with TLS enabled, which is disabled by default.

CxSetup.exe /install /quiet 


To reconfigure all settings to customized parameters:

Use the syntax and list all ENGINE settings with their parameter settings as illustrated below. For this option, RECONFIGURE_ENGINE must be set to 0 and all ENGINE parameters must be listed.

CxSetup.exe /install /quiet 

ENGINE_SETTINGS_FILE=<path to the JSON file 'engineConfiguration.json'>


  • Errors in the URL such as an illegal port cause an error indication


    and you cannot continue the process until the error is corrected.

  • The CxEngine Server uses port 8080 by default. You can also use a different port, although it is not recommended.

  • All the CxEngine Server the environment variables can be viewed and edited in the Windows Properties once the engine is configured and running.

Parameter Overview

Common Use Cases

There are two commonly used scenarios for distributed installations:

  • Installing ActiveMQ after installing CxManager

  • Changing the host name of ActiveMQ

Installing ActiveMQ after CxManager

Changing the Host Name of ActiveMQ

  • After changing the host name of ActiveMQ, you have to reconfigure both the Access Control and CxEngine as explained above.