2.4 Configuring and Launching Remote Management Viewer

2.4.1 Installing the Remote Management Viewer

The Remote Management Viewer is a management console application that enables a remote operator to perform remote operations on the managed device. It allows the remote operator to view the managed device desktop, transfer files, and execute applications on the managed device.

To install the Remote Management Viewer, click the Install Remote Management Viewer link that is displayed in ZENworks Control Center when you are performing a remote management operation on the managed device. This link is displayed only if you are performing a remote management operation on the device for the first time and if the viewer is not already installed on the device.

If an earlier version of the Remote Management Viewer is already installed on the device, then the Upgrade Remote Management Viewer link is displayed. Click this link to upgrade the version of the viewer installed on the device.

Pre-requisites for installing the Remote Management Viewer on Linux devices

Installing the Remote Management Viewer on SLES 11 or SLED 11 requires a dependent glitz package. The following RPM packages have been tested with ZENworks application:

Installing the Remote Management Viewer on SLES 12 or SLED 12 requires a dependent glitz package. The following RPM packages have been tested with ZENworks application:

Apart from the above packages, you need to add the following 32-bit libraries to run nzrviewer in SLES12 or SLED12 devices.

  • libglade2-32bit

  • libgnomeui-32bit

  • libglade2-32bit

  • libgnomeui-32bit

  • xorg-x11-libs-32bit

  • xorg-x11-libXmu-32bit

  • xorg-x11-libXt-32bit

  • xorg-x11-libXp-32bit

  • xorg-x11-libxcb-32bit

  • libjpeg-32bit

  • libopenssl0_9_8-32bit

After installing the RPM packages, you need to manually create the below symbolic links:

  • libXaw8.so.8 for libXaw8.so.8.0.0

  • libjpeg.so.62 for libjpeg.so.62.0.0

  • libXmu.so.6 for libXmu.so.6.2.0

  • libXt.so.6 for libXt.so.6.0.0

  • libXpm.so.4for libXmu.so.6.2.0

  • libXp.so.6 for libXp.so.6.2.0

  • libxcb-xlib.so.0 for libxcb-xlib.so.0.0.0

If you are installing the Remote Management Viewer on a Red Hat Enterprise Linux device, ensure that you have installed the following RPM packages:

  • For an RHEL 5, 32-bit device, you should have the glibc, libXaw, zlib, libjpeg, gtk2, libglade2, libgnomeui packages.

  • For an RHEL 5, 64-bit device, you should have 64-bit versions of the libXpm, libXt, gtk2 packages and 32-bit versions of the glibc, libXaw, zlib, libjpeg, gtk2, libglade2, libgnomeui packages.

  • For an RHEL 6, 32-bit device, you should have the glibc, libXaw, zlib, libjpeg, gtk2, libglade2, libgnomeui packages.

  • For an RHEL 6, 64-bit device, you should have the glibc(x86-32), libXaw(x86-32), zlib(x86-32), libjpeg(x86-32), gtk2(x86-32), libglade2(x86-32), libgnomeui(x86-32), libXpm(x86-64), libXt(x86-64), gtk2(x86-64) packages.

Installing the Remote Management Viewer on Linux

  1. In ZENworks Control Center, click Configuration.

  2. In the left navigation pane, click Download ZENworks Tools.

  3. In the left navigation pane of the ZENworks Download page, click Administrative Tools.

  4. Click Remote Management to view the viewer MSI files.

  5. Select one of the following actions:

    • For an RHEL 5, 32-bit device, click novell-zenworks-rpm-viewer-11.1.0-<version>.rhel5.i386.rpm

    • For an RHEL 5, 64-bit device, click novell-zenworks-rpm-viewer-11.1.0-<version>.rhel5.x86_64.rpm

    • For an RHEL 6, 32-bit device, click novell-zenworks-rpm-viewer-11.1.0-<version>.rhel6.i386.rpm

    • For an RHEL 6, 64-bit device, click novell-zenworks-rpm-viewer-11.1.0-<version>.rhel6.x86_64.rpm

    • For a SLES 11, 32-bit device, click novell-zenworks-rpm-viewer-11.1.0-<version>.i586.rpm

    • For a SLES 11, 64-bit device, click novell-zenworks-rpm-viewer-11.1.0-<version>.x86_64.rpm

  6. Decide whether to immediately install the viewer or save the viewer RPM file to install it later.

    • To immediately install the viewer, click Open With to open the Remote Management Viewer with zen-installer, specify the root password, then click OK.

    • To save the viewer RPM file to the default download directory so that you can install it later, click Save to Disk. To install the RPM, do one of the following:

      • Click the viewer RPM file, specify the root password, then click OK.

      • Run the appropriate command as a superuser or root user as shown:

        For a SLES device, run the rpm -ivh novell-zenworks-rm-viewer-<version>.<arch>.rpm command.

        For an RHEL device, run the rpm -ivh novell-zenworks-rm-viewer-<version>.<rhel>.<arch>.rpm command.

NOTE:If a 64-bit Remote Management Viewer RPM is installed on a 64-bit device, you can invoke the Remote Management Viewer by using any of the following options:

  • By using the 64-bit Firefox browser.

  • By running the /opt/novell/nzrviewer/nzrviewer command.

To invoke the Remote Management Viewer on a 64-bit device by using a 32-bit Firefox browser, do the following:

  1. Uninstall the 64-bit Remote Management Viewer RPM, if it is already installed.

  2. Install the 32-bit Remote Management Viewer RPM.

    If you have downloaded the 32-bit Firefox browser into a custom directory, ensure that you copy /usr/lib/firefox/plugins/nsZenworksPluginSample.so file to %Firefox_DIR%/plugins/ directory. For RHEL devices, copy /usr/lib/mozilla/plugins/nsZenworksPluginSample.so file to %Firefox_DIR%/plugins/ directory.

2.4.2 Installing the Remote Management Viewer in a Terminal Server or in a Citrix XENapp Environment

You can manually install the Remote Management Viewer in a common location for all users in a Terminal Server or in a Citrix XENapp environment and then register the plug-ins for Firefox and Internet Explorer accordingly.

  1. Log in to ZENworks Control Center.

  2. Click Configuration.

  3. In the left navigation pane, click Download ZENworks Tools.

  4. Click Administrative Tools in the left navigation pane of the ZENworks Download page.

  5. In the Remote Management tab, click novell-zenworks-rm-viewer-<version>.msi.

  6. Extract the files into a directory to which users have common access.

    For example, to extract files from novell-zenworks-rm-viewer-<version>.msi file at the command line, run the msiexec /a PathToMSIFile /qb TARGETDIR=DirectoryToExtractTo command.

  7. If you are using Firefox to launch the Remote Management viewer, copy npnzrPlugin.dll from the directory (\extracteddirectory\CFiles\Mozilla\Plugins) to which the msi was extracted to the directory which is in the Mozilla Firefox\plugins path.

    IMPORTANT:

    • For Firefox 21 onwards, copy npnzrPlugin.dll to the directory which is in the Mozilla Firefox\browser\plugins path. If the plugins directory is not available on the device, you need to create one.

    • For Firefox ESR 31.2 onwards, copy npnzrPlugin.dll to the directory which is in the Mozilla Firefox\plugins path.

    or

    If you are using Internet Explorer to launch the Remote Management Viewer, import the following registry files.

    For a 32-bit device:

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\Remote Management]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\Remote Management\Viewer]
    "Path"="C:\\rm\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrViewer.exe"
    "version"="11.4.3.22432"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Component Categories]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Component Categories\{7DD95801-9882-11CF-9FA9-00AA006C42C4}]
    "409"="Controls that are safely scriptable"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Component Categories\{7DD95802-9882-11CF-9FA9-00AA006C42C4}]
    "409"="Controls safely initializable from persistent data"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl\CLSID]
    @="{79A0EADB-6F62-4810-99D1-1245AD2AF81A}"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl\CurVer]
    @="nzrAXC.nzrAXCtrl.11.4.3.22432"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.4.3.22432]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.4.3.22432\CLSID]
    @="{79A0EADB-6F62-4810-99D1-1245AD2AF81A}"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\Implemented Categories]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\Implemented Categories\{7DD95801-9882-11CF-9FA9-00AA006C42C4}]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\Implemented Categories\{7DD95802-9882-11CF-9FA9-00AA006C42C4}]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\InProcServer32]
    @="C:\\rm\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrAXC\\nzrAXC.ocx"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\ProgID]
    @="nzrAXC.nzrAXCtrl.11.4.3.22432"

    For a 64-bit device:

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\Remote Management]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\Remote Management\Viewer]
    "Path"="C:\\rm\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrViewer.exe"
    "version"="11.4.3.22432"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Novell]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Novell\ZCM]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Novell\ZCM\Remote Management]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Novell\ZCM\Remote Management\Viewer]
    "Path"="C:\\rm\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrViewer.exe"
    "version"="11.4.3.22432"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Component Categories]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Component Categories\{7DD95801-9882-11CF-9FA9-00AA006C42C4}]
    "409"="Controls that are safely scriptable"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Component Categories\{7DD95802-9882-11CF-9FA9-00AA006C42C4}]
    "409"="Controls safely initializable from persistent data"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl\CLSID]
    @="{79A0EADB-6F62-4810-99D1-1245AD2AF81A}"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl\CurVer]
    @="nzrAXC.nzrAXCtrl.11.4.3.22432"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.4.3.22432]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.4.3.22432\CLSID]
    @="{79A0EADB-6F62-4810-99D1-1245AD2AF81A}"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\CLSID]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\Implemented Categories]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\Implemented Categories\{7DD95801-9882-11CF-9FA9-00AA006C42C4}]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\Implemented Categories\{7DD95802-9882-11CF-9FA9-00AA006C42C4}]
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\InProcServer32]
    @="C:\\rm\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrAXC\\nzrAXC.ocx"
    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Classes\CLSID\{79A0EADB-6F62-4810-99D1-1245AD2AF81A}\ProgID]
    @="nzrAXC.nzrAXCtrl.11.4.3.22432"
  8. Do the following:

    For Internet Explorer: Edit the registry to replace the path to the nzrViewer.exe and the nzrAXC.ocx files.

    In the [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\Remote Management\Viewer]"Path"="C:\\rm\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrViewer.exe" path, replace C:\\rm\\CFiles\\Novell\\ZENworks\\Remote Management\\bin with the path to which the msi file has been extracted.

    For Mozilla Firefox: Create the following registry keys for nzrViewer.exe

    NOTE:The path points to the location into which the exe file is extracted from msi. For example: “Path=”C:\\RMViewer. If the specified registry key is not available, then you need to create manually for unmanaged and Inventoried devices.

    • 32-bit Servers

      [HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\Remote Management\Viewer] "Path"="C:\\RMViewer\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrViewer.exe" "Version"="11.4.3.22432"

    • 64-bit Servers

      [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Novell\ZCM\Remote Management\Viewer]"Path"="C:\\RMViewer\\CFiles\\Novell\\ZENworks\\Remote Management\\bin\\nzrViewer.exe" "Version"="11.4.3.22432"

2.4.3 Upgrading the Remote Management Viewer

To upgrade the Remote Management viewer on a Linux device from Novell ZENworks 10 Configuration Management SP3 (10.3) to Novell ZENworks 11 SP3Configuration Management, run the appropriate command as a superuser or root user as shown:

For a SLES device, run the rpm -Uvh --nopostun novell-zenworks-rm-viewer-<version>.<arch>.rpm command.

For an RHEL device, run the rpm -Uvh --nopostun novell-zenworks-rm-viewer-<version>.<rhel>.<arch>.rpm command.

Alternatively, uninstall the old version novell-zenworks-rm-viewer-10.x.x.rpm, and install the new version. For more information on installing the viewer, see Installing the Remote Management Viewer.

If the Upgrade Remote Management Viewer link still appears in the Remote Management window, even after upgrading the rm-viewer RPM, delete the

nsZenworksPluginSample.so file from the plugins-wrapped folder of Mozilla Firefox. This is applicable for Firefox 3.x on the RHEL platform.

  1. Run the following command to delete:

    • For a 32-bit device:

      rm -f /usr/lib/mozilla/plugins-wrapped/*nsZenworksPluginSample.so

    • For a 64-bit device:

      rm -f /usr/lib64/mozilla/plugins-wrapped/*nsZenworksPluginSample.so

  2. Restart Firefox.

2.4.4 Options for Launching a Remote Management Operation

When you launch a remote management operation from the command line, you can specify options to control the behavior of the remote session. For example, specifying the remotecontrol option launches a Remote Control operation on the device and specifying the notoolbar option hides the toolbar of the viewing window.

Remote Management uses certain options internally when you launch a remote management operation on a device. For example, the zenrights option specifies that the authentication scheme is ZENworks Rights Authentication. You must not specify these internal options when you use the command line to launch a remote management operation on a device. For more information on the options that are internally used, see Internal Options for Launching a Remote Operation.

Review the following sections for more information on the remote management options:

Command Line Options for Launching a Remote Operation

Use the following command line options to control a remote operation:

Table 2-1 Command Line Options for Launching a Remote Operation

Command Line Option

Parameter

Description

listen

port

Enables the listener to listen to the remote session requests on the port specified. By default, the port is 5550.

restricted

 

Hides the toolbar and system menu.

viewonly

 

Launches a Remote View operation on the managed device.

remotecontrol

 

Launches a Remote Control operation on the managed device.

ftponly

 

Launches a File Transfer operation on the managed device.

remoteexecute

 

Launches a Remote Execute operation on the managed device.

diagnostics

appname

Launches a Remote Diagnostics operation on the managed device. If the appname parameter is specified, then that application is launched on the managed device.

filecompressionlevel

level

Provides means of optimizing the file compression process for better speed or better compression during a file transfer operation. The compression level can vary from 0 to 9:

  • 0 indicates no compression

  • 1 indicates best speed

  • 9 indicates best compression

If the compression level is not specified, the default compression level of 6, which is optimized for both speed and compression, is used.

noencrypt

 

Launches the remote session in an unencrypted mode.

fullscreen

 

Launches a remote operation in the full screen mode on the managed device.

notoolbar

 

Hides the toolbar of the viewing window.

exclusive

 

Launches the remote session in an exclusive mode.

8bit

 

Specifies the color depth to be used to render the session data.

shared

 

Enables a shared connection, allowing you to share the desktop with other clients already using it. This option is True by default.

collaborate

 

Launches the remote session in a collaborative mode. This option is not yet supported on Linux.

noshared

 

Enables an unshared connection, which disconnects other connected clients or refuses your connection, depending on the server configuration.

skipauth31

 

Launches Remote operation on a Mac device. This option skips Novell authentication that is unavailable on a Mac device.

swapmouse

 

Swaps the mouse buttons.

nocursor

 

Displays only the managed device mouse pointer. The local mouse pointer is not displayed.

dotcursor

 

Displays the local mouse pointer as a dot. This option is true by default.

smalldotcursor

 

Displays the local mouse pointer as a small dot.

normalcursor

 

Displays the local mouse pointer in the default shape.

belldeiconify

 

Allows the transmission of a bell character, causing a beep at the viewer. This option also causes a minimized vncviewer to be maximized when the bell character is received.

emulate3

 

Users with a two-button mouse can emulate a middle button by pressing both buttons at once. This option is True by default

noemulate3

 

Does not emulate a three-button mouse.

nojpeg

 

Disables lossy JPEG compression. This is not recommended because the efficiency of the encoder might reduce. You might want to use this option if it is absolutely necessary to achieve a perfect image quality.

nocursorshape

 

Disables the cursor shape updates to handle remote cursor movements. Using the cursor shape updates decreases the delays with remote cursor movements, and can improve bandwidth usage dramatically.

noremotecursor

 

Does not show the remote cursor.

fitwindow

 

Hides the scroll bar of the viewing window.

scale

percentage

Zooms the viewing window to the percentage of scaling specified.

emulate3timeout

ms

Specifies the time-out for emulating a three-button mouse.

disableclipboard

 

Disables the copying of data into the clipboard.

delay

 

Renders a display area and waits for the specified time before retrieving the next update.

loglevel

n

Specifies the levels of information logging.

console

 

Logs information in a console window.

logfile

filename

Name of the log file where information is to be logged.

config

filename

Name of the configuration file to be used for loading predefined configuration settings.

key

filename

Name of the file where private key is stored. This key is used during an SSL handshake with the managed device.

IMPORTANT:The key and the cert options must be used together. If you use these options along with the nzrViewer command, then for security reasons you must disable the Allow connection when Remote Management Console does not have SSL certificate option in the security settings of the Remote Management policy.

cert

filename

Name of the file where the certificate corresponding to the private key is stored.

If the certificate contains Enhanced Key Usage section, then the section must contain Client Authentication (1.3.6.1.5.5.7.3.2)

NOTE:Microsoft Certificate Services provides a number of certificate templates for issuing a certificate. Some of the certificate templates, such as Web Server, might not have the OID specified by default. If such a certificate is provided during the launch of a remote session, the SSL handshake fails. Consequently, the remote session also fails. So, if you are using Microsoft Certificate Services for issuing a certificate, ensure that the certificate template specifies Client Authentication (1.3.6.1.5.5.7.3.2) in the Enhanced Key Usage section.

IMPORTANT:The key and the cert options must be used together. If you use these options along with the nzrViewer command, then for security reasons you must disable the Allow connection when Remote Management Console does not have SSL certificate option in the security settings of the Remote Management policy.

CAcert

filename

Name of the file where the root certificate is stored. This certificate is used to verify the managed device certificate during an SSL handshake.

encoding

encname

Specifies the desired encoding to be used for the session. The different types of encoding are Raw, CopyRect, RRE, CoRRE, Hextile, Zlib, and Tight.

compresslevel

n

Specifies the compression level to compress the remote session data from 0 to 9. Level 1 uses a minimum of CPU time and achieves weak compression ratios, and level 9 offers best compression but is slow in terms of CPU time consumption on the server side. Use high levels with very slow network connections, and low levels when working over high-speed LANs. We recommend that you do not use compression level 0.

quality

n

Specifies the JPEG quality level from 0 to 9. Quality level 0 denotes poor image quality but very impressive compression ratios, and level 9 offers very good image quality at lower compression ratios.

zenpasswd

 

Specifies that the authentication scheme to be used is ZENworks Password Authentication.

locale

 

Specifies the locale in which the resources are to be displayed. By default, English is used. The values for this option are: English, French, German, Spanish, Portuguese, Japanese, Italian, Chinese(Simplified), and Chinese(Traditional).

proxy

proxy_server

Specifies the DNS name or the IP address of the remote management proxy and the port number in one of the following formats:

  • IP address~~Port. For example 10.0.0.0~~5750.

  • IP address~Port. For example 10.0.0.0~50.

The default port for the proxy is 5750. This option is not yet supported on Linux.

Internal Options for Launching a Remote Operation

The following table lists the options that Remote Management uses internally. These options should not be used when you launch a remote management operation from the command line.

Table 2-2 Internal Options for Launching a Remote Operation

Option

Description

zenrights

Specifies ZENworks Rights Authentication as the authentication scheme.

pipe

Specifies authentication information.

2.4.5 ZENworks Remote Management Viewer Options

You can use the various options available in the Remote Management Viewer Options dialog box to edit either connection-specific options or global settings:

Connection Tab

The following options are available in the Connection tab:

Display: Use the options under Display to specify the client-side display settings:

  • Use the Scale - by option to reduce or enlarge the local copy of the remote desktop.

  • Select Full-screen mode if you want the Viewer to show only the remote desktop and not the local desktop, toolbar, and window decorations.

Restrictions: Use the options under Restrictions to disable certain protocol features:

  • Select View only (input ignored) to view the remote desktop but not control it remotely with your mouse and keyboard.

  • Select Disable clipboard transfer, if you do not want the Viewer to propagate local clipboard changes to the server and vice-versa.

  • Select Block mouse move events to avoid sending information about local mouse movements to the managed device. This can improve session performance.

Mouse: Use the Mouse options to specify the following mouse configuration details:

  • Select Emulate 3 buttons [with 2-button click], if you have two- button mouse but you want to emulate using the third button. If this option is enabled, pressing the left and right buttons at the same time is equivalent to pressing the middle button.

  • Select Swap mouse buttons 2 and 3 to swap the events generated by the second and third mouse buttons.The right mouse button usually generates button 2 events, and the middle mouse button is usually treated as button 3.

Globals Tab

The following options are available in the Globals tab:

Interface Options: Under Interface Options, specify how the Remote Management Viewer interface is displayed:

  • Select Show toolbars by default to show toolbars in desktop windows.

  • Select Warn before switching to full-screen mode, if you want the Remote Management Viewer to display a warning before switching to the full-screen mode. The warning tells users how to exit full-screen mode.

  • Use the Connections to remember field to specify the number of connections for the Viewer to remember.

  • Click Clear all to remove the list of past connections from the system registry. This also removes all corresponding connection settings.

Local cursor shape: The local mouse cursor and the remote pointer might have different locations on the screen. You can choose one of the following options to customize the shape of the local cursor for improved cursor tracking:

  • Select Dot cursor to show the local cursor position as a dot.

  • Select Small dot cursor to show the local cursor position as a smaller dot.

  • Select Normal arrow to show the local cursor position as an arrow cursor.

  • Select No local cursor if you do not want to show the local cursor position.

Listening Mode: Use this option for settings specific to the listening mode that is used for reverse server-to-client connections.

Use the Accept reverse VNC connections on TCP port list to indicate the port number.The default port number is 5500.

Logging: Use the following logging options to customize how the Viewer logs it’s activity in a text file:

  • Select Write log to a file to enable logging.

  • Select Browse to choose a location for the log file.

  • Use the Verbosity level list to specify how many details to write into the log file.

    The Level 0 causes the Viewer to log only the most important events. Level 12 produces the maximum debugging output.

Performance Tab

The following options are available in the Performance Tab:

Format and encodings: You can specify the following Format and Encodings options:

  • Select the appropriate graphics encoding from the Use encoding list.

    Encoding refers to how graphics are sent over the network. Encodings can differ depending on bandwidth and CPU usage. Use Hextile encoding on fast networks, and use Tight encoding over slow connections. Raw encoding means no compression at all.

  • Select Use 8-bit color to minimize the amount of pixel data sent over the network.

  • Select Allow CopyRect encoding if you want to save bandwidth when a screen area on the server changes its position.

    CopyRect sends coordinates instead of pixel arrays. You should usually select this option.

  • Select Enable caching to cache remote desktop screen data on the local device. This improves session performance because repetitive screen information is not resent. The Viewer uses disk space on the local device to save screen information.

  • Select Update screen incrementally to control how information is displayed when the screen is refreshed.

    When the remote desktop is rendered locally at the start of the session or when a full screen refresh is requested, this setting determines whether the screen is shown gradually or all at once.This setting is especially useful on slow links as an indication that the connection is alive.

Compression: The following options are available under Compression:

  • Select Custom compression level to specify a particular compression level instead of using server's default.

    The compression level ranges from level 1(Fast) to 9 (best). Higher compression levels result in greater compression ratios, but require more time to encode data. Use lower values on fast networks, and higher levels for slow connections.

    NOTE:The Custom Compression level is available only for Tight, Zlib, and ZlibHex encoding.

  • Select Allow JPEG compression if you want the JPEG scheme to allow more compression for Tight encoding of full-color data. However the image quality might degrade in particular screen areas.

    The JPEG compression level ranges from poor to best. Higher JPEG quality levels result in less compression but better image quality. The Tight encoder usually tries to use JPEG only where it does not cause major quality losses, so you can safely choose low quality levels.

  • Select Enable if you want the Viewer to enable dynamic bandwidth detection and optimize the session parameters accordingly.

  • Select Automatic to opt for pre configured settings for the bandwidth that is detected.

  • Select Manual to manually select the settings to be used for different bandwidth spectrums.

NOTE:The Enable Caching and Dynamic Bandwidth Optimization options are available only for a ZENworks 11 SP3 managed device that is remotely managed from a ZENworks 11 SP4 server.

Reset to Default: Click Reset to Default if you want to restore user-defined settings to the defaults.

Bandwidth: Use this setting to display bandwidth information.

Encoding: Select the encoding from the Encoding list.

Color Depth (in bpp): Select the pixel format from the Color Depth (in bpp) list.