*******************************************************************************
* Licensed Materials - Property of IBM
*
* 5724-T01 5724-V38
*
* (C) Copyright IBM Corp. 2010. 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 April 2010

Perl Gateways
=============
This packages contains the following contents.

Gateway Component	Release
-----------------	-------
GATEWAY FRAMEWORK	3.5.1.9

Vendor Gateways:
ALCATEL BSS		3.5.1.4

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 x85-64 	i686-linux
Linux Server 4 & 5      	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 instructions provided below are for Gateway installations not 
conducted as part of a core installation for TNPMW. Refer to 
the TNPMW Installation Guide for more details.

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 /appl/virtuo/admin/logs/vt_install.log log file for installation errors.

Post Installation Note
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