Cold Fusion RHE Installation Procedure

1. Make sure apache and the firewall is turned off.
2. As most new linux installs mount /tmp as noexec for security reasons, issue the commands:
   ssh: mkdir /opt/iatempdir
   ssh: export IATEMPDIR=/opt/iatempdir
   
3. Make sure apache APXS is installed and enabled.
   • $ httpd -l (mod_so should be in the list)
   • run: up2date httpd-devel
   • run: up2date httpd
4. Use an FTP client such as Fillezilla to login to the new server: Servername: IP address of new server
   Userid: admin
   Password: (insert admin password)
   
   
   You will be in the default /admin/server.
   
5. Next Upload the Linux CF server application from the installation CD: coldfusion-61-lin.bin
6. Login to the server with a SSH like putty.ext Login as Admin to the ssh prompt
   means press the enter key
   Next type: su -
   this will prompt you for a password: retype the admin password, this will switch you the Super User (root) account. Dont forget the minus sign after su -
   
   This will get you to root prompt:
   [root@plain ~]##
   
7. Before you install CF you must STOP Apache and the Firewall or the config file will not isntall properly! - really CF should be installed before firewall is activated
   At the ssh prompt:
   [root@plain ~]## /etc/rc.d/init.d/httpd stop
   Stopping httpd:
   [ OK ]
   [root@plain src]# /etc/rc.d/init.d/apf stop
   Stopping APF: [ OK ]
   
   NOTE: If APF is already installed you may have a problem creating a connector - we had to reimage the server and install CF before APF was installed.
   
8. Open up access permissions to the installer:
   at the prompt:
   [root@plain ~]## chmod 777 /home/admin/coldfusion-61-lin.bin
   
9. Enable tmp directory for RHE type each line and enter afterwards:
   As most new linux installs mount /tmp as noexec for security reasons, issue the commands:
   mkdir /opt/iatempdir
   export IATEMPDIR=/opt/iatempdir
   
   
10. Now you are ready to run the installer, just type the location opf the file at the prompt, you can type the forst few letters of coldfusion and hit tab to auto fill in the file name:
    Type:
    /home/admin/cold Returns:
    [root@plain ~]## /home/admin/coldfusion-61-lin.bin
    Hit Enter to start installation
    [root@plain ~]## /home/admin/coldfusion-61-lin.bin
    
    

    Preparing CONSOLE Mode Installation...
    ===============================================================================
    Choose Locale...
    ----------------
    ->1- English
    CHOOSE LOCALE BY NUMBER: 1
    ### Next you will be prompted to hit enter about 20 times to read through the license  X20
    DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT?
    (Y/N) : y
    ===============================================================================
    Pre-Installation Check
    ----------------------
    The installer has found the following errors/warnings:
    Warning: C++ compatibility pack
    The installer was unable to determine if the C++ compatibility pack is
    installed by running the following command: rpm --query compat-libstdc++
    If this machine uses a version of glibc that is 2.2.5.x or higher the
    compatibility pack is necessary for C++ custom tags, Verity, and web server
    connectors to work properly.
    For more information see the installation manual at
    http://www.macromedia.com/go/livedocs_cfmx61docs
    PRESS  TO CONTINUE WITH THE INSTALLER:
    ===============================================================================
    Existing Macromedia ColdFusion MX Installation?
    -----------------------------------------------
    You cannot install a new installation of Macromedia ColdFusion MX 6.1 if you
    have an existing version of Macromedia ColdFusion MX installed on this
    computer.
    If you do have a previous version installed, the installer can update your
    current current installation to Macromedia ColdFusion MX 6.1.
    Is there already a version of Macromedia ColdFusion MX installed on this
    computer? (Y/N): n
    ===============================================================================
    Install Type
    ------------
    Choose the type of Macromedia ColdFusion MX installation you want to perform:
    ->1- Install new version of ColdFusion MX
    2- 30-day trial (Enterprise Edition)
    3- Developer Edition (Single-IP Only)
    Installation Choice: 1
    Serial Number: Cxxxx-xxxxx-xxxx-xxxx
    ===============================================================================
    Choose Install Folder
    ---------------------
    Select the directory in which to install Macromedia ColdFusion MX.
    Directory:
    Default Install Folder: /opt/coldfusionmx
    ENTER AN ABSOLUTE PATH, OR PRESS  TO ACCEPT THE DEFAULT
    :
    ===============================================================================
    Existing ColdFusion 4.5 or 5 Installation?
    ------------------------------------------
    The installer can migrate your settings from ColdFusion 4.5 or 5 if you have an
    installation on this computer.
    Is there a version of ColdFusion 4.5 or 5 installed on this computer? (Y/N)
    : n
    ===============================================================================
    Configure Web Servers
    ---------------------
    Please configure your webserver(s). If you do not configure a webserver the
    built-in webserver will be used on port 8500.
    1- Add Web Server Configuration
    ->2- Continue with installation
    Choice: 1
    ****************************************************
    ->1- Apache
    2- Netscape Enterprise Server/iPlanet
    3- Cancel
    What kind of Web Server are you configuring: 1
    What directory contains your Apache configuration file (httpd.conf)? (For
    example, on Red Hat Linux it could be located in the /etc/httpd/conf
    directory if you installed from an rpm.)
    Directory: /etc/httpd/conf
    ****************************************************
    Where is the Apache program binary file? (For example, on Red Hat Linux it
    could be located in the /usr/sbin/httpd directory if you installed from an
    rpm.) If you have more than one instance of Apache on your computer, enter
    the binary file location for the Apache web server that will use ColdFusion
    MX. (Note: this is not the Apache start and stop script.)
    File: /usr/sbin/httpd
    ****************************************************
    Where is the control file that you use to start and stop the Apache web
    server? (For example, this could be /etc/init.d/httpd on Red Hat Linux if
    you installed from an rpm and it could be /usr/local/apache/bin/apachectl on
    hand-compiled versions.)
    File: /etc/init.d/httpd
    ****************************************************
    Please configure your webserver(s). If you do not configure a webserver the
    built-in webserver will be used on port 8500.
    1- Add Web Server Configuration
    2- Remove Web Server Configuration
    3- Edit:Apache : /etc/httpd/conf
    ->4- Continue with installation
    Choice: 4
    ===============================================================================
    Choose ColdFusion MX Administrator Location
    -------------------------------------------
    Select the location of the web root for Macromedia ColdFusion MX. This is where the installer places the ColdFusion MX Administrator.
    This directory must be the web root for one of the websites to be configured for use with ColdFusion MX.
    Directory: (DEFAULT: /var/www/html):
    ===============================================================================
    Runtime User
    ------------
    Enter the name of the runtime user. This user must exist already on the system.
    User Name: (DEFAULT: nobody): admin
    ===============================================================================
    Init System
    -----------
    Would you like ColdFusion MX to start at System Boot? Please note, this is only
    supported on Solaris and Red Hat Linux. If you answer no to this, you can add
    ColdFusion MX to system boot post install by running
    /opt/coldfusionmx/bin/cfmx-init.sh
    Answer (Y/N): y
    ===============================================================================
    Administrator Password
    ----------------------
    Enter the password you will use to control access to the ColdFusion MX
    Administrator.
    This field is required.
    Password: xxxxxxxx
    Confirm Password: xxxxxxxxxx
    ===============================================================================
    Installation Confirmation
    -------------------------
    Installation Type:
    Server configuration
    Licensing:
    Fully Licensed Edition
    Serial Number: xxxxx-xxxx-xxxxxxxxxxxxx
    Install Directories:
    Product: /opt/coldfusionmx
    Web root: /var/www/html
    Server Information:
    Web Server: Apache (/etc/httpd/conf)
    Disk Space Information (for Installation Target):
    Required: 433,293,879 bytes
    Available: 69,982,748,672 bytes
    PRESS  TO CONTINUE:
    Installing …..
    Once installed run the installer again!
    This will update the server to the updater 3 for CF 6.1
    This time the beginning is the same nut there is one different choice
    Go through the license again until youget to:
    ===============================================================================
    Install Type
    ------------
    Choose the type of Macromedia ColdFusion MX installation you want to perform:
    ->1- Update ColdFusion MX to ColdFusion MX 6.1
    2- Install new version of ColdFusion MX
    3- 30-day trial (Enterprise Edition)
    4- Developer Edition (Single-IP Only)
    Installation Choice:1
    ===============================================================================
    Install Configuration
    ---------------------
    What kind of installation do you want?
    ->1- Server configuration
    2- J2EE configuration (EAR file)
    3- J2EE configuration (WAR file)
    Please choose one of the following options:1
    ===============================================================================
    Important Information
    ---------------------
    IMPORTANT:
    Please ensure that all ColdFusion MX services and associated web server
    services have been stopped. Services that are still running will prevent the
    upgrade from completing.
    Due to compiler enhancements, previously compiled code is not compatible with
    ColdFusion MX (Red Sky). The installer will back up the existing
    {cf_webroot}/WEB-INF/cfclasses directory to cfclasses_backup.
    PRESS  TO CONTINUE:
    ===============================================================================
    Specify Location of ColdFusion MX
    ----------------------------------
    Select the root directory of the current ColdFusion MX installation (typically,
    this is /opt/coldfusionmx).
    Where is ColdFusion MX currently installed?
    Default Install Folder: /opt/coldfusionmx
    ENTER AN ABSOLUTE PATH, OR PRESS  TO ACCEPT THE DEFAULT
    :
    ===============================================================================
    Specify Location of CFIDE
    -------------------------
    Select the location of the CFIDE directory for your current ColdFusion MX installation. This directory is typically in the root directory of the active web server and contains the ColdFusion administrator application.
    Where is the CFIDE directory located? (DEFAULT:
    /opt/coldfusionmx/wwwroot/CFIDE): /var/www/html
    ===============================================================================
    Runtime User
    ------------
    Enter the name of the runtime user that Macromedia ColdFusion MX has been configured to use.
    User Name: (DEFAULT: nobody): admin
    ===============================================================================
    Installation Confirmation
    -------------------------
    Installation Type:
    Server configuration (Update from 6.0 to 6.1)
    Install Directories:
    Product: /opt/coldfusionmx
    CFIDE root: /var/www/html/CFIDE
    Disk Space Information (for Installation Target):
    Required: 433,293,879 bytes
    Available: 69,807,697,920 bytes
    Installing…..
    ===============================================================================
    Installation Complete
    ---------------------
    You have successfully completed the first step in installing Macromedia
    ColdFusion MX.
    To continue with your installation, go to /opt/coldfusionmx/bin and type
    "./coldfusion start" to start your server.
    Once the server is started log in to the Configuration Wizard at
    http://[machinename]:8500/CFIDE/administrator/index.cfm
    

11. Now - once again make sure httpd is stopped!
    /etc/rc.d/init.d/httpd stop
    Now run cold fusion to create the apache connector
    /etc/rc.d/init.d/coldfusionmx start
    If you do not get the connector created you will get a screen like this:
    
    [root@plain ~]## /etc/rc.d/init.d/coldfusionmx start

    Starting ColdFusion MX...
    There may be a few moments before you can access the ColdFusion MX administrator. This is normal.
    ======================================================================
    Running the ColdFusion MX connector wizard
    ======================================================================
    Running the connector installer (Launched on the first run of the ColdFusion MX server start script)
    Running apache connector wizard...
    ColdFusion MX server not started, will retry connector 12 more time(s)
    ColdFusion MX server not started, will retry connector 11 more time(s)
    ColdFusion MX server not started, will retry connector 10 more time(s)
    ColdFusion MX server not started, will retry connector 9 more time(s)
    ColdFusion MX server not started, will retry connector 8 more time(s)
    ColdFusion MX server not started, will retry connector 7 more time(s)
    ColdFusion MX server not started, will retry connector 6 more time(s)
    ColdFusion MX server not started, will retry connector 5 more time(s)
    ColdFusion MX server not started, will retry connector 4 more time(s)
    ColdFusion MX server not started, will retry connector 3 more time(s)
    ColdFusion MX server not started, will retry connector 2 more time(s)
    ColdFusion MX server not started, will retry connector 1 more time(s)
    The connector wizard has not been able to contact the local ColdFusion MX server, connector installation aborted.
    ======================================================================
    ColdFusion MX has been started.
    ColdFusion MX will write logs to /opt/coldfusionmx/logs/cfserver.log
    ======================================================================
    [root@plain ~]##
    

    
    So you need to stop CF
    [root@plain ~]## /etc/rc.d/init.d/coldfusionmx stop
    This might take a few minutes, in the mean time you can login to another ssh window (or just wait) and so this:
    
12. Check to see if CF made the connector dir
    [root@plain ~]## dir /opt/coldfusionmx/runtime/lib/wsconfig/
    wsconfig.log
    
    
13. It didn't so we make it and give it open permissions:
    [root@plain ~]## mkdir /opt/coldfusionmx/runtime/lib/wsconfig/1
    [root@plain ~]## chmod 777 /opt/coldfusionmx/runtime/lib/wsconfig/
    
14. Now we try again once CF is stopped:
    [root@plain ~]## /etc/rc.d/init.d/coldfusionmx stop
    

    Stopping ColdFusion MX, please wait
    Stopping default server..........................................................................................................................................................................................................................................................................................................................................................................................could not stop server, either it's not running, you don't have permission to stop the server or it needs to be killed manually
    The ColdFusion MX server seems to be hanging, will stop non-gracefully
    ColdFusion MX has been stopped
    

15. With RHE4 You will have to manually create a new apache connector if CF cannot create it
16. Refer to creating an apache connector document