Virtual Serial Port (vSPC) on VM Servers

  • Updated on Apr 18, 2023
  • Published on Mar 17, 2023
  • 1 minute(s) read

To redirect the VMware VM vSPC data to the Nodegrid Platform, the VM serial port needs to be configured.

Configure vSPC on VM Server

Ensure the VM is turned off.

  1. Open the ESXi configuration (vSphere).
  2. Select the VM and click Edit Virtual Machine Settings.
  3. Click Add (displays dialog).
  4. Click Serial Manager Device.
  5. On the pop-up dialog, click Next.
  6. Click Connect Via Network, then click Next.
  7. Select Client (VM initiates the connection).
  8. (optional) For Port URI, enter <group_id> (identifier used during Auto Discovery to relate servers of the same group).
  9. On vSPC URI, type telnet://<IP or Nodegrid Manager hostname>:9977.
  10. Click Finish. 
  11. On the ESXi firewall, ensure the vSPC port is enabled. To confirm, go to ESXi Configuration, select Security Profile and click on Properties. 
  12. On the Remote Access page, review the box related to VM serial port connected to vSPC.  

Outgoing Ports should have a TCP port range starting from 1024 or higher. The port range must include the TCP port used on the vSPC URI field (default 9977).

Modify Outgoing Port Range

  1. Connect to the ESXi command line.
  2. Execute the following command:
    Text
    # vi /etc/vmware/firewall/service.xml
  3. Edit the port section:
    Text
    <!—Remote serial port with vSPC: all remote serial port traffic is initiated
<service id="0030">
  <id>vSPC</id>
  <rule id='0000'>
    <direction>outbound</direction>
    <protocol>tcp</protocol>
    <porttype>dst</porttype>
    <port>
      <begin>1024</begin>
      <end>65535</end>
    </port>
  </rule>
  <enabled>false</enabled>
  <required>false</required>
</service>
  4. Save the changes and then restart the firewall service.
    # esxcli network firewall refresh

For further information on VMware firewall, please refer to the VMware Knowledge Base.