Dynamic Relay Server configuration

Dynamic Relay Server configuration uses the DHCP servers in your network. To configure dynamic Relay Server configuration, you need to add Relay Server connection information as Server options or Scope options on the DHCP servers in your environment. When computers connect to the network, they will receive parameters defined at scope level from the DHCP servers. This allows Relay Server connection information defined in DHCP scope to be transferred to the computer's registry. When the Workspace Control Agent starts up, it will use the information in its registry to connect to the proper Relay Server.

You can export Relay Server connection information from Workspace Control to easily add it to the DHCP Scope. To export this data, at Administration > Relay Servers, on the Settings tab, click the button Export Connection string to file. The Workspace Control Relay Server window then opens and allows you to select one or more Relay Servers to pre-populate the connection string. The Relay Server connection string, in the first DHCP option 'RESWMRS=...', will automatically include all known items (Relay Server name(s) (with port number if a different than the default port number 1942 was specified), Environment ID and password, FQDN name (DNS)).

In the connection string, if the Relay Server list exceeds 253 characters, Workspace Control will automatically generate new lines with 'RESWMRSLIST=...' for the remainder of the Relay Server list. It is important to add all lines to the DHCP servers in your environment.

The Relay Server connection string will be exported to a text file. The lines in the text file need to be added as Server options or Scope options on the DHCP servers in your environment.

Example - Relay Server names in the Relay Server connection string:

  • relay1.example.com:2012 (Relay Server name with port number 2012)
  • relay2 (Relay Server name without port number)

Example - an FQDN name in the Relay Server connection string:

  • FQDNrelayserver.res.com

For more information about how to configure your DHCP server, see Configure the Datastore dynamically.

A restart of the Agent service is necessary for the change in connection to take place.