TRCuserguide PDF

Tivoli

Version 5.1.2
IBM Tivoli Remote Control Users Guide
SC23-6541-01
Tivoli

Version 5.1.2
IBM Tivoli Remote Control Users Guide
SC23-6541-01
Note
Before using this information and the product it supports, read the information in Notices, on page 121.
First Edition (September 2007), Second Edition (October 2009)

This edition applies to version 5, release 1 , modification 2 of IBM Tivoli Remote Control (product number
5724-C21) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition
replaces SC23-6542-00.
Copyright International Business Machines Corporation 2009.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Preface . . . . . . . . . . . . . . vii Setting your homepage . . . . . . . . . 22
Who should read this guide . . . . . . . . . vii Resetting your homepage. . . . . . . . . 22
Publications . . . . . . . . . . . . . . vii Refreshing the data that is displayed on screen 23
IBM Tivoli Remote Control Library . . . . . vii Setting page display options . . . . . . . . 23
Related publications . . . . . . . . . . vii Exporting data in various formats . . . . . . 23
Accessing publications online . . . . . . . vii Tools menu . . . . . . . . . . . . . . 25
Accessibility . . . . . . . . . . . . . . viii Downloading utilities . . . . . . . . . . 25
Tivoli technical training . . . . . . . . . . viii Accessing help . . . . . . . . . . . . . 29
Contacting software support . . . . . . . . viii
Conventions used in this book. . . . . . . . viii Part 2. Using IBM Tivoli Remote
Typeface conventions . . . . . . . . . . ix
Additional information. . . . . . . . . . . ix
Control as a controller user . . . . 31
Chapter 4. Controller Interface . . . . 33

Part 1. Overview of IBM Tivoli
Remote Control. . . . . . . . . . . 1 Chapter 5. Types of remote control
sessions that can be established . . . 37
Chapter 1. Overview of Tivoli Remote Taking full control of a target system . . . . . . 37
Control 5.1.2 . . . . . . . . . . . . . 3 Starting an active session . . . . . . . . . 37
Changing to Active Mode during a remote
Chapter 2. How does IBM Tivoli Remote control session . . . . . . . . . . . . 38
Control Work? . . . . . . . . . . . . 5 Chatting to the target user . . . . . . . . . 38
Chat Only Mode. . . . . . . . . . . . 38
Opening a chat window during a remote control
Chapter 3. IBM Tivoli Remote Control session . . . . . . . . . . . . . . . 39
Server Web Interface . . . . . . . . . 7 Viewing the target screen to monitor activity . . . 40
Accessing the IBM Tivoli Remote Control Server Web Starting a monitor session . . . . . . . . 40
Interface . . . . . . . . . . . . . . . . 7 Changing to monitor mode during a remote
Logging on to IBM Tivoli Remote Control Server 7 control session . . . . . . . . . . . . 40
Logging off IBM Tivoli Remote Control Server . . 9 Providing guidance to the target user. . . . . . 40
Targets menu options . . . . . . . . . . . 9 Starting a guidance session . . . . . . . . 41
Browsing for targets . . . . . . . . . . . 9 Changing to guidance mode during a remote
Viewing all targets . . . . . . . . . . . 10 control session . . . . . . . . . . . . 41
Searching for targets . . . . . . . . . . 10 Using the guidance tools . . . . . . . . . 41
Creating a favourite targets list . . . . . . . 11 Using the guidance tool . . . . . . . . . 42
Viewing the favourite targets list . . . . . . 11 Using the drawing tool . . . . . . . . . 43
Removing targets from favourites . . . . . . 11 Using the highlight tool . . . . . . . . . 43
View Recently Accessed Targets . . . . . . 12 Clear Instructions . . . . . . . . . . . 44
Viewing the session history for a target . . . . 12 File Transfer Mode . . . . . . . . . . . . 44
Viewing target status details . . . . . . . . 13 Reboot Target Machine . . . . . . . . . . 45
Viewing the policies which will be in effect
between a user and a target . . . . . . . . 13 Chapter 6. Enabling and Disabling
Starting a remote control session . . . . . . 14
Requesting temporary access to targets . . . . 15
Local Input . . . . . . . . . . . . . 47
Users Menu Options . . . . . . . . . . . 18
Viewing your user details . . . . . . . . 18 Chapter 7. Performing Actions on the
Viewing the list of groups that you belong to . . 19 target . . . . . . . . . . . . . . . 49
Sessions Menu Options . . . . . . . . . . 19
Viewing your session history . . . . . . . 19 Chapter 8. Retrieving Target System
Searching for specific sessions . . . . . . . 19
Information . . . . . . . . . . . . . 51
Viewing session details . . . . . . . . . 20
Reports Menu . . . . . . . . . . . . . 21
Running standard reports . . . . . . . . 21 Chapter 9. Chatting to the target user
Running custom reports . . . . . . . . . 21 during a remote control session. . . . 53
Options Menu . . . . . . . . . . . . . 21
Copyright IBM Corp. 2009 iii

Chapter 10. Inviting multiple Chapter 19. Obtaining help from the
participants into a remote control controller interface . . . . . . . . . 81
session. . . . . . . . . . . . . . . 55
Starting a collaboration session . . . . . . . . 55 Chapter 20. Ending a Session . . . . . 83
Joining a collaboration session . . . . . . . . 56
Controlling collaboration session activity . . . . 56 Chapter 21. Using remote control
Controlling session activity as the master
commands from the command line . . 85
controller . . . . . . . . . . . . . . 56
Starting a remote control session from the command
Controlling session activity as a participant. . . 57
line . . . . . . . . . . . . . . . . . 86
Ending a collaboration session . . . . . . . . 58
Examples of usage . . . . . . . . . . . 87
Running commands on the target from the
Chapter 11. Controller Tools . . . . . 59 command line . . . . . . . . . . . . . 87
Enabling quick input of text to the target screen . . 59 Examples of usage . . . . . . . . . . . 88
Capturing the screen during a remote control Error messages for the wrc command . . . . . 88
session . . . . . . . . . . . . . . . . 60 Error messages for the wrcmdpcr command . . . 89
Mapping of arguments, for the command line tools,
Chapter 12. Recording a remote control from TRC 3.8.1 to TRC 5.1.2 . . . . . . . . . 90
session . . . . . . . . . . . . . . 61 wrc argument mapping . . . . . . . . . 90
Automatically recording a Session . . . . . . . 61 wrcmdpcr arguments mapping . . . . . . . 91
Exporting and downloading a recording from the
server . . . . . . . . . . . . . . . . 61 Chapter 22. Establishing a session
Recording a session locally . . . . . . . . . 62 directly with a target. . . . . . . . . 93
Making a local recording . . . . . . . . . 62 Starting a peer to peer session . . . . . . . . 93
Playing a local recording . . . . . . . . . 63
Chapter 13. Transferring files . . . . . 65 Part 3. IBM Tivoli Remote Control

File Transfer Menu . . . . . . . . . . . . 65 target. . . . . . . . . . . . . . . 95
Sending files to the target . . . . . . . . 65
Receiving files from the target . . . . . . . 65 Chapter 23. Remote Control target
Opening the file transfer folder . . . . . . . 66 Overview . . . . . . . . . . . . . . 97
Chapter 14. Copying Clipboard Chapter 24. Functionality of the target

Information . . . . . . . . . . . . . 67 icon . . . . . . . . . . . . . . . . 99
Sending clipboard text to the target . . . . . . 67
Receiving clipboard text from the target . . . . . 67
Chapter 25. The Target Interface . . . 101
Viewing the session connection status . . . . . 101
Chapter 15. Enabling and Disabling Selecting a session type on the target . . . . . 101
Autoscroll . . . . . . . . . . . . . 69 Viewing or hiding the chat area . . . . . . . 101
Viewing or hiding the file transfer area . . . . . 102
Chapter 16. Enabling and Disabling Actions which can be carried out from the target
Scaled View . . . . . . . . . . . . 71 interface . . . . . . . . . . . . . . . 102
Viewing system information . . . . . . . . 103
Obtaining help . . . . . . . . . . . . . 103
Chapter 17. Enabling and Disabling
True Colour. . . . . . . . . . . . . 73 Chapter 26. Consenting to a Remote
Control Session . . . . . . . . . . 105
Chapter 18. Remotely installing the
target software in a peer to peer Chapter 27. Hiding applications . . . 107
session . . . . . . . . . . . . . . 75 Hiding running applications from view during a
Pre requisites for remote target installation . . . . 75 remote control session . . . . . . . . . . 107
Windows XP pre requisites . . . . . . . . 75 Restoring hidden applications to view during a
Windows Server 2008 . . . . . . . . . . 75 remote control session. . . . . . . . . . . 107
Windows Vista . . . . . . . . . . . . 76
UNIX and Linux targets . . . . . . . . . 77
Chapter 28. Disconnecting from a
Performing a remote target install from the
controller . . . . . . . . . . . . . . . 78 Remote Control Session . . . . . . 109
Part 4. Troubleshooting Appendix 111

iv IBM Tivoli Remote Control Users Guide
Chapter 29. Auditing . . . . . . . . 113 Appendix. Notices . . . . . . . . . 121
Trademarks . . . . . . . . . . . . . . 123
Chapter 30. Error Messages . . . . . 115
Index . . . . . . . . . . . . . . . 125
Chapter 31. Ensuring that current data
is reported . . . . . . . . . . . . 117 Bibliography . . . . . . . . . . . . 127
Part 5. Appendixes . . . . . . . . 119
Contents v
vi IBM Tivoli Remote Control Users Guide
Preface
The IBM Tivoli Remote Control Users Guide explains how the Remote Control
application works and describes how to use the functions of the application.
Who should read this guide

This publication is for Administrators and End users.
Readers need to be familiar with the following topics.

v Operating systems
v Desktop environments.
The target audience for this user guide includes:

v System users and administrators
Publications
Read the descriptions of the IBM Tivoli Remote Control library to determine which
publications you might find helpful. After you determine the publications you
need, refer to the instructions for accessing publications online.
IBM Tivoli Remote Control Library

The publications in the IBM Tivoli Remote Control library are:
v IBM Tivoli Remote Control Installation Guide (GI11-8173-01)
Explains how to install and configure the Tivoli Remote Control software
v IBM Tivoli Remote Control Quick Start Guide (GI11-8182-01)
Provides a Quick Start Guide for IBM Tivoli Remote Control
v IBM Tivoli Remote Control Administrators Guide (SC23-6542-01)
Explains how to manage and configure the Tivoli Remote Control program.
Related publications
The Tivoli Software Library provides a variety of Tivoli publications such as white
papers, datasheets, demonstrations, Redbooks, and announcement letters. The
Tivoli Software Library is available on the Web at: http://publib.boulder.ibm.com/
infocenter/tivihelp/v3r1/index.jsp
The Tivoli Software Glossary includes definitions for many of the technical terms
related to Tivoli software. The Tivoli Software Glossary is available, in English only,
from the Glossary link on the left side of the Tivoli Software Library Web page
http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp
Accessing publications online

The publications for this product are available online in Portable Document Format
(PDF) or Hypertext Markup Language (HTML) format, or both in the Tivoli
software library: http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/
index.jsp
Copyright IBM Corp. 2009 vii

To locate product publications in the library, click the Product manuals link on the
left side of the library page. Then, locate and click the name of the product on the
Tivoli software information center page.
Product publications include release notes, installation guides, users guides,

administrators guides, and developers references.
Note: To ensure proper printing of PDF publications, select the Fit to page check
box in the Adobe Acrobat Print window (which is available when you click
File Print) .
Accessibility
Accessibility features help a user who has a physical disability, such as restricted
mobility or limited vision, to use software products successfully. You can use
assistive technologies to hear and navigate the product documentation. You also
can use the keyboard instead of the mouse to operate some features of the
graphical user interface.
The following keys can be used for navigating through the graphical user interface
v F12 - Enable / disable the keyboard functions
v TAB - To navigate right and left through the menus
v Spacebar - To activate a menu
v Up / Down arrow keys - Navigate through the menu items
v Spacebar - Select a menu item on an active menu
v Esc - Closes an active menu.
Tivoli technical training

For Tivoli technical training information, refer to the IBM Tivoli Education Web
site: http://www.ibm.com/software/tivoli/education.
Contacting software support

Before contacting IBM Tivoli Software Support with a problem, refer to the IBM
Tivoli Software Support site by clicking the Tivoli support link at the following
Web site: http://www.ibm.com/software/support/
If you need additional help, contact software support by using the methods
described in the IBM Software Support Guide at the following Web site:
http://www14.software.ibm.com/webapp/set2/sas/f/handbook/home.html
The guide provides the following information:

v Registration and eligibility requirements for receiving support
v Telephone numbers, depending on the country in which you are located
v A list of information you should gather before contacting customer support
Conventions used in this book

This reference uses several conventions for special terms and actions and for
operating system-dependent commands and paths.
viii IBM Tivoli Remote Control Users Guide

Typeface conventions
The following typeface conventions are used in this reference:
Bold Lowercase commands or mixed case commands that are difficult to
distinguish from surrounding text, keywords, parameters, options,
names of Java classes, and objects are in bold.
Italic Variables, titles of publications, and special words or phrases that
are emphasized are in italic.
Monospace Code examples, command lines, screen output, file and directory
names that are difficult to distinguish from surrounding text,
system messages, text that the user must type, and values for
arguments or command options are in monospace.
Additional information
You can obtain additional information about the IBM Tivoli Remote Control
program from the following web site:
http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=/
com.ibm.itrc.doc_5.1.2/welcome.htm
The IBM Tivoli Remote Control Users Guide might be updated periodically. The
updated versions will be made available at this Web site.
Preface ix
x IBM Tivoli Remote Control Users Guide
Part 1. Overview of IBM Tivoli Remote Control
Copyright IBM Corp. 2009 1

2 IBM Tivoli Remote Control Users Guide
Chapter 1. Overview of Tivoli Remote Control 5.1.2
IBM Tivoli Remote Control ( hereafter also known as TRC ) 5.1.2 is the next major
version of Tivoli Remote Control.
Existing TRC 3.8x customers must migrate to 5.1.2 code in order to use any new
features, TRC 5.1.2 code will coexist with existing deployed RC tools.
IBM Tivoli Remote Control (TRC) 5.1.2 is a client-server application that allows the
takeover and control of workstations on a network using a specific Remote Control
technology. During these remote control sessions the controller or administrators
keyboard and mouse become the primary keyboard and mouse for the target
system for the duration of a Remote Control session. Functionality such as chat,
reboot, and file transfer are some of the options available for use in a Remote
Control Session.
There are three main infrastructure components in TRC 5.1.2

Server
The TRC server provides the following
v User Account Management
v Target Management
v Policy engine for users and target endpoints
v Centralised depot for session information relevant for audit purposes
v Authentication broker for each session
v Web interface for administrators and controller users
Controller (Console)
v Provides the controller interface for the person running the remote
session.
v Records audit information to be stored in the infrastructure server
Target (Utility)
v Resides on the endpoint (client) to be controlled.
v Presents a Graphical User Interface to the endpoint user.
v Registers and maintains current state information on the Infrastructure
server about the endpoint.
v Receives connection requests and authenticates them against the
infrastructure server
v Controls the policies set for the session
v Records audit information to be stored in the infrastructure server

Chapter 2. How does IBM Tivoli Remote Control Work?
The following section explains the devices involved in an IBM Tivoli Remote
Control Remote Control Takeover session.
When a TRC user is logged on to the TRC web interface, it is possible to browse or
search for a specific endpoint to control. When an endpoint is selected a Connect
button provides the entry point for the session start process:
1. The action associated with the Connect button is to send from the browser in
the controller machine a HTTP(S) Post request to the server.
2. After the session is created, a .jnlp file is crafted with the appropriate session
parameters and sent back to the controller browser. The .jnlp file is passed to the
Java Web Start system. This file specifies where to locate the latest version of the
controller so it can be automatically downloaded if necessary and the command
line parameters to apply. These parameters are: the TRC session id, the IP of the
target and the port where the target is listening on for connections.
3. As soon as the controller is launched it will attempt to connect to the IP and

port provided.
4. The target answers to create a secure channel.
5. The controller sends a start session packet to include the relevant session details
that will enable the target to validate the connection attempt with the TRC server.
6. The target receives the start session information.
7. The TRC server will check the session details and if valid will return an
acceptance response with the applicable policies and session information such as
screen names and what is the initial session mode.
8. The target evaluates the policies and then a packet accepting or rejecting the
connection will be sent back to the controller
Note: Takeover confirmation is a configurable value which enables the program to

function on platforms which do not require user acceptance e.g. Server
devices.
Remote control sessions with multiple participants.
An ongoing remote control session can be open for more participants (controllers)
to join in. The participants will have the ability take part in the chat conversation
as well as see the targets screen.

Chapter 3. IBM Tivoli Remote Control Server Web Interface
Accessing the IBM Tivoli Remote Control Server Web Interface
When you have installed the IBM Tivoli Remote Control Server software and the
IBM Tivoli Remote Control Target software ( see IBM Tivoli Remote Control
Installation Guide for details of installing and configuring the server and target
software) , you are now able to logon to the server application .
Logging on to IBM Tivoli Remote Control Server

1. In a Web Browser window type in the following address http://SERVERNAME/
trc
v SERVERNAME - This is the name of your IBM Tivoli Remote Control Server
. If you do not have this name, please see your IBM Tivoli Remote Control
System Administrator
2. The IBM Tivoli Remote Control Server logon screen is displayed
Figure 1. Logon screen for entering ID and password
3. Type in a valid ID and password ( invalid or missing IDs and passwords will
generate an error message)
v If you are an Administrator, and this is your first time into the program the
default Admin ID is admin and password is password. Type this into the
logon screen and you will then be allowed to change the password to your
own requirements.
Note: Password rules are set in the trc.properties file in the set of variables
starting with password. see the IBM Tivoli Remote Control Server
Administrators Guide for details
4. Click Logon
Note: On clicking Cancel , the Userid and password fields will clear and logon
to the application will not be achieved
5. The IBM Tivoli Remote Control Server GUI will now be displayed
v If you are an Administrator you will see the following available menu
options
Targets

Target Groups
Users
User Groups
Sessions
Reports
Admin
Options
Tools
Help
Notes:
a. Your ID with (A) denoting Administrator is displayed on the right of the
screen.
v If you are a User, you will see the following available menu options
Targets
Users
Sessions
Reports
Options
Tools
Help
Notes:
a. Your ID with (U) denoting User is displayed on the right of the screen.
Forgotten Password
If you have forgotten your password, there is a forgotten password function which
will generate an email providing a temporary password . This function will only
be available on the logon screen when email has been setup and enabled in the
system . Email can be enabled at installation (see the IBM Tivoli Remote Control
Installation Guide for more details) or by editing the trc.properties file (see IBM
Tivoli Remote Control Server Administrators Guide).
Note: If email is enabled AND LDAP is enabled, the forgotten password function
will not be available.
To obtain a temporary password complete the following steps: -

1. At the Logon screen type in your ID.
2. Click the Forgotten password check box.
3. Click Logon.
4. The following message will be displayed - A new password has been sent to
your registered email address
5. The email will be sent to the email address that is defined for the User who is
trying to logon.
6. When the temporary password is retrieved from the email, logon with your ID
and the temporary password.
7. The Edit details screen will be displayed allowing you to change the password .
8. Type in and confirm your new password
9. Click Submit

Note: When email is enabled, the logon screen will also display a message and a
link to allow the User to contact the System Administrator.
Logging off IBM Tivoli Remote Control Server

To Logoff from the IBM Tivoli Remote Control Server program select the Sign Out
link on the right. The system returns to the Welcome Screen
Targets menu options

In the IBM Tivoli Remote Control system, targets are endpoints which have client
software installed to allow them to identify themselves to the IBM Tivoli Remote
Control Server , to receive connection requests and to pass information to and from
the server ( see the IBM Tivoli Remote Control Install Guide for details on
installing the target software). Once installed, these targets report back periodically
to the IBM Tivoli Remote Control Server to let the server know that they are still
active and in particular when their state changes, for example when someone is
logged on, when a remote control session is taking place or when the system
powers up or shuts down. When a target is first installed and made known to the
server it is assigned a default set of policies. Administrators defined in the IBM
Tivoli Remote Control Server system will then decide which set of policies should
be applied by assigning the target to the relevant target Group. See IBM Tivoli
Remote Control Server Administrators Guide for details of target Groups and
Permissions.
This chapter describes the actions that can be carried out on targets, defined in the
IBM Tivoli Remote Control Server, by both Users and Administrators .
Browsing for targets

The Browse targets action allows you to browse through all of the defined target
groups to find a specific target . When you select Browse targets an expandable list
of target groups is displayed. When you select a target group, if you have
permission to access the targets in the selected group, the target members will be
displayed on the right. If you do not have permission to access the targets in the
selected target group , no targets are displayed . The permission to access targets is
derived from permissions links made between any groups that a User and target
belong to . See the IBM Tivoli Remote Control Server Administrators Guide for
more details .
To browse for targets complete the following steps: -

1. Log on to the IBM Tivoli Remote Control Server with a valid ID and password.
2. On the IBM Tivoli Remote Control Server menu bar click Targets> Browse
3. Click on the selector button to display the list of target groups.
4. Select the required target group.
5. If you have permission to access the target members, the list of available targets
is displayed on the right. If not , no targets are displayed.
6. Select the required target by selecting the radio button next to the target then
clicking the selector button.
7. Click Submit
8. The target details are now displayed and if the target is selected a list of
available actions is displayed. These actions are explained in other sections of
this document
Note:
Chapter 3. IBM Tivoli Remote Control Server Web Interface 9

Clicking Cancel will return the application to the previously displayed
screen.
Viewing all targets

When targets have been registered in the IBM Tivoli Remote Control Server you
can use the All Targets action to display a list of these targets.
To view the list of targets complete the following steps : -

2. On the IBM Tivoli Remote Control Server menu bar click Targets > All targets
3. The All targets screen is displayed giving details of all targets defined in the
system.
Searching for targets

To allow you to access specific targets or find a target using non specific
information a search utility is available. To search for a target , complete the
following steps: -
2. In the IBM Tivoli Remote Control Server menu bar, click Targets > Search
3. The Search screen is displayed.
4. The input field is used to enter the target information that will be used in the
search . This can be all or part of the Manufacturer, Model, Serial No. ,
Computername, logged on User name or IP address.
v If specific target information is known, for example serial number or
computer name , type this into the Search Target field for the quickest search
v If non specific target information is known , for example the model,
manufacturer or part of some other information then type this in
5. Click Submit
6.
v If any matching targets are found , the following will then be displayed
If the specific information was entered, the details for that target will be
displayed
If non specific information was entered, a list of any targets with this
information as part of their details will be displayed. See the following
examples
1) If 80 is entered into the search field, all targets that have 80 somewhere
in their details
targets with Model - 848032X
Serial Number - LMM80FX
2) If IBM is entered into the search field then all targets whose
manufacturer is IBM will be displayed
3) If 2373 is entered into the search field then all targets with model no.
2373 and any targets that have 2373 as part of their serial no. , Computer
name or IP address will be displayed.
Note: The information entered is not case sensitive - for example Test will
also match on test
v If no matching targets are found , a message will be displayed and the target
list will be blank

Notes:
1. Clicking Reset on the Search screen will clear or change back to previous
values any changes made to the input screen
2. Clicking Cancel on the Search screen will return to the previously displayed
screen
3. Not entering anything into the field and clicking Submit will give the list of all
targets
Creating a favourite targets list

If you access or connect to the same targets regularly, there is the ability to create a
list of Favourite targets that will allow you to quickly navigate to these targets .
The Add to Favourites action will allow you to add one or more targets to the list.
To create a favourites list complete the following steps : -

1. Select the required target(s)
v To select the required target(s) by searching, follow the steps in Searching
for targets on page 10 then go to step 2
v To select from the All targets list do the following
Log on to the IBM Tivoli Remote Control Server with a valid ID and
password.
In the IBM Tivoli Remote Control Server menu bar, click Targets > All
Targets
Select the required target(s)
2. Now do one of the following
v From the Targets menu select Add to favourites
v OR select Add to favourites from the Action list on the left
3. The Favourites screen is displayed listing all targets that have been added to
the favourites list
Viewing the favourite targets list

When you have created a favourite targets list you can use the Favourites option
in the targets menu to view this list.
To view the Favourites list , complete the following steps : -

2. In the IBM Tivoli Remote Control Server menu bar, click Targets > Favourites
3. The Favourites list is displayed
Removing targets from favourites

You can remove targets from the Favourites list by selecting the Remove from
Favourites action
To remove targets from the favourites list , complete the following steps: -
2. In the IBM Tivoli Remote Control Server menu bar, click Targets > Favourites
3. The Favourites list is displayed
4. Select the required target(s)
v From the Targets menu select Remove from favourites

v OR select Remove from favourites from the Action list on the left
6. The target(s) are now removed from the list
Note: You may have to click the Refresh link on the right to show the updated
list
View Recently Accessed Targets

When you have had remote control sessions with a targets you can view a list of
the targets that you have recently accessed by using the Recently Accessed Action.
The maximum number of items in this list is determined by the variable
limit.recently.accessed which is set in the common.properties file. See the IBM
Tivoli Remote Control Server Administrators Guide chapter on Editing the
properties files for more details.
To view a list of recently accessed targets, complete the following steps: -

2. In the IBM Tivoli Remote Control Server menu bar, click Targets > Recently
accessed
3. The Recent targets screen is displayed
4. As the number of targets displayed at a time is limited, if the full list of Recent
targets is greater than this limit, the targets will be displayed a Page at a time.
The Page drop down list can be used to navigate through the pages as well as
the arrows
v ! - To go to the first page
v < - To go back a page
v > - To go forward a page
v @ - To go to the last page
Viewing the session history for a target

You can view the list of sessions that a specific target has taken part in by using
the Session History action.
To view the session history for a specific target , complete the following steps : -
1. Select the required target
v To select the required target by searching, follow the steps in Searching for
targets on page 10 then go to step 2
password.
Targets
Select the required target
v Select Targets >Session History
v OR select Session History from the Action list on the left
3. The Session History screen is displayed listing all of the sessions that the target
has taken part in.

Viewing target status details
To view the status details for a specific target you can use the Target status action.
This will allow you to select a target and then view details about that target
To view target status details , complete the following steps : -

targets on page 10 then go to step 2
password.
Targets
v Select Targets >Target status
v OR select Target status from the Action list on the left
3. The target status screen is displayed giving details of the target
Note: Clicking Cancel on the target status screen will return to the previously
displayed screen
Viewing the policies which will be in effect between a user

and a target
You can use the View effective policies action to view what policies and
permissions will be in effect in a remote control session between the selected user
and target. The policies are displayed in two forms
Considered Policies
This table lists any permissions links defined for the user and target
groups that the selected user and target belong to and the policies and
permissions that have been derived from each of these links. These will
then be considered by the Policy Engine when determining the final set of
policies and permissions that will be granted for the session. See the IBM
Tivoli Remote Control Server Administrators Guide for details of the
Policy Engine, policy definitions and permissions .
Resolved Policies
This table shows the final set of policies and permissions, that the Policy
Engine has resolved from the Considered policies, and these will be
assigned when a remote control session is established between the selected
user and target
To view the effective policies, complete the following steps: -

targets on page 10 then go to step 3 on page 14
password.

Targets
3. Now do one of the following steps
v Select Targets >View effective policies
v OR select View effective policies from the Action list on the left
4. The Show Effective Policies screen is displayed with the selected target shown
5. To select a user , click the selector button next to user
6. On the left, select the required group ( in this example select Default Group)
then on the right, select the required user
7. Click the - Select a User - selector button
8. The expanded Show Effective Policies screen is displayed showing Considered
Policies and scrolling down the screen you will see Resolved Policies.
Note: Clicking Cancel will return to the previously displayed screen
Starting a remote control session

To connect to and control a remote target, a controller User would perform the
Start Session action. For details of the types of remote control sessions that can be
established see Chapter 5, Types of remote control sessions that can be
established, on page 37. Remote control sessions can be started between users and
targets who are members of groups which have permissions links defined . See the
IBM Tivoli Remote Control Server Administrators Guide for details of creating and
assigning members to user and target groups, for creating permissions links and
for how the policies and permissions are resolved for a remote control session.
The Start session action is available when a target is selected from any report that
displays one or more targets . Some examples of these reports are
v All Targets - see Viewing all targets on page 10 for how to create this report.
Note: This report also displays the userid of the user who is logged on to the
target.
v Recently Accessed - see View Recently Accessed Targets on page 12 for how to
create this report.
v Favourites - see Viewing the favourite targets list on page 11 for how to create
this report.
v Search Targets - see Searching for targets on page 10 for how to create this
report.
The following steps detail how to start a session from the All targets report , for
the others, see the relevant sections for displaying these reports then follow from
step 3 below
To start a session, complete the following steps: -

2. In the IBM Tivoli Remote Control Server menu bar, click Targets > All Targets
3. Select the target to connect to
4. Click Start session
5. The start session screen is displayed. This screen gives the details for the
selected target including the version of target software installed and the policies
and permissions that will be assigned for the session.

6. Click the relevant session mode button that corresponds to the session type that
you want to start.
7. When the Open or Save dialog is displayed, select open
8. The controller will start to run and the session will either be accepted of
refused.
If the session is accepted then the connection is established and the controller
window will be displayed showing the target screen. You will also see the
IPaddress of the target that you are connected to in the heading of the
controller window. This is helpful for keeping track of who you are connected
to if you have multiple sessions running at the one time.
If the session is refused a message will be displayed .
Session refusal can occur for a number of reasons
v The target user has clicked refuse on the acceptance dialog if user acceptance
was required for the session.
v The target user has not accepted the session within the given time,
determined by the acceptance grace time policy and if the acceptance timeout
policy was set to abort.
v The target is already in a remote control session, in which case a message
will be displayed showing who is connected to the target.
See the IBM Tivoli Remote Control Server Administrators Guide for details of
policies.
Notes:
1. If the Session mode buttons are not displayed on the Start Session screen and
an error message is displayed the following may be the reason for this.
v If the user or target are not a member of any groups
v If no permissions links were defined for any of the groups that the user and
target belong to.
v If the target is offline
v If none of the session mode policies have been set to Yes
Also see the IBM Tivoli Remote Control Server Administrators Guide for
details of groups , policies and permissions
Requesting temporary access to targets

IBM Tivoli Remote Control allows you to access and establish a remote control
session with the targets that you have permissions to access through your group
membership, and the relationships that have been set up between these groups
and target groups. However you can also request temporary access to one or more
targets that you do not normally have access to using the Request Access
capability. This will allow you to select the required target(s), define which types of
remote control sessions you would like to establish, and define a time period that
you would like this access to be valid for. When the request is submitted,
notification is sent to the administrator who will then action the request. When the
request is actioned, an email will be sent back to you detailing the outcome of the
request.
Note: It is important to note here that the email functionality should be enabled on
the IBM Tivoli Remote Control Server to allow the notification process to
take place. Please see the IBM Tivoli Remote Control Server Administrators
Guide for details of enabling email.
Temporary access to targets could be requested for the following reasons

v You have been notified of a problem on a target or targets which are not
members of any of the target groups that you have permission to access and you
need to establish a connection to be able to solve the problem.
v The permissions that you do have to allow you to access these target(s) have
now expired or do not allow you to do what it is you require for the session.
v You are not a registered user in the IBM Tivoli Remote Control Server. See
Making a request as a user not a registered in the IBM Tivoli Remote Control
Server. on page 17 for details of this procedure.
Making a request, as a registered user

If you are a user who is already registered with the IBM Tivoli Remote Control
Server you can request temporary access to targets in one of two ways.
v Using the Request Access option. See The request access option
v Clicking the Request Access button when starting a session. See Request access
at start of session on page 17
The request access option: To request temporary access to one or more targets,
complete the following steps :
2. On the IBM Tivoli Remote Control Server menu bar click Targets >All targets.
3. Select one or more targets.
4. Now complete one of the following actions : -
v Select Targets > Request Access.
v OR select Request Access from the Actions list on the left.
5. The Request Access to target screen is displayed.
6. Type in the required information for the access request.
Session Types
Select the required session type(s) that you want to be able to establish
with the chosen target(s).
Justification
Type in a reason for requesting access to the selected target(s).
Note: In all cases, but particularly where you are an existing user who
has existing permissions to access the target, but need these
modified for the temporary session, it is important to also add
any other policies that you want to be valid for the session
otherwise your existing policies will still be in effect for the
session.
For example : You are normally not allowed to access or

view the registry keys of the target but need to for this
temporary session. You should enter here that you need
to be able to access the registry keys so that the
administrator can enable the registry keys policy for the
temporary session.
Start date
Select from the calendar or type the date, in the format yyyy-mm-dd,
on which you want the access to commence.
Start time
Type in a time, in the format hh:mm:ss , that you want the access to
commence.

End date
Select from the calendar or type the date, in the format yyyy-mm-dd,
on which you want the access to end.
End time
Type in a time, in the format hh:mm:ss , that you want the access to
end.
email address
Type in your email address. This address is used for sending a
response back to when the access request has been actioned by an
administrator.
Note: This value is mandatory.

7. Click Submit.
Your request will now be sent to an administrator who will decide whether to
allow you temporary access to the selected target(s). You will receive an email
notifying you of the outcome of the request. If your request has been granted you
will now have access to the selected target(s) within the specified dates and times.
If your request has been denied you will NOT be allowed access to the selected
target(s).
Request access at start of session: If you try to start a remote control session with
a target that you do not have permission to access, a request access option will be
available on the create new session screen if the trc.ticket.allow.access property has
been enabled. This property is set in the trc.properties file by an administrator. See
the IBM Tivoli Remote Control Server Administrators Guide for details of editing
the properties files.
Note: If the property has not been enabled, request access will not appear as an
option on the screen.
To request temporary access to a target from the Create new session screen
complete the following steps : -
v On the Create new session screen click Request Access
v Go to step 5 on page 16 above and complete the steps required to create the
request.
Your request will now be sent to an administrator who will decide whether to
allow you temporary access to the selected target(s). You will receive an email
notifying you of the outcome of the request. If your request has been granted you
will now have access to the selected target(s) within the specified dates and times.
If your request has been denied you will NOT be allowed access to the selected
target(s).
Making a request as a user not a registered in the IBM Tivoli

Remote Control Server.
A user who is not registered with the IBM Tivoli Remote Control Server can
request temporary access to target systems. This may be a user who is not
involved in using the IBM Tivoli Remote Control Server application but needs
access to update software on certain systems, or a user who may be required to
debug a problem on a target system. The availability of this option is determined
by the property trc.ticket.allow.allaccess which is set in the trc.properties file by
an administrator. See the IBM Tivoli Remote Control Server Administrators Guide
for details of editing the properties files.

To request temporary access to one or more targets complete the following steps : -
1. Type the following URL into your browser
http://servername/trc/requestAccessAnon.do
where servername is the address of your IBM Tivoli Remote Control Server
2. Go to step 5 on page 16 above and complete the steps required to create the
request.
Note: It is important to note here that you should give details of the targets
required in the Admin Notes field to allow the administrator who deals
with the request to determine which targets to select.
When you click Submit an email containing the request will be sent to the
administrator. When this request is actioned you will receive an email detailing the
outcome of the request. If the request has been granted there will be a link
available in the email that will take you to the Create new session screen from
where you will be able to start a session with the selected target(s) within the
specified date and times. If your request has been denied you will NOT be
allowed access to the selected target(s).
Viewing your requests for temporary access

After you have submitted requests for temporary access to targets you can view a
list of these requests using the My Requests capability.
To view your submitted requests complete the following steps : -

1. On the IBM Tivoli Remote Control Server menu bar click Reports > My Access
Requests.
2. The My Requests list is displayed showing all access requests that you have
submitted.
Users Menu Options

The IBM Tivoli Remote Control Server program is designed to accommodate three
types of user authorities: user, super user and administrator . A variety of IBM
Tivoli Remote Control Server functions can be performed by each user account
with the Administrator having the most comprehensive privileges. This section
details the user options that all three user authorities can carry out within the Web
Interface. See the IBM Tivoli Remote Control Server Administrators Guide for
details of the user options that only an administrator can carry out for example
creating or deleting user accounts.
Viewing your user details

The My Details action allows you to view and update your own user details.
To view your user details, complete the following steps: -

2. In the IBM Tivoli Remote Control Server menu bar, click Users > My Details
3. The Change Details screen is displayed
4. If required, change or update the relevant details ,
Notes:
a. The User ID field cannot be changed

b. If the User logged on is an Admin User, the screen will also display the
User groups that are defined to allow the Admin User to select or deselect
required groups.
5. Click Submit
Viewing the list of groups that you belong to

The My Groups action allows you to view a list of any User Groups that you are a
member of.
To view the list of groups , complete the following steps: -

2. In the IBM Tivoli Remote Control Server menu bar, click Users > My Groups
3. The Selected User Groups screen is displayed listing the user groups
Sessions Menu Options
Viewing your session history

The My Session History action allows you to view a list of all previous sessions
that you have established.
To view your session history list complete the following steps :-

2. In the IBM Tivoli Remote Control Server menu bar, click Sessions > My
Session History
3. The My Session History screen is displayed.
Searching for specific sessions

Using the search utility for sessions allows you to search for a specific previously
established session or find a session by using a specific or non specific search
criteria
To search for a session complete the following steps:-

2. In the IBM Tivoli Remote Control Server menu bar, click Sessions > Search
3. The Search Session screen is displayed .
4. The input field is used to enter information about the target that was taken
over in the session and will be used as the search criteria .
v To search for sessions, all or part of any of the following target information
can be used ,
manufacturer
model
serial number
computername
Note: The information entered is not case sensitive - for example Test will
also match on test
5. Click Submit
6.

v If any matching targets are found within the session information, the session
details for these will be displayed
v If no matching targets are found , a message will be displayed and the
sessions list will be blank
Viewing session details

The Session Details action is available when a target is selected from either the
My Session History report or the Search Sessions report. Details of the controller
system, the policies and values set for the session and any audit log entries for
both the controller and target are shown .
To view session details for a specific session complete the following steps :-
2. In the IBM Tivoli Remote Control Server menu bar, click Sessions
3. Select either My Session History, All Session History or Search (follow steps
in search sessions to generate the report when selecting search)
4. Select one of the targets from the list
5. Now do one of the following steps
v Select Sessions > Session details
v OR select Session details from the action list on the left
6. The remote control session information screen is displayed giving details of the
controller system, the policies and permissions that were applied to the session
and , if the Force Session Audit policy was set to Yes, any audit entries that
were saved for the controller and target are also shown. If the Force Session
Recording policy was set to Yes there will also be a link to play back the
recording of the session. See the IBM Tivoli Remote Control Server
Administrators Guide for details of setting policies and permissions.
Note: Clicking Back from the Remote Control session information screen will
return the application to the previously displayed screen
Playing back a Recording
To Playback a recording complete the following steps : -

1. On the Session Details screen click the Play the recording of this session link
2. The Session Recording Player window opens and the recording begins to play.
The following buttons and functions are available during the playback
Pause To pause the recording while playing
Stop To stop the recording and the playback window clears
Enable Auto Scrolling View
As the recording is playing , you can scroll up, down, right or left by
moving the mouse over each edge of the playback window
Enable Scaled View
This option will scale down the display of the recording to show the
full recorded window inside the playback window
Note: Clicking Cancel from the Session Recording Player will return to the
previously displayed screen.

Reports Menu
The Reports Menu is used to create or run reports and the content of the menu is
dependant on the authority of the user who is logged on. This section describes
the functionality available to a user with user authority. A user with Super User or
Admin authority will have more functionality and this is explained in the IBM
Tivoli Remote Control Server Administrators Guide in the reports chapter.
The Reports menu for a user will show all Standard and Custom Reports that the
user has access to run.
Note: If you do not have access to any Custom Reports, the Reports menu will not
contain any items and therefore clicking it will have no effect
Running standard reports

There are a number of standard reports that are provided with IBM Tivoli Remote
Control which provide information about users, targets and groups.
To run a standard report complete the following steps :-

2. On the IBM Tivoli Remote Control Server menu bar click Reports > Standard
Reports
3. Click on the required standard report name
4. The output of the standard report will be displayed on the screen
Running custom reports

Custom reports are created by Super Users or Administrators. On saving the
custom query, they can select a group or groups that will have permission to run
this report. The result of this will be that the reports menu for all members of the
selected group(s) will be populated with a custom reports item which when
selected will show a list of available custom report menus and their corresponding
reports. See the IBM Tivoli Remote Control Server Administrators Guide for more
information on creating custom reports
To run a custom report complete the following steps:-

2. On the IBM Tivoli Remote Control Server menu bar click Reports > Custom
reports
3. Click on the menu item that the custom report belongs to
4. Click on the required custom report name
5. The output of the custom report will be displayed on the screen
Options Menu
The options menu gives you a selection of actions that can be carried out on any
reports that are produced. There are various actions that can be performed from
this menu and this section details those options which are available to users, super
users and administrators. See the IBM Tivoli Remote Control Server
Administrators Guide for additional options which are available to super users
and admin users only. This section details the options that will allow you to set
your homepage , choose page display options or provide ways to format the data
for output to other applications.

Note: On screens which are not in a report format, for example search screens or
input screens, the Options menu will not be visible in the menu bar.
To work with the Options menu complete the following steps

2. In the IBM Tivoli Remote Control Server menu bar, click Options then select
from the following options: -
v Set Current Report as Homepage- see Setting your homepage
v Reset to Default Homepage Report - see Resetting your homepage
v Refresh Results - see Refreshing the data that is displayed on screen on
page 23
v Page Options - see Setting page display options on page 23
v Output - see Exporting data in various formats on page 23
Setting your homepage

You can use this option to make the current report, your homepage. This is the
initial screen that appears when you logon to the IBM Tivoli Remote Control
Server Web Interface. You can use any of the standard reports that are available in
IBM Tivoli Remote Control Server or any custom reports that you have access to in
the custom reports menu.
To set a default homepage complete the following steps :-

v Generate the required report by running a standard report from any of the IBM
Tivoli Remote Control Server menus or run a custom report that you have access
to from the Custom reports menu.
v Click Options > Set Current Report as Homepage
For example to make the favourites report your homepage:

v In the IBM Tivoli Remote Control Server menu bar, click Targets > Favourites
v Click Options > Set Current Report as Homepage
The next time you logon the Favourites report will be the first screen that is
displayed
Resetting your homepage

The default homepage for the IBM Tivoli Remote Control Server is defined by the
property default.query in the trc.properties file. This property determines the
initial page that is displayed when a user logs on to the application if no other
default homepages have been set. See the IBM Tivoli Remote Control Server
Administrators Guide for details of editing the properties files. If you have set
your homepage to a different page by selecting the Set Current Report as
Homepage option you can then change this back to the page that is defined as the
default homepage by selecting the Reset to Default Homepage Report option.
Note: The page that is displayed when you logon now is determined by either the
value that is set in default.query or by any default homepages that have
been set for any groups that you are a member of. See the IBM Tivoli
Remote Control Server Administrators Guide for details of how homepages
are determined.
To reset to the default homepage complete the following step :-

v Click Options > Reset to Default Homepage Report

Example1: The All targets report is defined as the default homepage and you had
selected the Favourites report as your homepage, if there are no default homepages
set for any of the groups that you belong to and you select Reset to Default
Homepage Report, if you logoff and logon you will see that the All targets report
is now the first page that you see.
Example2: You are a member of user group testtargets and a default homepage of
targets manufactured by companyX has been set for the group. If you select Reset
to Default Homepage Report then logoff and logon again, this time it will be the
targets manufactured by companyX that is the first page that you see.
Refreshing the data that is displayed on screen

Whenever a report is generated in IBM Tivoli Remote Control Server a query is
run against the database which retrieves the required data and displays this on the
screen. This data is then held in a temporary location for the next time the same
report is run to allow the data to be displayed much more quickly on the screen .
To ensure that the latest data is reported to the screen, including any updates
which might have taken place since the last time the report data was displayed,
click Refresh Results . This will update the report with any changes or updates
that have been made.
For example : If you have added a target to the favourites list and then select the
Favourites option from the Targets menu , if the target that you added does not
appear in the list immediately, use the Refresh Results action to re - display the
screen and the target should now appear in the list.
Note: The Refresh link on the top right of the screen can also be used for the
same purpose.
Setting page display options

You can use this option to select the number of rows of output to be displayed on
the screen particularly if the report to be displayed is large. Select the number of
rows per page to display from the list.
Exporting data in various formats

You can use the options in the output menu to export the report data that is
displayed on the screen into various formats that will allow you to save the data,
email the data or print the data.
To export the report data complete the following steps :-

v In the IBM Tivoli Remote Control Server menu bar click the Options >Output
then select one of the following options: -
CSV File(UTF-8)
This will generate a CSV (UTF-8) file format of the current report that
is displayed on screen.
On the file download window select one of the following options :-
1. Click Open , to open the report in CSV format.
2. Click Save to save file as a .csv file.
CSV File(UTF-16LE)
This will generate a CSV (UTF-16LE) file format of the current report
that is displayed on screen.

Follow instructions in CSV File(UTF-8) , above, to create and save the
file
TSV File(UTF-8)
Generate a TSV(UTF-8) file format of the current report that is
displayed on screen.
On the file download window select one of the following options :-
- Click Open , to open the report in TSV format.
- Click Save to save file as a .tsv file.
TSV File(UTF-16LE)
This will generate a TSV (UTF-16LE) Filef format of the current report
that is displayed on screen.
Follow instructions in TSV File(UTF-8), above, to create and save the file
Note: This format is good for using in MS Excel

Email Report
You can use this option to Email the currently displayed report as a CSV
file . Using the All targets report as an example complete the following
steps
Targets
In the IBM Tivoli Remote Control Server menu bar, click Options >
Output > Email Report
The Email Report screen is displayed
Type the Email address of the recipient in E-Mail To field
In the Email Contents box, type in the content for your email
Click Send
The current report is attached to the Email as a CSV file and is sent to
the email address entered in step above.
If email is not enabled in the system, a message will be displayed
Note: Email must be enabled in the system for this option to work. See
IBM Tivoli Remote Control Server Administrators Guide for
details of editing the trc.properties file to do this.
Printable Report
You can use the this option to display the current report in a new
browser window with no menus, for easier printing. Using the All
targets report as an example complete the following steps
Targets
In the IBM Tivoli Remote Control Server menu bar, click Options
>Output > Printable Report
A new window opens with the report displayed
To print the report select print from the File menu in the action bar.

Tools menu
Downloading utilities
The Downloads page provides the User with various items that can be
downloaded for use with IBM Tivoli Remote Control Server and includes the
following
v Launch the TRC Session Player
v Download the Session player
v Agent Downloads
Launching the TRC Session Player

The Session Player can be launched using Java Web Start by doing the following : -
.
2. In the IBM Tivoli Remote Control Server menu bar, click Help
3. Select Downloads. The Downloads page is displayed listing the available items
for download.
4. Click the Launch TRC Player link
5. On the file download window select Run or Save
Run Selecting Run will launch the Session Player. See Recording section for
more details of playing a local recording.
Save Selecting Save will allow the TRCPlayer.jnlp file to be saved to a
selected location.
Note: Running this file will then launch the session player. See
Recording section for more details of playing a local recording.
Downloading the Session Player

The Session Player can be used to play back any recordings of sessions that have
been saved locally on the controller system. See Local Recording of a session for
more details on Session Recording. To download the session player, complete the
following : -
2. In the IBM Tivoli Remote Control Server menu bar, click Help
3. Select Downloads. The Downloads page is displayed listing the available items
for download.
4. Click the Download TRC Player link
5. Save the file to the required location, for example- the desktop.
Note: Some browsers will save the file as a .zip file . In this case rename the
file TRCPlayer.zip to TRCPlayer.jar.
6. For details of playing back a recording see Recording chapter
Downloading the agent software from the server

The Agent Download function is used to download various tools and components
that can be used for installing the target or controller software or for installing the
command line tools. When you select this function the agent downloads screen is
displayed listing the available items which can be downloaded.
v Windows Agent download - see Downloading the windows target software
on page 26

v Linux Agent download - see Downloading the Linux target software
v Windows controller download - see Downloading the windows controller
software
v Linux controller download - see Downloading the Linux controller software
on page 27
v Windows CLI Command set - see Downloading the Windows command line
files on page 27
v Linux CLI Command set - see Downloading the Linux command line files on
page 28
Downloading and installing the target software: You can download and run the
file required for installing the target software by completing the steps in the section
below which are relevant to your operating system.
Downloading the windows target software:

2. Click Tools > Downloads
3. Click Agent Downloads
4. On the Agent Downloads screen select trc_setup_target.exe
Run Selecting Run will start the install shield wizard for installing the target
software. See the IBM Tivoli Remote Control Installation Guide for
details of installing the target software.
Note: If the target software is already installed on the system , an

upgrade prompt will be displayed , click Yes to continue to the
install shield wizard.
Save Selecting Save will allow the trc_target_setup.exe file to be saved to a
selected location.
Note: Running this executable file will then install the target software.
See the IBM Tivoli Remote Control Installation Guide for details
of installing the target software.
Downloading the Linux target software:

4. On the Agent Downloads screen select ibm-trc-target-5.1.2.i386.rpm.exe. The
item with description Linux Agent download.
5. On the file download window select Save to save the rpm file to the required
location. See the IBM Tivoli Remote Control Installation Guide for details of
installing the Linux target software.
Downloading the controller software: You can download and run the file
required for installing the controller software by completing the steps in the section
below which are relevant to your operating system.
Downloading the windows controller software:


4. On the Agent Downloads screen select trc_controller_setup.exe
Run Selecting Run will start the install shield wizard for installing the target
software.
a. Click Next at the install program welcome screen.
b. Accept the license agreement, click Next.
c. Accept or change the location for the installation files, click Next.
d. Click Install.
e. Click Finish.
Note: If the controller software is already installed on the system ,

modify, repair or remove options will be available.
Save Selecting Save will allow the trc_controller_setup.exe file to be saved to
a selected location.
Note: Running this executable file will then install the controller
software using the same procedure as in the Run section above.
Downloading the Linux controller software:

4. On the Agent Downloads screen select ibm-trc-controller-5.1.2.noarch.rpm. The
item with description Linux Controller download.
location.
6. At a command prompt use the following command to install the controller
software
$ rpm -ivh ~/IBM/Tivoli_Remote_Control/RCTarget/ibm-trc-controller-
5.1.2.noarch.rpm
Downloading the command line software:
Downloading the Windows command line files:

4. On the Agent Downloads screen select trc_cli_setup.exe
Run Selecting Run will start the install shield wizard for installing the
command line software.
a. Click Next at the install program welcome screen.
b. Accept the license agreement, click Next.
c. Accept or change the location for the installation files, click Next.
d. On the server address screen type in the required information then
click Next :-

Server host name
Enter the IP address or server name of the TRC server.
Use secure connections(https)
Select https if you require secure connections
Advanced settings
Click Advanced settings to allow you to set the context and
server port
e. On the Proxy settings screen do one of the following steps then
click Next:-
v If you are not using proxy server or remote control gateway, click
Next.
v If you require to use a Proxy select Use a proxy server or a
remote Control Gateway then type in the required information
Select Use a proxy server
1)
Type in the address for the Proxy server
2)
Type in the port that proxy server is listening on
3)
Select whether you are using an http proxy or a rc gateway
4)
Select proxy requires authentication and enter the id and
5)
password required for authenticating to the proxy server.
f. Accept the default port or type in a required value, click Next
g. Click Install.
h. Click Finish.
Save Selecting Save will allow the trc_cli_setup.exe file to be saved to a
selected location.
Note: Running this executable file will then install the command line
software using the same procedure as in the Run section above.
You should now have the following executable files located in the directory
defined in step 5c on page 27.
v wrc.exe
v wrcmdpcr.exe
See Chapter 21, Using remote control commands from the command line, on
page 85 for details of using these tools.
Downloading the Linux command line files:

4. On the Agent Downloads screen select ibm-trc-cli-5.1.2.i386.rpm. The item with
description Linux CLI command set.
location.
6. At a command prompt use the following command to install the command line
software
$ rpm -ivh ~/IBM/Tivoli_Remote_Control/RCTarget/ibm-trc-cli-5.1.2.i386.rpm
7. When the installation is complete edit the ibmtrc.conf file and set your
required configuration.

v Set the value of ServerURL to the hostname or IP address of your IBM Tivoli
Remote Control Server
v If you require FIPS compliancy set the value of FIPSCompliance to Yes.
8. Save the file.
Note: After you have installed the CLI command set on the target you must
uninstall this before installing the target software by running the following
command
$ rpm -e ibm-trc-cli
Accessing help
The Help menu allows you to find out the version of IBM Tivoli Remote Control
Server that you are using and gives you access to the online documentation by
using the following options :-
On-Line Documentation
This option will take you to the IBM Tivoli Remote Control information
center where you can view the latest documentation.
About Tivoli Remote Control
This option will display the version number of the currently installed
server software.

Part 2. Using IBM Tivoli Remote Control as a controller user

Chapter 4. Controller Interface
The IBM Tivoli Remote Control controller is the interface used by the controller
user to communicate with the target. It provides you with the ability to connect to
a machine with the target software installed and perform certain functions as if at
the local machine.
The controller window toolbar provides a selection of menus and menu items
which you can use during a remote control session to communicate with and
perform actions on the target. The following list gives a brief description of these
items.
Connection icon
When a remote control session is established the connection icon is

displayed . You can click this icon to disconnect from the session.
Session Dropdown list
The session list shows the types of sessions which are available for
selection during the current remote control session. The types of session
available will be dependant on the policies set for the session and can be
any or all of the following types
v Chat only
v Monitor
v Guidance
v Active
v Reboot
v File Transfer
See Chapter 5, Types of remote control sessions that can be established,
on page 37 for more details of the session types.
Enable/Disable Local Input
Allows you to forward local mouse movements and keyboard strokes to

the remote machine within an Active session. With inputs disabled, you
cannot use the mouse or keyboard to interact with the target. See
Chapter 6, Enabling and Disabling Local Input, on page 47 for more
details.
Perform action in target
Shows a dynamic menu depending on the session mode that is selected.

For example, send a soft reboot to the target, Enable Privacy , open URL.
See Chapter 7, Performing Actions on the target, on page 49 for more
details.
Get System Info

This is a feature which gathers information about the target system. See
Chapter 8, Retrieving Target System Information, on page 51 for more
details.
Open Chat Window
Opens the Tivoli Remote Control Chat Window to allow you to chat to the
target user during a remote control session. See Opening a chat window
during a remote control session on page 39 for more details.
Collaboration
Allows you to invite multiple participants into the remote control session .
See Chapter 10, Inviting multiple participants into a remote control
session., on page 55 for more details.
Controller Tools
Allows you to input text and capture the screen of the target machine. See
Chapter 11, Controller Tools, on page 59 for more details.
Record Session
Allows you to make a recording of the remote control session. See

Chapter 12, Recording a remote control session, on page 61 for more
details.
File transfer menu
Allows you to transfer files between the controller and target and vice
versa. See Chapter 13, Transferring files, on page 65 for more details.
Clipboard transfer menu
Allows you to transfer the contents of the clipboard to or from the target.
See Chapter 14, Copying Clipboard Information, on page 67 for more
details.

Enable/Disable Autoscrolling view
Allows you to scroll the view of the targets desktop without having to use
the scroll bars. See Chapter 15, Enabling and Disabling Autoscroll, on
page 69 for more details.
Enable/Disable Scaled View
Allows you to re size the view of the remote desktop to fit within the
controller window. See Chapter 16, Enabling and Disabling Scaled View,
on page 71 for more details.
Enable/Disable TrueColour
Allows you to change the colour depth of the view of the remote machine
by toggling between 8 and 24 bit colour. SeeChapter 17, Enabling and
Disabling True Colour, on page 73 for more details.
Configure Controller
Allows you to remotely install peer to peer enabled target software. See
Pre requisites for remote target installation on page 75.
Help
Opens the IBM Tivoli Remote Control Help URL which provides help and
an About screen with details of the product. See Obtaining help on page
103 for more details.
Chapter 4. Controller Interface 35

Chapter 5. Types of remote control sessions that can be
established
When establishing a remote control session with a target you have a choice of
which type of session you would like to take part in. The session types available
are defined by the policies that have been set for the session and this section
describes those modes of connection :
Active Mode Allows you to view the targets screen and control the remote
mouse and keyboard. See Taking full control of a target system.
Chat Only Allows you to chat to the target user within a window, but you will
not be able to view the targets screen. See Chatting to the target user on page
38.
Monitor Mode Allows you to view the targets screen to monitor activity, but not
control the remote mouse or keyboard.Viewing the target screen to monitor
activity on page 40
Guidance Allows you to view the targets screen and add guidance icons to it
but not control the remote mouse or keyboard.Providing guidance to the target
user on page 40
File Transfer Allows you to view the targets file system and transfer files from
your system to the target and vice versa.
Reboot Allows you to restart the target system.
Taking full control of a target system

Using IBM Tivoli Remote Control you can connect to a target and obtain full
remote control of the target system by establishing an active session. When
connected in active mode you can view the targets screen and have full remote
input control (can control the mouse and keyboard). This mode is useful when
there are no privacy issues and the target user consents to giving you full access to
their machine. Active mode incorporates all of the functionality of the other remote
control session types.
Note: The functionality may be restricted depending on the session policies that
have been set. See the IBM Tivoli Remote Control Server Administrators
Guide for details of how policies are derived for a session.
Starting an active session

To start an active session, complete the following steps: -
1. Generate the required target report.
Note: You can also use a custom report for accessing the required target. See
the IBM Tivoli Remote Control Server Administrators Guide for details
of creating custom reports.
2. Select the target you want to connect to.
3. Click Start session.

4. The start session screen is displayed giving details of the selected target and the
policies and permissions that will be assigned for the session.
5. Click Active.
6. When the Open or Save dialog is displayed, select open.
7. The controller will start to run and when the connection is established the
controller window will be displayed showing the target screen.
Notes:
1. If an error message is displayed the following may be the reason for this.
v The user or target are not a member of any groups.
v No permissions links were defined for any of the groups that the user and
target belong to.
v The target is offline.
v None of the session mode policies have been set to Yes.
v The target may already be in another remote control session, in which case
you will also see the id of the user that is logged on to the target.
Also see the IBM Tivoli Remote Control Server Administrators Guide for
details of groups, policies and permissions
Changing to Active Mode during a remote control session

If the session that has been established is not an active session you can change to
an active session by performing the following procedure.
1. From the session type list on the controller window select active.
2. The remote control session will now continue in active mode giving you the
ability to control the remote mouse and keyboard.
Note: Depending on the policies set for the session, the target user may be
asked to accept or refuse the session mode change. If they refuse, the
session will not change to active mode.
Chatting to the target user

IBM Tivoli Remote Control allows you to participate in online conversation with
the target user in two ways.
v Chat only mode - This method of chat is performed by establishing a chat only
session which allows you to chat but you do not see the target screen. See Chat
Only Mode.
v Open chat window - This method of chat allows you to chat to the target user
whilst in another type of remote control session. See Opening a chat window
during a remote control session on page 39
Note: Depending on the policies set for the session, this option may not be
available.
Chat Only Mode

Chat only mode allows you to connect to the target and carry out an online
conversation with the target user but you will not be able to view the target screen.
Starting a chat only session

To start a chat only session, complete the following steps: -

5. Click Chat.
7. A chat session will be established. Type your message in the lower window
then click the Send button. This will send the message to the target and the
target user will see the message on their screen. The message will also be
displayed in the view area above the input window in your chat window.
Clicking Clear will remove any message sent, from your view only and the
chat history will still be visible on the target screen. .
There are also options to Copy Selected text and Paste . These options
allow you to copy text from the chat area to be pasted to another location and
paste already selected and copied text into the chat area.
Copy selected text
1. Select the required text within the chat window.
2. Click Copy selected text. This text can now be pasted into another
location on the controller system. For example to be added to an email.
Paste
1. Select and copy ( using CTRL+C) text that is not in the chat window.
For example from a open document.
2. In the controller window click Paste. The text is now pasted into the
input field of the chat window.
3. Click Send to forward the text to the target user.
Changing to chat only mode during a remote control session

If the session that has been established is not a chat only session you can change to
this type of session by performing the following procedure.
1. From the session type list select Chat only.
2. The remote control session will now continue in chat mode. You will no longer
be able to view the target screen.
session will not change to chat mode.
Opening a chat window during a remote control session

During a remote control session you can carry out an online conversation with the
target user, if required, by opening a chat window. This can be useful for obtaining
more information when trying to resolve a problem.
Note: Depending on the policies set for the session, the open chat window icon
may not be available for selection.
You can open a chat window while in another type of remote control session by
performing the following procedure.
Chapter 5. Types of remote control sessions that can be established 39

1. In the controller toolbar click the Open chat window icon.
2. Type your message in the lower window then click the Send button. This will
send the message to the target and the target user will see the message on their
screen. The message will also be displayed in the view area above the input
window in your chat window. Clicking Clear will remove any message sent,
from your view only and the chat history will still be visible on the target
screen. .
There are also options to Copy Selected text and Paste. These options are
explained in Starting a chat only session on page 38.
Viewing the target screen to monitor activity
Starting a monitor session

To start a monitor session, complete the following steps: -
5. Click Monitor.
controller window will be displayed showing the target screen with Monitor
showing in the session type field.
Changing to monitor mode during a remote control session

If the session that has been established is not a monitor session you can change to
1. From the session type list select Monitor.
2. The remote control session will now continue in monitor mode. You will still be
able to view the target screen but will have no control over the remote
keyboard or mouse.
Notes:
1. Depending on the policies set for the session, the target user may be asked to
accept or refuse the session mode change. If they refuse, the session will not
change to monitor mode.
2. The Disable Input, Perform Action in target and Clipboard Transfer menu on
the toolbar become inactive when a monitor session is established.
Providing guidance to the target user

You can remotely connect to a target system to provide guidance to the target user
to help solve a problem. When connected in guidance mode you can view the
targets screen, but you will have no input control (cannot control the mouse or
keyboard). However through a series of graphically implicit icons you can guide
the target user to perform necessary tasks on the target machine. This type of

session mode is often used in training situations, and in workplaces of very high
sensitivity. For example financial institutions.
Note: When opening a guidance session with a Linux target the Clear instructions
function will not remove any drawings or instructions from the target
machine. Maximising a window on the target or performing something
which requires a repaint of the target screen may remove them.
Starting a guidance session

To start a guidance session, complete the following steps: -
4. The start session screen is displayed giving details for the selected target and
the policies and permissions that will be assigned for the session.
5. Click Guidance.
controller window will be displayed showing the target screen with Guidance
showing in the session type field. You will now be able to provide guidance by
using the various guidance tools that are available . See Using the guidance
tools for more details.
Changing to guidance mode during a remote control session

If the session that has been established is not a guidance session you can change to
1. From the session type list select Guidance.
2. The remote control session will now continue in guidance mode. You will still
be able to view the target screen, will have no control over the remote
keyboard or mouse but can provide guidance instructions on screen using
drawing and highlighting tools. See Using the guidance tools for more
details.
session will not change to guidance mode.
Using the guidance tools

When you have established a guidance session with a target you can use various
tools to provide instructions for the target user to show them where to click their
screen or to highlight a particular part of the screen. These tools are available in
the Perform action in target menu in the controller window.
Note: It should be noted that these tools (except the Guidance Tool) are also
available for use while in an active session.

Guidance Tool
Allows you to direct the target user by placing symbols on the screen
which tell them what and where to click . See Using the guidance tool
for more details.
Drawing Tool
Allows you to draw simple coloured lines on the target screen. For
example to circle something for them to note.
Highlight Tool
Allows you to highlight parts of the target screen.
Clear Instructions
Allows you to clear all guidance instructions from the targets screen.
By using the on-screen guidance symbols and the Opening a chat window during
a remote control session on page 39 capability you can guide the target user
through any task they may have to perform on the target machine.
Using the guidance tool

The guidance tool allows you to place symbols on the target screen to give the
target user directions of what to click on their screen or where to click.
To use the guidance tool complete the following steps :-

1. Click Perform action in target > Guidance Tool.
2. Move your mouse to where you want the target user to place their mouse and
click the mouse button which you want them to click. For example, the left
mouse button. A list of actions will then appear.
3. Select the action that you want the target user to perform. For example Single
Click. The guidance symbol for that action will now be displayed on the screen
indicating to the target user which button on the mouse to click and which
action to perform on that button.
Guidance Tool Symbols

Using the guidance tool allows you to display action symbols on the target screen
which indicate to the target user which mouse button that they should press and
what action should be taken. The following actions are available
v Cancel - This will cancel the mouse action that you just performed and not place
a guidance symbol on the target screen.
v Move - Indicates to the target user to move their mouse at that particular
location on the screen.
v Single click the mouse button
v Double click the mouse button
v Drag Start - for holding down the mouse button while dragging the mouse. This
indicates where to start this action.
v Drag Stop - for holding down the mouse button while dragging the mouse. This
indicates where to stop this action.

The following table shows the relevant actions and their symbols.
Table 1. Mouse Action Symbols
Single Click Single Click Double Click Double Click
Left Hand Right Hand Left Hand. Right Hand. Drag Start Drag Stop
The mouse button that you click will determine which mouse button on the
guidance symbol will be shaded to indicate to the target user which button to
press. The following table gives examples of the symbols showing how each mouse
button action will look.
Table 2. Mouse action symbols
Left Hand button Middle button Right Hand button
All symbols placed on the remote screen can be removed by using Clear
Instructions on page 44
Using the drawing tool

The Drawing Tool allows you to draw basic coloured lines on the target screen to
mark parts of the screen that you want the target user to take note of.
To use the drawing tool complete the following steps :-

1. Click Perform action in target > Drawing Tool.
The cursor now changes to the drawing tool cursor within the session
window.
2. To draw a line move the mouse while holding down the left or the right mouse
button.
Note: Using the left button produces blue lines, the right button green lines
and the centre button (or right and left together) produces red lines.
All lines drawn on the remote screen can be removed by using Clear Instructions
on page 44
Using the highlight tool

The Highlight Tool allows you to highlight an area on the target screen.
To use the highlight tool complete the following steps :-

1. Click Perform action in target > Highlight Tool

The cursor now changes to the highlight tool cursor within the session
window.
2. To highlight text on the target machine screen move the mouse while holding
down the left or the right mouse button then release the mouse button when
you have highlighted the required area.
All highlights can be removed by using Clear Instructions.
Clear Instructions
The clear instructions function allows you to remove any guidance symbols, drawn
lines or highlighted areas that you have placed on the remote control session
screen.
To use clear instructions complete the following steps:-

1. Click Perform action in target > Clear Instructions
All guidance symbols will now be removed from the screen.
Note: When in a guidance session with a Linux target the Clear instructions
function will not remove any drawings or instructions from the target
machine. Maximising a window on the target or performing something
which requires a repaint of the target screen may remove them.
File Transfer Mode

File Transfer Mode is a connection mode that a controller can use to remotely
connect to a target. When connected in File Transfer Mode the controller can view
the targets file system and can transfer files from the controllers machine to the
target and vice versa. There is also an option to delete files and directories and
create a directory. The option to establish a File Transfer Mode Session will depend
on the policies set for the session.
When the connection is established the controller window shows two panes. The
pane on left shows the controllers file system, the pane on the right shows the
targets file system.
Copy from controller to target
To Copy one or more files from the controller to the target complete the following :
-
1. Select the right pane
2. Navigate to the location that the file(s) will be copied to on the target
3. Select the left pane
4. Navigate to the location of the file(s) to be copied.
5. Select the required file(s) (multiple files can be selected by holding the Ctrl key
and clicking the left mouse button)
v Drag the file to the right pane ( can only do when copying 1 file )
v Click Copy
Selected file(s) will appear in the target file system

Copy from target to controller
To Copy one or more files from the target to the controller complete the following :
-
1. Select the left pane
2. Navigate to the location that the file(s) have to be copied to on the controller
3. Select the right pane
4. Navigate to the location of the file(s) to be copied.
5. Select the required file(s) (multiple files can be selected by holding the Ctrl key
and clicking the left mouse button)
v Drag the file to the left pane ( can only do when copying 1 file )
v Click Copy
Selected file(s) will appear in the controller file system
Delete
Files and directories can be deleted from both the controller and the target.
To Delete one or more files or directories complete the following : -

1. Select the left pane to delete from the controller OR select the right pane to
delete from the target
2. Navigate to and select the required the required files or directories (hold the
Ctrl key and click the left mouse button to select multiple )
3. Click Delete
4. At the prompt click Yes to delete
New Directory
A new Directory can be created on the controller or target by completing the

following :-
1. Select the left pane for the controller OR select the right pane for the target
2. Navigate to the required the location for the new directory
3. Click New Directory
4. Type in a name for the directory and click OK
Refresh
Clicking the Refresh button will refresh the display of the selected pane and clear
any selections.
Reboot Target Machine

Reboot Target Machine
Reboot Mode is a connection mode that a controller can use to remotely reboot the
target machine.
To Reboot, select Reboot from the dropdown list. A window will open telling the
controller that the target is rebooting. There is an option to reconnect in a different
session mode if required. The target machine will shut down and restart.

Chapter 6. Enabling and Disabling Local Input
Enable Local Input enables the controller to take control of the mouse and
keyboard on the target machine.
Local Input is only available through an Active session. The following toolbar icon
is available when the inputs are enabled.
Note: On opening the controller, the Local input will be set dependant on the type
of session. When initiating a remote control session the input must be
enabled in order to control the target system. When switching from Active
session to another session the Local Input will be disabled. If the target user
moves the mouse, you will be temporarily blocked from sending any input
events to the target until the target user stops moving the mouse. The icon
changes to a blocked mouse image.

Chapter 7. Performing Actions on the target
Perform Action in target
The Perform Action in target menu allows you to perform various actions on the
target system during an active or guidance remote control session. The following
actions are available depending on the type of remote control session that has been
established. The full list is available during an active session and a limited number
of actions are available during a guidance session.
Inject Ctrl + ALT + Del
This action allows you to perform a soft reboot on the target system.
Inject ALT + F4
This action allows you to close the active window on the target machine.
Inject ALT + Tab
This action allows you to switch between active windows on the target
machine.
Inject Alt + Enter
This action allows you to run a command prompt window on the target in
full screen mode. Performing the action again returns the command
prompt window to normal mode.
Inject Control + Esc
This action allows you to open and close the Start menu on the target
machine.
Drawing Tool
The Drawing Tool allows you to draw basic coloured lines on the targets
screen. For example to point to a particular area on the target screen or
show them where to look. See Using the guidance tool on page 42 for
further details.
Highlight tool
The Highlight Tool allows you to select and highlight a specific area on the
targets screen. See Using the highlight tool on page 43 for further
details.
Clear Instructions
This action allows you to remove all guidance drawings or highlighted
areas from the target screen.
Lock Workstation
This action allows you to lock the target workstation.
Open URL
This action allows you to type in a URL that will be opened in the target
machines default web browser. Type in the URL and click OK. The target
default browser will now open at the specified URL.
Screens
This action allows you to select which of the target screens is shown in the
controller window if the target had multiple screens configured. For
example if the target has two screens configured there will be two entries
in the submenu: Screen 1 and Screen 2 so that you can toggle the remote
view between those.

Enable Privacy
This action allows you to hide the target screen from the target user. The
target screen is blacked out with a message saying that the system is being
serviced by Tivoli Remote Control but you are still able to work with the
target system on your screen. This functionality is useful when working on
systems with sensitive information.
Registry Keys
This menu item will only be available if the Allow registry key lookup or
View registry key list policies are enabled for the session When you click
this menu item there may be two options available to you depending on
the policies that have been set for the session. See the IBM Tivoli Remote
Control Server Administrators Guide for details of editing policies. The
two options that can be available for selection are : -
A list of defined registry keys
You can click on one of the listed keys to see its current value on the
target. The keys are defined in the trc.properties file and the names that
are listed correspond to a specific registry key on the target. See the IBM
Tivoli Remote Control Server Administrators Guide for editing the
properties files.
For example:-
When you click Registry keys you may see Services listed,
if you click on Services a new window will open listing all of the
services on the target.
Entering a specific registry key
You can click on the Enter key item to allow you to enter a specific registry
key that you want to know the value for by completing the following steps
:-
v Type in a key value in the Registry key field
for example HKLM\SYSTEM\CurrentControlSet\Services\TRCTarget
Note: Please make sure you enter the exact path to the registry key.
v Click View
v This will open a new window showing the current values for the
specified key
Note: This is a dynamic menu which will change dependant upon which
operating system is being controlled and the connection mode. This option
might be disabled depending on the Operating system and policies in the
session.

Chapter 8. Retrieving Target System Information
To allow you to see retrieve and see information about the target, for example, the
amount of memory or type of network connection, select Get System Info. This
action initiates a very small but useful utility called IBM System Information
Gatherer LITE which provides information about the remote machine.
1. Click on the Get System Info icon in the taskbar

2. A text file called sysinfo.txt will be automatically created on the target
machine and sent back to be displayed on the controller.
On the controller system the file is saved within:
$HOME on a UNIX system.
%USERPROFILE%\IBM_FT on a Windows system.
Note: Depending on the policies set for the session, the target user may be asked
to accept or refuse the system information request. If they refuse, the system
information will not be displayed.

Chapter 9. Chatting to the target user during a remote control
session
During an active, guidance and monitor remote control session you are able to chat
to the target user by selecting the Open chat window option. The availability of
this option will be dependant on whether the policies set for the session have
enabled the chat function.
To initiate a chat with the target user during a remote control session, complete the
following steps :-
1. Click the Open Chat Window icon:
2. The Tivoli Remote Control Chat Window opens on the controller system and
the chat area is opened in the target window.
3. Type your text in the text input box and click Send or press Enter.
4. Click Clear to remove any text which has been typed in the Tivoli Remote
Control Chat Window.
5. To close the chat window click the X in the top left hand of the window.
Note: The Clear button will only remove the text from the chat window on the
controller screen, and not the target.

Chapter 10. Inviting multiple participants into a remote control
session.
When a remote control session is established with a target you can use the
collaboration functionality to allow other participants to join the session when they
request to start a session with the target. This function is useful for obtaining
additional help for a problem as all controller users who join the session can see
the target screen. The controller who initiates the session with the target is known
as the master controller and it is this user who controls the activity in the session.
For example, who is allowed to join, how many people are allowed to participate
or who should have control of the session. The availability of this functionality is
determined by the Allow multiple controllers policy and if set to No for the
session you will not have the ability to allow other participants into the session.
See IBM Tivoli Remote Control Server Administrators Guide for details of policies
and permissions.
Starting a collaboration session

To start a collaboration session to allow others to join the session you need to start
a session with the required target and become the master controller by completing
the following steps: -
1. Generate a target report that contains the required target. For example All
targets.
2. Select the required target.
3. Select Start session.
4. When the session is established, click the Open the collaboration panel for
multiple controllers icon in the controller window toolbar.
5. The Collaboration Control Panel opens and you are now the master controller
for the session. Click Start.
Figure 2. Collaboration Control Panel

You now have the ability to allow other participants to join this remote control
session. See Joining a collaboration session for details of requirements for
allowing others to join. When other participants have joined the session you can
use the functions within the Collaboration Control Panel to control the activity
within the session. SeeControlling session activity as the master controller for
more details. You can also accept or reject requests for control of the session from
the other participants. See Controlling session activity as a participant on page
57 for more details.
Joining a collaboration session

When you try to initiate a remote control session and select a target to start the
session with, this target may already be connected to another session. If this is the
case and the controller of this session has started a collaboration session ( see
Starting a collaboration session on page 55 ) you can request to join the session
by completing the following steps :-
1. Generate a target report that contains the required target. For example All
targets.
2. Select the required target.
3. Select Start session.
4. On the Create new session screen you will see a message saying that the target
is already in a session but is accepting multiple participants. Click Join.
5. The remote control session will start to initiate and a message will be sent to
the master controller to let them know that you have requested to join the
session, allowing them to accept or deny the request.
Yes If the master controller clicks Yes the remote control session will be
established but you will have no control over the session. The master
controller will now see you listed in the participants list in the
Collaboration Control Panel.
Note: If the policy for Allowing chat in session and for allowing local
recording have been enabled for the session they will be
available for use. This would allow you to chat to the master
controller if required ( see Opening a chat window during a
remote control session on page 39 ) or to make a recording of
the session ( see Recording a session locally on page 62) .
No If the master controller clicks No you will not be allowed to join the
session and you will receive a message that the target has refused the
session. Click OK.
When you join a collaboration session you can request control of the session by
using the collaboration icon in the toolbar. SeeControlling session activity as a
participant on page 57 for more details.
Controlling collaboration session activity
Controlling session activity as the master controller

After you have established a collaboration session and have become the master
controller you will be able to control the session activity from within the
Collaboration control panel, using the following options :-

Give control
Allows you to select a participant to allow them to take control of the
session
1. Select a participant from the participants list.
2. Click Give control.
The selected participant now has control of the session and the target and
is able to use the tools and actions that are available in the controller
window toolbar. They can also change the session type by selecting from
those available in the session pulldown.
Note: The master controller will no longer have control of the session and
parts of their controller toolbar will be inactive.
Revoke control
When control has been granted to a participant you can take back control
of the session at any time. To take back control complete the following
steps :-
1. Select the participant from the list.
2. Click Revoke control.
Control now passes back to the master controller, whose controller toolbar
becomes available for use, and the selected participant no longer has
control.
Disconnect
You can disconnect selected participant(s) from the session at any time by
completing the following steps :-
1. Select the required participant(s).
2. Click Disconnect.
The selected participant(s) will receive a message that the session has been
cancelled and when they click OK the session is ended.
Disconnect all
You can disconnect all participants from the session at any time by clicking
Disconnect all. All participants will receive a message that the session has
been cancelled.
Participants limit
This value determines the maximum number of participants who are
allowed to join the session. The number is in the range of 1 to 10 and set
to 3 as default whenever a collaboration session is established. You can
change this value at any time during a session. When a controller tries to
join a session, if the limit has already been reached they will receive the
following message when they click Join. Session rejected because the
limit has been reached.
Controlling session activity as a participant

As well as the master controller having control over the collaboration session, the
participants can also ask for control of the session by using the following options
within the Collaboration control panel. This is available by clicking the Open the
collaboration panel for multiple controllers icon on the controller window toolbar
on the participants system.
Request control
Chapter 10. Inviting multiple participants into a remote control session. 57

You can use the Request control option to ask the master controller for control of
the collaboration session. To request control complete the following steps :-
1. Click the Open the collaboration panel for multiple controllers in the
controller window toolbar. The Collaboration control panel will open.
2. Click Request control. The master controller will now receive the following
message with the option to accept of reject the request.
Do you want to accept the request from user XXXXX at aaa.aaa.aaa to get control
where XXXXX is the user id of the participant who is requesting control

and aaa.aaa.aaa is the IP address of the participants machine.
The outcome of the request will be dependant on the master controller and the
action that they choose.
Yes If the master controller clicks Yes you will now have control of the
session.
No If the master controller clicks No, you will receive the following
message and will not have control of the session. Click OK to continue.
Request for session control has been denied.
Returning control
After you have requested control of a collaboration session you can return the
control to the master controller by clicking Return control in the collaboration
control panel. The master controller now has control of the collaboration session
and you will no longer have control.
Note: If the collaboration control panel is not open, click the Open the
collaboration panel for multiple controllers in the controller window
toolbar.
Note: Clicking the Close dialog button will close the Collaboration control panel.
Ending a collaboration session

A collaboration session can be stopped at any time by the master controller using
the Stop button in the collaboration control panel. When this is selected all
participants in the session will be automatically disconnected and will receive a
message that the session has been cancelled.

Chapter 11. Controller Tools
The controller tools option gives you two actions that you can perform on the
target .
v Quick text input box. See Enabling quick input of text to the target screen
v Capture screen See Capturing the screen during a remote control session on
page 60
Click on the Controller tools icon in the toolbar.
The following options appear in the drop down menu.
Enabling quick input of text to the target screen

When you require to enter text onto the target screen, for example to type in a
path name or command or adding some text to a file, you can use the Quick text
input box to type in the full text required and then press Enter to send the text to
the target system. This option is only available when local input is enabled and
when it is selected, a text input box will appear everytime you press a key. This
functionality can be used to compensate for differences in controller and target
keyboards layouts for example the controller may have an English keyboard and
the target may have a French keyboard. To use the Quck input text box complete
the following steps :-
1. Click Controller tools
2. Select Quick text input box
3. Click in the window where you want to enter the text and press the key of first
character of text that you want to enter. The quick text input box will appear.
There are now three ways that you can continue to input the required text
Type text and enter
Type the required text and press Enter. The text is then input into the
target screen.
Type text and assign it to favourites list
It is possible to keep a list of commonly used text strings as favourites.
Each of these is stored in a slot assigned a number from 0 to 9. To
assign a text string to the favourites complete the following steps:-
v Type the required text then press CTRL+SHIFT+n. Where n is a
number from 0 to 9. For example CTRL+SHIFT+2.
v Press ENTER.
This will assign the text to the slot defined by the number entered.
Note: The favourites list is only maintained for the duration of the
session.
Retrieve previously entered text
The input box keeps a history of the recently typed text therefore it is
possible to retrieve previously typed strings. This can be done in two
ways.

Cycle through the text strings
You can cycle through any previously typed text strings by
clicking the UP or DOWN arrow keys.
Retrieve a string from the favourites
You can retrieve a string from the favourites list by clicking
CTRL+n, where n is the number of the slot that the string was
assigned to when it was assigned to favourites. For example
clicking CTRL+2 will retrieve the string that was saved to slot
2. Press ENTER to send the text to the target.
Notes:
a. Quick text input injects Unicode strings and is also intended to help when
typing texts and when the connection is slow.
b. The Text input box is invisible to the target.
Capturing the screen during a remote control session

The Capture screen action can be used to take a snapshot image of the target
screen as it appears in the session. The captured image is saved onto the controller
system which can be useful when problem solving, for example to attach to an
email to send to another support agent.
To use the Capture screen capability complete the following steps :-

1. Click Controller tools
2. Select Capture screen. The Capture Screen to file window will open.
3. Navigate to the required location that you want to save the image to by using
the Save In pulldown.
4. Type in a name for the file or accept the name that is given.
5. Click Save.
Note: Clicking Cancel will not save the captured screen image.

Chapter 12. Recording a remote control session
You can use the recording function to record everything that happens during a
remote control session.
Two types of recording are available:-

v Automatic recording of a session
v Local recording of a session
Automatically recording a Session

Automatic recording is determined by the Force Session Recording policy which is
set by an Administrator. See the IBM Tivoli Remote Control Administrators Guide
for more information on setting policies. If this policy is enabled for the current
session , all session activity will be recorded while the session is in progress and
will be saved to the server when the session ends. The session recording can then
be played back from the Session details screen . See Viewing session details on
page 20 for details of playing back a session recording.
Exporting and downloading a recording from the server

When a recording of a remote control session has been saved to the server you can
use the Export session recording capability to export and save the recording to
your system. See Automatically recording a Session for details of recording and
saving a session to the server.
This can be useful in a number of ways

v if a local recording was not made during the session.
v if you want to use the recordings for education or training purposes.
To export one or more recordings complete the following steps : -

1. Depending on your user authority you will have one or both of the following
options available for selection
v Sessions > All Session History
v Sessions > My Session History
2. Select the required session(s).
3. Now do one of the following actions
v Click Export session recording from the action list on the left
v OR click Sessions > Export session recording
4. If there are recordings saved for the selected sessions they will be listed on the
screen. If the recording exporting functionality has not been enabled the
following message will be displayed
The recording export functionality is disabled. Please consult the
documentation for details on how to enable it.
5. Select the required file compression
Lossless
Choosing this will compress the file without losing any detail but will
produce a larger file size. You should choose this file type if you
require a better image quality or if the recording may be used for

editing to provide educational material. To allow you to playback this
type of recording you need to install a Quicktime codec.
Compressed
Choosing this will compress the file losing very minor details and the
file size will be smaller. You should choose this file type if the
recording is only required for viewing. To allow you to playback this
type of recording you need to install an Xvid codec. This can be found
at http://www.xvid.org.
6. The filename field will be populated with a filename and extension depending
on which compression method you select.
filename
This will be in the format SSS-nnnnnnnn
where SSS = the session id
and nnnnnnnn = the computername of the target
for example : 152-tivtest1
file extension
This can be .mov or .avi.
.mov This file extension will be applied when Lossless is chosen for
the file compression.
.avi This file extension will be applied when Compressed is chosen
for the file compression.
7. Click Export recording.
8. When the recording is exported the status changes to Exported and a
Download button is available for selection.
9. Click Download.
10. Click Save.
11. On the Save As window browse to the required location for saving the
recording file to. You can change or keep the name that is given then click
Save.
Note: If you click Cancel the file will not be downloaded.
You have now exported and downloaded a recording from the IBM Tivoli Remote
Control Server and saved it to your local system. To ensure that it can be played
back correctly you need to install the correct codec as indicated in step 5 on page
61.
Note: For Linux systems you need to download and install MPlayer with support
for the Xvid codec.
Recording a session locally

Local recording is determined by the Allow Local Recording policy which is set by
an Administrator. See the IBM Tivoli Remote Control Administrators Guide for
more information on setting policies. If this policy is enabled for the current
session you can record and save the session activity to your system.
Making a local recording

To record the session complete the following steps : -
1. Click the Record session button.

2. The Save session to file window opens. Save the recording to the default
location by clicking Save or browse to the required directory then click Save.
Note: You can accept the file name and extension given for the recording file or
you can change the name and extension to your own requirements.
3. The Record session icon in the menu will turn to a Blue Square icon indicating
that the recording is in progress. To stop the recording press the Blue Square
icon .
Note: Local recording can not be posted to the Server.
Playing a local recording

A local recording can be played back using the downloadable Session Player.
To playback a local recording complete the following steps :-

1. Download the Session Player - See Download session player in Chapter 3 page
18.
2. Start the Session player by double clicking on the TRCPlayer.jar file or by
using Start -> Run then browsing to the TRCPlayer.jar file.
3. In the Open file window, browse to the directory that the saved recording is
stored in.
4. Select the required recording then click Open. The recording begins to play .
The following buttons and functions are available in the Session Player
Play To play the selected recording . When this button is clicked it changes to
the Pause button.
Pause To pause the recording while playing. When this button is clicked it
changes to the Play button.
Stop To stop the recording and the playback window clears.
Open file
v Browse to the required recording file.
v Select the required file then click Open for the recording to start playing.
Enable Auto Scrolling View
As the recording is playing, if the mouse pointer reaches the edge of the
player window, the viewing area will scroll in the relevant direction to
bring the non visible parts of the recording into view. The function works
in both the Vertical and Horizontal directions.
Enable Scaled View
This option will scale down the display of the recording to fit fully inside
the playback window
Chapter 12. Recording a remote control session 63

Chapter 13. Transferring files
File Transfer Menu
In IBM Tivoli Remote Control files can be transferred in two ways
v In a File Transfer Mode Session - seeFile Transfer Mode on page 44
v Using the File Transfer Menu
This section describes the File Transfer Menu functionality. The File Transfer Menu
options allow the transfer of files when in an Active session. The options available
in the File Transfer Menu are dependant on the policies set for the Active session .
These options are
v Send file - See Sending files to the target.
v Pull file - See Receiving files from the target.
v Open transfer folder - See Opening the file transfer folder on page 66.
Notes:
1. Open transfer folder is the only option available when in a Chat Only,
Guidance or Monitor session.
2. Depending on the policies set for the Active session, the target user may be
asked to accept or refuse the file transfer request. If they refuse, the file will not
be transferred.
Sending files to the target

The send file option allows you to the transfer files from the controller system to
the target system.
To send a file to the target complete the following steps : -

1. Click File Transfer Menu > Send file.
2. The browseable Send File to Client window opens.
3. Select the required file and click Send File.
4. A progress bar is shown as the file is transferred to the file transfer directory on
the target.
Receiving files from the target

The pull file option allows the transfer of files from the target system to the
controller system.
To receive a file from the target complete the following steps : -

1. Click File Transfer Menu > Pull file.
2. The Choose file to send window opens displaying the contents of the targets
defined file transfer directory .
Note: Click the up arrow to change to a different location if required.

3. Select the required file and click OK.
4. The file is transferred to the file transfer directory on the controller system.
The file can be viewed by following the steps in Opening the file transfer folder
on page 66.

Opening the file transfer folder
The Open transfer folder option allows you to view the files which have been
received from the target.
To open the file transfer folder complete the following steps : -

1. Click File Transfer Menu > Open transfer folder.
2. The contents of the file transfer directory is displayed.
Changing the file transfer directory location

The file transfer directory location is determined by the TransferDir property
defined in the target properties. This property can be edited and the location of the
transfer directory changed by completing the following steps on the target
Note: You will require administrative authority to edit the target registry.
:-
Windows
1. At a command prompt window run the regedit command.
2. Navigate to HKEY_LOCAL_MACHINE/SOFTWARE/IBM/Tivoli/
Remote Control/Target.
3. Right click the TransferDir property.
4. Select Modify and type the required location into the Value data field.
5. Click OK.
6. Restart the target service.
Linux
1. Edit the ibmtrc.conf file.
2. Change the value of TransferDir to the required location and save the
file.
3. Restart the target service.

Chapter 14. Copying Clipboard Information
Copying clipboard information is a simple function which allows clipboard
information to be sent to and from the controller and target systems during a
remote control session. You can use this functionality to copy text from your
system into the clipboard and then paste this into the target system or from the
target system to your system.
The Clipboard transfer menu provides two options for transferring clipboard
information.
v Send Clipboard text :- This allows you to send text from the controller system
to the target system. See Sending clipboard text to the target.
v Pull clipboard text :- This allows you to transfer text from the target system to
the controller system. See Receiving clipboard text from the target.
Sending clipboard text to the target

To send text via the clipboard to the target, complete the following steps :-
1. On your system highlight the text you want to send to the target.
2. Press the right hand mouse button and select Copy or click Edit, Copy.
3. Click Clipboard transfer menu >Send Clipboard text .
4. On the target system, in the location you wish to paste the text, for example in
Notepad , select Edit then Paste or click CTRL+V. The text will be pasted into
the required location on the target system.
Receiving clipboard text from the target

To receive text from the target via the clipboard complete the following steps :-
1. In the session window highlight the text on the target system that you want to
copy. Press the right hand mouse button and select Copy or click Edit, Copy.
2. Click Clipboard transfer menu > Pull Clipboard text.
3. On your system in the location you wish to paste the text, for example in
Notepad , select Edit then Paste. The text will be pasted into the required
location on your system.

Chapter 15. Enabling and Disabling Autoscroll
If the target systems screen is larger than the remote control session window you
can use the autoscroll functionality to view the targets screen without having to
use the scroll bars. The Enable / Disable Autoscroll option is used to enable or
disable this functionality.
Enable Autoscroll
Click Enable/Disable Autoscroll
As the mouse pointer reaches the edge of the session window the non
visible area of the target desktop will scroll into view. This function works
in both the horizontal and vertical directions.
Note: Autoscroll is off by default

Chapter 16. Enabling and Disabling Scaled View
Enable Scaled View enables the controller to reduce the size of the full target
desktop to fit within the size of the controller window. The controller window can
then be resized and the target desktop will resize accordingly.
Click on the Enable/Disable Scaled View icon. The following taskbar icon is
represented when scaled view is active
Due to a slight increase in processing power it is only recommended that this

function is used when remote or local resolutions prohibit viewing of the full
screen. When switching this function off, the Screen can be resized to the remote
system by clicking on the @ in the bottom right hand side of the controller. This
Match screen size button changes the controller window size to match the remote
system resolution: that is if the remote system is 800x600, the Match Screen Size
will attempt to change the controller window size so the remote view area of the
GUI is 800 pixels wide by 600 pixels high.
Note: On opening the controller, scaled mode is always set to disable. The option
can be switched at any point throughout the session.

Chapter 17. Enabling and Disabling True Colour
Enable/Disable True Colour allows the controller window to switch between 8
and 24 Bit colour view of the target desktop. The default view when opening the
controller is 8bit. This is a bandwidth conserving feature which reduces the
amount of data being passed across the connection during a connection with 8 Bit
colour.
Click on Enable/Disable TrueColour. The following toolbar icon is represented
when 8bit colour view is active
Note: On opening a Session, 24 bit colour mode is set to disabled. The option can
be switched at any point throughout the session depending on the policies
that have been set for the session . If the Lock colour depth policy has been
enabled you will not be able to switch to a different colour mode. See IBM
Tivoli Remote Control Server Administrators Guide for details of policies
and permissions.

Chapter 18. Remotely installing the target software in a peer
to peer session
When you have downloaded and installed the IBM Tivoli Remote Control
controller, for use in establishing peer to peer sessions with targets, you can also
use it to remotely install the target software and enable it for peer to peer mode.
See the IBM Tivoli Remote Control Installation Guide for details of installing and
enabling peer to peer mode and Starting a peer to peer session on page 93 for
details of running peer to peer sessions.
Pre requisites for remote target installation

Before using the remote install utility there are a number of pre requisites required
depending on the operating system that you are using on the target.
Note: The use of this function in Windows 7 and Windows 2008 R2 will be
supported in a future release.
Windows XP pre requisites

Windows XP systems must have Simple File Sharing disabled. Simple File Sharing
forces all logins to authenticate as guest but a guest login does not have the
authorisations necessary for the remote install utility to function. To disable Simple
File Sharing complete the following steps :-
1. Using Windows Explorer click Tools > Folder Options.
2. Select the View tab.
3. Scroll through the list of settings until you find Use Simple File Sharing.
4. Remove the check mark next to Use Simple File Sharing, then click Apply and
OK.
Windows XP includes a built-in firewall called the Internet Connection Firewall
(ICF). By default, ICF is disabled on Windows XP systems. Windows XP Service
Pack 2 comes with the Windows Firewall on by default. If either firewall is enabled
on a Windows XP or Vista target, it will block attempted accesses by the remote
install utility. On XP Service Pack 2, you can select the File and Printer Sharing box
in the Exceptions tab of the Windows Firewall configuration to allow access.
Windows Server 2008

On Windows Server 2008 shares must be shared for the Guest or Everyone
accounts, and password protected sharing must be disabled. To disable password
protected sharing on Windows Server 2008, complete the following steps:
1. Click Control Panel> Networking and Sharing Centre.
2. Click the down arrow that is next to Password protected sharing.
3. Click Turn off password protected sharing.
4. Click Apply and exit the control panel.
Additionally, on Windows Server 2008 you might need to disable User Account
Control if your account is not a domain user account. See Windows Vista on
page 76 to learn how to disable User Account Control. You can select the File and
Printer Sharing box and the remote registry box in the Exceptions tab of the
Windows Firewall configuration to allow access if the firewall is enabled.

Windows Vista
Password protected sharing must be disabled. To disable password protected
sharing on Windows Vista systems, perform the following steps:
1. Click Control Panel > Networking and Internet >Sharing and Discovery.
2. Click the down arrow that is next to Password protected sharing.
3. Click Turn off password protected sharing.
4. Click Apply and exit the control panel.
The new User Account Control feature in Windows Vista requires users to perform
several steps before the remote install utility can communicate with Vista targets. If
you have a domain user account, ensure that the controller and the target machine
are both members of a Windows domain. You can select the File and Printer
Sharing box and the remote registry box in the Exceptions tab of the Windows
Firewall configuration to allow access if the firewall is enabled. If you are a
member of a local administrators group and you use a local user account, complete
the three steps below to be able to perform administrative tasks on the target
machine:
1. Enable the built-in Administrator account and use it to connect.
a. Open the Windows Control Panel.
b. Click Administrative Tools > Local Security Policy > Security Settings >
Local Policies > Security Options.
c. Double-click on Accounts: Administrator account status and select enable.
d.
2. Disable User Account Control if a different Administrator user account is to be
used to connect to the Vista target. To disable User Account Control complete
a. Open the Windows Control Panel.
b. Click Administrative Tools > Local Security Policy > Security Settings >
Local Policies > Security Options.
c. Double-click User Account Control: Run all administrators in Admin
Approval Mode and select disable. Changing this setting requires a system
reboot.
3. Disable User Account Control when you administer a workstation with a local
user account (Security Account Manager user account). Otherwise, you will not
connect as a full administrator and will not be able to perform administrative
tasks. To disable User Account Control complete the following steps :-
a. Click Start, click Run, type regedit, and press ENTER.
b. Locate and then click the following registry subkey:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\
CurrentVersion\Policies\System
c. If the LocalAccountTokenFilterPolicy registry entry does not exist, follow
these steps:
1) On the Edit menu, point to New, and then click DWORD Value.
2) Type LocalAccountTokenFilterPolicy, and press ENTER.
d. Right-click LocalAccountTokenFilterPolicy, and click Modify.
e. In the Value data box, type 1. Click OK.
f. Restart your computer.
Alternatively, you can modify the registry entry manually by typing the
following command :

cmd /c reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\system
/v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f
UNIX and Linux targets

You must ensure SSH is installed and enabled on any target you want to access
using SSH protocol. OpenSSH 3.71, or higher, contains security enhancements not
available in earlier releases.
Connections cannot be established with any UNIX targets that have all remote
access protocols (rsh, rexec, or SSH) disabled.
In all UNIX environments except Solaris, the Bourne shell (sh) is used as the target
shell. On Solaris targets, the Korn shell (ksh) is used instead due to problems
encountered with sh.
In order to communicate with Linux and other SSH targets using password
authentication, you must edit the file /etc/ssh/sshd_config file on target machines
and set:
PasswordAuthentication yes
(the default is no)
After changing this setting, stop and restart the SSH daemon using the following
commands:
/etc/init.d/sshd stop
/etc/init.d/sshd start
In order to use SFTP for file transfers, in addition to calling

SSHProtocol.setUSESFTP(true), make sure that the SFTP server is enabled on the
target machine.
Note: The location of the sftp-server is OS dependent. It is typically found in the

following locations:
v Solaris: /usr/lib/ssh/sftp-server
v Linux: /usr/libexec/openssh/sftp-server
v HP-UX: /opt/ssh/libexec/sftp-server
v AIX: /usr/sbin/sftp-server
The sshd_config file contains a line similar to the one below. Make sure that the
line that enables the sftp-server subsystem is not commented out, and that it points
to the OS-specific location of the sftp-server subsystem.
For example:
Subsystem sftp /one_of/the_paths/shown_above
To perform the remote install action you will also require the following
information
v Target hostname or IP address.
v The admin user id used for logging on to the target.
v The admin password used for logging on to the target.
Chapter 18. Remotely installing the target software in a peer to peer session 77
Performing a remote target install from the controller
Once you have installed the controller software locally and have it running you
can remotely install the target software using the Configure controller icon. See the
IBM Tivoli Remote Control Installation Guide for details of installing the controller
software.
To remotely install peer to peer enabled target software from the controller,
complete the following steps :-
1. Click on the Configure controller icon in the toolbar
2. Select the item required

Target Remote Install
To perform a remote install of the target software complete the
following steps : -
a. Supply the required information
Platform Type
Select the operating system that is running on the target.
Target Host
Enter the hostname or IP address of the target.
Target User Name
Enter a valid userid for logging on to the target operating
system.
Target password
Enter here a valid password for logging on to the target
operating system.
b. Select Connect upon installation if you want to start a remote
control session with the target as soon as the target software is
installed.
c. For further configuration click Advanced , set the required options
then click OK. You can accept the values that are shown or change
them to the required values for your environment.
Target Listening Port
Specify the port that the target will listen for remote control
connections on. Default is 888.
Installation Folder
Specify the installation path for the target files.
Temporary Folder
Specify a path to a folder where temporary installation files
will be stored during the install.
Note: You should only change this field if required.

Use a FIPS certified cryptographic provider
Select this to enable FIPS compliancy on the target. See IBM
Tivoli Remote Control Installation Guide for details of
enabling FIPS compliancy.
Authenticate using Windows logon
Determines the appearance of a login window when the
session type button is clicked on the Open Connection

window. If enabled, the controller user must logon with a
valid windows user id and password.
Enable user acceptance for takeover sessions
Select this to enable the user acceptance dialog which will
appear to the target user allowing them to accept or refuse
the session.
d. Click OK.
Target Remote Uninstall
To perform a remote uninstall of the target software complete the
following steps : -
a. Enter the required information
Platform Type
Select the operating system that is running on the target.
Target Host
Enter the hostname or IP address of the target.
Target User Name
Enter a valid userid for logging on to the target operating
system.
Target password
Enter a valid password for logging on to the target
operating system.
b. For further configuration click Advanced , set the required options
then click OK. You can accept the values that are shown or change
them to the required values for your environment.
Remove all instances
The target registry is checked for any IBM Tivoli Remote
Control target installations and any that are found are
deleted.
Full registry search
The target registry is checked for any IBM Tivoli Remote
Control target installations and any that are found are
deleted. However this is the longer option as you are shown
all of the target installations that are found and are given
the opportunity to select which one(s) to delete.
c. Click OK.
Note: This icon is not available in a controller which is initiated from a remote
control session request from the server.
Chapter 18. Remotely installing the target software in a peer to peer session 79
Chapter 19. Obtaining help from the controller interface
When using the controller interface you can access the online documentation or
find out the version of TRC that you are running by using the Shows Help icon.
1. Click on the Shows Help icon in the toolbar
2. Select the item required

Help Select this item to access the online IBM Tivoli Remote Control
documentation via your default browser.
About A window will open displaying the product name and version number.
Click the window or any key to return to the IBM Tivoli Remote
Control application.

Chapter 20. Ending a Session
Ending a session can be performed by the controller in a number of different ways
:
Method 1
1. Click on the Connection icon in the taskbar.
2. A warning message will ask There is a session in progress. QUIT?

3. Click on Yes
4. The session will be ended and the target user will regain sole control of their
desktop
Method 2
1. Click on the X in the Top Right hand side of the controller window
2. A warning message will ask There is a session in progress. QUIT?
3. Click on Yes
4. The session will be ended and the target user will regain sole control of their
desktop
Note: The target user can press Pause on their keyboard or click on the connection
icon to end the session.
For further details see Disconnecting a remote control session in the target
section Chapter 26 . If the target closes the session it will be ended immediately
without confirmation from the controller.

Chapter 21. Using remote control commands from the
command line
There are two commands which can be run from the command line that will allow
you to start a remote control session with a target and run commands on a target
system without target user interaction. These commands can be useful if you want
to connect to a target without using the usual IBM Tivoli Remote Control Server
interface or for using as part of a script to run multiple commands in an
automated fashion. These commands were also available in IBM Tivoli Remote
Control 3.8.1, see Mapping of arguments, for the command line tools, from TRC
3.8.1 to TRC 5.1.2 on page 90 for details of the changes between the usage in the
two versions. See the IBM Tivoli Remote Control Installation Guide for details of
how to install the command line tools.
There are two command line tools available

v wrc - to start a remote control session.
v wrcmdpcr - to run a command on a target and see the output from the
command on the machine that you issued the command from.
Before using the command line tools the following configuration actions should be
carried out.
v The server URL defined in the trc.properties file on the server should be the
same URL defined in the ServerURL in the target properties.
v The remote control port defined during the installation of the command line
tools should be the same on both the machine that the commands are being
issued from and in the target settings.
v If FIPS compliancy is required the machine that is issuing the command and the
target both require FIPS compliancy enabled. See IBM Tivoli Remote Control
Installation Guide for details of enabling FIPS compliancy.
Note: The machine that will be launching the controller software will require a
registry key entry named JavaHome which contains the path to the FIPS
compliant IBM JRE which is installed with the controller software. If you
are launching the controller on a remote machine you will have to create
a registry key entry on the remote machine too.
Windows
C:\Program Files\IBM\tivoli\Remote Control\Controller\jre
Linux Edit the ibmtrc.conf file and update the value of the JavaHome
property.
v If logging needs to be enabled when running the wrcmdpcr command ensure
that the DebugTrace property is set to yes, in the target settings, to allow a text
file, cli_trace.txt, to be created in the same location as the target log files.
Note: The wrc and wrcmdpcr commands do not work if launching the remote
controller or the commands on machines where you need to establish the
connection through TRC gateways.

Starting a remote control session from the command line
You can start a session with a target by running the wrc command which allows
you to specify the type of remote control session that you would like to start with
the target.
Note: The target software must be installed on the target that you are starting a
session with.
To start a remote control session complete the following steps :-

1. At a command prompt navigate to the directory where you installed the
command line tools.
2. Type in the wrc command to start a session. The command has the following
syntax :-
wrc user:password Action Rctarget [Rccontroller] [options]
user:password
Type in here a valid userid and password that you would use to logon
to the IBM Tivoli Remote Control Server.
Action
The action defines which type of remote control session that you want
to establish.
v rc - Used in conjunction with option -S. Using this action will start a
remote control session whose type is determined by the value
assigned to option -S
v filexfer or filetransfer - Use either of these if you want to start a file
transfer session with the target.
v active - Used to start an active session with the target.
v reboot - Used to reboot the target.
v guidance - Used to start a guidance session with the target.
v monitor - Used to start a monitor session with the target.
v chat - Used to start a chat session with the target.
Rctarget
Specifies the computername or the IP address of the target that you
want to start a session with. It has the following syntax:
@Endpoint:<computername or ipaddress>
Rccontroller
If you want the controller to be run on a different machine you can
type in here the computername or IP address of the other machine. If
you do not specify a value for this parameter then the controller will be
launched from the machine that the command is being issued from.
The parameter has the following syntax:
The ability to launch the controller to start a session is subject to the
following conditions being met:
v The target software must be installed on the machine where you
want the controller to run.
v A Java Runtime Environment supported by TRC 5.1.2 is installed on
the controller machine.

v The machine that you are issuing the command from must be able to
establish a TCP connection (on the remote control port set at
installation) to the machine where you are launching the controller.
options
-S Used in conjunction with the rc action.
v A: Set to A will start an Active session if the rc action is set.
v M: Set to M will start a Monitor session if the rc action is set.
Note: If you use this option with an action other than rc, the
value set in action will determine the type of remote
control session set and the -S value will be ignored.
Examples of usage
The examples listed here use target ipaddress 9.169.67.23, controller computername
testcontroller, userid newuser1 and password newuser100.
1. The command below activates a guidance session between the target and the
machine that the command is being issued from.
wrc newuser1:newuser100 guidance @Endpoint:9.169.67.23
2. Either of the commands below will activate an active session between the target
and the machine that the command is being issued from.
wrc newuser1:newuser100 rc @Endpoint:9.169.67.23 -S:A
wrc newuser1:newuser100 active @Endpoint:9.169.67.23
3. Either of the commands below will activate a monitor session between the
target and controller testcontroller .
wrc newuser1:newuser100 rc @Endpoint:9.169.67.23 @Endpoint:testcontroller -S:M
wrc newuser1:newuser100 monitor @Endpoint:9.169.67.23 @Endpoint:testcontroller
Running commands on the target from the command line

You can connect to a target to run a non interactive command-prompt command
by using the wrcmdpcr command. This command allows you to specify the
command that you want to run on the target and the output from that command is
displayed on the machine that the command was issued from. This command can
be useful for debugging a target when you do not have access to the IBM Tivoli
Remote Control Server user interface.
To start a command on a target complete the following steps :-

1. At a command prompt navigate to the directory where you installed the
command line tools.
2. Type in the following command to start a session
wrcmdpcr user:password Rctarget command [argument ...]
user:password
Type in here a valid userid and password that you would use to logon
to the IBM Tivoli Remote Control Server.
Rctarget
Specifies the computername or the IP address of the target that you
want to start a session with. It has the following syntax:
command
Specifies a command that runs from a command prompt. For
Chapter 21. Using remote control commands from the command line 87
commands that are built into the operating systems shell and do not
have a binary executable file, for example dir or tree in windows and
cd or echo in Linux you must also add the command shell command.
Windows
You must type cmd /c before the command - see Examples of
usage
for example
cmd / c dir
Linux You must type sh -c before the command - see Examples of
usage
Notes:
a. The command run here should be specific to the operating system
running on the target. If you are issuing the command from a
Windows machine to a Linux target, you should specify the Linux
command.
b. If you are issuing the command from a Linux machine to a
windows target and are using pathnames in the argument, for
example \windows, you must use a double backslash in the
argument, \\windows.
c. The command being run must be in the PATH of the target
otherwise the full path to the command must be used.
argument
Provides arguments to the command.
Examples of usage
The examples listed here use target ipaddress 9.169.67.23, userid newuser1 and
password newuser100.
1. The command below displays a directory listing, of the temp directory, on the
machine that is issuing the command.
To display the contents of temp of a windows target
wrcmdcpr newuser1:newuser100 9.169.67.23 cmd /c dir \temp

To display the contents of temp of a linux target
wrcmdcpr newuser1:newuser100 9.169.67.23 ls /temp

2. The command below will copy a file from the test directory to the match
directory of a windows target
wrcmdcpr newuser1:newuser100 9.169.67.23 cmd /c copy c:\temp\1.csv c:\match
3. The command below will show the network statistics of a windows target
wrcmdcpr newuser1:newuser100 9.169.67.23 cmd /c netstat
Error messages for the wrc command

If there is an error executing the wrc command, the following error codes are
returned as the program exit code and the corresponding message is displayed.

Table 3. Error messages for the wrc command
Exit Code Message Reason
1 Invalid argument: Malformed user:password Invalid parameters passed to command
Invalid argument: Unknown action
Invalid argument: Target endpoint definition: {0}
Invalid argument: Controller endpoint definition: {0}
Error reserving memory for arguments
Invalid argument: Unknown option: {0}

2 Error: No settings for the Server URL found There is no ServerURL setting in the registry /
properties file
3 Error {0} Unable to connect to the configured server
(RC_SERVER_CONN_ERROR):
Unable to connect to the Server
4 Error {0} (RC_LOGIN_ERROR): Cannot log in to the TRC server with the credentials
Unable to login to the Server with the specified provided in the command parameters
credentials
5 Error {0} The RC session to launch the command cannot be
(RC_CREATE_SESSION_ERROR): created. The normal causes are that the user does
Unable to create RC session not have permissions or the target cannot be found
6 Error {0} The Java Web Start TRC Controller cannot be
(RC_LOCAL_LAUNCH_ERROR): launched on the local machine. Usually this would
Unable to launch the Java Web Start controller be caused by a supported JRE not being installed
and set up to handle Java Web Start applications
correctly.
7 Error: Failed to load FIPS support libraries The settings specify FIPS mode but the required
libraries cannot be loaded.
10 Error {0} The connection to the remote controller cannot be
(RC_REMOTE_CONNECT_ERROR): established.
Unable to connect to the remote controller to
launch the session
16 Error {0} After connecting to the target, launching the
(RC_REMOTE_LAUNCH_ERROR): controller failed. Usually this would be caused by a
Unable to launch controller on the remote supported JRE not being installed and set up to
machine handle Java Web Start applications correctly.
Error messages for the wrcmdpcr command

If there is an error executing the wrcmdpcr command, the following error codes
are returned as the program exit code and the corresponding message is displayed.
Table 4. Error messages for the wrcmdpcr command
1 Invalid argument: Malformed user:password Invalid parameters passed to the command
1 Invalid argument: Target endpoint definition: {0}
1 Error reserving memory for arguments

2 Error: No settings for the Server URL found There is no ServerURL setting in the registry /
properties file
3 Error {3} (RC_SERVER_CONN_ERROR): Unable to Unable to connect to the configured server
connect to the Server
4 Error {4} (RC_LOGIN_ERROR): Unable to login to Cannot log in to the TRC server with the credentials
the Server with the specified credentials provided in the command parameters
Table 4. Error messages for the wrcmdpcr command (continued)
5 Error {5} (RC_CREATE_SESSION_ERROR): Unable The RC session to launch the command cannot be
to create RC session created. The normal causes are that the user does
not have permissions or the target cannot be found
7 Error: Failed to load FIPS support libraries The settings specify FIPS mode but cant load the
required libraries
10 Error {10} (RC_REMOTE_CONNECT_ERROR): The TRC connection to the target to execute the
Unable to connect to the target to launch the command cant be established.
command
16 Error {16} (RC_REMOTE_CMD_EXEC_ERROR): After connecting to the target, launching the
Unable to launch the command in the remote command failed. Usually this would be caused by
machine the command not being found
17 Error {17} (RC_REMOTE_CMD_TERM_ERROR): The remote command failed or did not terminate
The remote command terminated abnormally properly.
Mapping of arguments, for the command line tools, from TRC 3.8.1 to
TRC 5.1.2
wrc argument mapping

The mapping between the TRC 3.8.1 wrc arguments and the TRC 5.1.2 wrc
command is detailed in the following table:
Table 5. Mapping between the TRC 3.8.1 and TRC 5.1.2 wrc command arguments
TRC 3.8.1 TRC 5.1.2 Comments
RemoteControlName user[:password] The parameter containing the RC tool name is
changed to a single parameter containing both
the user name and the password needed to
login to the IBM Tivoli Remote Control Server,
separated by :.
rc | filexfer | chat | reboot rc | filexfer | chat | reboot | monitor | Denotes Action in the syntax. See step2 on
guidance | active | filetransfer page 86
rc maps to either active or monitor depending

on the value set for -S. The default mapping is
active.
@Endpoint:<endpoint_label> @Endpoint:<computername or IP address> Denotes Rctarget in the syntax. See step2 on
page 86
The target can be specified either by computer

name or IP address.
[@Endpoint:<endpoint_label>] [@Endpoint:<computername or IP address>] Denotes Rccontroller in the syntax. See step2
on page 86
The controller can be specified by computer

name or IP address.
-B:(Y|N) Desktop background. No equivalent option. Set
in TRC 5.1.2 as a policy of the association
between the user group and the target group
-C:(0|4|8) Number of colours. No equivalent option but
can be changed through the controller user
interface
-D:<WSTID> ID of Windows Terminal Server session. No
equivalent option
-J:<Y|N> JRE installation. No equivalent option

Table 5. Mapping between the TRC 3.8.1 and TRC 5.1.2 wrc command arguments (continued)
-G:(0|5..|480|960) Grace period. No equivalent option. Set in TRC
5.1.2 as a policy of the association between the
user group and the target group
-P:(Y|N) Proceed if time-out. No equivalent option. Set
in TRC 5.1.2 as a policy of the association
-R: (50) Refresh rate. No equivalent option
-T: (Y | N) Enable change state No equivalent option
-Z: (Y | N) Compression No equivalent option.
Compression is done automatically.
-I: (0..) Inactivity time-out No equivalent option. Set in
TRC 5.1.2 as a policy of the association
-S: (A | M) -S: (A | M) -S: (A | M) Start-up state
A (Active)
If rc is specified as the Action, it gets
mapped to starting the session in
active mode
M (Monitor)
If rc is specified as the Action, it is
mapped to starting the session in
monitor mode.
-Y: (Y | N) Optimize for slow link No equivalent option.
wrcmdpcr arguments mapping

The mapping between the TRC 3.8.1 wrcmdpcr arguments and the TRC 5.1.2
command arguments is detailed in the following table:
Table 6. Mapping between the TRC 3.8.1 and TRC 5.1.2 wrcmdpcr command arguments
RemoteControlName user[:password] The parameter containing the RC tool name is
changed to a single parameter containing both
the user name and the password needed to
login to the IBM Tivoli Remote Control Server,
separated by :.
@Endpoint:<endpoint_label> @Endpoint:<computername or IP address> Denotes Rctarget in the syntax. See step2 on
page 86
The target can be specified either by computer

name or IP address.
command command command to be run on the target
[argument list] [argument list] List of arguments passed to the command. The
limitation of 4 arguments is removed.
Chapter 22. Establishing a session directly with a target.
When a remote control session request is initiated from the server, the controller is
launched and it contacts the target to send the session request. The target then
contacts the server to authenticate the request and obtain the policies and
permissions that will be set for the session. If the target cannot reach the server
then the session will be refused. Peer to peer remote control sessions are remote
takeover sessions not initiated from the server, they are established directly
between the controller and the target. When peer to peer mode is enabled on the
target and the server is down or cannot be reached by the target, the session will
be established directly between the target and the controller and the local policies
which have been set on the target will be used for the session. You can set the peer
to peer policies during installation of the target or after installation by configuring
the target properties. See IBM Tivoli Remote Control Installation Guide for details
of enabling peer to peer mode and the policies that can be set.
Starting a peer to peer session

You can start a peer to peer session with a target that has been enabled for peer to
peer connections by running the controller locally on your system. You will have to
download and install the controller to your system. See Downloading the agent
software from the server on page 25 for details.
After installing the controller you can start a peer to peer session by completing
1. Launch the controller
Windows
a. Click Start > All Programs
b. Click IBM Tivoli Remote Control > Controller
Linux / UNIX
To launch the controller locate the Tivoli Remote Control controller
application from the operating system application interface or issue the
following command
java jar /opt/ibm/trc/controller/TRCConsole.jar
2. At the Open Connection window type in the IP address of the target that you
want to start a session with. Select use proxy if you require to use a proxy,
select the required protocol and supply the information required.
Server Type in here the hostname or IP address of the proxy server
Port Type in here the port required for the proxy server
Proxy requires authentication
Select this option if you are required to authenticate with the proxy
server. Provide the username and password that is required for
authentication.
3. Click on the session type that you would like to establish with the target.
Notes:
a. If the target has Windows installed, and the CheckUserLogin policy is set to
Yes, a login window will appear. You must enter a valid windows id and
password to continue.

b. A user acceptance dialog may be presented to the target user to allow them
to accept or reject the session, depending on the policies set on the target.
When the session is accepted, it will be established and the policies set locally on
the target will determine what actions can be carried out during the session.

Part 3. IBM Tivoli Remote Control target.

Chapter 23. Remote Control target Overview
The IBM Tivoli Remote Control Target software provides the interface that allows
the target user to communicate with the controller user during a remote control
session.
When the target software is installed and the IBM Tivoli Remote Control target
service is running, the following icon will be visible in the taskbar of the target
machine. This icon will allow you to open the target interface to communicate with
the controller user during a remote control session and also provides connection
and system information.

Chapter 24. Functionality of the target icon
When the IBM Tivoli Remote Control target software is installed and the target
icon is visible in the task bar you can perform the following actions on the icon :-
Rolling the mouse over the icon
This will display the computer name, IP address and FIPS status of the
target.
Right clicking the icon
The following options are available to you when you right click the icon
Open IBM Tivoli Remote Control - Target
This option will open the target interface. See Chapter 25, The
Target Interface, on page 101 for more details.
About This option will display the version number of the currently
installed target software.
Note: This is useful to note when reporting connectivity issues.

Online help
This option will take you to the IBM Tivoli Remote Control
information center where you can view the latest documentation.
Connection info
This option displays the target computer name and IP address.
Click OK.
Who is connected?
This option will display the user ID of the controller user and the
IP address and MAC address of the controller machine that has
established the remote control session. Click OK to continue.
Note: This option is only available during a remote control session.

Disconnect
This option will disconnect the target from any remote control
session that it may be taking part in.
System Information
This option generates a file called sysinfo.txt which contains
information about the target such as computername, vendor,
model, IP address, running processes. The file is displayed in
notepad.
Transfer folder
This option opens the folder used for transferring files to and from
the server. See File Transfer Mode on page 44 for more details.
.
Double clicking the icon
This will open the target interface. See Chapter 25, The Target Interface,
on page 101 for more details.

Chapter 25. The Target Interface
The target interface allows you to participate in a remote control session and
communicate with a controller user during the session. When you double click on
the taskbar icon the target interface opens.
The interface provides you with the following capability

v Connection status. See Viewing the session connection status.
v Session types pulldown. See Selecting a session type on the target.
v Show / Hide chat area. See Viewing or hiding the chat area.
v Show / Hide Transfer area. See Viewing or hiding the file transfer area on
page 102
v Actions Menu. See Actions which can be carried out from the target interface
on page 102
v View system information. See Viewing system information on page 103
v Help Menu. See Obtaining help on page 103
Viewing the session connection status
The connection icon shows you the status of the target with regard to a
remote control session. This icon will be visible and connected when a session has
been established and will be greyed out when there is no session in progress.
Selecting a session type on the target

The session list on the target interface displays the session types that you can select
during a remote control session. When initiating a session the controller user
selects the session type but after the session is established you can change the
session type by selecting one from the list. The session type options available are
determined by what was set in the permissions for the session. See Chapter 5,
Types of remote control sessions that can be established, on page 37 for more
details of types of sessions available.
Viewing or hiding the chat area
You can click on the Show/Hide Chat Area icon to open a chat window for
real-time communication with the controller. Clicking the icon again will hide the
chat window.
When the chat window appears you can type text into the window and hit enter.
This will forward the text to the controller user who can then respond. The chat
history can be removed from the window by selecting Clear chat history from the
Actions menu.
Note: Depending on the policies set for the remote control session, if chat has not
been enabled the chat icon will be greyed out and not available for selection.

Viewing or hiding the file transfer area
You can click on the Show/Hide Transfer area icon to open a window
with fields showing files that have been or are being, transferred between the
controller and target . The icon on the left hand side shows the direction of the
transfer. The colour of the progress bar denotes which type of transfer took place.
When the transfer is from the target to the controller a left arrow is displayed and
the status bar turns green when the transfer is complete.
When the transfer is from the controller to the target a right arrow is displayed
and the status bar turns blue when the transfer is complete.
Actions which can be carried out from the target interface
The Actions menu allows you to perform the following actions :-

Connection info
Selecting this action will display the computername, IP address list and
FIPS status of the target machine. Click OK to continue.
Report status to server
Selecting this action will cause the target to call home to the server to
report its status.
Who is connected
Selecting this action will display the user ID of the controller user and the
IP address and MAC address of the controller machine that has established
the remote control session. Click OK to continue.
Note: This option is only available during a remote control session.

Transfer folder
Selecting this action will allow you to view the contents of the directory
that has been defined as the file transfer directory. This will show all files
which have been transferred from the controller to the target.
Send file to controller
Selecting this action will allow you to select a file on the target machine
and transfer it to the controller machine. SeeChapter 13, Transferring
files, on page 65 for more details on transferring files.
Clear chat history
Selecting this option allows you to clear the chat history area of the target
interface. A window will open which will give you the option of accepting
to clear the chat area by clicking Yes or clicking No to leave the chat
history displayed.
Hidden Windows
Selecting this option allows you to re display any running applications on
the target which were hidden before the session was established. See
Chapter 27, Hiding applications, on page 107 for more details of hiding
running applications.

Viewing system information
You can view a targets system info by clicking the Get system info icon
.This action generates a file called sysinfo.txt which contains information about the
target such as computername, vendor, model, IP address, running processes. The
file is displayed in notepad and can be sent to the controller via email to assist in
troubleshooting.
Obtaining help
The help menu provides you with three options for obtaining the help you
require.
About This option will display the version number of the currently installed
target software.
Note: This is useful to note when reporting connectivity issues.

Online help
This option will take you to the IBM Tivoli Remote Control information
center where you can view the latest documentation.
Chapter 25. The Target Interface 103

Chapter 26. Consenting to a Remote Control Session
When an remote control session is requested if the Enable user acceptance for
incoming connections policy is enabled, and set to yes in the resolved policies for
the session, the target user will be given the option of refusing to allow the session
to be established. An acceptance dialog will be displayed on the target system and
the target user can accept or refuse the session. If this policy is not enabled or set
to no in the resolved policies, the session will be established without any
acceptance from the target user. See the IBM Tivoli Remote Control Server
Administrators Guide for more details of how policies are derived for a remote
control session.
You will have the following options when confirmation is required to establish a
remote control session.
Accept
To accept the remote control connection and allow the session to be
established click Accept. The remote control session will now be
established.
Refuse
To refuse the remote control connection and not allow the session to be
established click Refuse The remote control session will not be established
and a message will be displayed on the controller screen saying that the
target has refused the session.
Session Type
On the acceptance dialog, depending on the policies set for the session,
there can be the following three options to select a different session if you
do not want the controller to have Active control of the target machine.
1. Guidance :- Allows the controller to view the target screen in guidance
mode but not control the remote mouse or keyboard. See Providing
guidance to the target user on page 40 for more details of this session
type.
2. Monitor :- Allows the controller to view the target screen in monitor
mode but not control the remote mouse or keyboard. See Viewing the
target screen to monitor activity on page 40 for more details of this
session type.
3. Chat :- Allows the controller to chat to you without allowing them to
view the target screen.
Hide applications
Allows you to hide any applications that are running on the target that
you do not want the controller user to see. See Chapter 27, Hiding
applications, on page 107 for more details.
Note: You will have a pre defined number of seconds to accept or refuse the
session. This value is defined in the Acceptance grace time policy and
works in conjunction with Acceptance timeout action. If you do not accept
the request within the given time the outcome of the session will be
determined by what is set for Acceptance timeout action. If it is set to
proceed the session will be established without the user acceptance. If it set
to Abort, the session will not be established and a message will be displayed
on the controller system saying that the target has refused the session. See

the IBM Tivoli Remote Control Server Administrators Guide for details of
how policies are derived for a Remote Control session.

Chapter 27. Hiding applications
Hiding running applications from view during a remote control session
When a remote control session is requested the target user has the ability to hide
from view, any running applications, on the target , that they do not want the
controller user to see. This option is only available when the Enable user
acceptance for incoming connections policy has been enabled for the session and
it will appear on the user acceptance dialog when the session is requested.
You can hide applications by completing the following steps : -

1. When the user acceptance dialog appears click Hide Applications then Accept.
2. The Show / Hide window appears listing all of the running applications on the
target.
3. Select the required application(s) that you do not want the controller user to
see.
4. Click OK
5. When the session is established the selected applications are no longer visible
in the target and controller windows.
Notes:
1. The above steps can only be carried out by the target user in the session.
2. If you click Cancel on the Show / Hide window the selected applications will
not be hidden when the session is established.
Restoring hidden applications to view during a remote control session.

If during a remote control session any running applications which have been
hidden are now required to be seen by the controller user these can be made
visible again by the target user.
You can make hidden applications visible again by completing the following steps
:-
1. Click the IBM Tivoli Remote Control icon to bring the target window toolbar
into view.
2. From the Actions menu select Hidden Applications.
3. Click Accept on the acceptance window.
4. On the Show/Hide applications window select the applications that you want
to bring back into view.
5. Click OK.
The previously hidden applications will now be visible in the controller window

Chapter 28. Disconnecting from a Remote Control Session
When a remote control session is established there are two ways that the target
user can disconnect from the session.
Method 1
(The easiest and most efficient way to disconnect someone from your
computer)
1. Press the PAUSE/BREAK button in your keyboard.
2. There is no confirmation and the session is terminated immediately.
3. The controller will be disconnected and a message will be displayed
telling them that the session has been cancelled.
Method 2
1. Click the Connection icon

2. This will end the current session with no confirmation and the session
is terminated immediately.
3. The controller will be disconnected and a message will be displayed
telling them that the session has been cancelled.

Part 4. Troubleshooting Appendix

Chapter 29. Auditing
Auditing is available via the Windows Application Event Log and also within a
local file on the controller and target. The two methods are available together or
independently. Depending on policy setup Auditing may be disabled.
Auditing Remote Takeover Example
On a successful Session, the Information Properties window can be displayed in

the Application Event Viewer of the target machine.
To access the Application Event Viewer in Windows goto Start, Control Panel,
Administrative Tools, Event Viewer, Application. You will see a list appear. IBM
Tivoli Remote Control - Target can be selected and if you right click with mouse
button and select Properties an Information Properties window will open. For
more information please see Server Session details in Chapter 3.
The information displayed to the User will include :-
Date of Takeover
Time of Takeover
Computer being taken over
IP Address initiating takeover
Mac Address
A Description section is also shown and is amended dependant upon the Actions,
their resultant dialogs and whether the instance took place on the controller or the
target.

Chapter 30. Error Messages
In the majority of cases, connectivity problems experienced in IBM Tivoli Remote
Control will be related to the surrounding network infrastructure. Error messages
in IBM Tivoli Remote Control will help to pin point these problems. The following
list of error messages can be displayed to the controller user.
Unable to connect to <IP> because of timeout :- An example of this error is that

the controller could not establish basic connectivity to the target or there was an
error with the connection before it could be accepted or refused.
The target has refused the session :- Example of this error is that either the server
has not validated the session attempt .
Session rejected because the pre-session script was not found :- Examples of this
error are that the Run pre-session script policy is set but the script cannot be
found or the pre-script times out, and the pre/post-script fail operation is set to
abort.
Session rejected because the post-session script was not found :- Examples of this
error are that the Run post-session script policy is set but the script cannot be
found or the post-script times out, and the pre/post-script fail operation is set to
abort.
Session rejected because the pre-session script failed with error code: <X> :- This
is the same as the Session rejected because the pre-session script was not found
or timed out error shown above but in this error message if the pre-script fails it
shows the error code the script returned.
Session rejected because the limit of allowed clients has been reached :- This
error message is used specifically when joining a collaborative session when the
number of participants already in the session has reached the limit of allowed
controllers.
Session rejected because the provided credentials are invalid :- This error
message is used when an invalid username and password have been entered when
trying to establish a Peer to Peer session.
Session rejected because the provided credentials have expired :- This error
message is used when the operating system password, used when the windows
userid and password are required to establish a peer to peer session, has expired.
Session rejected because it is out of the allowed times :- This error message is
used when the session has not been established within the allowed times.
Session rejected because there is no user logged to confirm the session :- This
error message is used when connect at logon policy is set to Yes but there is no
user logged on at the target who can accept the session.
The target might be busy with another session or listening on a different port.
Error in the session handshake with target at {0}. :- This error message is
displayed when the controller can establish a network connection but it is unable
to exchange TRC data. This usually happens because there is already an active

remote control session on that target or a service other than the TRC target is
listening on that port. The IP address of the target is substituted for the {0}.
Error initializing the local FIPS certified cryptographic provider. The session to
{0} cannot be established. :- This error message is used when FIPS compliancy has
not been setup on the controller correctly. The controller is not running on a FIPS
capable Java Runtime Environment. The IP address of the target is substituted for
the {0}.
The target does not support FIPS certified encryption. The session to {0} cannot
be established. :- This error message is used when FIPS compliancy is not
supported on the target. The session to {0} cannot be established. The IP address of
the target is substituted for the {0}.
Session rejected because of acceptance timeout :- This error message is used

when session has not been accepted by the target user in the time specified by the
acceptance grace time policy and the acceptance timeout action has been set to
abort.
The network connection to {0} timed out :- This error message is used when the
network connection attempt fails with a time out. Usually this occurs when the
connection is stopped by a firewall that is configured to not give any kind of
response to the connection attempts it rejects. The IP address of the target is
substituted for the {0}.
The network connection to {0} was refused :- This error message is used when the
network connection attempt fails because it was rejected. Usually this happens
when the host is not listening for connections on the port or a firewall is
intercepting the connection and is configured to explicitly reject the connections to
that port.
Note: this is not related to a TRC Session refusal, which happens once the basic
network connection has been established.
Unable to resolve the address for host {0} :- This error message is used when a
hostname is provided in the connection details and it cannot be resolved to an IP
address.
Failed to connect to {0} :- This error message is a generic connection failure

message, it is only displayed if the code cannot figure out why the connection
failed so it cannot display any more information than this generic failure message.
Unable to listen for incoming connections :- This error would be displayed if the
controller is not able to start listening for connections from other controllers in
collaboration mode.

Chapter 31. Ensuring that current data is reported
Whenever a report is generated in IBM Tivoli Remote Control Server a query is
run against the database which retrieves the required data and displays this on the
screen. This data is then held in a temporary location for the next time the same
report is run to allow the data to be displayed much more quickly on the screen .
To ensure that the latest data is reported to the screen, including any updates
which might have taken place since the last time the report data was displayed,
click Refresh at the right of the screen. This will update the report with any
changes or updates that have been made.
For example if you have created a new user and do not see the user details in the
All Users report, click Refresh to update the report with the new entry.

Part 5. Appendixes

Appendix. Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the users responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing

IBM Corporation
500 Columbus Avenue
Thornwood, NY 10594
U.S.A
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation

Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758
USA
Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.
The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
Customers are responsible for ensuring their own compliance with various laws
such as the Graham-Leach-Bliley Act, the Sarbanes-Oxley Act, and the Health
Insurance Portability and Accountability Act. It is the customers sole responsibility
to obtain advice of competent legal counsel as to the identification and
interpretation of any relevant laws that may affect the customers business and any
actions the customer may need to take to comply with such laws. IBM does not
provide legal, accounting or auditing advice, or represent or warrant that its
products or services will ensure that customer is in compliance with any law.
Any performance data contained herein was determined in a controlled

environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of

those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBMs future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.

Trademarks
The following terms are trademarks or registered trademarks of International
Business Machines Corporation in the United States, other countries, or both:
AIX
DB2
DB2 Universal Database
IBM
IBM logo
Lotus
SmartSuite
Tivoli
Tivoli logo
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
Intel, Intel Inside (logos), MMX and Pentium are trademarks of Intel
Corporation in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Sun Microsystems, Inc. in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or

both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Other company, product, and service names may be trademarks or service marks
of others.
Appendix. Notices 123

Index
A controller interface (continued)
enable / disable autoscroll 69
guidance session (continued)
tools 41
about TRC 81 enable / disable scaled view 71 guidance tool
access requests enable / disable true colour 73 symbols and action 42
creating 16 file transfer menu 65 using 42
viewing 18 open chat window 53
accessibility viii perform action in target 49
active session
changing to 38
controller software
downloading
H
starting 37 Help
Linux 27
Appendix A server 29
Windows 26
Notices 121 Help Menu
Trademarks 122 server 29
applications highlight tool
hiding 107 D using 43
unhiding 107 direct connection to a target homepage
auto scrolling establishing 93 resetting 22
disabling 69 downloads setting 22
enabling 69 agent download 25 How does IBM Tivoli Remote Control
download trc player 25 Work? 5
launch trc player 25
C drawing tool
using 43 I
chat session
changing to 39 IBM Tivoli Remote Control Server Web
starting 38 Interface
clipboard menu E options menu 21
receiving text 67 entering text on the target screen 59 reports menu 21
sending text 67 error messages sessions menu 19
collaboration session wrc command 88 targets menu 9
controlling 56 wrcmdpcr command 89 tools menu 25
disconnecting participants 56 exporting data 23 Users Menu 18
ending 58 IBM Tivoli Remote Control User Guide
giving control 56 TRC Server Web Interface 7
joining 56 F
limiting participants 56 favourite targets list
requesting control 57 creating 11 L
returning control 57 removing targets 11 local input
revoking control 56 viewing 11 disabling 45
starting 55 file transfer directory enabling 45
command line software changing the location 66 local recording
downloading file transfer menu making 62
Linux 28 open file transfer directory 66 playing 63
Windows 27 receiving a file 65 logging off 9
command line tools sending a file 65 logging on
using 85 files forgotten password 8
wrc command 86 changing the file transfer logging on to IBM TRC server 7
wrcmdpcr arguments mapping 91 directory 66
wrcmdpcr command 87 Open file transfer directory 66
controller
establishing sessions 37
receiving a file 65
sending a file 65
M
help 81 monitor session
remote target install 78 changing to 40
target starting 40
remotely installing in a peer to G
peer session 75 guidance session
controller actions changing to 41
clear instructions 44
O
open chat window 39 options menu
controller interface 33 drawing tool 43
exporting data 23
capture screen 60 guidance tool 42
output 23
clipboard menu 67 highlight tool 43
refresh results 23
controller tools 59 starting 41
reset to default homepage report 22

options menu (continued) session details (continued) targets (continued)
set current report as homepage 22 viewing 20 searching 10
Overview, TRC 3 session history view access requests 18
viewing 12, 19 viewing 10
session player targets menu 9
P downloading 25
launching 25
all targets 10
browse targets 9
password
session recording 61 recently accessed 12
forgotten password 8
automatic recording 61 remove from favourites 11
peer to peer session
exporting and downloading 61 request access 15
starting 93
local recording 62 search 10
Preface vii
session types session history 12
active 37 Start Session 14
chat 38 target status 13
Q guidance 40 view effective policies 13
quick text input monitor 40 view favourites 11
enabling 59 sessions temporary access to a target
searching 19 requesting 15
sessions menu tolls menu
R my session history 19
search 19
downloads 25
transferring files 44
recordings
session details 20 TRC Server Web Interface
launching the session player 25
system information accessing 7
registry keys
retrieving 51 logging off 9
looking up values 49
viewing 103 logging on 7
viewing 49
troubleshooting 113
remote control session
auditing 113
accepting 105
collaboration session 55 T viewing current data 117
Troubleshooting Appendix
disconnecting 107 target
Error messages 115
ending 83 functionality 99
true colour
inviting multiple participants 55 overview 97
disabling 73
recording 61 remote install from controller
enabling 73
refusing 105 pre reqs 75
starting 14 remotely installing in a peer to peer
remote control sessions session 75
active session 37 target installation U
chat during a session 39 remotely user details
chat session 38 pre reqs 75 viewing 18
establishing 37 target interface 101 users groups
file transfer 44 actions 102 viewing 19
guidance session 40 connection status 101 users menu
monitor session 40 help 103 my details 18
reboot 45 session type 101 my groups 19
types of 37 show chat area 101 Using IBM Tivoli Remote Control as a
remote install show file transfer area 102 controller user 33
pre reqs view system information 103 Using remote control commands from the
Linux 77 target menu command line 85
UNIX 77 add to favourites 11
Win XP 75 target policies
Windows Server 2008 75
Windows Vista 76
viewing 13
target software
W
wrc command
reports downloading
arguments mapping 90
custom Linux 26
error messages 88
running 21 Windows 26
using 86
standard remotely installing
wrcmdpcr command
running 21 pre reqs 75
arguments mapping 91
target status
error messages 89
viewing 13
using 87
S targets
browsing for 9
scaled view
capturing the screen 60
disabling 71
getting system information 51
enabling 71
rebooting 45
screen data
requesting temporary access
refreshing 23
anonymous user 17
session details
at start of session 17
playing a recording 20
request access 16

Bibliography
v IBM Tivoli Remote Control Installation Guide (GI11-8173-01)
Explains how to install and configure the Tivoli Remote Control software.
v IBM Tivoli Remote Control Quick Start Guide (GI11-8182-01)
Provides a Quick Start procedure for the Tivoli Remote Control software.
v IBM Tivoli Remote Control Administrators Guide (SC23-6542-01)
Explains how to manage and configure the Tivoli Remote Control program.


Printed in USA
SC23-6541-01

TRCuserguide PDF

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

TRCuserguide PDF

Încărcat de

Drepturi de autor:

Formate disponibile

Tivoli

IBM Tivoli Remote Control Users Guide

IBM Tivoli Remote Control Users Guide

First Edition (September 2007), Second Edition (October 2009)

Chapter 4. Controller Interface . . . . 33

Copyright IBM Corp. 2009 iii

Chapter 13. Transferring files . . . . . 65 Part 3. IBM Tivoli Remote Control

Chapter 14. Copying Clipboard Chapter 24. Functionality of the target

Part 4. Troubleshooting Appendix 111

Part 5. Appendixes . . . . . . . . 119

Who should read this guide

Readers need to be familiar with the following topics.

The target audience for this user guide includes:

IBM Tivoli Remote Control Library

Accessing publications online

Copyright IBM Corp. 2009 vii

Product publications include release notes, installation guides, users guides,

Tivoli technical training

Contacting software support

The guide provides the following information:

Conventions used in this book

viii IBM Tivoli Remote Control Users Guide

Copyright IBM Corp. 2009 1

There are three main infrastructure components in TRC 5.1.2

Copyright IBM Corp. 2009 3

3. As soon as the controller is launched it will attempt to connect to the IP and

4. The target answers to create a secure channel.

6. The target receives the start session information.

Note: Takeover confirmation is a configurable value which enables the program to

Remote control sessions with multiple participants.

Copyright IBM Corp. 2009 5

Logging on to IBM Tivoli Remote Control Server

Figure 1. Logon screen for entering ID and password

Copyright IBM Corp. 2009 7

To obtain a temporary password complete the following steps: -

8 IBM Tivoli Remote Control Users Guide

Logging off IBM Tivoli Remote Control Server

Targets menu options

Browsing for targets

To browse for targets complete the following steps: -

Chapter 3. IBM Tivoli Remote Control Server Web Interface 9

Viewing all targets

To view the list of targets complete the following steps : -

Searching for targets

10 IBM Tivoli Remote Control Users Guide

Creating a favourite targets list

To create a favourites list complete the following steps : -

Viewing the favourite targets list

To view the Favourites list , complete the following steps : -

Removing targets from favourites

Chapter 3. IBM Tivoli Remote Control Server Web Interface 11

View Recently Accessed Targets

To view a list of recently accessed targets, complete the following steps: -

Viewing the session history for a target

12 IBM Tivoli Remote Control Users Guide

To view target status details , complete the following steps : -

Viewing the policies which will be in effect between a user

To view the effective policies, complete the following steps: -

Chapter 3. IBM Tivoli Remote Control Server Web Interface 13

Note: Clicking Cancel will return to the previously displayed screen

Starting a remote control session

To start a session, complete the following steps: -

14 IBM Tivoli Remote Control Users Guide