Mother Module RIG Guide

Overview

This guide explains how to add and enable the Mother Module to a RIG. The Mother Module facilitates the sharing of information from different RIGs into a CIP. It also provides a communication platform between Nectar Foundation and Nectar Diagnostics.

For detailed information on performing Nectar RIG operation tasks, such as using dashboards and dependency trees, see the Nectar Foundation Remote Intelligence Gateway (RIG) Administration Guide.

About this Guide

This guide explains how to:

Add and Enable the Mother Module to a RIG

Audience

This guide is intended for system administrators or engineers who have system administration access and technical knowledge of the Mother Module along with a familiarity with deploying Nectar Foundation.

Supported Software Versions

• Nectar v8.7

Prerequisites

When requesting a license, specify that you want a license that includes the Mother Module.

Add and Enable the Mother Module to a RIG

This document explains how to add and enable the Mother Module to a RIG. The Mother Module facilitates the sharing of information from different RIGs into a CIP. It also provides a communication platform between Nectar Foundation and Nectar Diagnostics.

This chapter contains the following sections:

Apply the License

Enable EIP/Perspective Controller (Mother)

Verify the Mother Module is Installed

Point Nectar Diagnostics to the RIG

Add Permissions to the Mother Module RIG

Make Sure the RIG is Connected

Apply the License

Next apply the license to your RIG.

Follow one of these procedures (your setup determines what procedure to follow):

Apply a License to a Local Host RIG from a CIP/EIP

Apply a License to a Newly Installed RIG

Apply a License to a Local Host RIG from a CIP/EIP

To apply a license to a local host RIG from a CIP/EIP:

1. Access your RIG by way of the CIP/EIP.
2. Navigate to RIG > Server License.

Figure 2-1RIG > Server License

The Server License window appears:

1. Click Copy to Clipboard.

Figure 2-2Server License Window

1. Open a ticket with the Nectar Services Desk and attach the value copied to the clipboard.

The Service Desk provides a license file.

1. Download this license file to the desktop.
2. Click Install License....
3. Select the file received from the Nectar Services Desk.
4. Click Restart.

The Restart confirmation window appears:

1. Click Yes.

Figure 2-3Restart Confirmation

Apply a License to a Newly Installed RIG

To apply a license to a newly installed RIG (directly from the RIG)

1. Log in to your RIG via http://[RIG Host name or IP Address].

The Server License window appears:

1. Click Copy to Clipboard.

Figure 2-4Server License Window

1. Open a ticket with the Nectar Services Desk and attach the value copied to the clipboard.

The Service Desk provides a license file.

1. Download this license file to the desktop.
2. Click Install License....
3. Select the file received from the Nectar Services Desk.
4. Click Restart.

The Restart confirmation window appears:

1. Click Yes.

Figure 2-5Restart Confirmation

Enable EIP/Perspective Controller (Mother)

1. Navigate to RIG > Module Configuration. Module Configuration window appears.

Figure 2-6EIP/Perspective Controller (Mother)

1. Scroll down and select the checkbox for EIP/Perspective Controller (Mother).
2. Click Apply.
3. Navigate to RIG > Admin > Restart.
4. Click Yes when the Restart window appears to confirm you want to restart the RIG.

Note

If EIP/Perspective Controller (Mother) is not an available option, please contact

Nectar Services Desk and request a license that includes “Mother” in it.

Verify the Mother Module is Installed

Follow this procedure to verify that the Mother Module is installed:

1. Navigate to Configure > Distributed:

Figure 2-7Configure > Distributed

1. In the Satellites panel, you can see the newly installed Mother Module RIG. (In this case, a satellite represents the Mother Module RIG.)

Figure 2-8Satellites Panel Shows Mother Module Installed

1. To drill down, double-click on a satellite to see that device that is pointed to the Mother Module RIG.

Point Nectar Diagnostics to the RIG

Follow this procedure to point Nectar Diagnostics to the new Mother Module RIG. The IP address of the RIG and Nectar Diagnostics is needed.

1. Navigate to Tools > Remote Access > Connection Broker:

Figure 2-9Tools > Remote Access > Connection Broker

The Connections Broker window appears:

Figure 2-10Connection Broker

1. Double-click on the correct SSH connector for Nectar Diagnostics:

Note

If an SSH connector for Nectar Diagnostics is needed, build a new one by right- clicking in the Connections panel and selecting Add. Select SSH and enter the Nectar Diagnostics IP address and port 22.

Add Permissions to the Mother Module RIG

Follow this procedure to add permissions to the RIG:

1. Navigate to RIG > Permissions:

Figure 2-11RIG > Permissions

The Permissions window appears:

1. Click Add.

Figure 2-12Permission Manager - Click Add

Note

You can also select a user, right click, and select Add from the menu.

The Add User window appears:

Figure 2-13Add User Window

1. Enter the Username that Nectar Diagnostics uses to connect to the RIG.
2. Enter Password and re-enter in Confirm password field.
3. Leave Organization at the default entry. (This will be root or empty depending on the RIG version).
4. Leave Default Dashboard at the default entry.
5. Click OK to add the user; do not give the user any rights on the RIG.

Make Sure the RIG is Connected

Follow this procedure to make sure your RIG is connected.

1. Navigate to Configure > Distributed:

Figure 2-14Configure > Distributed

The Distributed window appears. You should see the RIG in the Satellites panel.

Note

If you do not see the RIG in the Satellites panel, you can try a few things:

• Go back to the remote desktop connection (see Point Nectar Diagnostics to the RIG and enter the showrun command to view the RIG configuration.
• Enter ping
• Enter traceroute
• Make sure the port 443 is open.
• Check the Windows Firewall rules. Make sure you have the appropriate rules set up to allow Nectar Diagnostics’ incoming connections.

Enter CTRL+C to exit.

Figure 2-15Distributed Satellites

1. Navigate to Tools > Satellites:

Figure 2-16Tools > Satellites

The new RIG should appear in the Satellites panel.

1. Double-click on the correct satellite to drill-down until you see the Summary panel showing that the satellite has an Alert status of Good:

Figure 2-17Satellite with Alert Status of Good

1. Click on the Nectar Diagnostics menu to view a variety of options:

Figure 2-18Nectar Diagnostics Menu

For more information on Nectar Diagnostics, see the Nectar Diagnostics user documentation.