Discovering Endpoints > Configuring DHCP Options Discovery

Configuring DHCP Options Discovery

When MC DHCP vendor class option discovery is used, endpoints receive a DHCP option value that contains information about the MC (i.e., the EBM/EM) to which they should connect. If an endpoint has already obtained a DHCP lease before the server is configured with MC DHCP options, it will be updated with this information when it renews the lease or acquires a new one. A zero client will renew its lease after a reboot or when it detects that the network has returned after going down (e.g., if someone reconnects the endpoint's network cable after unplugging one end of it).

Note: Endpoints also poll the DHCP server for option values at an interval equal to half the DHCP lease time.

You can configure your DHCP server with MC vendor class options to provide the following information:

This discovery method requires you to have a DHCP server in your network that meets the following requirements:

Before You Begin

These instructions explain how to create a PCoIP Endpoint vendor class and two MC PCoIP Endpoint DHCP options.

Note: If you have used DHCP vendor class option discovery with a previous 1.x release of the MC and have already configured your DHCP server with the PCoIP Endpoint vendor class, you can skip the section entitled Adding the PCoIP Endpoint Vendor Class, below.

Before beginning, you should have the following information handy:

You can locate the MC's fingerprint as follows:

  1. Use Firefox to log in to the MC web interface.
  2. Click the padlock icon in the browser's address bar.
  3. Click More Information.
  4. Click View Certificate.
  5. In the Fingerprints section, copy and paste the SHA-256 fingerprint into a text editor.

Note: The examples in this section use Windows Server 2012 R2. The instructions may vary with other systems.

Adding the PCoIP Endpoint Vendor Class

To add the PCoIP DHCP vender class to your DHCP server:

  1. Log in to your Windows Server and select DHCP.
  2. Right-click on your DHCP server in the SERVERS pane and select DHCP Manager.
  3. Expand your server in the tree, right-click on IPv4, and then select Define Vendor Classes.

  4. Click Add to add a new DHCP Vendor Class.
  5. Enter PCoIP Endpoint in the Display name field.
  6. Enter PCoIP Endpoint in the ASCII column as the Vendor ID.

  1. Click OK to save and close the dialog.

Configuring DHCP Options

To add two MC DHCP options and apply them to a scope:

  1. Right-click on IPv4 in the tree and select Set Predefined Options.

  2. Select PCoIP Endpoint as the Option class and then click Add.
  3. In the Option Type dialog, enter the name EBM URI, data type String, code 10, and description Endpoint Bootstrap Manager URI, and then click OK.

  4. Click OK to save and close the dialog.
  5. For the MC's SHA-256 certificate fingerprint, repeat steps 1 and 2 again to add another option.
  6. In the Option Type dialog, enter the name EBM X.509 SHA-256 fingerprint, data type String, code 11, and description EBM X.509 SHA-256 fingerprint, and then click OK.

  7. Expand the tree for the DHCP scope to which you want to apply the options.
  8. Right-click Scope Options and then select Configure Options.
  9. Click the Advanced tab and then select the PCoIP Endpoint vendor class.
  10. Enable the check box for 010 EBM URI and then enter a valid Management Console URI in the Data entry field, and click Apply.

    This URI requires a secured WebSocket prefix (e.g., wss://<MC IP address>:[port number]. The MC's listening port is 5172. Entering this port number is optional. If you do not include it, port 5172 will be used by default.

  11. Enable the check box for 011 EBM X.509 SHA-256 fingerprint and paste the MC certificate SHA-256 fingerprint you obtained above into the String value field.

  12. Click OK to save and close the dialog.