Connecting the Portal to the Engines

Connecting the Portal to the Engines

For the Portal to compute and display some data in its widgets, you must connect it to the Engines that receive and organize the end-user data coming from the Collectors.

To connect the Portal to an Engine:

  1. Log in to the Portal as administrator.
  2. In the Administration module, select the Engines dashboard under the section Nexthink Portal.
  3. Click the plus sign that is located in the top right corner of the widget Engines Management. The dialog to add a new Engine shows up.
  4. Type in the IP address or DNS name of the appliance that hosts the Engine in the Address (IP or hostname) field.
  5. In the Port field, type in the port number that the Engine uses to communicate with the Finder and the Portal.
  6. Optional: In the field Description, write down a brief sentence to help you distinguish the new Engine that you want to connect to the Portal from other Engines.
  7. Click Ok.

After completing the procedure, the Engines Management widget displays the newly connected Engine as a row in the table of connected Engines. The row displays the name, address, description, version and timezone of the Engine. However, since the connection is not yet established, a red dot appears in the first column of the row and the actual name, version and timezone of the Engine are not available yet.

To establish the connection and get information from the Engine:

  1. In the table of Engines find the chain and pencil icons that are placed to the right of the Name column.
  2. Click on the chain icon to establish the connection with the Engine. The red dot turns to yellow and then to green, to indicate that the connection is now established. The widget fills in the name, version and timezone of the Engine with the information that the Engine itself sends.

Repeat the operation described above for any other Engine that you want to connect to the Portal.

Once the connection is established, the Portal collects information from the Engine in a regular basis. While the Engine connection is working, you cannot edit the parameters of the Engine and so the pencil icon in the row that holds the information about the Engine is disabled. Otherwise, if the Portal cannot establish a connection to the Engine, the dot in the beginning of the row stays red, which means that you probably did not set the parameters of the Engine correctly. In this case, click the pencil icon, edit the connection parameters of the Engine as explained above and try to establish the connection again by clicking the chain icon.

Similarly, if the appliance of an Engine changes its configuration and the modifications make the connection with the Portal fail, the dot will turn to red as well. To recover the connnection:

  1. Click the chain icon (displayed as a broken chain now) to unlink the Engine from the Portal and be able to edit the modified parameters.
  2. Edit the parameters of the Engine as we just explained above.
  3. Click again the chain icon and wait for the red dot to turn to green.