Install the Cloud Connector Sensor

Cloud Connector Sensor is a new on-premises service that is installed on the Admin Server and registers as a sensor that provides a gateway to fetch the data from the NetWitness Cloud and transfer the data to the on-premises NetWitness Platform for further analysis and investigation.

Prerequisites

Ensure that the NetWitness Platform and the host (Admin Server) are on version 12.3 or later.

Note

Every customer needs to install only one Cloud Connector Sensor in their environment.

Step 1. Install the Cloud Connector Sensor
Step 2. Download the Activation Package
Step 3. Register the Sensor

Step 1: Install the Cloud Connector Sensor

  1. Log in to the NetWitness Platform as an administrator and go to admin icon Admin > Hosts.

    The Hosts view is displayed.

  2. Select the host (Admin Server) and click install button.

    A dialog listing all the services already installed on this host is displayed and seeks your confirmation if you want to install a new service.

  3. Click Yes.

    The Install Services dialog is displayed.

  4. Select the Cloud Connector Service from the Category drop-down menu, and click Install.

    how to install the cloud connector sensor

  5. Go to admin icon Admin > Services to verify successful Cloud Connector Service installation.

Step 2: Download the Activation package

The activation package contains the credentials and configurations for the Cloud Connector sensor to register with NetWitness.

  1. Log in to the NetWitness Cloud Portal.

  2. Go to admin icon Admin > Sensors > Sensor Downloads.

  3. Click the Cloud Connector tab.

    how to download activation package for registering sensors

  4. Under Activation Package, click download icon to download the activation package.

Step 3: Register the Sensor

You need to copy the Activation Package to the Cloud Connector sensor directory to complete the registration of the sensor.

Note

  • The same activation package can be used to register multiple sensors.
  • Ensure you use the most recently downloaded activation package.
  • If the activation package is not available, generate a new one.
  • The activation package contains sensitive information, you must handle it carefully and don’t share it with anyone.

  1. SSH to the host on which the Cloud Connector Sensor is installed.

  2. Copy the device-activation-package.json file downloaded from the NetWitness Cloud Portal to the /var/lib/netwitness/cloud-connector-server directory on the Cloud Connector Service host.

  3. Navigate to the following directory, by running the command:

    cd /var/lib/netwitness/cloud-connector-server

  4. Change the user and group of the device-activation-package.json file to netwitness by executing the following command:

    chown netwitness:netwitness device-activation-package.json

  5. To verify if Cloud Connector Sensor is connected successfully, log in to the NetWitness Cloud Portal, and go to Sensor List and check if the sensor appears as Cloud Connector with connected status.

See also

Install Insight Sensor