To add Controller Broker Service, follow the below steps in the create service page. To know more about create service, refer Adding Service.

Step I: Click on Controller Broker from Add Services tab in Diyotta Manager explorer.

Step II: The Controller Broker service can be configured in two ways.

Option I: Add and deploy a service - Choose this option, if you want to to newly install the controller broker service on the host selected.

Option II: Auto Register - Choose this option, if the controller broker service is already installed on the host and you want to register it.

  • To create controller broker service you need to have the Node Manager on the same host where you want to install the controller broker service. To create a Node Manager Service, refer Adding Node Manager Service.
  • Controller Broker will get enabled only when you have configured the Node Manager service.
  • Controller Repository, Controller Broker Service and Agent are independent of each other and can be configured without any dependency.
  • Controller Repository, Controller Broker and Controller service should be installed on the same Node Manager.

Let's illustrate Option I to see how to add and deploy a service.

Option I: Add and deploy a service

1. Select Add and deploy a service. Following fields are displayed.

  • Do you want to download package from repository - Choose 'Yes', if the installation file should be downloaded from the package repository. Choose 'No', if the installation file is present on the host where node manager needs to be installed.

Note:

  • Package repository is a centralized location where all the installation files are managed. This is setup under Admin. For more information, refer Managing Package Repository.
  • If the package repository is not already created, then click on the download icon next to the dropdown and it takes you to the Package Repository page.
  • Package Location on Host - This option is displayed only when Do you want to download package from repository is set as No. Provide the path where the controller broker installation file is located on the server.
  • Controller Message Broker Startup Port - Startup port.
  • Controller Message Broker Connector Port - Connector Port.
  • Installation Directory - This is disabled and defaulted to the home directory path of node manager. 
  • Version - Click on the download icon to get the installer versions. The list of existing installer versions are picked from the package location specified. You can choose the installer required from the version drop-down. The version should match with the Diyotta Manager version.

2. Once you have entered all the details, click Deploy.

Once we click Deploy, Controller broker service gets installed with details provided and it starts the services. The installation details are provided in the log. Click Finish.

To download Node Manager Logs, click on Download.

The registered service details are displayed. Diyotta Manager Values shows the fields which are registered, and Config File Values shows the field values from controller broker Config file.

Note:

To check updated values from controller broker config file, click on Refresh. The value differences is indicated by showing ''

The value differences if any, is indicated with red highlighted text under Config File Values. To update Diyotta Manager values with controller broker config file values, click on '←' icon (arrow icon and highlight).

To add additional values to controller broker jmx, controller broker log, controller broker java opts values, click on Add. Two value fields get added and you can provide the values as required. To remove the values, click × icon.

If any value is changed then, click on Save changes.

It displays 'configuration values updated successfully' message and click on OK to continue.

Note:

  • The Save Changes gets displayed only once you make any changes in the field values.
  • Restart the node manager by clicking on Restart. Restart gets displayed only when changes are saved.

Option II: Auto Register service

Let's illustrate Option II, to see how to register an already installed service.

1. Select Auto RegisterFollowing fields are displayed.

  • Controller Message Broker Startup Port - The port on which the controller broker is running.
  • Controller Message Broker Connector Port - The port on which the controller broker's connector is running.
  • Installation Directory - This is disabled and defaulted to the home directory path of node manager. 

The controller Broker startup port and connector port details are obtained from the file -$DIYOTA_HOME/controller-broker/conf/controllerbroker.config under the installation of Controller Broker service.

  • Uses the value against the parameter controllerbroker.startup_port to get value for Controller Message Broker Startup Port  
  • Uses the value against the parameter controllerbroker.connector_port to get the value for Controller Message Broker Connector Port.

2. Once you choose auto register, the controller broker Configuration is retrieved for the host and the retrieval message is displayed . To finish controller broker service registration, click Continue.

  • To cancel auto registering and stay back in controller broker page, click on Cancel.
  • If controller broker configuration details are not found then the message 'service not exist' is displayed.

3. Once you choose to continue, it displays Diyotta Manager configuration details.

  • Once the Controller Broker service is added then, you can see the green tick against the Controller Broker tab. The Controller service tab gets enabled and you can move to the next step. To continue and configure the Controller and Agent, refer Adding Controller Service, and Adding Agent Service

Note: 

  • To manage controller broker service to start, stop and restart the service, refer Managing Controller Broker Services
  • Clicking on controller broker service later displays Diyotta Manager Values and Config File Values to show the field value differences from controller broker Config file.The value differences if any, is indicated with red highlighted text under Config File Values. To update Diyotta Manager values with controller broker config file values, click on '←' icon.