Installing ColdFusion MX 7 on UNIX Last updated: December 7, 2004 ============================================================ ColdFusion MX 7 Overview These instructions are for UNIX console-mode users who are installing ColdFusion MX 7 but have no access to installation instructions in print, PDF, or HTML format. We recommend that you use these instructions as a last resort and start by attempting to access PDF or HTML documentation, as follows: * PDF - If you have access to a workstation that can read PDF files, use the Installing.pdf file (from the Documentation directory on the CD) to guide you through the install process. * HTML - If you have access to a web browser, use LiveDocs: http://www.macromedia.com/go/livedocs_cfmx7docs or the ColdFusion MX Documentation page: http://www.macromedia.com/support/coldfusion/documentation.html Note: The ColdFusion MX 7 installation contains two steps (the installation wizard and the configuration wizard). The configuration wizard requires access to a web browser, so if you are responsible for the complete installation, you must be able to access your installation computer through a web browser. ============================================================ System Requirements Red Hat Linux AS 2.1, 3.0 Install the latest patches (including the kernel) from ftp://ftp.redhat.com/pub The Linux install must have the corresponding RedHat libc compatibility libraries, as follows: RH Enterprise 3.0 for i386 compat-libstdc++-7.3-2.96.123.i386.rpm compat-glibc-7.x.rpm (if using Apache or Apache2) RH Enterprise 2.1 for i386 compat-libstdc++-6.2-2.9.0.16.i386.rpm Users must have 6.2-2.* or later for RedHat Enterprise 2.1 or 7.3-2.* for RedHat Enterprise 3.0. SuSE Linux Enterprise Server 8 Install the latest patches (including the kernel) from ftp://ftp.suse.com/pub TurboLinux 8 Server (Japanese only) Install the latest patches (including the kernel). Verity does not support TurboLinux 8 server. Solaris 8, 9 Macintosh OS X 10.3 (Developer Edition only) J2EE configuration only, no Verity support CPU Linux - Pentium (Pentium III recommended) Solaris - SPARC Hard drive space 500 MB RAM 512 MB Web servers Apache 1.3.27 or higher Apache 2.4.43 or higher IPlanet 6.x Sun ONE 6.x JRun HTTP Server (not for production use) ColdFusion MX built-in web server (not for production use) ============================================================ These instructions provide information that helps you: * Choose the correct installation program * Choose the correct configuration * Make the appropriate web server specifications * Select the appropriate installation options INSTALLATION SCENARIOS The ColdFusion MX 7 installation process supports the following scenarios: * New installation - Install ColdFusion MX 7 on a computer with no previous ColdFusion installation. * Upgrade installation - You can upgrade from ColdFusion 4.5, ColdFusion 5, ColdFusion MX, or ColdFusion MX 6.1. The configuration wizard migrates your previous settings to ColdFusion MX 7. Note: There is not an in-place upgrade for ColdFusion MX 7. ColdFusion MX 7 can co-exist with either ColdFusion 4.5/5 or ColdFusion MX/ColdFusion MX 6.1. However, you can configure a web server for one installation only. CONFIGURATION OPTIONS You can install ColdFusion MX 7 in the following configurations: * Server configuration - Lets you install one instance of ColdFusion MX with an embedded J2EE server. This version contains an embedded copy of JRun and is most similar to previous ColdFusion versions. * Multiserver configuration (Enterprise and Developer Editions only) - Installs JRun and automatically deploys ColdFusion MX 7 in a separate JRun server instance. This configuration supports server instance creation and ColdFusion deployment in the ColdFusion MX Administrator and lets you manage ColdFusion MX 7 deployments on multiple JRun servers. * J2EE configuration (Enterprise and Developer Editions only) - Lets you deploy ColdFusion MX as a Java application running on a Java 2 Enterprise Edition (J2EE) application server. When installing this configuration install an EAR file or WAR files, which you then must deploy on an existing J2EE application server, such as IBM WebSphere, Sun ONE Application Server, or BEA WebLogic. EXTERNAL WEB SERVERS In most cases, you will configure ColdFusion MX 7 to run through an external web server, such as Apache or iPlanet. The product also includes a built-in web server that runs on port 8500 (server configuration) or 8300 (multiserver configuration), but it is not appropriate for production use. You must know your computer's web server configuration information before runing the installation wizard. If you are currently using an existing version of ColdFusion MX or ColdFusion MX 6.1 with the built-in web server, the installation wizard installs the built-in web server on an unused port (typically 8501). INSTALLATION CHECKLIST All installation types Platform-specific installer name? * coldfusion-70-lin.bin * coldfusion-70-sol.bin * coldfusion-70-other.jar (J2EE configuration only) New installation or update? New install | Existing ColdFusion or ColdFusion MX Location of new ColdFusion default is /opt/coldfusionmx7 MX directory? Will you configure an external web Yes | No server (recommend Yes)? (Apache and iPlanet) Configuration _________________________________________ directory? (Apache) Path to server binary? _________________________________________ Location of your web root directory? _________________________________________ ColdFusion MX Administrator _________________________________________ password? Remote Development Services (RDS) _________________________________________ password? Runtime user - Default is nobody. _________________________________________ For security reasons, it is crucial that you do not use root for the runtime user. Start at system startup (Solaris Yes | No and RedHat Linux only) Upgrade from ColdFusion 4.5 or ColdFusion 5 Co-exist or upgrade? Co-exist | Upgrade Location of existing ColdFusion 4.5 _________________________________________ or 5 directory If using built-in web server, what _________________________________________ port number does the installer configure? ============================================================ Running the installation wizard To run the installation wizard, perform the following steps: 1. Read the online version of the ColdFusion MX Release Notes at http://www.macromedia.com/go/cfmx7_releasenotes for late-breaking changes. 2. If you plan to configure an external web server, ensure that the web server is running. 3. (ColdFusion 4.5 or 5 upgrade install only) Shut down the ColdFusion server. 4. Log in as root. 5. Copy the installation file that is appropriate for your platform from the CD or Macromedia website, and save it to a directory on your local disk. The installation files for supported server configuration platforms are as follows: * coldfusion-70-lin.bin * coldfusion-70-sol.bin * coldfusion-70-other.jar (J2EE configuration on platform other than Linux or Solaris) 6. Go to the directory with the installation file. 7. Start the installation with the following command: ./coldfusion-70-***.bin To use coldfusion-70-other.jar to install on a platform other than Solaris or Linux, enter the following command: java_home/bin/java -jar coldfusion-70-other.jar -i console 8. Follow the on-screen instructions. Note: The installer displays a status bar at the end of the installation that stops for a while. This is expected behavior; the installer has not hung. Please be patient and let the installer run to completion. 9. (J2EE configuration) Deploy the EAR or WAR file using your application-server specific deployment method. For more information, see http://www.macromedia.com/go/cfmxj2ee-cert. 10. After the installation finishes, you must start ColdFusion MX to finish the product configuration. To do so, run the following command: /cf_root/bin/coldfusion start In the server configuration, starting ColdFusion MX 7 for the first time runs a script that executes the Web Server Configuration Tool to configure ColdFusion for use with your external web server. In the multiserver configuration, you run this script file (jrun_root/bin/cfmx-connectors.sh) after starting the cfusion JRun server and after starting your web server. You do not perform this step if you are deploying ColdFusion MX in the J2EE configuration on a server other than JRun. IMPORTANT: After starting ColdFusion MX, you complete the install process by opening the ColdFusion MX Administrator in a web browser, which runs the configuration wizard the first time you open it. 11. Respond to the prompts displayed by the configuration wizard. Completion of the configuration wizard and display of the ColdFusion MX Administrator or Getting Started Experience indicates a successful install of ColdFusion MX.