Installing a Modular Sensor in VMware

This topic describes how to install a Modular Sensor in VMware.

About Modular Sensors

Sensors provide the data gathering foundation for Stellar Cyber's OpenXDR platform, gathering the right data with context. Modular sensors are purpose-built Stellar Cyber sensors that include both the host and the Stellar Cyber monitoring software. They are provided as both physical devices (Photon sensors) and virtual machine images for different target environments.

Previous releases provided a variety of different types of device sensors, including Network, Security, and Modular. Going forward, the only type of device sensor is Modular. You can use the Modular Sensor Profile to enable whatever sensor features you like, creating the same functionality provided by the different sensor types in previous releases.

Keep in mind that VM resource requirements increase as you add more features to the Modular Sensor Profile. Refer to Modular Sensor Specifications for details on the resources required to run different combinations of features in a Modular Sensor Profile, as well as how to use the show module and show module request CLI commands to compare provisioned resources against those required to run specific feature combinations. Stellar Cyber only enables a Modular Sensor Profile on a sensor if the host VM's resources can support it.

Stellar Cyber does not support the installation of third-party software on its virtual or physical device sensors.

Site Preparation

Click to see the minimum system requirements for installing a modular sensor.

You will also need to:

• Open firewall ports for log ingestion.
• Open firewall ports for Network Traffic, Sandbox, and IDS features, as necessary.

One physical port on the system will be configured to receive network traffic to be analyzed. It must have promiscuous mode capability and be connected to an appropriate data source.

In addition, the system BIOS must have VT-d/IOMMU enabled.

Downloading Images

The virtual machine image for modular sensors in VMware can be downloaded from the Stellar Cyber production server at the link below.

Installation links point to the most recent release. To download a different version, simply substitute the version you want for the version specified in the link.

Description	Version	URL
Modular Sensor	5.3.0	https://acps.stellarcyber.ai/release/5.4.0/datasensor/aella-modular-ds-5.4.0.ova

Contact Stellar Cyber support (support@stellarcyber.ai) for login credentials.

Alternatively, you can use a curl command in a shell user environment to download the images. For example, the following command downloads a Version 5.3.0 Modular Sensor:

curl -k -u login:password https://acps.stellarcyber.ai/release/5.3.0/datasensor/aella-modular-ds-5.3.0.ova -o aella-modular-ds-5.3.0.ova

Supported ESXi Versions

Sensor installation is supported on the following ESXi versions:

• 8.0
• 7.0
• 6.7

Installation Steps

Once the prerequisites have been met, use the following procedure to install the sensor:

Use our example as a guideline, as you might be using a different software version.

Create a new virtual switch with port mirroring capabilities. Start with the add-networking wizard function and select the Virtual Machine Port Group option as shown in the following image.

You can add the port to an existing switch or create a new switch. The following image shows the attachment being made to an existing switch named vSwitch0.

Create a network label with the VLAN ID of 4095. This is shown in the following image.

At this point the settings should be complete. Select the "FINISH" button as shown below.

When completed, the resulting switch can be seen in the Networking section of the vCenter Navigator as shown in the following image. Select the network connection as shown in "STEP 1" and then the Edit button shown as "STEP 2".

Select the "Security" panel option and enable Promiscuous Mode by selecting the appropriate Override and Accept controls as shown in the following image.

You can repeat the above steps as necessary to monitor additional ports.

The next steps create the VM. Select the option to deploy a new OVF template wizard and use the Local file option, as shown below.

The Stellar Cyber distribution provides an OVA file, which is a format that includes the requested OVF file as a component.

On the next screen provide the VM a name and select the appropriate data center where it will be deployed, as shown below:

Within the data center, there may be more than one resource that can run the VM. Select the one which hosts the mirror port. A simple configuration is shown in the following image:

Once the selections are made, the summary page appears as follows. If the settings are correct, click the Finish button shown in the following image:

The VM is loaded into the hypervisor management and can then be seen in the vCenter summary page. An example of this is shown in the following image:

Expand the Virtual Hardware sub-page. The Management channel used by the sensor is implemented over "Network Adapter 1" which needs to be connected. Select it as shown in the following image:

Select the "Edit Settings" menu item to add a second adapter. This is the network interface that will be used to monitor traffic on the virtual switch we created in prior steps. This is shown in the next two images. Note that you can only add a network adapter to the VM while it is powered off:

At this point the Sensor is installed and can be started. An example of this is shown in the following image:

Connecting the Sensor to the Stellar Cyber Platform

To connect to the DP:

1. Log in to your new sensor. The default username/password is aella/changeme. You are immediately prompted to change the password.

2. Change the password.

   After you change the password, your session closes automatically. When you log back in with your new credentials, the prompt changes to DataSensor>.

3. Set IP parameters for the management port. You can use either a static IP address or a DHCP server, if available.

   Stellar Cyber recommends using a static IP address for ease of troubleshooting.

   The commands are as follows:

   Configuration Type	Commands
   Static IP Substitute your own IP parameters for those shown in bold.	set interface management ip 192.168.14.100/255.255.255.0 set interface management gateway 192.168.14.1 set interface management dns 8.8.8.8
   DHCP	set interface management ip dhcp

4. Verify the IP settings with the show interfaces command.

5. Set the host name. The host name is displayed in Stellar Cyber and should be unique for each sensor:

   set hostname <new hostname>

6. If necessary, set the proxy HTTP server:

   set proxy http://<proxy IP address:port>

   Note: The CLI prevents you from entering non-printable characters as part of the username or password for the proxy, as well as the proxy itself.

7. If this sensor is associated with a specific Tenant, use the set tenant_id <Tenant ID> command to specify the name of that tenant. For example:

   set tenant_id MyTenant

8. Use the set cm command to specify the IP address to reach the management interface of the Stellar Cyber Platform. For a cluster, this is the IP address of the DL-master's management interface. For a single DP deployment, this is simply the Stellar Cyber Platform's management IP address. You can specify either an IP address or a hostname. For example:

   set cm 192.168.44.10

   or:

   set cm example.company.com

   If you specify a hostname rather than an IP address, the system attempts to verify the hostname with the DNS server. If the DNS server is not reachable, the system reports the error and lets you either proceed with the configured hostname or quit. This way, you can specify a hostname for the set cm destination in an offline environment without access to a DNS server.

9. Verify your settings with the show cm command. You should see the IP address of the Stellar Cyber Platform listed as the CM Controller and the Status should be Established.
10. Log out with the quit command.

The sensor automatically contacts the Stellar Cyber Platform to register itself.

Configure NTP and Set the Timezone

Stellar Cyber strongly recommends that configure NTP and set the timezone for the sensor.

Refer to Best Practices for NTP and Timezones for details.

Authorize the Sensor

You must authorize the sensor when it appears in the network.

You can authorize multiple sensors at a time. So if you're installing multiple sensors, install them all, then authorize them all at once.

Enabling SSSE3 for the Modular Sensor VM

The Modular Sensor VM must have SSSE3 enabled for its processors in order to operate correctly. In most cases, SSSE3 will already be enabled. However, if you encounter issues with packet collection or Interflow data generation, you can use the instructions below to ensure that SSSE3 is enabled.