iTivity™ User Guide

3. Installing and Running iTivity iManager
 
Previous Chapter Table of Contents Next Chapter

3.1 System Requirements
3.2 Installation on Windows
3.3 iTivity iManager Quick Start

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 10
Windows 8.1
Windows 8
Windows 7
Windows Vista
Windows XP
Windows 2012 Server
Windows 2008 Server
Windows 2003 Server

.         500MHz Pentium IV or higher processor

.         256 MB of RAM

.         200 MB of available hard disk space

.         VGA or higher resolution monitor

Runtime Resource Requirements

.         Approximately 25MB to 50MB of virtual memory.

3.2  Installation on Windows

This section contains instruction for installing the iManager on a Windows system from a Tridia distribution MSI file.

1.       Download the distribution MSI file for the iManager from the Tridia FTP site. After saving this file to disk, right-click the file and select Install.

The following Welcome dialog is displayed:

2.       Click Next.

The License Agreement page is displayed.

3.       Scroll Down to view the entire agreement. Then click "I accept the terms in the license agreement" to indicate your acceptance. Click Next.

The following dialog is displayed.

4.       Click the Change button to change the Destination Folder if desired. Otherwise, click Next to continue.

The Application Configuration dialog is displayed.

The System Name refers to the name of the computer where you are installing the iManager software. Typically, this is your desktop workstation.

The Description should be a short description of the computer purpose or location. This field is optional.

The Import Configuration Settings from URL may refer to a web accessible registry settings file. This setting is also optional, most customers will leave it blank. This "Reg" file, if any, is stored on your web server to allow for extended configuration of registry settings as the installer is finishing.

5.       After updating the fields as needed, click Next.

The Ready To Install dialog is displayed.

Click Install to continue.

6.       Next the installer prompts for elevated privileges needed to perform the installation.

Click Yes to continue with the installation.

The installer displays a progress bar depicting the status of the installation and configuration.

8.       The following dialog is displayed when the installer finishes.

9.   The installation is now complete. Click Finish to exit.

3.3  iManager Quick Start

This section provides instructions for the tasks you need to complete to connect to an iServer and begin viewing remote computers.

For complete instructions for all of the features and options in the iManager, see Chapter 4.

3.3.1 Launching the iManager

To open the iManager, click on the shortcut icon you may have installed on your desktop during installation, or select Start > All Programs > iTivity > iManager > iTivity iManager.

The main window is displayed.

3.3.2  iManager Main Window

The iManager main window contains menu and tool bars and a dual-pane list area. The left pane displays the available iServers and the computers and servers that are currently connected to each iServer. The right pane shows detailed information about the computers connected to the currently highlighted iServer.

3.3.3  Adding an iServer

When you first install iManager, the list area is blank. You must add your iServers to the list in order to display them in the left pane.

1.       Click the Edit Menu and choose Add iTivity iServer.

The new iTivity iServer dialog is displayed.

2.       Fill in the information.

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 > All Programs > iTivity > iManager > 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

 

 

 

Previous Chapter Table of Contents Next Chapter

Copyright © 2017 - 2023, iTivity Corporation
Copyright © 2004 - 2016, Tridia Corporation
Copyright and License Information

webmaster@tridia.com
sales@tridia.com
Technical Support