Installing Service Monitor Agent on Windows

Note: Service Monitor is a portal for administrators to observe the health of deployed NetBrain servers (including both Windows servers and Linux servers), with operations management of related services. It is highly recommended to install it on your NetBrain servers that require monitoring. See Monitoring Server and Service Metrics for more details.

Complete the following steps with administrative privileges.

1.Download the netbrain-servicemonitoragent-windows-x86_64-8.0.3.zip file and save it in your local folder.

Tip: Contact NetBrain Support Team to get the download link.

2.Extract installation files from the netbrain-servicemonitoragent-windows-x86_64-8.0.3.zip file.

3.Right-click the netbrain-servicemonitoragent-windows-x86_64-8.0.3.exe file, and then select Run as administrator to start the Installation Wizard.

1)On the Welcome page, click Next.

2)On the System Configuration page, review the system configuration summary and click Next.

3)On the License Agreement page, read the license agreements, select the I have read the subscription EULA… check box and then click I ACCEPT.

4)On the Destination Location page, click Next to install the Service Monitor Agent under the default path C:\Program Files\NetBrain\. If you want to install it under another location, click Change.

5)On the Web API Server Configuration page, enter the following information to connect to your NetBrain Web API Server, and then click Next.

API URLthe URL used to call the Web API service, http://<IP address of NetBrain Web API Server>/ServicesAPI. For example, http://10.10.3.141/ServicesAPI.

Note: If SSL is enabled with https binding created for the system website in IIS Manager, use https in the URL. Besides, if you want to authenticate the Certificate Authority of the SSL certificate used by the system website (to be completed in the next step), the hostname must be specified in the URL.

API Key — the key used to authenticate the connections to Web API Server. By default, it is netbrain.

Note: The API Key must be kept consistent with the API Key configured when you installed Web API Server.

6)This step is required only if https is used in API URL. Configure whether to authenticate the Certificate Authority (CA) of the certificates used to enable SSL for NetBrain website in IIS Manager, and then click Next.

To authenticate CA:

a)Select the Conduct Certificate Authority verification check box.

b)Click Browse to import the CA certificate file, for example, ca.pem.

Note: Only the certificate in Base-64 encoded X.509 PEM format is supported.

7)Review the summary of the installation information and click Install.

4.After NetBrain Service Monitor Agent is successfully installed, click Finish to complete the installation process and exit the Installation Wizard.

Tip: After the installation is completed, you can open the Task Manager and navigate to the Services panel to check whether NetBrainAgent is running.

5.If you changed the default port number when installing a NetBrain server, you must add the customized port number to its corresponding configuration file so that the Server Monitor can detect and monitor its service. See Configuration Files for Port Information for more details.

Configuration Files for Port Information

The Service Monitor Agent checks the following configuration files for the customized port or service name information about NetBrain servers installed on Windows.

Server Name

File Name

Front Server

fs.yaml

Front Server Controller

fsc.yaml

Web API Server

iis.yaml

Task Engine

taskengine.yaml

Worker Server

workerserver.yaml

Example: If you configured a port number 5662 during Task Engine installation, do the following:

1.Navigate to the C:\ProgramData\Netbrain\nbagent\checks directory.

Tip: The ProgramData folder is hidden usually. You can copy and paste the directory to navigate to the checks folder directly.

2.Open the taskengine.yaml file with a text editor to modify it.

Note: Follow the text format in the example strictly, including alignment, punctuations, and spaces.

init_config:
 
instances:
 - name: default
   port: 5662