Installation guide

Contents
1. INTRODUCTION.............................................................................................................1
1.1 ABOUT THIS MANUAL ....................................................................................................1
1.2 TECHNICAL SUPPORT ....................................................................................................1
1.2.1 Additional Information in FAQs.............................................................................2
1.3 OTHER DOCUMENTATION...............................................................................................2
2. BLUEDRAGON PRODUCT CONFIGURATIONS..........................................................3
2.1 BLUEDRAGON SERVER AND SERVER JX.........................................................................3
2.2 BLUEDRAGON/J2EE .....................................................................................................3
2.3 BLUEDRAGON FOR THE MICROSOFT .NET FRAMEWORK .................................................4
2.4 REFERENCES TO PRODUCT NAMES IN THIS DOCUMENT ..................................................4
2.5 TRIAL EDITIONS AND LICENSING.....................................................................................4
3. PREPARING FOR INSTALLATION...............................................................................5
3.1 SYSTEM REQUIREMENTS ...............................................................................................5
3.1.1 JDK Requirements................................................................................................6
3.2 RUNNING ALONGSIDE COLDFUSION AND SERVLET/JSP ENGINES....................................6
3.3 UPGRADING AND INSTALLING MULTIPLE VERSIONS OF BLUEDRAGON ..............................7
3.4 SUPPORT FOR MYSQL..................................................................................................7
3.5 BLUEDRAGON SERVERS ACCOUNT PRIVILEGES..............................................................8
3.6 BUILT-IN WEB SERVER ..................................................................................................8
3.7 WEB SERVER ADAPTERS...............................................................................................8
3.7.1 General Web Server Adapter Issues....................................................................8
3.7.2 IIS Web Server Adapter Issues ............................................................................9
3.7.3 Apache Web Server Issues................................................................................12
3.7.4 iPlanet Web Server Issues .................................................................................14
3.8 LINUX INSTALLATION CONCERNS..................................................................................14
3.8.1 Graphics Rendering Operations on a Headless Linux System..........................14
3.8.2 Running as a Non-root User on Linux-based Systems .....................................15
3.8.3 C++ CFX Tags on Linux .....................................................................................15
4. RUNNING THE INSTALLER ........................................................................................16
4.1 INSTALLING ON WINDOWS............................................................................................16
4.1.1 Resolving Installation Problems on Windows.....................................................16
4.2 INSTALLING ON LINUX ..................................................................................................17
4.2.1 Installing via GUI Versus Console Mode............................................................17
4.2.2 Resolving Installation Problems on Linux...........................................................17
4.2.3 Startup and Shutdown Automation on Linux......................................................17
4.3 INSTALLING ON MAC OS X...........................................................................................18
4.3.1 Resolving Installation Problems on OS X...........................................................19
4.3.2 Startup and Shutdown Automation on OS X ......................................................19
4.4 WHAT WAS INSTALLED ................................................................................................19
4.4.1 How the BlueDragon Server Has Been Installed ...............................................21
5. VERIFYING YOUR INSTALLATION ............................................................................22
5.1 BUILT-IN WEB SERVER ................................................................................................22
5.2 WEB SERVER ADAPTER...............................................................................................22
6. BLUEDRAGON ADMINISTRATION CONSOLE..........................................................24
6.1 ACCESSING THE BLUEDRAGON ADMINISTRATION CONSOLE ..........................................24
6.2 ACCESSING THE ADMINISTRATION CONSOLE REMOTELY ...............................................26
6.2.1 Changing the Default Localhost Limitation for the Built-in Web Server .............26
BlueDragon 6.2.1 Server and Server JX Installation Guide
ii