|
3. Installing and Running iTivity iManager
The iManager provides the interface for administrators and support personnel to view and manage remote computers and servers. The iManager can be installed on the same computer as the iServer software or on a different computer either inside or outside the same firewall. You can obtain the installation program for the iManager from the Tridia web site. Other Installation Options: · You can automate installation on Windows. See Appendix A in this guide. · You can also create custom installers on the Tridia Support web site. See Appendix B. 3.1 System Requirements
Windows® 2000 Professional
|
|
iTivity iServer name |
The server DNS name. You can fill in either this name or the IP address. Note: When you enter either the DNS name or the IP address, iManager will look up and verify the other. If you enter both values, the program assumes your entries are correct and does not try to validate. |
|
IP address |
IP address for the iServer. |
|
List-View Port number |
The default value of 25800 is provided but can be edited if a different port is used on this iServer. |
|
Description |
Optional Description of the iServer displayed in the iManager. |
3. Click OK.
The iServer dialog is added and displayed in the left pane on the Main Window.
3.3.4 Connecting to an iServer
After adding an iServer to the list, use this procedure to connect to it and view attached computers.
1. In the left pane, highlight the iServer you want to connect to.
2. Click the Connect toolbar button, or click the Action Menu and choose Connect. You can also double-click on the iServer in the left pane.
The iManager displays messages indicating that it is building the tunnel and then waiting for authentication. The Authentication dialog is displayed.
3. Enter your User Name, Password, and Support Domain (if used) for the iServer and click OK.
Note: If your network uses Active Directory domains, you must enter the domain along with the user name, for example "MYDOMAIN\user name". Contact your network administrator if you need assistance.
The connection is established. The connected iServer changes in the left pane to a light green color.
3.3.5 Viewing an iAgent Computer
After successfully logging in to the iServer, you can view and control any iAgents currently connected to it. This can include systems running the Attended iAgent (which have an on-demand connection), and the Unattended iAgent (which have an always-on connection).
1. In the left pane, highlight the connected system to view.
2. Click the View toolbar button, or click the Action Menu and choose View.
3. If this is the first time your iManager is connecting to this computer, you may be asked to verify the requested encryption certificate fingerprint of the computer.
Note: For Windows iAgent systems, this option depends on how the Attended iAgent or Unattended iAgent was installed. This can be controlled by editing the HTML files used to download and install the iAgents from a web server. See Section 5.4, Editing the iAgent HTML Files.
If verifying the certificate number is required, the number can be obtained by right-clicking on the iTivity icon in the iAgent computer's system tray and selecting the Show Certificate Fingerprint option. Your computer retains the fingerprint in its cache for the next viewing session.
4. The iManager displays messages indicating that it is building the tunnel and then waiting for authentication. The Authentication dialog is then displayed.
Note: The authentication method and dialog depend on how the Attended iAgent or Unattended iAgent was installed. See Section 5.4, Editing the iAgent HTML Files. If connecting to a UNIX/Linux Unattended iAgent, see Section 8.4, Configuring the Unattended iAgent on UNIX/Linux.
4. Enter your User Name and Password. Optionally, enter the Reason for connecting. Click OK.
The login is processed and the screen image for the iAgent computer appears in a separate window on your screen. Also, a task with a lock icon appears in the system tray
5. Several options are available while viewing. You can access a viewer system menu in either of two ways:
· Click on the lock icon in the upper-left hand corner of the session window OR
· Right-click on the task in the system tray.
For complete information on the menu options available, see Section 4.4, iAgent System Tray Menu.
3.3.6 Ending the Remote Session
To end the remote viewing session:
Right-click on the lock icon in the upper-left hand corner of
the session window to open the viewer system menu and select Close.
OR
From the iManager, select the End Session option from the toolbar.
3.4 Customizing iManager Startup with Command
Line Shortcuts
To launch iManager, you normally click on a desktop shortcut or select Start > Programs > iTivity > iManager.
You can also launch iManager with specific options from the Windows Command Prompt, and you can customize startup by creating Windows shortcuts with these command line options.
3.4.1 Launch iManager in Diagnostic Mode
In this mode, iManager is launched with debugging dialogs and a console window to review error log output.
Command parameter: -x
Command Line Example:
C:\Program
Files\iTivity\bin\starter.exe -x
Windows Shortcut Example:
"C:\Program
Files\iTivity\bin\starter.exe" -x
Note: When defining a Windows shortcut, be sure to place the path and exe filename in double quotes and the parameters outside of the quotes.
3.4.2 Specify the iServer List File or Scan File
This command instructs iManager to load a specific NCN file containing one or more iServers to list for connection.
Command parameter: -s <ncn-file
specification>
Command Line Example:
C:\Program
Files\iTivity\bin\starter.exe -s Z:\shared\itivity\iserver.ncn
Windows Shortcut Example:
"C:\Program
Files\iTivity\bin\starter.exe" -s Z:\shared\itivity\iserver.ncn
3.4.3 Connect Automatically to a Specific iServer
This command automatically connects to a specified iServer when iManager launches. You can specify the hostname or IP address and an optional port number (default is 25800).
Command parameter: -iserver
hostname/ipaddress[:port number]
Windows Shortcut Example: "C:\Program Files\iTivity\bin\starter.exe" -iserver myiserver.myacme.com:25800
3.4.4 Connect Automatically to a Specific iAgent Using Session Name
This command connects automatically to a specified iAgent on the iServer based on the system name. You need to enter the session id for the iAgent, which is found on the iAgent's "About" dialog.
This option is only valid when used in conjunction with the -iserver option above.
Command parameter: -session_name
host name
Windows Shortcut Example:
"C:\Program
Files\iTivity\bin\starter.exe" -iserver myiserver.myacme.com -session_name
agent.myacme.com
3.4.5 Connect Automatically to a Specific iAgent Using Session Number
This command is similar to the one above, except it uses the session number instead of the name.
This option is only valid when used in conjunction with the -iserver option above.
Command parameter: -session_name sessionID
Windows Shortcut Example:
"C:\Program
Files\iTivity\bin\starter.exe" -iserver myiserver.myacme.com -sessionID
10000007
3.4.6 Connect Directly to a Specific iAgent Without Intervening User Interface
These parameters can be used to connect directly to a specific iAgent session through the iManager, but without displaying intervening windows or dialogs.
This allows you to open a shortcut and directly begin viewing the iAgent system, or to call the iAgent session from within another program.
These parameters can be combined in a single command line or shortcut. All are optional depending on how you need to connect to iManager and the iAgent session. Except for -nologo, all the parameters must be preceded by the -iserver parameter.
Parameter |
Purpose |
|
-isuid user-name-at-iserver |
Specify the user name valid on the iServer for the automatic connection |
|
-ispwd password-at-iserver |
Specify the password matching the valid iServer user for the automatic connection. |
|
-issdmain support-domain |
Specify the support domain, if any, matching the valid iServer user for the automatic connection. |
|
-isnodiag |
Do not display the iServer authentication dialog during automatic connection. |
|
-suid user-name-at-iagent |
Specify the user name valid on the iAgent for the automatic connection. |
|
-spwd password-at-iagent |
Specify the password matching the valid iAgent user for the automatic connection. |
|
-snodiag |
Do not display the iAgent authentication dialog during automatic connection. |
|
-nologo |
Do not display the iManager logo during startup. Suppresses the iManager title and copyright logo display during startup. |
|
-nogui |
Do not display the standard iManager user interface. Supresses the standard iManager user interface. This is useful only when the automatic connections options are specified to connect immediately to a specific iServer and then to a specific iAgent |
Examples
This shortcut launches iManager and connects immediately to the named iServer and iAgent (without displaying authentication dialogs) for user TJones, password TJ90786. The password is the same for the iServer and iAgent.
"C:\Program
Files\iTivity\bin\starter.exe" -iserver myiserver.myacme.com -session_name
agent.myacme.com -isuid TJones -ispwd TJ90786 -isnodiag -suid TJones -spwd
TJ90786 -snodiag
This shortcut does the same as the above, but launches iManager with no logo or UI:
"C:\Program
Files\iTivity\bin\starter.exe" -iserver myiserver.myacme.com -session_name
agent.myacme.com -isuid TJones -ispwd TJ90786 -isnodiag -suid TJones -spwd
TJ90786 -nologo -nogui -snodiag
 |
Table of Contents |  |
Copyright © 2004 - 2009, Tridia
Corporation
Copyright and License Information