This document serves as a comprehensive guide that outlines the prerequisites required to integrate Windows OS devices instrumented with the NetSpeek Windows Runtime Service (NWRS) with the NetSpeek platform.

This device type uses a concept called “sub-integration” which means that the Edge VM uses another component to reach orchestrated devices. In the case of this integration, that component is the NetSpeek Windows Runtime Service being used to reach a Windows PC.

---

Prerequisites

Before beginning the integration, confirm the following:

• Your Windows device is powered on and connected to a network that is routable to/from your NetSpeek Edge.
• You have the NWRS installed on your Windows device. This software is distributed by NetSpeek as an MSI as described at: NetSpeek Windows Runtime Service Installation Guide for Individual Devices
• Relevant software for your use case is installed on the PC.
• You have deployed a NetSpeek Edge VM as described here: https://docs.netspeek.ai/netspeek-edge-installation-guide/
  • Note: This integration requires an Edge running software version 1.1.1 or later.

---

Step 1. Create Sub-Integration (Tenant-Level)

Sub-Integration Configuration

This step assumes an Edge VM is already deployed – the sub-integration is added as a configuration parameter to the Edge at the tenant level.

1. Navigate to Settings → Tenant Management → (select tenant) → Integrations
2. Click Add Integration
3. Choose the NetSpeek Runtime Service integration type.
   1. Note that for integrations where a sub-integration applies (and only those integrations), a “Parent Integration” field is shown.
4. Select the appropriate NetSpeek Edge VM to serve as the parent.

Step 2. Add Device to NetSpeek Room Canvas

Device Provisioning Flow

1. In the NetSpeek Console, navigate to Room Management
2. Select the room you wish to add your NWRS-orchestrated Windows PC to
3. Click Launch Room Canvas
4. Click Add device to room
5. Choose Generic in the Manufacturer list, and Room Compute – Windows from the device model list.
6. Configure the appropriate values, and in the “Integrations” section, select the previously created NetSpeek Edge VM sub-integration from Step 1. Ensure that the Edge VM is on a network that can reach the Windows PC’s configured IP address. Configure the following:
   • Device Name
   • Serial Number
   • IP Address or Hostname of the Windows PC

---

Verification

Once the relevant settings described above are configured, to validate the integration:

• Select a NWRS-orchestrated Windows OS device in the NetSpeek console, open the Device Actions Tab, and select an available device action. It is generally advisable to test by dispatching a non-intrusive command such as a Get Status.
• On the device, observe the selected action occurring.

---

Troubleshooting

Connection Issues

• Confirm the IP address on the NWRS device is correct and routable from the network segment where the NetSpeek Edge VM is deployed.
• Ensure port TCP 443 is not blocked by firewall rules on the Windows PC where your NWRS instance is installed.

---

Support

If you run into any issues during onboarding or have questions, contact NetSpeek Support at support@netspeek.com.