Installation guide

Contents
1. INTRODUCTION..............................................................................................................I
1.1 ABOUT THIS MANUAL .....................................................................................................I
1.2 TECHNICAL SUPPORT .....................................................................................................I
1.2.1 Additional Information in FAQs.............................................................................ii
1.3 OTHER DOCUMENTATION...............................................................................................II
2. BLUEDRAGON PRODUCT CONFIGURATIONS...........................................................I
2.1 BLUEDRAGON SERVER AND SERVER JX..........................................................................I
2.2 BLUEDRAGON/J2EE ......................................................................................................I
2.3 BLUEDRAGON/.NET......................................................................................................II
2.4 REFERENCES TO PRODUCT NAMES IN THIS DOCUMENT ..................................................II
2.5 TRIAL EDITIONS AND LICENSING.....................................................................................II
3. PREPARING FOR INSTALLATION...............................................................................1
3.1 SYSTEM REQUIREMENTS ...............................................................................................1
3.1.1 JDK Requirements................................................................................................2
3.2 RUNNING ALONGSIDE COLDFUSION AND SERVLET/JSP ENGINES....................................2
3.3 UPGRADING AND INSTALLING MULTIPLE VERSIONS OF BLUEDRAGON ..............................3
3.4 SUPPORT FOR MYSQL..................................................................................................3
3.5 BLUEDRAGON SERVERS ACCOUNT PRIVILEGES..............................................................3
3.6 BUILT-IN WEB SERVER ..................................................................................................3
3.7 WEB SERVER ADAPTERS...............................................................................................4
3.7.1 Multi-homed Web Servers and the CacheRealPath Option.................................4
3.7.2 Microsoft IIS Adapter uses Extension Mappings..................................................5
3.7.3 Restarting Microsoft IIS ........................................................................................5
3.7.4 Apache Support on Red Hat 9..............................................................................6
3.7.5 Apache Configurations in Linux and Mac OS X ...................................................6
3.7.6 Disabling Netscape Enterprise Server/iPlanet Servlet Support............................8
4. RUNNING THE INSTALLER ..........................................................................................9
4.1 INSTALLING ON WINDOWS..............................................................................................9
4.1.1 Resolving Installation Problems on Windows.......................................................9
4.2 INSTALLING ON LINUX ..................................................................................................10
4.2.1 Installing via GUI Versus Console Mode............................................................10
4.2.2 Resolving Installation Problems on Linux...........................................................10
4.2.3 Startup and Shutdown Automation on Linux......................................................11
4.3 INSTALLING ON MAC OS X...........................................................................................11
4.3.1 Resolving Installation Problems on OS X...........................................................12
4.3.2 Startup and Shutdown Automation on OS X ......................................................12
4.4 WHAT WAS INSTALLED ................................................................................................12
4.4.1 How the BlueDragon Server Has Been Installed ...............................................14
5. VERIFYING YOUR INSTALLATION ............................................................................15
5.1 BUILT-IN WEB SERVER ................................................................................................15
5.2 WEB SERVER ADAPTER...............................................................................................15
6. BLUEDRAGON ADMINISTRATION CONSOLE..........................................................17
6.1 ACCESSING THE BLUEDRAGON ADMINISTRATION CONSOLE ..........................................17
6.2 ACCESSING THE ADMINISTRATION CONSOLE REMOTELY ...............................................19
6.2.1 Changing the Default Localhost Limitation for the Built-in Web Server .............19
6.2.2 Enabling SSH Tunneling.....................................................................................20
6.3 DATASOURCE CONFIGURATION....................................................................................21
BlueDragon 6.1 Installation Guide
ii