The eG Installation Guide - eG Innovations

Table of Contents
INTRODUCTION.........................................................................................................................................................................................................1
1.1 SYSTEM ARCHITECTURE.............................................................................................................................................................................1
1.1.1 Manager........................................................................................................................................................................................1
1.1.2 Agents............................................................................................................................................................................................2
1.1.3 Database .......................................................................................................................................................................................4
1.1.4 User Interface ...............................................................................................................................................................................4
1.2 FACTORS GOVERNING THE LOCATION OF THE MANAGER .........................................................................................................................5
1.2.1 Sizing the Hardware and Database Required by an eG Manager ..............................................................................................6
INSTALLING AND CONFIGURING ON UNIX.....................................................................................................................................................7
2.1 INSTALLING THE EG MANAGER..................................................................................................................................................................7
2.1.1 System Requirements ....................................................................................................................................................................7
2.1.2 Installing the Manager on Solaris................................................................................................................................................7
2.1.3 Installing the Manager on Linux/CentOS ..................................................................................................................................13
2.1.4 Configuring the eG Manager .....................................................................................................................................................14
2.1.5 Using an Oracle Database .........................................................................................................................................................18
2.1.6 Using an MS SQL Server Database ...........................................................................................................................................21
2.1.7 Configuring Manager Redundancy............................................................................................................................................35
2.2 SSL-ENABLING THE EG MANAGER ON UNIX ...........................................................................................................................................36
2.2.1 Generating the Keystore File .....................................................................................................................................................36
2.2.2 Extracting the Certificate to a Certificate File ..........................................................................................................................37
2.2.3 Requesting a Certificate Authority for a Valid Certificate ........................................................................................................38
2.2.4 Configuring Tomcat for Using the Keystore File ......................................................................................................................39
2.3 CONFIGURING TOMCAT TO LISTEN ON MULTIPLE PORTS........................................................................................................................40
2.4 INSTALLING THE EG MANAGER ON PRIVILEGED PORTS ..........................................................................................................................41
2.5 STARTING THE MANAGER.........................................................................................................................................................................42
2.6 INCREASING THE MEMORY OF THE EG MANAGER PROCESS ...................................................................................................................42
2.7 INSTALLING THE EG AGENT .....................................................................................................................................................................43
2.7.2 Installing an Agent on Solaris ....................................................................................................................................................43
2.7.3 Installing an Agent on Linux ......................................................................................................................................................45
2.7.4 Installing an Agent on AIX .........................................................................................................................................................47
2.7.5 Installing an eG Agent on HP-UX..............................................................................................................................................48
2.7.6 Installing an eG Agent on an HP-UX Server Running an Itanium Processor ..........................................................................52
2.7.7 Manually Installing / Uninstalling the Auto-restart Feature for the eG Agent / Manager.......................................................53
2.8 SILENT MODE INSTALLATION OF THE EG AGENT ON UNIX .....................................................................................................................54
2.8.1 Installing an eG Agent on Linux in the Silent Mode ..................................................................................................................54
2.8.2 Installing an eG Agent on Solaris in the Silent Mode................................................................................................................57
2.8.3 Installing an eG Agent on AIX in the Silent Mode.....................................................................................................................58
2.8.4 Installing an eG Agent on HPUX in the Silent Mode.................................................................................................................58
2.8.5 Installing an eG Agent on HPUX Host with Itanium Processor in the Silent Mode.................................................................59
2.9 DEALING WITH OPERATING SYSTEM VARIATIONS...................................................................................................................................60
2.9.1 Deploying the eG Agent on Solaris Environments.....................................................................................................................60
2.9.2 Deploying the eG Agent on Linux Environments.......................................................................................................................61
2.9.3 Deploying the eG Agent on HPUX Environments .....................................................................................................................62
2.9.4 Deploying the eG Agent on AIX Environments..........................................................................................................................62
2.10 CONFIGURING THE EG AGENT..................................................................................................................................................................63
2.11 STARTING THE EG AGENT ........................................................................................................................................................................67
2.12 PERFORMANCE IMPACT OF THE EG AGENT..............................................................................................................................................70
2.13 INCREASING THE MEMORY OF THE EG AGENT ........................................................................................................................................70
2.14 CONFIGURING WEB SERVERS ...................................................................................................................................................................71
2.14.1 Configuring the eG Web Adapter for an iPlanet/SunONE Web Server (before Version 6.0).................................................71
2.14.2 Configuring the eG Web Adapter for a SunONE Web Server Version 6.x on Solaris ............................................................73
2.14.3 Configuring the eG Web Adapter for an Apache/IBM HTTP Web Server on a 32-bit Unix Operating System.....................73
2.14.4 Configuring the eG Web Adapter for an Apache Web Server on a 64-bit Linux Operating System ......................................75
2.15 CONFIGURING APPLICATION SERVERS .....................................................................................................................................................77
2.15.1 Coldfusion Server .....................................................................................................................................................................77
2.15.2 WebLogic Server 5.x and iPlanet Servers................................................................................................................................77
2.15.3 WebLogic Server 6.x or WebLogic Server 7.x .........................................................................................................................77
2.15.4 Configuring a BEA WebLogic Application Server 8.1 ............................................................................................................84
2.15.5 Configuring a BEA WebLogic Application Server 9.2 ............................................................................................................88
2.15.6 Configuring an Execute Queue ..............................................................................................................................................105
2.15.7 WebSphere Application Server...............................................................................................................................................115
2.15.8 Configuring a WebSphere Application Server 5.1 to work with the eG Agent......................................................................129
2.15.9 Deploying the egurkha.ear file in a Clustered Environment .................................................................................................137