Remote Control drivers used in ZENworks For Desktops 4.01.

(Last modified: 09Sep2005)

This document (10089810) is provided subject to the disclaimer at the end of this document.

fact

Novell ZENworks for Desktops 4.01 - ZfD 4.01

Novell Remote Control

symptom

Some incompatibility issues exist with older or non compliant Video drivers. 

See Microsoft tech link for more information.

Darpan implements the Mirror driver technology.  ( Darpan means mirror)

Drishti implements video driver interceptor (hook) technology ( DRishti means focus)

-If you choose mirror driver during install, this will install darpan.dll and darpan.sys in system32 and system32\drivers directory respectively.

-is also provided by default, for backward compatibility purposes.

A: If you had already installed Mirror driver and in case if you want to revert to Drishti do the following:

1) Run RmSetDrv.exe /hook from RMAgent Installed directory

2) Restart the machine

B: If you had already installed drishti.dll and if you experience any incompatibility issues do the following:

1) Run RmSetDrv.exe /unhook from RMAgent Installed directory

2) Restart the machine

 

-In future we plan to support this new Microsoft mirror driver technology only and not  use the Drishti.dll.   Most of the compatibility issues we had with  Drishti.dll

should be solved by the darpan.dll .

 - To test for the existence of either driver follow How do you tell if you have DRISHTI.DLL or DARPAN.DLL running as the Remote

 

Workstation goes into a reboot loop after installing ZFDAGENT.MSI on a w/s with two video cards (one onboard, one in a slot).

note

Frequently Asked Questions:

This FAQ contains the frequently asked question of rmsetdrv.exe. This FAQ will help you understand rmsetdrv.exe and its functionalities better.

1: What is Rmsetdrv.exe?

Rmsetdrv.exe file is a simple Remote Management executable, which runs on the Remote Management Agent machine. You can use rmsetdrv.exe to switch between the optimization driver functionality of Drishti and the Mirror driver.

 

2: What is the need of rmsetdrv.exe?
Customers may experience problems with Drishti or Mirror driver on their machines. Rmsetdrv.exe provides an easy way to switch to either optimization driver without installing Remote Management again.

 

3: Are there any command line options required for rmsetdrv.exe?        

Yes. Rmsetdrv.exe includes three command line options - /hook, /unhook, and /s.

 

Are the command line options case sensitive?

Yes. All the command line options are case sensitive.

 

Should I reboot the machine after executing rmsetdrv.exe with a particular command line option?
Yes. You must reboot the machine once, after rmsetdrv.exe completes executing a command line option.

 

What is the functionality of rmsetdrv.exe  /hook option?
The command line option “/hook” creates registry entries for Drishti to be operational. After the successful execution, restart the server to make Drishti operational. You will be prompted to restart the machine after rmsetdrv.exe completes its execution successfully.

 

What is the functionality of  rmsetdrv.exe /unhook option?
The command line option “/unhook” removes the registry entries created for Drishti.  After a successful execution, Drishti will not be operational after you restart the machine. You will be prompted to restart the machine after rmsetdrv.exe completes its execution successfully.

 

What is the functionality of rmsetdrv.exe /hook and /unhook with “/s” option?
The “/s” option executes rmsetdrv.exe with /hook or /unhook option in a silent way and restarts the machine automatically once after a successful execution.

 

Is it possible to run rmsetdrv.exe with /s option without “/hook” or  “/unhook” option?
No.  You need to either have “/hook” or “/unhook” in combination with “/s” option.

 

What happens on a machine where Remote Management Mirror driver was already installed and if I run rmsetdrv.exe with /hook option?
The traditional optimization driver, Drishti will be operational after rmsetdrv.exe executes completely and you restart the machine.

 

What happens to the already installed Mirror Driver after running rmsetdrv.exe with /hook option?
The Mirror driver install is intact and it will be simply non-functional once after the successful execution of rmsetdrv.exe with /hook option.

 

What happens to the already installed Mirror Driver after running rmsetdrv.exe with /unhook option?
The Mirror driver will be operational during the next Remote Control or Remote View session.  But, you must restart the machine at least once after rmsetdrv.exe executes successfully with the /unhook option.

 

Will there be any optimization driver available after running rmsetdrv.exe with /unhook option if Mirror driver was not selected previously during install?
No. None of the optimization drivers will be available after you restart the machine. The rmsetdrv.exe does not install the Mirror driver. You must have selected to install the Mirror driver during the Remote Management installation.

 

Is it possible to install Mirror driver using rmsetdrv.exe?
No. Rmsetdrv.exe does not install the Mirror driver. It is n.ot possible to switch over to the Mirror driver if it is not installed previously.

 

What is the need of rmsetdrv.exe?
Customers may experience problems with Drishti or Mirror driver on their machines. Rmsetdrv.exe provides an easy way to switch to either optimization driver without installing Remote Management again.

 

Are there any command line options required for rmsetdrv.exe?        

Yes. Rmsetdrv.exe includes three command line options - /hook, /unhook, and /s.

 

Are the command line options case sensitive?

Yes. All the command line options are case sensitive.

 

Should I reboot the machine after executing rmsetdrv.exe with a particular command line option?
Yes. You must reboot the machine once, after rmsetdrv.exe completes executing a command line option.

 

What is the functionality of rmsetdrv.exe  /hook option?
The command line option “/hook” creates registry entries for Drishti to be operational. After the successful execution, restart the server to make Drishti operational. You will be prompted to restart the machine after rmsetdrv.exe completes its execution successfully.

 

What is the functionality of  rmsetdrv.exe /unhook option?
The command line option “/unhook” removes the registry entries created for Drishti.  After a successful execution, Drishti will not be operational after you restart the machine. You will be prompted to restart the machine after rmsetdrv.exe completes its execution successfully.

 

What is the functionality of rmsetdrv.exe /hook and /unhook with “/s” option?
The “/s” option executes rmsetdrv.exe with /hook or /unhook option in a silent way and restarts the machine automatically once after a successful execution.

 

Is it possible to run rmsetdrv.exe with /s option without “/hook” or  “/unhook” option?
No.  You need to either have “/hook” or “/unhook” in combination with “/s” option.

 

What happens on a machine where Remote Management Mirror driver was already installed and if I run rmsetdrv.exe with /hook option?
The traditional optimization driver, Drishti will be operational after rmsetdrv.exe executes completely and you restart the machine.

 

What happens to the already installed Mirror Driver after running rmsetdrv.exe with /hook option?
The Mirror driver install is intact and it will be simply non-functional once after the successful execution of rmsetdrv.exe with /hook option.

 

What happens to the already installed Mirror Driver after running rmsetdrv.exe with /unhook option?
The Mirror driver will be operational during the next Remote Control or Remote View session.  But, you must restart the machine at least once after rmsetdrv.exe executes successfully with the /unhook option.

 

Will there be any optimization driver available after running rmsetdrv.exe with /unhook option if Mirror driver was not selected previously during install?
No. None of the optimization drivers will be available after you restart the machine. The rmsetdrv.exe does not install the Mirror driver. You must have selected to install the Mirror driver during the Remote Management installation.

 

Is it possible to install Mirror driver using rmsetdrv.exe?
No. Rmsetdrv.exe does not install the Mirror driver. It is not possible to switch over to the Mirror driver if it is not installed previously..

fix

To download this utility go to Utility.

For the workstations with two video cards: 

1.  Remove the current zfdagent (IR5) and then installed IR6 with the mirror driver, this works OK.  [Using the RMSETDRV.EXE utility with the /hook switch to switch back to drishti, reboots start happening again.]
2.  Without removing the existing zfdagent, using RMSETDRV.EXE to /unhook resolves the video issue (reboot loop).
3.  Upgrading an zfdagent IR5 existing install with IR6 installing the mirror driver caused the reboots. The mirror driver gets installed, but isn't active.  Using RMSETDRV/EXE to /unhook and use the mirror driver resolves the reboot issue.

Just installing the mirror driver (through the MSI selections) doesn't mean that it's active. Use the RMSETDRV.EXE utility to make the adjustments to use the mirror driver.

document

Document Title: Remote Control drivers used in ZENworks For Desktops 4.01.
Document ID: 10089810
Solution ID: NOVL94666
Creation Date: 22Dec2003
Modified Date: 09Sep2005
Novell Product Class:Management Products

disclaimer

The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.