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

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

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

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

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

  • To create Agent service you need to have the Node Manager on the same host where you want to install the Agent service. To create a Node Manager Service, refer Adding Node Manager Service.
  • Controller Repository, Controller Broker Service, and Agent gets enabled once the Node Manager Service is configured.
  • 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. Whereas Agent can be configured either on same or different 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 drop-down 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 node manager installation file is located on the server.
  • Agent Name: Name of the agent
  • Agent installation directory: This is disabled and defaulted to the home directory path of node manager. 
  • Choose controller service: From the list select the controller service
  • Start Range: Start range number
  • End Range: End range number
  • Do you want to enable JVM metrics collection?: Select this option to enable JVM metrics.  If this is selected, then you need to provide the JMX Port. 
  • Enable Data Receiver?: Select this option for Data Receiver Port. If this is selected, then you need to provide the Data Receiver Port.
  • Min JVM memory: Enter the minimum memory allocated for JVM
  • Max JVM Memory: Enter the maximum memory allocated for JVM
  • Agent 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, agent 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.
Note: Controller licence needs to be applied for the agent to start.

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

Note:

To check updated values from agent 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 agent config file values, click on '←' icon (arrow icon and highlight).

To add additional values to Agent Broker Log, Agent Secret key, Agent_service_java_opts,Server HA, Agent Java Opts, Agent Service jmx, timeout 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 agent by clicking on Restart. Restart gets displayed only when changes are saved.

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

Option II: Auto Register

1. Select Auto Register. Following fields are displayed.

  • Agent Name: Name of the agent.
  • Agent installation directory: This is disabled and defaulted to the home directory path of node manager.
  • Choose controller service: From the list select the controller service.
  • Start Range: Start range number
  • End Range: End range number
  • Do you want to enable JVM metrics collection?: Select this option to enable JVM metrics.  If this is selected, then you need to provide the JMX Port.
  • Enable Data Receiver?: Select this option for Data Receiver Port. If this is selected, then you need to provide the Data Receiver Port.
  • Min JVM memory: Enter the minimum memory allocated for JVM.
  • Max JVM Memory: Enter the maximum memory allocated for JVM.

The Agent details are obtained from the file -$DIYOTA_HOME/agent/conf/diagent.config under the installation of Agent service.

  • Uses the value against the parameter diagent.name to get value for Agent Name.
  • Uses the value against the parameter diservice.port_range to get the values for Start Range and End Range.

To install Diyotta, refer Diyotta Installation.

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

  • To cancel auto registering and stay back in Agent page, click on Cancel.
  • If Agent 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 Agent service is added then, you can see the green tick against the Agent tab.

Note: 

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