******************************************************************************* * Licensed Materials - Property of IBM * * 5724-T01 5724-V38 * * (C) Copyright IBM Corp. 2003, 2009. All Rights Reserved. * * US Government Users Restricted Rights - Use, duplication or * disclosure restricted by GSA ADP Schedule Contract with IBM Corp. ******************************************************************************* Title: Tivoli Netcool Gateway Framework v3.5.1 Multiplatform English Media Pack Release Date: 30 November 2009 Perl Gateways ============= This packages contains the following contents. Gateway Component Release ----------------- ------- GATEWAY FRAMEWORK 3.5.1.8 Vendor Gateways: ALCATEL BSS 3.5.1.3 Abstract ============= This download package consists of interim fix packs for Tivoli Netcool Gateway Framework 3.5.1, which includes the Gateway Framework and Vendor Gateways. Description ============= The Gateway Framework provides a standardized architecture for the collection, parsing and presentation of vendor specific data formats. The Vendor Gateways consist of a number of Engine and Post Parser modules to perform the transformation of the vendor specific data. The Vendor Gateways is integrated into the Gateway Framework via the configuration files within the Gateway Configurations. Prerequisites ============= Tivoli Netcool Gateway Framework 3.5.1 is built on Perl version 5.6.1. The Gateway Framework is currently supported on the following platforms: Operating System Chipset Perl Build Version(s) Architecture ----------------------- ------------ --------------------- Solaris 9 & 10 SPARC sun4-solaris Red Hat Enterprise x86-32, and i686-linux Linux Server 4 & 5 x85-64 PPC64 ppc64-linux AIX 5.3 PPC64 aix HP-UX 10.2 & 11.0 PA-RISC2.0 PA-RISC2.0 Tru64 UNIX 5.0 DEC-ALPHA alpha-dec_osf Note: x86-64 includes EM64T (Xeon), and AMD64 (Opteron, Athlon 64); x86-32 is Intel 32-bit and AMD Athlon. Use of other versions of Perl has led to unexpected run time errors. Installation ============= The installation is broken into 3 stages: 1. The installation of the Gateway Framework, 2. The installation of the Vendor Gateways, 3. The installation of the Gateway Configuration. Step 1 and 2 only needs to be completed if a version of the Gateway Framework and Vendor Gateway has not already been installed on the server. Create a Gateways root directory where all the Gateway Framework, Vendor Gateways and Gateway Configurations will be installed. A common name that can be used is "gways". Gateway Framework Installation Within the GATEWAY_ROOT directory, the Gateway Framework is installed in the "gateway-framework" directory. This directory will be referenced by all Gateway Configurations. This path will be set for the environment variable GATEWAY_FRAMEWORK by default. Install the package: zcat gways-.tar.Z | tar -xvf - Vendor Gateway Installation The following steps should be undertaken to install a Vendor Gateway. Within the GATEWAY_ROOT directory, all Vendor Gateways is installed in the "modules" directory with their respective vendor technology directory name. This directory will be referenced by all Gateway Configurations that requires it. This path will be set for the environment variable VENDOR_GATEWAY by default. Install the package: zcat gways-.tar.Z | tar -xvf - Gateway Configuration Installation The following steps should be undertaken to install a Gateway Configuration. Within the GATEWAY_ROOT directory, the Gateway Configuration is installed in the "config" directory with each respective vendor sub-system and release directory. These directories name are a unique for each vendor sub-system and release. Install the package: zcat gways-cfg-.tar.Z | tar -xvf - The Gateway Configuration directory will be created. This directory contains the gateway configuration files of the Gateways Configuration, and will be referenced by the Gateway Framework start script. For additional configurations of the Gateway Configuration, please follow the instructions in the Gateway Framework User Guide, and the respective Vendor Gateway User Guide for the Gateway Configuration. If the StatisticsConfig.pm script is configured, then create the file_statistics and block_statistics directory in the config directory, eg. config//file_statistics config//block_statistics Post Installation Note After installing the Gateway Framework, it is required to run the install_extension.sh from within the ./gateway-framework/install directory. This process is to install the platform specific libraries on the machine platform that the Gateway is to be run on. Create the spool directories for input files, intermediate files, and loader files. Set the directory variables in the properties file within the Gateway Configuration installation respectively: IN_DIR=./spool/input_d INT_DIR=./spool/inter_d OUT_DIR=./spool/output_d The properties file must exist within the Gateway Configuration release directory and updated accordingly. A copy of the properties file is available within the vstart directory of the Gateway Framework as a template. Set the following environment variables accordingly: - TZ: the time zone as defined in RFC 822 Universal: GMT, UT US zones : EST, EDT, CST, CDT, MST, MDT, PST, PDT Military : A to Z (except J) Other : +HHMM or -HHMM ISO 8601 : +HH:MM, +HH, -HH:MM, -HH - PERL5_BASE: the full path to where Perl base is installed, which contains the bin and lib directories for the Perl installed. PERL5_BASE=/usr - PERL5: the path of the perl command, which is commonly found in the bin directory of PERL5_BASE. Please set it if otherwise. PERL5=${PERL5_BASE}/bin/perl END