===================================================================== IBM® Electronic Service Agent for Linux® on xSeries® - Director Extension - Version 3.2 README Information ===================================================================== Table of Contents ================= 1.0 Introduction 1.1 What's New in Release 3.2 1.2 Determining the Version of Director 1.3 Security 1.4 Supported Machines 2.0 Prerequisites 2.1 General Requirements 2.2 System and Network Requirements 3.0 Installation 3.1 Obtaining Files 3.2 Installing Files 4.0 Release Notes 5.0 Known Issues 6.0 Support 7.0 Trademarks and Notices 8.0 Disclaimer 1.0 Introduction ================ Electronic Service Agent is a secure, remote, information-gathering program designed to help you minimize the resources required to run and maintain your networked computers, increase your systems' availability, and aid IBM in servicing and maintaining your system. 1.1 What's New in Release 3.2 ----------------------------- - Support for IBM Director version 4.20.2. Please note that version 4.20 will not work. The version must be 4.20.2. See Section 1.2: Determining the version of Director. - Support for Linux includes: - SUSE Linux Enterprise Server 8 for x86 (Service Pack 3 required) - Red Hat Enterprise Linux ES, version 3.0 - Red Hat Enterprise Linux AS, version 3.0 for Intel x86 1.2 Determining the Version of Director ----------------------------- - From a command prompt: - cd /opt/IBM/director - more version.srv - codebase_version must be 4.20 AND build date must be at least 2004-10-05 - This is version.srv for 4.20.2 (the one you want) 420141005 420141005 DAR component=IBM Director Server version=4.20 builddate=2004-10-05 buildnum=d0498 codebase_version=4.20 prodversion=DAR key=EJT5RU05IIS9B5MKPJ5H - This is version.srv for 4.20 (the one you don't want: the date is earlier than 2004-10-05) 420140713 420140713 DAR component=IBM Director Server version=4.20 builddate=2004-07-13 buildnum=d0498 codebase_version=4.20 prodversion=DAR key=EJT5RU05IIS9B5MKPJ5H 1.3 Security ------------ - Electronic Service Agent communicates with IBM using an IBM Certified Secure Network structure. - No unique customer data is ever accessed. - No inbound calls are allowed. - Access to programs providing control over Electronic Service Agent is restricted to users with Windows Administrative rights. 1.4 Supported Machines -------------------- Brand Name Machine Type x200 8478 x200 8479 x200VL 8481 x205 8480 x220 8645 x220 8646 x225 8647 x230 8658 x232 8668 x235 8671 x236 8841 x240 8664 x250 8665 x255 8685 x305 8673 x335 8676 x336 8837 x342 8669 x345 8670 x346 8840 RXE-100 8684 x300 8672 x330 8654 x330 8674 x330 8675 x330T 8674 x340 8656 x342 8669 x350 8682 x360 8686 x365 8860 x365 8861 x365 8862 x370 8681 x380 8683 x440 8687 x445 8870 x450 8688 2.0 Prerequisites ================= 2.1 General Requirements ----------------------- - Ensure that all monitored servers have correctly configured machine type, model and serial number. - Ensure the person installing Electronic Service Agent has Administrative authority. - Ensure that all monitored servers are under warranty or an IBM Service agreement. - Ensure that you have supplied accurate contact information when configuring Electronic Service Agent. - It is particularly important that you configure the location details of your managed systems accurately. If you record location details incorrectly, IBM's service delivery will be delayed. Similarly, if you record your managed systems location details incorrectly, IBM service representatives will not be dispatched to the correct site location after a hardware problem has been reported. 2.2 System and Network Requirements ----------------------- - One of the following Operating Systems - SUSE Linux Enterprise Server 8 for x86 (Service Pack 3 required) - Red Hat Enterprise Linux ES, version 3.0 - Red Hat Enterprise Linux AS, version 3.0 for Intel x86 - x86, Pentium or higher - Internet access on managed system where Director server resides - Monitor: Super VGA monitor with the screen resolution set to at least 800 x 600, small fonts setting, and 256 colors 3.0 Installation ================ - The Electronic Service Agent is available from the following web site; http://www.pc.ibm.com/qtechinfo/MIGR-40870.html 3.1 Obtaining Files =================== - Download the following files to a temporary directory; - 5639-n89-32.bin (this is the installation file) - The User's Guide (print this for configuration and general information) 3.2 Installing Files ==================== Note: Installation requires Administrator privileges. These instructions assume you are using some X11 window manager to perform the actual installation. To install Electronic Service Agent on your IBM Director Server: 1. Log in as the user root. Do not 'su' to become the user root; the product will not install properly. 2. 'cd' to the directory where you stored the installation program. 3. Execute the following command: ./5639-n89-de32.bin 4. At the Electronic Service Agent Setup panel, click Next to continue with the program setup. 5. If you accept the terms and conditions of the License Agreement, click Yes to continue with the setup program. 6. Click Finish to complete the installation. 4.0 Release Notes ==================== 1. The Test page is only displayed when the electronic service task is launched in single targeted mode. 2. Electronic Service Agent is currently not supported on IBM Director Server with Oracle Database Backend. 5.0 Known Issues ================ The following problems/issues may be associated with Electronic Service Agent: 1. Once in awhile during installation of Electronic Service Agent, the install program will hang on a panel after the files have been copied to your system. As part of the installation process, an uninstall program is created, and this step takes longer than the steps that download files to your system. Give the installer an adequate amount of time to complete its actions. If you are sure the installation program is in a 'hang' state, you can go to the window that you launched the product in, and type Ctlr+C. Or close the terminal window. The installation is complete. 2. If you get the following errors: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable. OR Xlib: connection to :0.0 refused by server Xlib: No protocol specified The installer is unable to run in graphical mode. Try running the installer with console or silent flag. It is likely that you used 'su' to become the user 'root'. You must log in as the user root. Do NOT run the installer with the console or silent flags; your product will not install properly. 3. Some supported systems may not appear as eligible for Electronic Service when the 'Electronic Service Eligible Systems' icon is selected in the Groups pane. Select 'All Systems and Devices' from the Groups pane if a supported system is not listed as eligible for Electronic Service. 6.0 Support =========== If you encounter problems or have technical questions regarding Electronic Service Agent, you should call your nearest IBM support center. You can obtain support center contact details that are appropriate for your country/region from the following web site: http://publib.boulder.ibm.com/pubs/html/as400/v4r4/ic2924/info/rzajitbl.htm If you are a resident of the United States, contact support at 1-800-IBM-SERV (1-800-426-7378) and select hardware support. You should have your machine type and serial number ready to give to the IBM support staff. Your machine type is identified by a four-digit number. Web Sites IBM PC Support and Information http://www-3.ibm.com/pc/support/site.wss/ IBM Support Center contact information http://publib.boulder.ibm.com/pubs/html/as400/v4r4/ic2924/info/rzajitbl.htm Electronic Service Agent installation package http://www.pc.ibm.com/qtechinfo/MIGR-40870.html 7.0 Trademarks and Notices =========== Please see the "Trademarks and Notices" section in the User's Guide. 8.0 Disclaimer =========== 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 jurisdictions 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. (C) Copyright IBM Corporation 1999, 2004. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.