Review the following:
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
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
link is displayed. Click this link to upgrade the version of the viewer installed on the device.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:
For 32-bit SLES11 or SLED 11 devices, install glitz-0.5.6-190.1.i586.rpm
For 64-bit SLES 11 or SLED 11 devices, install glitz-0.5.6-190.1.x86_64.rpm followed by glitz-32bit-0.5.6-190.1.x86_64.rpm
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.
In ZENworks Control Center, click
.In the left navigation pane, click
.In the left navigation pane of the ZENworks Download page, click
.Click
to view the viewer MSI files.Click
.(Conditional) If you have launched ZENworks Control Center by using Internet Explorer, do one of the following:
Click
to install the viewer.Click
to save the file to a temporary location. Double-click the file to install the viewer.(Conditional) If you have launched ZENworks Control Center by using Firefox, click
to save the file to a temporary location, then double-click the file to install the viewer.In ZENworks Control Center, click
.In the left navigation pane, click
.In the left navigation pane of the ZENworks Download page, click
.Click
to view the viewer MSI files.Select one of the following actions:
For an RHEL 5, 32-bit device, click
For an RHEL 5, 64-bit device, click
For an RHEL 6, 32-bit device, click
For an RHEL 6, 64-bit device, click
For a SLES 11, 32-bit device, click
For a SLES 11, 64-bit device, click
Decide whether to immediately install the viewer or save the viewer RPM file to install it later.
To immediately install the viewer, click
to open the Remote Management Viewer with zen-installer, specify the root password, then click .To save the viewer RPM file to the default download directory so that you can install it later, click
. To install the RPM, do one of the following:Click the viewer RPM file, specify the root password, then click
.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:
Uninstall the 64-bit Remote Management Viewer RPM, if it is already installed.
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.
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.
Log in to ZENworks Control Center.
Click
In the left navigation pane, click
.Click
in the left navigation pane of the ZENworks Download page.In the Remote Management tab, click
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.
If you are using Firefox to launch the Remote Management viewer, copy npnzrPlugin.dll from the directory to which the msi was extracted, to the Mozilla Firefox\plugins directory.
or
If you are using Internet Explorer to launch the Remote Management Viewer, import the following registry files.
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.2.0.16054" [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.2.0.16054" [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.2.0.16054] [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.2.0.16054\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.2.0.16054"
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.2.0.16054" [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.2.0.16054" [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.2.0.16054" [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.2.0.16054] [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\nzrAXC.nzrAXCtrl.11.2.0.16054\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.2.0.16054"
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.
If you are performing a remote management operation on a Windows managed device on which an earlier version of the Remote Management Viewer is already installed, the
link is displayed in ZENworks Control Center. Click this link to upgrade the version of the viewer installed on the device.To upgrade the Remote Management viewer on a Linux device from Novell ZENworks 10 Configuration Management SP3 (10.3) to Novell ZENworks 11Configuration 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 Section 2.3.1, Installing the Remote Management Viewer.
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:
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:
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 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 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 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 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:
The default port for the proxy is 5750. This option is not yet supported on Linux. |
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. |