The desktop4.exe application that ships with ZENworks 7 Desktop Management allows you to start the following Remote Management operations without using ConsoleOne: Remote Control, Remote View, Remote Execute, File Transfer, Remote Wake Up, and Remote Diagnostics.
You can install desktop4.exe using either of the following methods:
Install the ZENworks 7 Desktop Management ConsoleOne snap-ins. This automatically installs desktop4.exe. Desktop4.exe is located in the ConsoleOne_installation_directory\consoleone_version\bin directory.
From the desktop directory in the ZENworks 7 Companion 2 CD, extract desktop.zip to a temporary directory on your machine. Copy the contents of temporary_directory\desktop to the ConsoleOne_installation_location directory.
Before you can run desktop4.exe, you must perform the following tasks.
For Password-Based Remote Management, enter the following details in the ConsoleOne_installation_directory\bin\remagent.ini file:
Agent IP address: IP address of the managed workstation.
Agent Password: Remote Management Agent password.
Authentication Mode: PASSWORD.
Protocol: Enter TCPIP.
A sample remagent.ini file is as follows:
# Novell Inc.
AGENT_IPADDRESS=164.99.149.37
AGENT_PASSWORD=novell
AUTHENTICATION_MODE=PASSWORD
PROTOCOL=TCPIP
If you want to perform the Remote Management operation using the Directory mode of authentication, you must log into the eDirectory tree to which the Managed workstation is imported. For Directory-Based Remote Management, make sure that the AUTHENTICATION_MODE in ConsoleOne_installation_directory\bin\remagent.ini file is DS.
You can run desktop4.exe from the MS-DOS prompt or by using a .bat file. You must specify valid values for the following parameters
-w: Fully qualified Distinguished Name (DN) of the managed workstation
-n: eDirectory tree name
-c: Remote Management operation to be performed on the managed workstation.
-x: Remote Execute operation command to be performed on the managed workstation.
For example, if you want to launch notepad application without having to ask the remote operator for entering a command to execute, at the MS-DOS prompt enter:
Desktop4 -w"CN=WINXP-R1B164_99_151_48.OU=WsProm.O=novell" -n"INDYPROM-TREE" -c"Remote Execute" -x"notepad"
For example, you can perform Remote control using either of the following methods:
At the MS-DOS prompt, enter the following command:
Desktop4 -w"CN=WINXP-R1B164_99_151_48.OU=WsProm.O=novell" -n"INDYPROM-TREE" -c"RemoteControl"
where Desktop4 is the name of the application; "CN=WINXP-R1B164_99_151_48.OU=WsProm.O=novell" is the DN of the managed workstation; "INDYPROM-TREE" is the eDirectory tree name; and “Remote Control” is the Remote Management operation to be performed on the managed workstation.
NOTE:You need to make sure that the remagent.ini file is updated with the specific details before you execute the desktop4.exe at the MS-DOS prompt.
Using a .bat file.
Create a .bat file in the same directory as desktop4.exe with the following contents:
Desktop4 -w"CN=WINXP-R1B164_99_151_48.OU=WsProm.O=novell" -n"INDYPROM-TREE" -c"RemoteControl"
where Desktop4 is the name of the application; “CN=WINXP-R1B164_99_151_48.OU=WsProm.O=novell” is the DN of the managed workstation; “INDYPROM-TREE” is the tree name; and “RemoteControl” is the Remote Management operation to be performed on the managed workstation.
Run the .bat file.
Depending upon the operation that you have specified, the Remote Management session starts.
Desktop4.exe is a back-end utility that can be leveraged by developing user-friendly interface to launch desktop4.exe.
Using desktop4.exe, you can also view Inventory information of the inventoried workstations. For more information, see Section 77.3, Viewing Inventory Information Without Using ConsoleOne.
You can launch Remote Management from desktop4.exe in both Password-Based or Directory-Based authentication mode.
To launch Remote Management from desktop4.exe:
Run the desktop.exe, then specify -w.
Populate the IP address of the managed workstation in which the user has logged in the ConsoleOne_installation_directory\bin\remagent.ini file.