Install ColdFusion on CentOS


This is a guide for installing ColdFusion 9 on CentOS 6.4. The virtual machine is created with VirtualBox with CentOS installed and running on Windows 7 host with Workgroup networking. The set up and configuration are intended only for a development server and environment. It is assumed that httpd is already installed and properly configured.

Install samba

Install samba and set up a share in CentOS to enable transfer of file from the Windows Explorer to the virtual machine share running CentOS.

# yum install samba samba-client
# useradd <samba-user-name>
# passwd <samba-user-name>

Changing password for user <samba-user-name>
New password: <type-samba-user-name-centos>
Retytp new password:  <retype-pwd-samba-user-name-centos>

On successful change, you will see this message:
passwd: all authentication tokens updated successfully

# smbpasswd -a <samba-user-name>
New SMB password: <type-smb-user-pwd>
Retype new SMB password:  <retype-smb-user-pwd>

On successful change, you will see this message:
Added new user <samba-user-name>.

# nano /etc/samba/smb.conf
workgroup = WORKGROUP
netbios name = <your-chosen-netbios-name>

Control-X and Yes to save the smb.conf file. The above workgroup assumes your Windows host is using Workgroup networking.

Turn off SELinux so you can access the virtual machine share (only for development environment, to simplify things).

# nano /etc/selinux/config
SELINUX=disabled

Control-X and Yes to save the config file

# service nmb start
# service smb start
# chkconfig nmb on
# chkconfig smb on

Note: the virtual machine share on the Windows 7 host will be known as samba-user-name and is mapped to the user’s home directory, ie. /home/<samba-user-name>/ in CentOS.

Install ColdFusion 9

Add host name to the hosts file to prevent a HTTP 500 error when completing the second web based part of the ColdFusion Installation Wizard:

#  nano /etc/hosts

On the first line, add your virtual machine host name to the list

Install the required package and libraries

# yum install libstdc++.so.5 httpd-devel

Create a user for the ColdFusion service

# useradd coldfusion

Download the 64bit Linux .bin file from http://www.adobe.com and save it to the share you created above. Please note you need to sign up to download the ColdFusion installation file. Look for this file: ColdFusion_9_WWEJ_linux64.bin.

Make the downloaded .bin file executable, and run the installation as the root user.

# cd /home/<samba-user-name>/
# chmod +x ./ColdFusion_9_WWEJ_linux64.bin

Kick off the installation wizard

# ./ColdFusion_9_WWEJ_linux64.bin

Accept the licence agreement and make the following choices:

  • Installation choice: 3 (Developer Edition)
  • Installer Configuration: 2 (Enterprise Multiserver Configuration)
  • Existing installation: 2 (No)
  • Subcomponent installation:
    • 3, <enter> to de-select Start ColdFusion on init
    • 4, <enter> to continue with installation
  • Installer Folder: to accept this default path: /opt/jurn4
  • Earlier version of ColdFusion: 2 (No)
  • Runtime User: coldfusion
  • Configure ColdFusion with OpenOffice: 2 (Skip)
  • Administrator password: enter a password and remember it
  • Enable RDS: yes, and enter a password

You are then presented with the installation summary of your selections. Start the installation.

After installation completes, you will see the following message:

 You have successfully completed the first step in installing Adobe ColdFusion 9
 with JRun 4.

 To continue with your installation, go to /opt/jrun4/bin and type “./jrun
 -start cfusion” to start the cfusion server on JRun.

 Once the server is started, log in to the Configuration Wizard at
 http://ip-address-or-host-name:8300/CFIDE/administrator/index.cfm
 Press enter to exit the installer.

Start the cfusion server on JRun

# /opt/jrun4/bin/jrun start cfusion &

Open a web browser in the host, and enter the following in the address:

http://ip-address-or-host-name:8300/CFIDE/administrator/index.cfm

In CF Admin, create a new instance

Instance Manager > Add a New ColdFusion Server

Server Name: <your-server-instance>
Server Directory: /opt/jrun4/servers/

You will see the following messages:

Enterprise Administrator – Creating New CF Instance
   [step 1 of 4] Creating new CF Instance… Done
   [step 2 of 4] Creating the CF runtime, this may take a few minutes…
   [step 3 of 4] Deploying, this may take a few minutes…
   [step 4 of 4] Starting new CF Instance…
   New CF Instance started!

   The HTTP Port for your new server is: :8301

Hook up the new instance to Apache (httpd)

# /opt/jrun4/bin/wsconfig -ws Apache -dir /etc/httpd/conf -server -bin /usr/sbin/httpd -script /usr/sbin/apachectl -coldfusion -ws64 -v

You will see the following messages:

   Wrote file /etc/httpd/conf/httpd.conf
   Added JRun configuration to Apache configuration file /etc/httpd/conf/httpd.conf
   Created file /opt/jrun4/lib/wsconfig/1/README.txt
   Wrote file /opt/jrun4/lib/wsconfig/wsconfig.properties
   Exec’ing /usr/sbin/apachectl restart
   The Apache connector was installed to /etc/httpd/conf

Create a script to start the ColdFusion Server instance on server reboot:

# nano /etc/rc.d/init.d/<your-cf-service-name>

Enter the following text in the new file <your-cf-service-name>:

#!/bin/bash
#
# Startup script for ColdFusion
# chkconfig: 345 90 14
# description: Start/stop ColdFusion as service
#
INSTANCE_NAME=”<your-server-instance>”
# Source function library.
. /etc/rc.d/init.d/functions
#
case “$1” in
start)
echo -n “Starting CF $INSTANCE_NAME: “
/opt/jrun4/bin/jrun -start $INSTANCE_NAME &
echo
;;
stop)
echo -n “Shuting down CF $INSTANCE_NAME: “
/opt/jrun4/bin/jrun -stop $INSTANCE_NAME
echo
;;
restart)
/opt/jrun4/bin/jrun -restart $INSTANCE_NAME &
;;
*)
echo “Usage: $0 {start|stop|restart}”
exit 1
esac
exit 0

Control-X to exit and Yes to save the file.

Make this new file executable and ensure this service starts up on server reboot:

# chmod +x /etc/rc.d/init.d/
# chkconfig –add

If you also want to automatically start up the CF Admin instance, make a copy off the above script and set  INSTANCE_NAME= “cfusion”.

Acknowledgement:

The ColdFusion service start-up script is adapted from Aaron West’s blog on setting up ColdFusion on CentOS.

Congratulations! You have now successfully installed ColdFusion on CentOS.

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s