*******************************************************************************
* 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
=============
Refer to the TNPMW Installation Guide for more details.

The media contains the following directories:
  1. packages
  2. docs

The packages directory contains packages for the Gateway Framework
and all the standard Vendor Gateways.

The docs directory contains the Distribution Note and User Guide
for the Gateway Framework and all the standard Vendor Gateways.

The TNPMW requires the Gateway Framework and the Vendor Gateways
to be installed in $WMCROOT/gways. The gateways installation
package is shown below and should be placed in the same directory
as the core TNPMW packages:

     vallent-vt-gways-vallent-TFP<release>.tar.gz

To install the gateways, copy the EPM packages to a directory of
your choice. In the example below the directory /appl is used.

1.   Execute the following commands as user virtuo:

     cd /appl/virtuo/admin/common/install/scripts
     ./deploy_gateways -pkgdir /appl

Note: If you wish to install gateways other than the standard
ones, invoke deploy_gateways as follows:

     ./deploy_gateways -pkgdir /appl -gateways <gw1>,<gw2>,...

where <gw1>,<gw2>,... is a comma-separated list of gateway
packages.

The following output is displayed:

     Virtuo Gateways Install
     
     * > 1. Install Gateways Software
     
     Use PageUp and PageDown to scoll down or up a page of items.
     Arrow Keys to navigate (X to Exit).
     
     Do you want to deploy the packages? [yes/no] >yes
     Packages: (gways-vallent gwaysperl)
     Please enter the location of the Virtuo Software packages:
     ---->/appl

2.   Enter the location of the two Gateway packages.

See $WMCROOT/admin/logs/vt_install.log log file for installation
errors.

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

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