Starting Remote Management Operations Without Using ConsoleOne

The desktop4.exe application that ships with ZfD 4 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 ZfD 4 Workstation Inventory ConsoleOne snap-ins. This automatically installs desktop4.exe. desktop4.exe is located in the consoleone_installation_directory\consoleone_version\bin directory.
• Copy and extract the desktop.zip file from the \desktop directory in the ZENworks for Desktops 4 Companion CD. desktop4.exe is located in the \bin directory.

Before you can run desktop4.exe, you must perform the following tasks.

1. If you have deployed Directory-Based Remote Management, you must log in as an administrator into the Novell eDirectory tree where you want to perform the Remote Management operations.

2. 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: If you have deployed Password-Based Remote Management, enter PASSWORD. For Directory-Based Remote Management, enter DS.

   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

3. For Directory-Based Remote Management, ensure 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.

  To perform File Transfer, enter -c"File Transfer"

  To perform Diagnostics, enter -c"Diagnostics"

  To perform Remote Control, enter -c"RemoteControl"

  To perform Remote View, enter -c"RemoteView"

  To perform Remote Execute, enter -c"Remote Execute"

  To perform Remote Wake-up, enter -c"Remote Wakeup"

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 ensure 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.

1. 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 "Remote Control" is the Remote Management operation to be performed on the managed workstation.

2. Run the .bat file.

Depending upon the operation that you have specified, the Remote Management session will start.

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 Viewing Inventory Information Without Using ConsoleOne.