IBM Tivoli Configuration Manager for Automated Teller Machines Readme File for Interim Fix 2.1-CMA-IF0001 Version 2.1 +---- Note ------------------------------------------------------------+ Before using this information and the product it supports, read the information in 3.0, "Notices". +----------------------------------------------------------------------+ This edition applies to interim fix 2.1-CMA-IF0001 for version 2, release 1, modification level 0 of IBM Tivoli Configuration Manager for Automated Teller Machines (program number 5724-E50) Copyright International Business Machines Corporation 2003, 2009. US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents 1.0 Tables 2.0 IBM Tivoli Configuration Manager for Automated Teller Machines, 2.1 ReadMe File for Interim Fix 2.1-CMA-IF0001 2.1 About this interim fix 2.1.1 Enhancement in previous fix packs 2.1.2 Product compatibility 2.1.3 Limitations 2.2 Fixed defects 2.3 Installation 2.3.1 Prerequisites 2.3.2 Supported platforms 2.3.3 Traditional interim fix installation methods 2.3.3.1 Installing interim fixes using the Tivoli desktop 2.3.3.2 Installing interim fixes using the CLI 2.3.3.2.1 wpatch command 2.3.3.3 Installing interim fixes using SIS 2.3.4 Updating the automated teller machine endpoint configuration 2.3.5 Updating the inventory schema 2.3.5.1 Updating tables and views on DB2 2.3.5.2 Updating tables and views on DB2 on MVS 2.3.5.3 Updating tables and views on Informix 2.3.5.4 Updating tables and views on MS SQL 2.3.5.5 Updating tables and views on Oracle 2.3.5.6 Updating tables and views on Sybase 2.4 Documentation notes 2.4.1 Installation and Configuration Guide for Fix Pack 1 3.0 Notices 3.1 Trademarks 1.0 Tables 1. Fixed defects and APARs 2. Index file included in this interim fix 2.0 IBM Tivoli Configuration Manager for Automated Teller Machines, 2.1 ReadMe File for Interim Fix 2.1-CMA-IF0001 This readme file provides important information about Interim Fix 2.1-CMA-IF0001 for IBM® Tivoli® Configuration Manager for Automated Teller Machines Version 2.1. This readme file is the most current information for the interim fix and takes precedence over all other documentation for IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1. Please review this section thoroughly before installing or using this interim fix. 2.1 About this interim fix This section includes the following topics: * 2.1.1, "Enhancement in previous fix packs" * 2.1.2, "Product compatibility" * 2.1.3, "Limitations" 2.1.1 Enhancement in previous fix packs The following enhancement has been introduced in previous fix packs: Support required for automated teller machines running XFS 3.0 - Feature MR0412057114 Tivoli Configuration Manager for Automated Teller Machines has been upgraded to support XFS 3.0.2 and 3.0.3. 2.1.2 Product compatibility Compatibility is defined as whether different versions of a Tivoli product can communicate with different versions of Tivoli Management Framework or other Tivoli products. IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 interim fix 2.1-CMA-IF0001 was tested using: * Tivoli Management Framework, Version 4.1.1 plus the following interim fixes: * 4.1.1-LCF-0056 to be installed on the Tivoli gateways. * 4.1.1-TMF-100 to be installed on the managed nodes with JRIM and JCF components installed. * 4.1.1-TMF-104 to be installed on Tivoli servers, managed nodes, and gateways. * Tivoli Configuration Manager, Version 4.2.3 Fix Pack 8. 2.1.3 Limitations Before distributing the ATM_InventoryScan profile to scan the automated teller machines, the user must be logged on to the automated teller machines. 2.2 Fixed defects Table 1 lists the defects and APARs that were fixed for this interim fix. Table 1. Fixed defects and APARs +---------------------------------------------------------------------+ | Configuration Manager for Automated Teller Machines, Version 2.1, | | interim fix 2.1-CMA-IF0001 | +-------------+-------------+-------------+-------------+-------------+ | 63232 | IZ42463 | IZ43275 | IZ43806 | | +-------------+-------------+-------------+-------------+-------------+ Defect 63232 Abstract: Implementation of enhancement MR0306093643 frm_version serial_number Error Description: The Configuration Manager for Automated Teller Machines scan needs to collect the firmware version and installation date for the following devices: * Card readers * Receipt printers * Dispensers * Deposits * Passbooks and the firmware serial number for the PIN PAD device. In case multiple versions of firmware are found, the most recent is collected. Additional Information: The mentioned information is available only if you have installed the XFS 3.0x product layer on the Automated Teller Machine workstation, where the scan occurs, and if you are using the vendor Wincor Nixdorf International GmbH. APAR IZ42463 Abstract: Issues with XFS when scanning a Wincore system Error Description: When scanning an Automated Teller Machines Wincore system using Configuration Manager for Automated Teller Machines, Version 2.1 FP21, a problem occurs with the XFS device information stored under the following directory: KKEY_USERS\.DEFAULT\XFS\logical_services Additional Information: To enable the fix provided, create the dummy file IGNORE_HKEY_CLASSES_ROOT under the same directory where the binary sstntxfsscan.exe \inv\SCAN is located. APAR IZ43275 Abstract: SSTNTXFS.MIF partially written causes a MIF parse failure Error Description: The partially written sstntxfs.mif file causes a MIF parse error failure, when Inventory attempts to read the file. APAR IZ43806 Abstract: Need to disable interrupt filtering to allow Dr. Watson during a CM for ATM scan Error Description: The current Configuration Manager for Automated Teller Machines application does not open Dr. Watson when there is an error because all interrupts are filtered. A fix is needed to disable interrupt filtering and to open Dr. Watson when an error occurs. Additional Information: To enable the fix provided, create the dummy file DISABLE_SIGNAL_CAPTURE under the same directory where the binary sstntxfsscan.exe \inv\SCAN is located. 2.3 Installation This section describes how to upgrade IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 to interim fix 2.1-CMA-IF0001. When you have installed the interim fix, you cannot uninstall it automatically. Ensure that you perform a complete backup of your system before installing this interim fix. This section includes the following topics: * 2.3.1, "Prerequisites" * 2.3.2, "Supported platforms" * 2.3.3, "Traditional interim fix installation methods" * 2.3.4, "Updating the automated teller machine endpoint configuration" * 2.3.5, "Updating the inventory schema" 2.3.1 Prerequisites Before installing the IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 interim fix 2.1-CMA-IF0001 ensure you install IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 Fix Pack 1. 2.3.2 Supported platforms Supported platforms at the time of the release are detailed in the IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 Release Notes. To establish what platforms and databases are supported by IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 Interim Fix 2.1-CMA-IF0001, see the IBM Tivoli Configuration Manager: Release Notes related to the level of IBM Tivoli Configuration Manager 4.2.3 you are using together with the IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 Release Notes. For the most recent information, you can also consult the supported platforms matrix on the IBM software support Web site: http://www-304.ibm.com/jct03001c/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html. IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 Interim Fix 2.1-CMA-IF0001 was tested on Windows® XP Automated Teller machines. 2.3.3 Traditional interim fix installation methods You can install the interim fix for IBM Tivoli Configuration Manager for Automated Teller Machines using any of the following installation methods: * 2.3.3.1, "Installing interim fixes using the Tivoli desktop" A graphical user interface that you use to select the interim fix components to install and the target workstations on which to install them. * 2.3.3.2, "Installing interim fixes using the CLI" Tivoli Management Framework command that you use to specify the interim fix components to install and the target workstations on which to install them from the command line interface. * 2.3.3.3, "Installing interim fixes using SIS" The SIS console or SIS commands you use to specify the interim fix components to install and on which target workstations to install them. 2.3.3.1 Installing interim fixes using the Tivoli desktop The basic procedure for using the Tivoli desktop to upgrade a product is as follows: 1. From the Tivoli desktop, select Install-> Install Patch. 2. Select the media and component to be upgraded or added. 3. Select the workstations on which the component is to be upgraded or added. 4. Click Install. 2.3.3.2 Installing interim fixes using the CLI Use the wpatch command to install updates to existing components. 2.3.3.2.1 wpatch command When upgrading existing components using the wpatch command, specify the name of the index file using the file shown in Table 2. When using the wpatch command to upgrade a product, you specify the following information on the command line: * The location of the image on the installation media. * The name of the index file associated with the product to be upgraded. * The workstations on which the image is to be installed. Example: wpatch -c CD-ROM/images -i index_file managed_node where: -c CD-ROM/images Specifies the path to the images on the IBM Tivoli Configuration Manager for Automated Teller Machines, Version 2.1 Interim Fix 2.1-CMA-IF0001. -i index_file Specifies the product installation index file to which the interim fix is installed. managed_node Specifies the Tivoli server on which the interim fix is installed. If you do not specify a workstation when running the wpatch command, the image is installed on all managed nodes in the Tivoli region where there is a prior version of this image. For detailed information about using the wpatch command, see Tivoli Management Framework: Reference Manual. The following table contains the index file for this interim fix. Table 2. Index file included in this interim fix +-------------+----------------------------------------+--------------+ | Index file | Product name | Tag | +-------------+----------------------------------------+--------------+ | 21CMAF1P.IN | IBM Tivoli Configuration Manager for | 2.1-CMA-IF00 | | D | Automated Teller Machines, Version | 01 | | | 2.1, Interim Fix 2.1-CMA-IF0001 | | +-------------+----------------------------------------+--------------+ 2.3.3.3 Installing interim fixes using SIS When installing interim fixes using Tivoli Software Installation Service, select the interim fix component to be installed using the product name shown in Table 2. Tivoli Software Installation Service does not distinguish between products and interim fixes. Whether the installation image is used for an installation or upgrade, Tivoli Software Installation Service refers to all installation images as products. Tivoli Software Installation Service can install multiple products on multiple workstations in parallel. This software can install several products on several computer systems in less time than using the installation methods provided by Tivoli Management Framework. The basic procedure for using Tivoli Software Installation Service to install products is as follows: 1. Import the product images into the Tivoli Software Installation Service depot. 2. Select the components to be installed. 3. Select the workstations on which each component is to be installed. 4. Click Install. For detailed information about using Tivoli Software Installation Service, see Tivoli Enterprise: Installation Guide. 2.3.4 Updating the automated teller machine endpoint configuration To update IBM Tivoli Configuration Manager for Automated Teller Machines on automated teller machine endpoints, install the ATM_Configuration_Fix.v2.1.FP01.IF0001 software package as described in the IBM Tivoli Configuration Manager for Automated Teller Machines: Installation and Configuration Guide for Fix Pack 1. 2.3.5 Updating the inventory schema When you install an interim fix, you must update the inventory schema by running the provided SQL scripts. This interim fix installation provides scripts to update inventory tables and views with the new database information introduced by the interim fix, depending on the database you installed. 2.3.5.1 Updating tables and views on DB2 To update the tables and views in the DB2 RDBMS, perform the following steps: 1. Copy the tivoli_sstxfs_db2_upgrade_21_FP02.sql script from the $BINDIR/TME/sst/ntxfs/scripts/rdbms directory on the Tivoli server to a temporary directory on the RIM host or on the DB2 server. For DB2, run the tivoli_sstxfs_db2_upgrade_21_FP02.sql upgrade script. 2. Create a connection to the DB2 server database using the following command: db2 connect to database_name user user_name using password where: database_name Specifies the name or alias name of the Inventory configuration repository user_name Specifies the name of the user who owns the Inventory configuration repository password Specifies the password of the user specified by user_name 3. From the temporary directory into which you copied the tivoli_sstxfs_db2_upgrade_21_FP02.sql script, run the script using the following command: db2 -f tivoli_sstxfs_db2_upgrade_21_FP02.sql -o -t -z tivoli_sstxfs_db2_upgrade_21_FP02.log This command updates the Inventory configuration repository schema for IBM Tivoli Configuration Manager for Automated Teller Machines, on DB2. It also directs the output to the screen, and logs the output in the tivoli_sstxfs_db2_upgrade_21_FP02.log file. 2.3.5.2 Updating tables and views on DB2 on MVS To update the tables and views in the DB2 RDBMS, perform the following steps: 1. Copy the tivoli_sstxfs_db2_mvs_upgrade_21_FP02.sql script from the $BINDIR/TME/sst/ntxfs/scripts/rdbms directory on the Tivoli server to a temporary directory on the RIM host or on the DB2 server. For DB2 on z/OS, there are two different upgrade scripts: * tivoli_sstxfs_db2_mvs_upgrade_21_FP02.sql if you want to use the default tablespace storage information. * tivoli_sstxfs_db2_mvs_custom_upgrade_21_FP02.sql if you want to specify tablespace storage information. 2. Create a connection to the DB2 server database using the following command: db2 connect to database_name user user_name using password where: database_name Specifies the name or alias name of the Inventory configuration repository user_name Specifies the name of the user who owns the Inventory configuration repository password Specifies the password of the user specified by user_name 3. From the temporary directory into which you copied the tivoli_sstxfs_db2_mvs_upgrade_21_FP02.sql script, run the script using the following command: db2 -f tivoli_sstxfs_db2_mvs_upgrade_21_FP02.sql -o -t -z tivoli_sstxfs_db2_mvs_upgrade_21_FP02.log This command updates the Inventory configuration repository schema for IBM Tivoli Configuration Manager for Automated Teller Machines, on DB2. It also directs the output to the screen, and logs the output in the tivoli_sstxfs_db2_mvs_upgrade_21_FP02.log file. 2.3.5.3 Updating tables and views on Informix To update the tables and views in the Informix RDBMS, perform the following steps: 1. Copy the tivoli_sstxfs_infx_upgrade_21_FP02.sql script from the $BINDIR/TME/sst/ntxfs/scripts/rdbms directory on the Tivoli server to a temporary directory on the RIM host or on the Informix server. 2. Run the tivoli_sstxfs_infx_upgrade_21_FP02.sql script using the following command: dbaccess database_name@$INFORMIXSERVER tivoli_sstxfs_infx_upgrade_21_FP02.sql where database_name is the name of the Inventory configuration repository. This command updates the Inventory configuration repository schema for IBM Tivoli Configuration Manager for Automated Teller Machines on Informix. 2.3.5.4 Updating tables and views on MS SQL To update the tables and views in the MS SQL RDBMS, perform the following steps: 1. Copy the tivoli_sstxfs_sql_upgrade_21_FP02.sql script from the $BINDIR/TME/sst/ntxfs/scripts/rdbms directory on the Tivoli server to a temporary directory on the RIM host or on the MS SQL server. 2. From the temporary directory, run the script using the following command: isql -U user_name [-P password][-S server id][-d database id] -i tivoli_sstxfs_sql_upgrade_21_FP02.sql -o tivoli_sstxfs_sql_upgrade_21_FP02.log where: user_name Specifies the MS SQL user name. password Specifies the password for the MS SQL server user. server id Specifies the MS SQL server identifier. database id Specifies the name of the Inventory database. This command updates the Inventory configuration repository schema for IBM Tivoli Configuration Manager for Automated Teller Machines on MS SQL. It also directs the output to the screen, and logs the output in the tivoli_sstxfs_sql_upgrade_21_FP02.log file. 2.3.5.5 Updating tables and views on Oracle To update the tables and views in the Oracle RDBMS, perform the following steps: 1. Copy the tivoli_sstxfs_ora_upgrade_21_FP02.sql script from the $BINDIR/TME/sst/ntxfs/scripts/rdbms directory on the Tivoli server to a temporary directory on the RIM host or on the Oracle server. 2. Switch to the Oracle user and start an SQL *Plus session. Log in to the Oracle server using the following command: sqlplus user_name/password where user_name and password are the Oracle user name and password created and set when you ran the inventory admin script. 3. To specify a file for the log information, use the following command: spool tivoli_sstxfs_ora_upgrade_21_FP02.log 4. In the SQL *Plus session, run the tivoli_sstxfs_ora_upgrade_21_FP02.sql script using the following command: @tivoli_sstxfs_ora_upgrade_21_FP02.sql The script updates the Inventory configuration repository schema for IBM Tivoli Configuration Manager for Automated Teller Machines on Oracle. It also logs the results in the tivoli_sstxfs_ora_upgrade_21_FP02.log file. 2.3.5.6 Updating tables and views on Sybase To update the tables and views in the Sybase RDBMS, perform the following steps: 1. Copy the tivoli_sstxfs_sybase_upgrade_21_FP02.sql script from the $BINDIR/TME/sst/ntxfs/scripts/rdbms directory on the Tivoli server to a temporary directory in which you can run isql on the RIM host or the Sybase server. 2. From the temporary directory, run the script using the following command: isql -U user_name [-P password] [-S server id] [-d database id] -i tivoli_sstxfs_sybase_upgrade_21_FP02.sql -o tivoli_sstxfs_sybase_upgrade_21_FP02.sql.log where: user_name Specifies the name of the Sybase user created when you ran the inventory admin script. The default value is invtiv. password Specifies the password, defined when you ran the inventory admin script, for the Sybase user. The default value is tivoli. server id Specifies the Sybase server identifier. database id Specifies the name of the Inventory database. This command updates the Inventory configuration repository schema for IBM Tivoli Configuration Manager for Automated Teller Machines on Sybase and logs the output in the tivoli_sstxfs_sybase_upgrade_21_FP02.log file. 2.4 Documentation notes This section contains new information and documentation corrections contained in this interim fix. 2.4.1 Installation and Configuration Guide for Fix Pack 1 This section contains new and updated information for IBM Tivoli Configuration Manager for Automated Teller Machines Installation and Configuration Guide for Fix Pack 1: Defect 63232 In Appendix A. Inventory tables, views, and queries in sections: * "Cash dispenser capabilities" * "Depository capabilities" * "ID card reader capabilities" * "PIN pad capabilities" * "Printer capabilities" add to the current Columns list the following new columns: FRM_INST_DATE (*) FRM_VERSION (*) Add the following note at the end of each section: Note: (*) These columns are populated only if you have installed the XFS 3.0x product layer and if you are using the vendor Wincor Nixdorf International GmbH. In case of multiple firmware versions, only the most recent is reported. Defect 63232 In Appendix A. Inventory tables, views, and queries in section "PIN pad status" add to the current Columns list the following new column: SERIAL_NUMBER (*) Add the following note at the end of the section: Note: (*) This column is populated only if you have installed the XFS 3.0x product layer and if you are using the vendor Wincor Nixdorf International GmbH. In case of multiple firmware versions, only the most recent is reported. Defect 63713 In Chapter 4. Upgrading inventory configuration repository in sections: * "Updating tables and views on DB2" * "Updating tables and views on Informix" * "Updating tables and views on MS SQL" * "Updating tables and views on Oracle" * "Updating tables and views on Sybase" add the following statement at the beginning of each section: You only need to run the tivoli_sstxfs_vendorschema_inv4.sql script if you have performed a fresh installation of Configuration Manager for Automated Teller Machines version 2.1 Fix Pack 1. Use the procedure described in this section if you have upgraded from Configuration Manager for Automated Teller Machines version 2.1 GA to Fix Pack 1. 3.0 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 might 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 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. 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. 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 in softcopy form, the photographs and color illustrations might not display. 3.1 Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or (TM)), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml. Intel®, the Intel Inside® logos, MMX, and Pentium® are trademarks of Intel Corporation in the United States, other countries, or both. Microsoft®, Windows NT® and Windows NT are registered trademarks of Microsoft Corporation in the United States, other countries, or both. | Java(TM) and all Java-based trademarks and logos are | trademarks or registered trademarks of Sun Microsystems, | Inc. in the United States, other countries, or both. UNIX® is a registered trademark of The Open Group in the United States and other countries. Linux® is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others.