====================================================================== Readme file for: Interim Fix 1 for IBM Tivoli Remote Control, Version 5.1.2 IBM Corp. 20 January 2010 ====================================================================== Contents 1.0 Copyright statement 2.0 Product fix history 2.1 Defects fixed 2.2 APARs fixed 3.0 Function Added Since GA Release 3.1 Report computer description to server on Windows systems 3.2 Security lock policies for session disconnect 3.3 Visual indication for session in progress 3.4 New improved icons for windows 7 4.0 Installation information 4.1 Manual Install 4.2 Tivoli Remote Control 5.1.2 Windows, Derby Database and eWAS Installation 4.3 Tivoli Remote Control 5.1.2 LINUX, Derby Database and eWAS 4.4 Tivoli Remote Control 5.1.2 Websphere Application Server (WAS), AIX, Linux, Solaris and Windows 4.5 Target requirements 4.6 Admin id for manual AIX install 4.7 New Installation 5.0 Uninstallation information 6.0 Contacting IBM Support 7.0 Notices and trademarks ====================================================================== 1.0 Copyright statement (c) Copyright International Business Machines Corporation 2009. All rights reserved. U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM(R) Corp. ====================================================================== 2.0 Product fix history 2.1 Defects fixed -------------- CLI missing support for gateways (d13012) Server setup for linux requires deletion of ewaslin subdirectory to support upgrade from TRC 5.1.0 (d13052) Fix redirection of target to a different trc server (d13086) 2.2 APARs fixed ----------- Czech keyboard issues (IZ65518) Thread contention reading properties can stall server (IZ65452) Session history does not display for deleted users (IZ65905) Improved behaviour when query for default homepage does not exist or is incorrect (IZ66585) Send message to Administratator from Login Page causes error (IZ67871) User email in trc.properties appears as configurable when it is not (IZ66179) Target msi location causes issue when trying to modify the setup from add/remove programs (IZ68100) TRC LDAP paging support (IZ66718) TRC_SERVER_PROTOCOL install parameter does not appear to be enforced when using the user interface installation (IZ65449) The "All session history" query fails to display session history for users that have been deleted (IZ65905) The option to send a message to the System Administrator from the login page does now work correctly (IZ67871) Removal of user fields (userid, useremail and password) that appear as configurable in the common.properties file when they are not (IZ65801) TRC icon does not always appear in taskbar (IZ66708) 3.0 Function Added Since GA Release * Report computer description to server on Windows systems - see 3.1 * Security lock policies for session disconnect (MR112609168) - see 3.2 * Visual indication for session in progress - see 3.3 * New improved icons for windows 7 3.1 Report computer description to server on Windows systems __________________________________________________________ The computer description is now reported to the server for environments where important information is stored in this field, however, this information is not added by default to the "All targets" report. In order to add this information: - From the "All Targets" report, click on "Edit SQL" - Select "Add Column" and locate the Asset.Description column, click on "Add" and then "Submit". The report will now show the computer description, but the change needs to be saved. To do this, click on "Reports/Save as custom report" and complete the required information. 3.2 Security lock policies for session disconnect (MR112609168) ___________________________________________________________ A new policy, "Set target locked" has been introduced that, if enabled, will automatically lock the workstation after a TRC session is terminated. 3.3 Visual indication for session in progress _________________________________________ The TRC target icon will now change from a faded red colour when no session is in progress, to a bright red colour icon when a TRC session is in progress. ===================================================================== 4.0 Installation information 4.1 Manual Install -------------- When using Disk 3 to perform a manual install of this release, the following should be noted:- A manual install can only be performed on a system which has the previous release of IBM Tivoli Remote Control already installed. 4.2 Tivoli Remote Control 5.1.2 Windows, Derby Database and eWAS Server Installation --------------------------------------------------------------------------------- Unzip TRC_Disk_1_v512.zip and navigate to trc_Server_setup.exe Run trc_Server_setup.exe Follow on screen instructions to install Fix Pack. Refer to Installing IBM Tivoli Remote Control for Server in the Installation if more detailed information required at:- http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/ com.ibm.itrc.doc_5.1.2/welcome.htm In the left pane select the Installation Guide for Server and Target 4.3 Tivoli Remote Control 5.1.0 LINUX, Derby Database and eWAS Server Installation ------------------------------------------------------------------------------- Untar TRC_Disk_2_v512.tar and navigate to trc_Server_setup.bin Run trc_Server_setup.bin Follow on screen instructions to install Fix Pack. 4.4 Tivoli Remote Control 5.1.2 Websphere Application Server (WAS), AIX, Linux, Solaris and Windows Server Installation --------------------------------------------------------------------- IMPORTANT ********************************************************************* Please back up your video recordings and customised properties files ********************************************************************* The following property files are likely to be customised and therefore need to be backed up. ---------------------------------------------------------------------------------------------- common.properties ldap.properties trc.properties log4j.properties These files are found in the following directory For Windows based systems: [TRCInstallDir]\TRCAPP.ear\trc.war\WEB-INF\classes\ For UNIX based systems [TRCInstallDir]/TRCAPP.ear/trc.war/WEB-INF/classes/ Where TRCInstallDir is the IBM Tivoli Remote Control installation directory The video recordings folder is defined in the rc.recording.directory of the trc.properties file. ***************************************************************************** Untar TRC_Disk_3_v512.tar and navigate to your Operating System sub folder: AIX Run trc_additional_setup.bin Linux Run trc_additional_setup.bin Solaris Run trc_additional_setup.bin Windows Run trc_additional_setup.exe For AIX/Linux and Solaris ------------------------- Run trc_Server_setup.bin Select 'Install IBM Tivoli Remote Control' Select 'Tivoli Remote Control 5.1.2 Manual Installation Files The trc_additional_setup.bin will launch InstallAnywhere and will validate that you have the GA version installed or extracted. The new War file will be saved to a place of your choice or the InstallAnywhere default location. Use the WAS Administrative Console to update the war file. After completing the update, restore the saved property files and video recordings if applicable. For Windows ----------- Run trc_additional_setup.exe The trc_additional_setup.exe will launch InstallAnywhere and will validate that you have the GA version installed or extracted. The new War file will be saved to a place of your choice or the Installer default location. Use the WAS Administrative Console to update the war file. After completing the update, restore the saved property files and video recordings if applicable. 4.5 Target requirements ------------------- Detailed Hardware and Software requirements can be found at: http://www-306.ibm.com/software/tivoli/products/remote-control/platforms.html 4.6 Admin id for manual AIX install ------------------------------- After a manual install of the IBM Tivoli Remote Control Server on an AIX system, the default admin id and password should be typed in camel case as follows id = Admin password = password see- http://www-1.ibm.com/support/docview.wss?rs=661&uid=swg21281844 4.7 New Installation ---------------- For customers installing the Fix Pack immediately after installing the GA Level (5.1.2.1080). Please to log onto the application to ensure that database initialisation has been completed before applying the Fix Pack ===================================================================== 5.0 Uninstallation information To uninstall this interim fix complete the following steps:- * backup and save your properties files These files are found in the following directory for windows based systems [TRCInstallDir]\TRCAPP.ear\trc.warWEB-INF\classes\ for UNIX based systems [TRCInstallDir]/TRCAPP.ear/trc.warWEB-INF/classes/ where TRCInstallDir is the IBM Tivoli Remote Control installation directory * backup your database - Derby database save a copy of the database by taking a copy of the following directory [TRCInstallDir]\DB\TRCDB - windows systems [TRCInstallDir]/DB/TRCDB - UNIX based systems - All other databases follow the standard procedure for backing up the database * Uninstall the IBM Tivoli Remote Control Server To uninstall the Server complete one of the following steps - Add/Remove programs Uninstall Tivoli Remote Control 5.1.2 - Running the uninstall application Run the file 'Uninstall Tivoli Remote Control.exe' which can be found in the IBM Tivoli Remote Control installation directory * Install the previous version of IBM Tivoli Remote Control For installation instructions go to the following site http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.itrc.doc_5.1.2/welcome.htm In the left pane select the Installation Guide for Server and Target * Stop the IBM Tivoli Remote Control service * Restore your properties files and database * Start the IBM Tivoli Remote Control Service ===================================================================== 6.0 Contacting IBM Support Additional help or information can be found at the following Web sites http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=/com.ibm.itrc.doc_5.1.2/welcome.htm http://www.ibm.com/software/sysmgmt/products/support/ ===================================================================== 7.0 Notices and trademarks 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 user's 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 North Castle Drive Armonk, NY 10504-1785 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 that has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. 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 document 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 customer's sole responsibility to obtain advice of competent legal counsel as to the identification and interpretation of any relevant laws that may affect the customer's 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 IBM's 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. A.1 Trademarks The following terms are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both: AIX DB2 IBM IBM logo iSeries pSeries Tivoli Tivoli logo xSeries zSeries Java(TM) and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT(R), and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. UNIX(R) 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.