When running the Media Server in a virtual machine (VM), the server process might terminate immediately after launching.

Most likely Cause

To calculate a unique Hardware ID, the VMS requires specific system details from the operating system (OS) API. In certain virtual environments, the OS API fails to return these system values. As a result, the VMS cannot generate a unique Globally Unique Identifier (GUID) and shuts down.

Identify the issue

If your server process terminates unexpectedly, check the Media Server Log files. The issue is present if you see the following log entry which contains:

ERROR: Can't save guid. Run once as administrator.

Solution

To resolve this issue, manually generate a new GUID and add it to your server configuration.

Step 1: Generate a new GUID

1. Go to guidgenerator.com.

2. Assure UUID v4 is selected

3. Select the Hyphens option is selected.

4. Click Generate Some UUID v4s.

5. Copy the generated GUID to your clipboard.

Step 2: Apply the GUID to your operating system

Follow the instructions below for your specific operating system.

For Windows

1. Press Windows Key + R to open the Run dialog.

2. Type regedit and press Enter.

3. In the Registry Editor, navigate to the following path: HKEY_LOCAL_MACHINE\SOFTWARE\Network Optix\Network Optix Media Server

4. Locate and double-click the serverGuid attribute to edit the string.

5. Paste the copied GUID into the Value data field and click OK.

6. Close the Registry Editor.

7. Restart the mediaserver service, by stopping and starting the Media Server application in the System Tray Overflow Menu

For Ubuntu

1. Open your terminal.

2. Navigate to the configuration directory: cd /opt/networkoptix/mediaserver/etc/

3. Open the configuration file in a text editor: sudo nano mediaserver.conf

4. Locate the serverGuid attribute and remove its existing value.

5. Paste the new GUID as the value for serverGuid.

6. Save and close the file.

7. Restart the media server service: sudo service networkoptix-mediaserver restart