You can configure certain options by adding entries to the files /etc/vmware/config or /etc/vmware/viewagent-custom.conf.

During the installation of View Agent or Horizon Agent, the installer copies two configuration template files, config.template and viewagent-custom.conf.template, to /etc/vmware. In addition, if the files /etc/vmware/config and /etc/vmware/viewagent-custom.conf do not exist, the installer copies config.template to config and viewagent-custom.conf.template to viewagent-custom.conf. In the template files, all the configuration options are listed and documented. To set an option, simply remove the comment and change the value as appropriate.

For example, the following line in /etc/vmware/config enables the lossless PNG mode.
RemoteDisplay.alwaysLossless=TRUE

After you make configuration changes, reboot Linux for the changes to take effect.

Configuration Options in /etc/vmware/config

VMwareBlastServer and its related plug-ins use the configuration file /etc/vmware/config.

Table 1. Configuration Options in /etc/vmware/config
Option Value Default Description
RemoteDisplay.alwaysLossless TRUE or FALSE FALSE Graphic applications, especially graphic design applications, require pixel-exact rendering of images in the client display of a Linux desktop. You can configure a lossless PNG mode for images and video playback that are generated on a Linux desktop and rendered on the client device. This feature uses additional bandwidth between the client and the ESXi host.
mksVNCServer.useUInputButtonMapping TRUE or FALSE FALSE Set this option to enable the support of a left-handed mouse on Ubuntu or RHEL 7. CentOS and RHEL 6.6/6.7/6.8 support a left-handed mouse and you do not need to set this option.
RemoteDisplay.allowAudio TRUE or FALSE TRUE Set this option to disable audio out
VVC.ScRedir.Enable TRUE or FALSE TRUE Set this option to disable smart card redirection.
VVC.logLevel FATAL, ERROR, WARN, INFO, DEBUG, or TRACE INFO Use this option to set the log level of the VVC proxy node.
VVC.RTAV.Enable TRUE or FALSE TRUE Set this option to disable audio input.
Clipboard.Direction 0, 1, 2, or 3 2 This option determines the clipboard redirection policy.
  • 0 - Disable clipboard redirection.
  • 1 - Enable clipboard redirection in both directions.
  • 2 - Enable clipboard redirection from client to remote desktop only.
  • 3 - Enable clipboard redirection from remote desktop to client only.
mksVNCServer.useXExtButtonMapping TRUE or FALSE FALSE Set this option to enable or disable the support of a left-handed mouse on SLED 11 SP3.
mksvhan.clipboardSize INTEGER 1024 Use this option to specify the clipboard maximum size to copy and paste.
RemoteDisplay.maxBandwidthKbps INTEGER 4096000 Specifies the maximum bandwidth in kilobits per second (kbps) for a VMware Blast session. The bandwidth includes all imaging, audio, virtual channel, and VMware Blast control traffic. The max value is 4 Gbps (4096000).
RemoteDisplay.maxFPS INTEGER 60 Specifies the maximum rate of screen updates. Use this setting to manage the average bandwidth that users consume. Valid value should be between 3 and 60. The default is 60 updates per second.
RemoteDisplay.enableStats TRUE or FALSE FALSE Enable or Disable the Blast protocol statistics in mks log, such as bandwidth, FPS, RTT and so on.
RemoteDisplay.allowH264 TRUE or FALSE TRUE Set this option to enable or disable H.264 Encoding.
vdpservice.log.logLevel FATAL, ERROR, WARN, INFO, DEBUG, or TRACE INFO Use this option to set the log level of the vdpservice.
RemoteDisplay.qpmaxH264 available range of values: 0-51 36 Use this option to set the H264minQP quantization parameter, which specifies the best image quality for the remote display configured to use H.264 encoding. Set the value to greater than the value set for RemoteDisplay.qpminH264.
RemoteDisplay.qpminH264 available range of values: 0-51 10 Use this option to set the H264maxQP quantization parameter, which specifies the lowest image quality for the remote display configured to use H.264 encoding. Set the value to less than the value set for RemoteDisplay.qpmaxH264.
RemoteDisplay.minQualityJPEG available range of values: 1-100 25 Specifies the image quality of the desktop display for JPEG/PNG encoding. The low-quality settings are for areas of the screen that change often, for example, when scrolling occurs.
RemoteDisplay.midQualityJPEG available range of values: 1-100 35 Specifies the image quality of the desktop display for JPEG/PNG encoding. Use to set the medium-quality settings of the desktop display.
RemoteDisplay.maxQualityJPEG available range of values: 1-100 90 Specifies the image quality of the desktop display for JPEG/PNG encoding. The high-quality settings are for areas of the screen that are more static, resulting in a better image quality.

Configuration Options in /etc/vmware/viewagent-custom.conf

Java Standalone Agent uses the configuration file /etc/vmware/viewagent-custom.conf.

Table 2. Configuration Options in /etc/vmware/viewagent-custom.conf
Option Value Default Description
Subnet NULL or network address and mask in IP address/CIDR format NULL If there are multiple local IP addresses with different subnets, use this option to set the subnet that the Linux Agent provides to the View Connection Server.

When multiple subnet configurations are detected on a Linux Agent machine, this option is required to specify the correct subnet that should be used by the Linux Agent. For example, if you installed Docker on the Linux machine, it will be introduced as a virtual network adapter. To avoid Linux Agent from using Docker as a virtual network adapter, you have to set this option to use the real physical network adapter.

You must specify the value in IP address/CIDR format. For example, Subnet=192.168.1.0/24.

NULL implies that the Linux Agent randomly selects the IP address.

SSOEnable TRUE or FALSE TRUE Set this option to disable single sign-on (SSO).
SSOUserFormat A text string [username] Use this option to specify the format of the login name for single sign-on. The default is the user name only. Set this option if the domain name is also required. Typically the login name is the domain name plus a special character followed by the user name. If the special character is the backslash, you must escape it with another backslash. Examples of login name formats:
  • SSOUserFormat=[domain]\\[username]
  • SSOUserFormat=[domain]+[username]
  • SSOUserFormat=[username]@[domain]
StartBlastServerTimeout An integer 20 This option determines the amount of time, in seconds, that the VMwareBlastServer process has for initialization. If the process is not ready within this timeout value, the user's login will fail.
SSLCiphers A text string !aNULL:kECDH+AESGCM:ECDH+AESGCM:RSA+AESGCM:kECDH+AES:ECDH+AES:RSA+AES Use this option to specify the list of ciphers. You must use the format that is defined in https://www.openssl.org/docs/manmaster/apps/ciphers.html.
SSLProtocols A text string TLSv1_1:TLSv1_2 Use this option to specify the security protocols. The supported protocols are TLSv1.0, TLSv1.1, and TLSv1.2.
SSLCipherServerPreference TRUE or FALSE TRUE Use this option to enable or disable the option SSL_OP_CIPHER_SERVER_PREFERENCE. For more information, see https://www.openssl.org/docs/manmaster/ssl/SSL_CTX_set_options.html.
LogCnt An integer -1 Use this option to set the reserved log file count in /tmp/vmware-root.
  • -1 - keep all
  • 0 - delete all
  • > 0 - reserved log count.
RunOnceScript

Use this option to rejoin the cloned VM to AD.

Set the run once script after the host name has changed. The specified script is executed only once after the first host name change. The script is executed as root permission when the agent service starts and host name has been changed since agent installation.

For example, for the winbind solution, you must join the base VM to AD with winbind, and set this option to a script path. This must contain the domain rejoin command /usr/bin/net ads join -U <ADUserName>%<ADUserPassword>. After VM Clone, the operating system customization changes the host name. When the agent service starts, the script is executed to join the cloned VM to AD.

RunOnceScriptTimeout 120 Use this option to set the timeout time in seconds for the RunOnceScript option.

For example, set RunOnceScriptTimeout=120

Note: The three security options, SSLCiphers, SSLProtocols, and SSLCipherServerPreference are for the VMwareBlastServer process. When starting the VMwareBlastServer process, the Java Standalone Agent passes these options as parameters. When Blast Secure Gateway (BSG) is enabled, these options affect the connection between BSG and the Linux desktop. When BSG is disabled, these options affect the connection between the client and the Linux desktop.