User's Guide

IRIS - INTOUCH Remote Interactive Supervisor was developed
and is supported by Touch Technologies, Inc.
IRIS is distributed by Touch Technologies, Inc.

NOTICE

Touch Technologies, Inc. (TTI) has prepared this publication for use by TTI personnel, licensees, and customers. This information is protected by copyright. No part of this document may be photocopied, reproduced or translated to another language without prior written consent of Touch Technologies, Incorporated.

TTI believes the information described in this publication is accurate and reliable; much care has been taken in its preparation. However, no responsibility, financial or otherwise, is accepted for any consequences arising out of the use of this material.

The information contained herein is subject to change without notice and should not be construed as a commitment by Touch Technologies, Inc.

The following are trademarks of Touch Technologies, Inc., and may be used only to describe products of Touch Technologies, Inc.:

DYNAMIC TAPE ACCELERATOR INTOUCH 4GL DYNAMIC LOAD BALANCER PLUS REMOTE DEVICE FACILITY

The following are trademarks of Digital Equipment Corporation, and may be used only to describe products of Digital Equipment Corporation:

DBMS DCL DECNET OpenVMS RDB RMS VAX

Revised April 23, 1998 for V1.0

Copyright ©1998-1999 Touch Technologies, Inc.

Contents

Index

IRIS - INTOUCH Remote Interactive Supervisor is a fully-interactive network-wide session observation tool. Hosted on an OpenVMS system, IRIS lets you view and interact with user sessions on any system on your network --- REGARDLESS OF THE PLATFORM.

With IRIS you can observe Telnet, RLOGIN, LAT, FTP, and URL accesses, seven days a week, 24 hours a day.

Once a user session is defined, IRIS enables you to:

• Display the session in real-time
• Identify the user and where they are on the system
• Take a screen snapshot
• Record the session for later review

Purpose

The purpose of this manual is to provide:

• An explanation of what IRIS is and how it works
• Instructions for installing and implementing IRIS
• Examples of how to use IRIS
• Report generation instructions

Audience

This document is intended for use by the system administrator, network manager, or other technical personnel.

IF YOU HAVE NO SYSTEM MANAGER OR YOU HAVE QUESTIONS ABOUT INSTALLING IRIS, PLEASE CALL TOUCH TECHNOLOGIES, INC., AT:

(800) 525-2527 toll free within the U.S. and Canada

(619) 566-3603 elsewhere

1.1 IRIS - INTOUCH Remote Interactive Supervisor

1.1.1 Network and System Impact

1.2 Network-Wide Observation

IRIS - INTOUCH Remote Interactive Supervisor lets you see any user session anywhere on your network regardless of the platform! This makes IRIS a tremendously valuable resource, with countless applications.

With IRIS, you can observe any user activity on your network, seven days a week, 24 hours a day, at the keystroke level. Whether the user is coming from inside or from outside your network, IRIS lets you observe and interact with the user session in real-time.

1.2.1 How IRIS Does Its Job

1.2.2 IRIS Is Inexpensive and Highly Effective

• Provide both real-time and retrospective analysis
• Track and analyze historical session details

With IRIS - INTOUCH Remote Interactive Supervisor, the network manager finally has a tool that allows the interactive observation and recording of any user session --- down to the keystroke level --- in real-time!

1.3 About This Manual

• Chapters that explain how to get started and use IRIS. These chapters provide examples for new users.
• Chapters that describe in detail what each menu item does, and how and what data to enter at the prompts.
• Chapters on various topics, such as Transport Agents, etc.
• Appendix and glossary sections.

IRIS can be installed on any:

• Alpha computer running under OpenVMS version 6.1 or greater

The following items are included with this installation package:

• An IRIS CD-ROM, .ZIP file, or distribution tape
• An IRIS License PAK
• This IRIS user guide

You should register and load the License PAK before you start the IRIS installation.

To register a license under OpenVMS, first log onto the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration:

1. Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK.
2. At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information.

2.2 Install Instructions

1. Log onto the SYSTEM account:

   Username: SYSTEM Password: (enter your system password)

2. Create the IRIS directory:

   $ CREATE/DIRECTORY SYS$SYSDEVICE:[TTI_IRIS]

   Note IRIS can be loaded into any directory on any disk ( e.g., $1$WORK:[IRIS] )

   
   
3. Enter the IRIS directory:

   $ SET DEFAULT SYS$SYSDEVICE:[TTI_IRIS]

4. Verify that you are in the new directory. You should see the message "No files found."

   $ DIRECTORY No files found.

5. Transfering IRIS from the web site:

   Note IRIS.BCK is a 20MB+ file. The transfer could take 30-60 minutes or more.

   
   

   (Using the Netscape browser for OpenVMS) http://www.ttinet.com/iris/ (choose DOWNLOAD. After the download...) $ SET FILE IRIS.BCK/ATTR=(RFM:FIX,LRL:8192) $ BACKUP/LOG IRIS.BCK/SAVE SYS$SYSDEVICE:[TTI_IRIS]*.*/NEW_VERSION $ DELETE IRIS.BCK;

   
   

6. Load instructions for CD-ROM:
   1. Put the IRIS distribution CD-ROM into your computer's CD drive.
      
   2. Make the CD drive available.

      $ ALLOCATE MKA0: $ MOUNT MKA0:/OVERRIDE=ID Volume is write locked IRIS mounted on _MKA0:

      Note MKA0 may have to be replaced with the appropriate CD identifier for your system.

      
      
   3. Transfer IRIS to disk using OpenVMS BACKUP.

      $ BACKUP/LOG MKA0:[IRIS.KIT]*.*/SAVE *.*/NEW_VERSION $ DISMOUNT MKA0: $ DEALLOCATE MKA0:

      
      The transfer will take about 2 minutes. As IRIS is transferred to disk, you will see a list of the files being transferred.
      

7. Load instructions for tape:
   1. Put the IRIS distribution tape on your computer's tape drive.
      
   2. Make the tape drive available.

      $ ALLOCATE MSA0: $ MOUNT MSA0:/FOREIGN Volume is write locked IRIS mounted on _MSA0:

      Note MSA0 may have to be replaced with the appropriate magtape identifier for your system.

      
      
   3. Transfer IRIS to disk using OpenVMS BACKUP.

      $ BACKUP/LOG MSA0:IRIS *.*/NEW_VERSION $ DISMOUNT MSA0: $ DEALLOCATE MSA0:

      
      The transfer will take about 2 minutes. As IRIS is transferred to disk, you will see a list of the files being transferred.
      

   
   
8. Activate IRIS background processes interactively by executing the following command:

   $ @SYS$SYSDEVICE:[TTI_IRIS]IRIS_STARTUP

9. Add the above command to your system startup command procedure. Adding the command to the system startup command procedure will cause IRIS to start up each time the system is booted.
   
10. IRIS has now been installed on your computer.

Starting up and using IRIS - INTOUCH Remote Interactive Supervisor is very simple. This chapter explains how to start up IRIS and get to the main menu.

3.1 Initialization

$ @tti_iris:iris_manager

To get you started using IRIS, this chapter provides step-by-step examples of how to use many of the menu items and features. You will also learn how to display session information and watch sessions.

As you proceed through the examples, you will see references to various sections of this manual. For example, at some step you might be told to select "ALL" as the sort option and there will be a reference to another section. If you look at that section, you will see other available sort options that you can try later.

4.1 The IRIS Main Menu

Example 4-1 IRIS Main Menu

+--------------IRIS - INTOUCH Remote Interactive Supervisor V1.0---------------+ | Sessions Status Reports Maintenance General Advanced Exit | ++------Sessions-------+-------------------------------------------------------+ | Active | | Playback | | Archive Playback | +---------------------+ EXIT = Exit IRIS \ = Back HELP = Help

IRIS is now ready for you to select menu items and proceed.

Using the Mouse to Execute Menu Items

Use the mouse to locate the menu item you want to run, and then click once to execute that menu item.

Using the Help System

If you want to see what each main menu item does, use the mouse, or the arrow keys, to highlight the menu item. You can also type the menu item name --- you need to enter only as many characters of the item name as is necessary to distinguish the item from all other items on the menu. When you have selected a menu item, press the [Help] key. For example, to see what Reports does, highlight this menu item and press [Help]. There is online help for all menu items and prompts (see Section 5.5, Online Help System).

4.2 Example: Displaying Active Sessions

Here are the steps:

1. Using either the mouse or arrow keys, select the Sessions option on the IRIS main menu. The Sessions submenu is displayed and looks like this:
   

   +--------------IRIS - INTOUCH Remote Interactive Supervisor V1.0---------------+ | Sessions Status Reports Maintenance General Advanced Exit | ++------Sessions-------+-------------------------------------------------------+ | Active | | Playback | | Archive Playback | +---------------------+

   
   

2. Use the mouse, or arrow keys, to select Active on the Sessions menu.
   

   +------Sessions-------+ | Active | | Playback | | Archive Playback | +---------------------+

   
   

3. The Active menu is displayed. Select All to display all active sessions.
   

   +Select Sessions+ | All | | User names | | Locations | |---------------| | Exit | +---------------+

   
   

4. IRIS Manager displays a list of the active sessions on your network. The display looks like this:
   

   +--------------------------------Active Sessions-------------------------------+ | Sessions Clear Exit | +------------------------------------------------------------------------------+ +----------------28 active sessions as of 14-Feb-1999 09:32:55-----------------+ | Refresh | | Next... | | | | Source Location Destination Loc Type User Last Cnct Ins Status | | LAT 2.22:17 LAT 17.3 INTER ALLEN 09:29 1:24 | | TTITEST.COM TTITEST.COM INTER DAN 09:31 11:13 | | LAT 2.22:97 LAT 97.1 INTER DEBBIE 09:23 1:30 | | IP 204.212.151.105:1634 CAST.TTINET.COM INTER SYSTEM 09:31 15:55 | | LAT 31.144:7 LAT 7.2 INTER HENRY 09:31 1:28 | | LAT 1.182:1 LAT 1.1 INTER JEANNIE 09:31 0:40 | | ASA.COMNET.COM TR.TTINET.COM INTER GWEN 09:31 1:04 | | LAT 1.80:1 LAT 1.1 INTER GWEN 09:25 1:04 | | LAT 2.22:49 LAT 49.4 INTER MSR 09:31 1:13 | | LAT 1.80:2 LAT 2.2 INTER SUE 09:31 2:46 | | CRL25.CRL.COM TR.TTINET.COM INTER SUE 09:29 2:45 | | . . . | +------------------------------------------------------------------------------+ Sessions watched: 0 EXIT = Exit IRIS \ = Back HELP = Help

   
   Each line is an active session and shows: the source and destination locations, login type, user name, time of last activity (keystroke), elapsed connect time, watch and/or recording status.
   If there are more active sessions than can be displayed on the screen, the choices Next... and/or Previous... will appear. Select either one of these in order to display the next screen or display the previous screen, respectively.

5. Select Refresh to get updated session information. The screen clears and an updated active sessions list is displayed.
6. When you have finished reviewing the active sessions list, you can exit by selecting the Exit option at the top of the screen. This takes you back to the Select Sessions menu where you can again select Exit and get back to the main Sessions menu.

You now know how to display a list of all the active sessions.

The next example shows how to select and watch individual sessions.

4.3 Example: Watching an Active Session

Here are the steps:

1. Before you can select an active session to watch, you must first display a list of the active sessions --- as was done in the previous example. Display All active sessions or use one of the other Active menu options.
   

   +-----------------------------------Active Sessions----------------------------+ | Sessions Clear Exit | +------------------------------------------------------------------------------+ +----------------28 active sessions as of 14-Feb-1999 09:32:55-----------------+ | Refresh | | | | Source Location Destination Loc Type User Last Cnct Ins Status | | LAT 2.22:17 LAT 17.3 INTER ALLEN 09:29 1:24 | | TTITEST.COM TTITEST.COM INTER DAN 09:31 11:13 | | LAT 2.22:97 LAT 97.1 INTER DEBBIE 09:23 1:30 | | IP 204.212.151.105:1634 CAST.TTINET.COM INTER SYSTEM 09:31 15:55 | | LAT 31.144:7 LAT 7.2 INTER HENRY 09:31 1:28 | | LAT 1.182:1 LAT 1.1 INTER JEANNIE 09:31 0:40 | | . . . | +------------------------------------------------------------------------------+

   
   

2. To get more information and watch a session, use the mouse, or arrow keys, to select one of the active sessions on the list. In the following example, ALLEN is selected.
   

   +-----------------------------------Active Sessions----------------------------+ | Sessions Clear Exit | +------------------------------------------------------------------------------+ +----------------28 active sessions as of 14-Feb-1999 09:32:55-----------------+ | Refresh | | | | Source Location Destination Loc Type User Last Cnct Ins Status | | LAT 2.22:17 LAT 17.3 INTER ALLEN 09:29 1:24 | | TTITEST.COM TTITEST.COM INTER DAN 09:31 11:11 | | LAT 2.22:97 LAT 97.1 INTER DEBBIE 09:23 1:30 | | IP 204.212.151.105:1634 CAST.TTINET.COM INTER SYSTEM 09:31 15:55 | | LAT 31.144:7 LAT 7.2 INTER HENRY 09:31 1:28 | | LAT 1.182:1 LAT 1.1 INTER JEANNIE 09:31 0:40 | | . . . | +------------------------------------------------------------------------------+

   
   

3. The screen clears and more detailed information about the selected session is displayed. For example:
   

   +----------------------------Session Supervision------------------------------+ | Refresh Actions Exit | +-----------------------------------------------------------------------------+ +-------------------Session as of 14-Feb-1999 09:57:54-------------------+ | | | LAT 2.22:17 --> LAT 17.3 | | | | Type : INTER | | User name : probably ALLEN | | Last login : 23-Jan-1999 08:09:18 | | Last activity : 23-Jan-1999 09:46:49 | | Watch status : none | +------------------------------------------------------------------------+ EXIT = Exit IRIS \ = Back HELP = Help

   
   Depending on the selected session, additional information might be displayed.

4. To watch this session, use the mouse to select the Actions option from the menu at the top of the screen and then, select the Watch option from the submenu.
   

   +-----------------------------Session Supervision----------------------------+ | Refresh Actions Exit | +-----------+------Actions------+--------------------------------------------+ | Watch | | Unwatch | | Snapshot | | Playback | | Start Recording | | Stop Recording | | Disconnect | +-------------------+

   
   A pop-up window appears and you can watch the user's keystroke activity and see what they see on their screen. For example, if the user was entering data, you would see what they were entering.
   If the user is not typing anything when you start watching the session, the pop-up window remains blank until there is keystroke activity.

5. When you are finished watching the session, use the mouse to select the Unwatch option from the Actions submenu.
   

   ---

   Next

   Contents

   Index