File Name: README.txt Electronic Service Agent for Netfinity version 1.1.2 README.txt CONTENTS ________ 1.0 Overview 1.1 Change History 2.0 Limitations 3.0 Prerequisites 4.0 Migrating from IBM Remote Connect to Electronic Service Agent 5.0 Remote Administration 6.0 About IBM's Electronic Systems Management Services for Netfinity Extended Service Levels 7.0 A Note About Your Entitlement to Support From IBM 8.0 README Updates and Contacting Customer Support 9.0 Trademarks and Notices 10.0 Disclaimer 1.0 Overview ________________ Electronic Service Agent for Netfinity version 1.1.2 is a program that operates on IBM Netfinity and IBM eserver xSeries servers. This agent is designed to be installed as an extension to your IBM Director Central Management Server. Electronic Service Agent monitors your networked servers for hardware errors and also has an integrated performance monitor function that automatically collects system utilization information. Electronic Service Agent also performs hardware and software inventories, and reports inventory changes to IBM. All information sent to IBM is stored in a secure IBM database and used for improved problem determination. Electronic Service Agent version 1.1.2 also provides generic support for IBM's Electronic Systems Management Services for Netfinity Extended Service Levels. Electronic Systems Management Services for Netfinity currently provides two Extended Service Levels. These are the Premiere and Premiere Plus Extended Service Levels (refer to section 6.0 below). 1.1 Change History -------------- 1.1.1 Previously using Electronic Service Agent version 1.1.1 a user with administrative privileges had to be logged on to the Central Management Server (CMS) in order for the modem connection for Electronic Service to function properly. This is no longer the case. Using Electronic Service Agent version 1.1.2 it is not necessary for any user to be logged on to the Central Management Server. 1.1.2 A note has been added for the benefit of Asia Pacific users of Electronic Service Agent in section 2.3. 1.1.3 Section 2.8 contains some amended information about socksifying your Electronic Service Agent Central Management Server. 1.1.4 Section 3.1 contains some additional upgrade information. 1.1.5 Electronic Service Agent version 1.1.2 now supports IBM eserver xSeries 330 and Netfinity 4100 managed systems. This is in addition to the exhaustive list of supported managed systems reported in your Electronic Service Agent User's Guide. 1.1.6 Electronic Service Agent version 1.1.2 now supports managed systems running the SCO UnixWare version 7.1 operating system. 1.1.7 A single fan failure event: Netfinity System.Non-critical.SFF has been added to Electronic Service Agent's base event list. 1.1.8 Additional countries/regions have been added to Electronic Service Agent's list of supported countries. 1.1.9 Previously when Electronic Service Agent was installed on a newly formatted server containing no files other than those of a freshly installed Windows 2000 operating system (excluding IBM Director and Universal Manageability Server Extensions) the dialer did not function properly. This defect has now been fixed. 1.1.10 Korean and Chinese license agreements have been added to the installation program. 1.1.11 This version of Electronic Service Agent should now be used in conjunction with IBM Director version 2.2, Universal Manageability Server Extensions version 2.2 and IBM Director Service Pack 1. 2.0 Limitations _______________ 2.1 Due to differing capabilities of the Advanced Systems Management Adapters in various Netfinity models, Electronic Service Agent will not report the following events from Netfinity 5000, 5500, 5500 M10, 5500 M20, or 7000: - Netfinity System Events.Critical.Temperature - Netfinity System Events.Critical.Voltage - Netfinity System Events.Critical.Voltage Regulator Module Failure - Netfinity System Events.Critical.Power Failure - Netfinity System Events.Critical.Hard Disk Drive The Netfinity Advanced Systems Management Processor and Adapter must be updated to the latest level on each managed server. To obtain the latest level of device driver: 1.0 Visit website: http://www.pc.ibm.com/support on the Internet Ensure that your web browser is capable of displaying frames. 2.0 Select "Servers." 3.0 Select the machine type of your managed server from the drop down list. 4.0 Select "Downloadable files" from the left hand navigation frame. 5.0 Select "Advanced Systems Management" from the Category drop down list. 6.0 Download and follow the directions for all Advanced Systems Management firmware and device driver updates. 2.2 You must ensure that you type only English or Latin characters into the text fields of the Electronic Service Agent interface. 2.3 A note to Asia Pacific users: Japanese, Korean, Simplified and Traditional Chinese versions of Electronic Service Agent version 1.1.2 are currently available. Note however that Electronic Service Agent version 1.1.2 will not accept contact and location details typed as double byte characters. You must ensure that you type the appropriate contact and location details in the Contact/Location page and associated editor panels as single byte characters (English, French, German, Spanish and Italian). 2.4 If you enable one or more systems for PMR Tracking or Performance Management then subsequently disable either PMR Tracking or Performance Management, then inventory collection will automatically be disabled. You must then explicitly enable inventory collection if you require it. 2.5 If you have clicked Send in the Inventory or Performance Manager page or clicked Test Modem Connection in the Dialer page, then you must wait until the tasks have completed before interacting with the Electronic Service Agent user interface. These tasks may take several minutes to complete. The user interface may display "Ready" even though the modem may still be in use. We recommend that you physically view the modem (using the Dial-Up Networking Monitor screen)and wait until it is in a state of rest before using the interface again. If Electronic Service Agent appears to hang during any of the tasks mentioned above, then you may have to shutdown then restart the IBM Director Management Console. Lastly, you should note that when collecting and sending inventory or performance data using the Inventory or Performance Manager pages respectively, targeting more than four systems at one time may cause heavy network traffic. 2.6 If you are viewing inventory data for a managed system or group of managed systems using IBM Director's Query Browser window and then you change the Extended Service Level enablement of this managed system or group of managed systems, note that the inventory data displayed in the Query Browser window will not be automatically updated. To view updated inventory data, you must close the IBM Director Query browser window and then reopen it by relaunching the inventory task targeted at the managed system or group of managed systems for which you want to view refreshed inventory data. 2.7 If the IBM Director Central Management Server is stopped and restarted, Performance Monitors will stop functioning. Changing Extended Service Levels may also have unpredictable effects. If you stop an IBM Director Central Management Server, that is managing systems enabled for the Premier Plus Extended Service Level, and then restart the IBM Director Central Management Server, you must restart Performance Monitors. To restart Performance Monitors: 1.0 Restart IBM Director to launch the IBM Director Management Console. 2.0 Drag and drop the Resource Monitors task from the Tasks pane onto the Electronic Service Eligible Systems group in the Groups pane of the IBM Director Management Console. 3.0 The Resources Window appears. Close this window. 2.8 If you want to socksify your IBM Director Central Management Server (CMS) after you have installed Electronic Service Agent, then you must make a modification to your Socks.cnf file. Locate and open your Socks.cnf file, then type the following line at the TOP of the file: EXCLUDE MODULE DIALERSERVICE 2.9 Once installed, this release of Electronic Service Agent cannot be uninstalled from an IBM Director remote console using the Windows Add/Remove programs function. This small defect however, does not have any adverse effect on the day to day running and functionality of Electronic Service Agent. 3.0 Prerequisites __________________ 3.1 Electronic Service Agent versions 1.0 and 1.0.1 are NOT upgradeable to Electronic Service Agent version 1.1.2. If you have previously installed either version 1.0 or 1.0.1, then you should use the uninstalling procedure detailed in Chapter 3, "Obtaining and installing Electronic Service Agent for Netfinity" of your Electronic Service Agent for Netfinity User's Guide to properly remove all version 1.0 or 1.0.1 files from your IBM Director Central Management Server. Electronic Service Agent versions 1.1 and 1.1.1 can be upgraded to version 1.1.2. There is no need to uninstall either version 1.1 or 1.1.1 prior to installing Electronic Service Agent version 1.1.2. 3.2 Before installing Electronic Service Agent version 1.1.2, you should ensure that you have properly installed the following: (i) IBM Director version 2.2 (ii) Universal Manageability (UM) Services version 2.2. (iii)IBM Director Service Pack 1. Refer to your Electronic Service Agent user's guide for further information. 3.3 Electronic Service Agent version 1.1.2 supports the following operating systems: 3.3.1 IBM Director Central Management Server - Windows NT 4.0 Server with Service Pack 4 or higher - Windows NT 4.0 Enterprise with Service Pack 4 or higher - Windows 2000 Server, Windows 2000 Advanced Server 3.3.2 Managed systems - SCO UnixWare version 7.1 - OS/2 3.00, OS/2 3.00 Connect, OS/2 Warp Server, OS/2 Warp Server SMP, OS/2 Warp Merlin 4.0, OS/2 Aurora 4.5 - Windows NT 4.0 Server with Service Pack 4 or higher - Windows NT 4.0 Workstation with Service Pack 4 or higher - Windows NT 4.0 Enterprise with Service Pack 4 or higher - Novell Netware 4.10 Server, 4.11 Server, 4.2 Server, 5.0 Server, 5.1 Server - Windows 2000 Professional - Windows 2000 Server - Windows 2000 Advanced Server 3.3.3 IBM Director Management Console - Windows NT 4.0 Server with Service Pack 4 or higher - Windows NT 4.0 Workstation with Service Pack 4 or higher - Windows NT 4.0 Enterprise with Service Pack 4 or higher - Windows 95 Release 2 - Windows 98, Windows 98 Second Edition - Windows 2000 Professional - Windows 2000 Server - Windows 2000 Advanced Server NOTE: IBM supports modems on the Microsoft Compatibility List for Windows 2000. If you have problems with Microsoft's Routing and Remote Access Service (RRAS) with Windows 2000, review the following websites: (1) http://msdn.microsoft.com/library/psdk/rras/ rrasovr_19r9.htm (2) http://www.microsoft.com/technet/network/ default.asp 3.4 If you are managing systems running SCO UnixWare version 7.1, you must ensure that you have installed the latest level of SCO UnixWare Package Transmission Files (PTF). Electronic Service Agent for Netfinity version 1.1.2 may not function properly if you have not installed the latest level of PTF. 3.5 Electronic Service Agent version 1.1.2 supports IBM eserver xSeries 330 and Netfinity 4100 managed systems. Refer to Chapter 1, "Introducing Electronic Service Agent for Netfinity", of your Electronic Service Agent User's Guide for an exhaustive list of supported managed system models. 3.6 Ensure that you have selected the Remote Access Service (RAS) option when installing your Windows NT ® operating system or Routing and Remote Access Service (RRAS) when installing your Windows 2000 Operating System on your Central Management Server. You can add the Remote Access Service from the Network Properties resource on your server console. For further information refer to your Windows NT Administrator's Guide. NOTE: If you have more than one modem installed, then the AT&T dialer arbitrarily selects one as the default modem for your IBM Director Central Management Server. 3.7 Ensure that you have completed the configuration of the dialer and contact and location information before activating the Electronic Service Agent task in targeted mode. It is particularly important that you configure the location details of your IBM Director Central Management Server and managed systems accurately. If you record your IBM Director Central Management Server location details incorrectly then IBM's service delivery will be delayed. Similarly, if you record your managed systems' location details incorrectly, then IBM service representatives will not be dispatched to the correct site location after a hardware problem has been reported. 4.0 Migrating from IBM Remote Connect to Electronic _______________________________________________ Service Agent ______________ 4.1 Electronic Service Agent is a functional replacement for IBM Remote Connect Manager providing greater ease of installation, higher reliability, and improved manageability of IBM Netfinity(tm) Servers. 4.1.1 The primary software architectural difference between IBM Remote Connect and Electronic Service Agent is between the underlying systems management products and is detailed as follows: - IBM Remote Connect leverages Netfinity Manager. - Electronic Service Agent leverages IBM Director and UM Server Extensions. 4.1.2 The primary hardware architectural difference between IBM Remote Connect and Electronic Service Agent is: - IBM Remote Connect Manager installs on a generic workstation running Netfinity Manager. - Electronic Service Agent installs on a supported server running IBM Director Central Management Server and UM Server Extensions. To view the current list of supported servers visit website: http://www.ibm.com/pc/qtechinfo/MIGR-4L4QVC.html As with the IBM Remote Connect Manager workstation, the Electronic Service Agent Central Management Server must be dedicated to the task of Netfinity systems management. 4.2 The first step in migrating from IBM Remote Connect to Electronic Service Agent is to decommission IBM Remote Connect. Uninstall Netfinity Manager Services on each server managed by IBM Remote Connect. For further details refer to the Netfinity Manager user documentation. The IBM Remote Connect Manager workstation may then be put to another use; for example the workstation could be used as an auxiliary IBM Director console. 4.3 Install IBM Director Agent version 2.2 on each of the supported servers formerly managed by Netfinity Manager and IBM Remote Connect. Refer to the IBM Director documentation for IBM Director version 2.2 installation details. Nefinity Manager Services must be uninstalled on the managed servers prior to installing IBM Director Agent. Nefinity Manager Remote Control and IBM Director Remote Control are incompatible. IBM Director will not allow Remote Control to be installed if Netfinity Manager Remote Control is detected. 4.4 Install UM Server Extensions version 2.2 on each of the supported servers on which IBM Director Agent was installed in step 4.3 above. Refer to the UM Server Extensions documentation for UM Server Extensions version 2.2 installation details. 4.5 Install IBM Director Server 2.2 on a supported server dedicated to IBM Director systems management. Refer to the IBM Director version 2.2 user documentation for installation details. Do not install IBM Director Central Management Server on a server with other applications. The Central Management Server is the point of service for managing servers running applications. Microsoft® RAS must be installed, and NOS Service Packs reapplied, prior to installing IBM Director Server on the Central Management Server. Refer to the Electronic Service Agent Prerequisites in section 3.0 above. The default Windows NT® Server RAS configuration must be changed to allow dial-out connections. 4.6 Install UM Server Extensions version 2.2 on the IBM Director Central Management Server. Refer to the UM Server Extensions version 2.2 user documentation for installation details. 4.7 Using IBM Director, perform a Systems Discovery and Inventory Collection on the managed supported servers. Refer to the IBM Director version 2.2 on-line help for further details. 4.8 Download and install Electronic Service Agent on the IBM Director Central Management Server. Refer to the Electronic Service Agent User's Guide for this procedure. 4.9 Ensure that you have installed IBM Director version 2.2, Electronic Service Agent version 1.1.2 and UM Server extensions ONLY on IBM supported servers. If you install IBM Director version 2.2, Electronic Service Agent version 1.1.2 or UM Server extensions on a NON-IBM supported server then the server will not have an electronic call generation capability. Refer to Chapter 1, "Introducing Electronic Service Agent for Netfinty" of your Electronic Service Agent for Netfinity Version 1.1 User's Guide for an exhaustive list of supported managed systems. Refer to your IBM Director version 2.2 documentation for a list of supported Central Management Servers (CMS). 5.0 Remote Administration _________________________ You can administer Electronic Service Agent using a remote IBM Director console. To use a remote IBM Director console: 1.0 Ensure that the system that you want to use as a remote IBM Director console constitutes part of the list of supported servers detailed in your IBM Director version 2.2 User's Guide. 2.0 Follow the instructions detailed in Chapter 2 "Preparing your network" of your Electronic Service Agent User's Guide. 3.0 On the remote console system, enable RAS (Remote Access Service) for systems running Windows NT version 4.0 or RRAS (Routing and Remote Access Service) for systems running Windows 2000. (This can be done by selecting a modem driver during the operating system installation without physically attaching a modem. 4.0 Install the IBM Director Console component of IBM Director version 2.2, Universal Manageability Server Extensions 2.2 and IBM Director Service Pack 1 IN THIS ORDER on the system you want to use as an IBM Director remote console. 5.0 Install Electronic Service Agent version 1.1.2 on the remote console. NOTE: At the end of the install you may see an error message displayed which reads: "Unable to Launch AddDialUp.exe". Click OK. The console will have installed properly even though it appears that it has not. 6.0 Reboot the machine on which you have installed the IBM Director Remote Console. 6.0 About IBM's Electronic Systems Management Services _______________________________________________________ for Netfinity Extended Service Levels _____________________________________ In some countries/regions, IBM has announced Electronic Systems Management Services for Netfinity Extended Service Levels. IBM's Electronic Systems Management Services for Netfinity Extended Service Levels provide enhancements to Electronic Service Agent's systems' health monitoring capabilities. Each Extended Service Level consists of a software extension that provides a combination of hardware, software and capacity monitor events in addition to the base events provided by Electronic Service Agent. Premiere: The Premiere Extended Service Level provides additional RAID and Service Processor events. Premiere Plus: The Premiere Plus Extended Service Level adds system utilization and availability events to those supplied by the Premiere Extended Service Level. The purchase and installation of the Premiere Extended Service Level is a prerequisite for the Premiere Plus Extended service level. Enterprise: It is IBM's intention to make the enterprise service level available in the future. Customized services: Additional services are available beyond those that are offered in the Premiere and Premiere plus service levels. If you require further information, contact your local IBM customer representative. 7.0 A Note About Your Entitlement to Support From IBM ______________________________________________________ You are entitled to support from IBM only if your systems are under warranty and your organization has a maintenance agreement with IBM. This service program is not intended for customers who have a third party maintaining their IBM xSeries and Netfinity servers. 8.0 README Updates and Contacting Customer Support ____________________________________________________ 8.1 This README document may be periodically updated. You can obtain the latest version of the Electronic Service Agent for Netfinity version 1.1.2 README from the following World Wide Website: http://www.pc.ibm.com/qtechinfo/MIGR-4L4QVC.html 8.2 Should you encounter problems or have technical questions regarding the Electronic Service Agent for Netfinity product, you should call your nearest IBM support center. You can obtain support center contact details from the following website: http://publib.boulder.ibm.com/pubs/html/as400/v4r4/ ic2924/info/rzajitbl.htm When calling IBM you should quote program number 5639-L09. You should have your machine type ready when calling. Your machine type is identified by a four digit number. You will be asked for this four digit number by IBM support staff. 9.0 Trademarks and Notices ___________________________ 9.1 The following terms are trademarks of the International Business Machines Corporation in the United States, or other countries, or both: Electronic Service Agent Extended Services IBM Netfinity OS/2 xSeries 9.2 Microsoft, Windows and Windows NT are registered trademarks of Microsoft Corporation. 9.3 Other company, product, and service names may be trademarks or service marks of others. 10.0 Disclaimer _______________ 10.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 10.2 Note to U.S Government Users-- Documentation related to restricted rights -- use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule contract with IBM Corporation. 10.3 You agree to pay any communications charges associated with accessing Electronic Service Agent for Netfinity unless we specify otherwise. (C) COPYRIGHT IBM CORPORATION 2000, 2001. ALL RIGHTS RESERVED.