3. Installing and Running the Console

The iTivity console provides the interface for administrators and support personnel to view and manage remote computers and servers. The console can be installed on the same computer as the hyperserver software or on a different computer either inside or outside the same firewall.

You can obtain the installation program for the console from the iTivity 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 iTivity Support web site. See Appendix B.

3.1 System Requirements

Windows 10 Windows 8.1 Windows 8 Windows 7 Windows Vista Windows XP

. 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 console on a Windows system from a iTivity distribution MSI file.

1. Download the distribution MSI file for the console from the iTivity website. 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 console 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.2.1 Installing FileZilla

iTivity uses FileZilla to perform file transfers to and from the Windows-based console and the Windows-based agents. Due to licensing requirements, you must install FileZilla separately. Once FileZilla is installed, iTivity will recognize it and launch it automatically to perform file transfers.

Here are the steps for installing FileZilla.

Download FileZilla

Go to the website https://filezilla-project.org

Select Download FileZilla Client

Click on the Download FileZilla Client link.

Select Download FileZilla Client for Windows (32bit)

Click on the Download FileZilla Client for Windows (32bit) link to start the download.

Run the FileZilla Install Program

Once the FileZilla download is complete, go to the Downloads directory and run the FileZilla installation program by double-clicking it.

Accept the License Agreement

Accept the terms of the License Agreement by clicking [I Agree].

Choose Installation Options

Select your preferred installation option and click [Next>]. The default (Anyone) is recommended.

Choose Components

Select the default components by clicking [Next >].

Choose Install Location

You make specify the folder in which to install FileZilla. The default is recommended. Complete this step by clicking [Next >].

Choose Start Menu Folder

Select the default Start Menu Folder by clicking [Install].

Complete FileZilla Installation

Complete the FileZilla installation by clicking [Finish].

FileZilla is now installed and ready for use by iTivity. If you selected the Start FileZilla now option in the previous step, FileZilla will start. It is not necessary for FileZilla to be running for iTivity to use it.

3.3 Installation on Linux

Use the following instructions to download and install the console on Linux. Filenames and some command names will vary depending on the exact version you are installing.

1. Download the console Linux distribution file from the iTivity website.

Example Filename: linux-console.tar

Note: Many popular Window's based ZIP file utilities do not properly extract the contents of our distribution files. Please do not attempt to use them with any of the distribution files.

2. Place the downloaded file in your home directory where you want to install the console.

Example: /home/username/where username is your actual user name

3. Log on as the root user or issue the su command.

4. Change to the /tmp directory.

cd /tmp [Enter]

6. Extract the distribution (*.tar) file:

tar xvf /home/username/<filename>

7. Run the install console script.

./install-console

8. Files are extracted and the installation completes.

3.4 Console Quick Start

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

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

3.4.1 Launching the Console

To open the console, 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.4.2 Console Main Window

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

3.4.3 Adding a Hyperserver

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

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

The new iTivity Hyperserver 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, the console 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 hyperserver.

List-View Port number

The default value of 25800 is provided but can be edited if a different port is used on this hyperserver.

Description

Optional Description of the hyperserver displayed in the console.

3. Click OK.

The hyperserver dialog is added and displayed in the left pane on the Main Window.

3.4.4 Connecting to an Hyperserver

After adding a hyperserver to the list, use this procedure to connect to it and view attached computers.

1. In the left pane, highlight the hyperserver 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 hyperserver in the left pane.

The console 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 hyperserver 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 hyperserver changes in the left pane to a light green color.

3.4.5 Viewing an Agent Computer

After successfully logging in to the hyperserver, you can view and control any agents currently connected to it. This can include systems running the attended agent (which have an on-demand connection), and the unattended agent (which have an always-on connection).

1. 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 console is connecting to this computer, you may be asked to verify the requested encryption certificate fingerprint of the computer.

Note: For Windows agent systems, this option depends on how the attended agent or unattended agent was installed. This can be controlled by editing the HTML files used to download and install the agents from a web server. See Section 5.4, Editing the agent HTML Files.

If verifying the certificate number is required, the number can be obtained by right-clicking on the iTivity icon in the agent 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 console 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 agent or unattended agent was installed. See Section 5.4, Editing the agent HTML Files. If connecting to a Linux unattended agent, see Section 8.4, Configuring the unattended agent on 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 agent 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, Agent 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 console, select the End Session option from the toolbar.

3.5 Customizing the Console Startup with Command Line Shortcuts

To launch consoler, you normally click on a desktop shortcut or select Start > All Programs > iTivity > iManager > iTivity iManager.

You can also launch the console with specific options from the Windows Command Prompt, and you can customize startup by creating Windows shortcuts with these command line options.

3.5.1 Launch the Console in Diagnostic Mode

In this mode,the console 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.5.2 Specify the Hyperserver List File or Scan File

This command instructs the console to load a specific NCN file containing one or more hyperservers 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.5.3 Connect Automatically to a Specific Hyperserver

This command automatically connects to a specified hyperserver when the console 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.5.4 Connect Automatically to a Specific Agent Using Session Name

This command connects automatically to a specified agent on the hyperserver based on the system name. You need to enter the session id for the agent, which is found on the agent'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.5.5 Connect Automatically to a Specific Agent 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.5.6 Connect Directly to a Specific Agent Without Intervening User Interface

These parameters can be used to connect directly to a specific agent session through the console, but without displaying intervening windows or dialogs.

This allows you to open a shortcut and directly begin viewing the agent system, or to call the agent 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 console and the agent 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 hyperserver for the automatic connection

-ispwd password-at-iserver

Specify the password matching the valid hyperserver user for the automatic connection.

-issdmain support-domain

Specify the support domain, if any, matching the valid hyperserver user for the automatic connection.

-isnodiag

Do not display the hyperserver authentication dialog during automatic connection.

-suid user-name-at-iagent

Specify the user name valid on the agent for the automatic connection.

-spwd password-at-iagent

Specify the password matching the valid agent user for the automatic connection.

-snodiag

Do not display the agent authentication dialog during automatic connection.

-nologo

Do not display the console logo during startup. Suppresses the console title and copyright logo display during startup.

-nogui

Do not display the standard console user interface. Supresses the standard console user interface. This is useful only when the automatic connections options are specified to connect immediately to a specific hyperserver and then to a specific agent

Examples

This shortcut launches the console and connects immediately to the namedhyperserver and agent (without displaying authentication dialogs) for user TJones, password TJ90786. The password is the same for the hyperserver and agent.

"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 the console 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

3.6 iTivity Product Support

Product support is available from iTivity by web site or email:

Copyright © 2004 - 2019, iTivity Corporation Copyright and License Information