You can configure environment variables in Dynamic Environment Manager to control the behavior of the digital watermark feature on specific Linux desktops.
Prerequisites
- Install and configure Dynamic Environment Manager. See Installing Dynamic Environment Manager and Configuring Dynamic Environment Manager.
- Enable the DEMEnable option and configure the DEMNetworkPath option in the /etc/vmware/viewagent-custom.conf file. See Setting Options in Configuration Files on a Linux Desktop.
Configure Environment Variables in Dynamic Environment Manager
Use the following steps to configure environment variables that define the settings for a digital watermark on a Linux desktop.
- In the Dynamic Environment Manager Management Console, click the User Environment tab and then select Environment Variables.
Existing environment variable definitions, if any, appear in the Environment Variables pane.
- To create a new environment variable, click Create.
- Click the Settings tab and define the environment variable settings.
- In the General Settings section, enter a name for the settings definition in the Name text box.
- In the Environment Variable Settings section, enter the variable name and value exactly as described in the "Dynamic Environment Manager Environment Variable Values for the Digital Watermark Feature" section that follows this procedure.
- Add the conditions required to use the environment variable with remote Linux desktops.
- Select the Conditions tab, click Add, and select the Operating System Architecture condition.
- Set the value to Linux.
Operating System is Linux
- Click Add and select the Endpoint IP Address condition.
The AND operator is added by default.
- In the Endpoint IP Address dialog box, set the endpoint IP address range, and click OK.
Following is an example of the condition statement.
Operating System is Linux AND Endpoint IP address is in range 11.22.33.44 - 11.22.33.54
- To save the environment variable, click Save.
Repeat this procedure for each additional environment variable that you want to configure for digital watermark.
Dynamic Environment Manager Environment Variable Values for the Digital Watermark Feature
In Dynamic Environment Manager, configure the environment variables described in the following table. Each environment variable maps to a corresponding configuration option in the /etc/vmware/config file. The environment variable settings take priority over the settings in /etc/vmware/config.
Environment variable | Corresponding option in /etc/vmware/config | Value/format of variable | Default | Description |
---|---|---|---|---|
WATERMARK | rdeSvc.enableWatermark | 0: Deactivate 1: Enable |
0 | Enables or deactivates the digital watermark feature. For information about the feature, see Features of Horizon 8 Linux Desktops. |
WATERMARK_FONT_NAME | rdeSvc.watermark.font | serif sans-serif cursive fantasy monospace |
serif | Defines the font used for the digital watermark. |
WATERMARK_FONT_SIZE | rdeSvc.watermark.fontSize | An integer within the range of values: 8–72 | 12 | Defines the font size (in points) of the digital watermark. |
WATERMARK_IMAGE_LAYOUT | rdeSvc.watermark.fit | 0: Tile 1: Center 2: Multiple |
0 | Defines the layout of the digital watermark on the screen, which is divided into nine squares:
|
WATERMARK_MARGIN | rdeSvc.watermark.margin | An integer within the range of values: 0–1024 | 50 | Defines the amount of space (in pixels) around the digital watermark for the Tile layout. As the watermark scales, the margin also scales proportionally. |
WATERMARK_OPACITY | rdeSvc.watermark.opacity | An integer within the range of values: 0–255 | 50 | Defines the transparency level of the digital watermark text. |
WATERMARK_TEXT | rdeSvc.watermark.template | String constructed using any of the available information variables: $BROKER_USER_NAME $BROKER_DOMAIN_NAME $USER_NAME $USER_DOMAIN $MACHINE_NAME $REMOTE_CLIENT_IP $CLIENT_CONNECT_TIME |
$USER_DOMAIN\ $USER_NAME\n $MACHINE_NAME On $CLIENT_CONNECT_TIME \n$REMOTE_CLIENT_IP |
Defines the text that you want to display for the digital watermark. Construct the watermark using any combination and order of the information variables. The character limit is 1024 characters and 4096 characters after expansion. The text is truncated if it exceeds the maximum length. |
WATERMARK_TEXT_ROTATION | rdeSvc.watermark.rotation | An integer within the range of values: 0–360 | 45 | Defines the display angle of the digital watermark text. |
Processing Order for Environment Variables
Dynamic Environment Manager processes environment variables each time a user connects or reconnects to the remote desktop.
Dynamic Environment Manager processes multiple environment variables in alphabetical order based on the environment variable name. Environment variables appear in alphabetical order in the Environment Variables pane. If several environment variables conflict, the last environment variable processed takes precedence. For example, if you have an environment variable named B that enables the watermark for the user named Sue, and another environment variable named A that deactivates the watermark for the desktop pool named Ubuntu1804, the watermark is enabled when Sue connects to a remote desktop in the Ubuntu1804 desktop pool.