Blog

15
May 2014

Gavin Pickin

Multi CFML Engine Install - Installing CF9 on Linux - Centos

CFML Server, Server Admin

Installing CF9 on Linux, as part of the Multi CFML Engine Series, will show you how to install CF 9 on linux, keeping a couple of key pieces in mind, so we can have apache connect to each engine, based on the Virtual Host.

Configuration Conventions

I am using /home/www for all of my Websites, Config, Settings etc, so you'll see that path a lot.
/home/www/_settings will hold downloads settings etc.
You dont have to follow these, but for this documentation, thats how I will do it.

References and Other Guides

I found this guide by Aaron really nice, but i have a few differences, here and there, I'd recommend reading this too. I think Aaron explains it better than I do. Consider my guide, the quick guide… look up his guide for more details.
http://www.aaronwest.net/blog/index.cfm/2011/2/7/Super-Guide-Installing-ColdFusion-9-on-CentOS-Linux

We are doing a single instance install, so it differs somewhat… I'll try and highlight the "differences" as I go, so they're obvious.

Setup ColdFusion User

Create a linux user for Coldfusion Service to run as. We have to do this before we start the installation, so lets add a user now. Name it to match the version, as we'll install CF 10 and CF 11 in future posts.

useradd cfusion9

For security purposes, we want to make sure these accounts are locked down, so we need to disable SSH and FTP login for the Coldfusion User Account.

nano /etc/passwd

Look for the line with cfusion9… should be at the bottom of the file.
Update the line to go from
cfusion9:x:502:503::/home/cfusion9:/bin/bash
to
cfusion9:x:502:503::/home/cfusion9:/sbin/nologin

CTRL-X        -to exit the file
Y                  - to save the file
[ Enter ]        - to save the file with the same name

Downloading the File

Assuming your have 64 bit Centos installed, we'll go ahead and get the 64 bit bin file (linux .bin), and prepare to install now.

Looking at Adobe's website https://www.adobe.com/support/coldfusion/downloads_updates.html#cf9

This is the link we'll use to get the file
http://download.macromedia.com/pub/coldfusion/cf9_installer/ColdFusion_9_WWEJ_linux64.bin

I have a ColdFusion Install Repo, read more on my blog about that, where I keep as many old install files as possible around, so you do not have to worry when Adobe drops them from their site.

i like to keep my files together, so i'm going to make a folder for downloads like this
mkdir /home/www/_setup/downloads
cd /home/www/_setup/downloads
wget http://download.macromedia.com/pub/coldfusion/cf9_installer/ColdFusion_9_WWEJ_linux64.bin

Get a drink while the file downloads.
Aaron shows you how to use scp from his macbook to his server, but this is more universal, since most machines will get wget (if not, yum it )

Dependencies before Installing

Install the required libstdc++/so/5 C++ library.
This is required by cf8 and cf9 for certain features.

Use Yum to install it with this comment
yum install libstdc++.so.5
Press y to confirm.

Installation

Now that we have everything setup, lets install.
Make the bin file executable
chmod +x ColdFusion_9_WWEJ_linux64.bin

Now lets execute it
./ColdFusion_9_WWEJ_linux64.bin


Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

===============================================================================
Adobe ColdFusion 9                               (created with InstallAnywhere)
-------------------------------------------------------------------------------



===============================================================================
Introduction
------------

Welcome to the Installation Wizard for Adobe ColdFusion 9

This wizard installs Adobe ColdFusion 9  on your computer or produces an EAR or
WAR file for deployment on your J2EE application server.  Adobe recommends that
you exit from all running applications before proceeding.

Respond to each prompt to proceed to the next step in the installation.  If you
want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.


WARNING: This program is protected by copyright laws and international
treaties.


PRESS <ENTER> TO CONTINUE:

Press [ Enter ] several times to get through the license agreement.
After you've broken your finger from smashing the keyboard [ Enter ] key, you'll get to the end of it.

Press Y then [ Enter ] to accept the agreement (Rocket Science I know)



===============================================================================
Install Type
------------

If you do not have a serial number, select either 30-day trial or Developer
Edition.

  ->1- Install new version of Adobe ColdFusion 9 with a serial number
    2- 30-day trial
    3- Developer Edition

Installation Choice:

Press 2  [ Enter ] - 30 day trial. You can key in your license number in the CF Admin later.



===============================================================================
Installer Configuration
-----------------------

What kind of installation do you want?

  ->1- Server configuration
    2- Enterprise Multiserver configuration
    3- J2EE configuration (EAR file)
    4- J2EE configuration (WAR file)

Choose one of the following options::

Press 1  [ Enter ] - This setup is a single server setup. You can follow Aarons guide more closely if you want an Enterprise Multiserver Config, but we're doing a single instance here... makes it easier to follow my guides if you do the same.



===============================================================================
Is Adobe ColdFusion 9 (Server Configuration) Installed?
-------------------------------------------------------

You cannot install the server configuration of Adobe ColdFusion 9 if it is already installed on this computer.

Is there already a server configuration of Adobe ColdFusion 9 installed?

    1- Yes
  ->2- No

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

Press 2  [ Enter ] - We have no other copies, we assume you don't either.



===============================================================================
Subcomponent Installation
-------------------------

The following options are available for installation.

An option marked with "[X]" in front will be installed and an option with "[ ]"
will not.  Choosing an option will toggle it on or off

[X] 1) ColdFusion 9 Documentation
[X] 2) ColdFusion 9 Solr Services
[X] 3) Start ColdFusion on system init

    4) Continue with installation


Select the subcomponents to install:

We are going to turn off Documentation, at this time… but we will leave Solr and Start CF on system init.
So we press 1 [ Enter ] and it reloads and we press 3 [ Enter ] and it reloads again until we're happy with the options.


 

===============================================================================
Subcomponent Installation

[ ] 1) ColdFusion 9 Documentation
[X] 2) ColdFusion 9 Solr Services
[X] 3) Start ColdFusion on system init

    4) Continue with installation


Select the subcomponents to install:

We press 4  [ Enter ] to proceed with install



===============================================================================
Choose Install Folder
---------------------

Select the directory where you want to install Adobe ColdFusion 9.

Directory:

  Default Install Folder: /opt/coldfusion9

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      :

You can choose your install folder here, we're going with the default.
[ Enter ] to proceed.


===============================================================================
Earlier Versions of Adobe ColdFusion installed?
-----------------------------------------------

If you installed an earlier version of ColdFusion on this computer, you can migrate your settings to Adobe ColdFusion 9.

Is there an earlier version of ColdFusion installed on this computer (for example, ColdFusion 6 or ColdFusion MX 7)?

    1- Yes
  ->2- No

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

We assume this is a clean install, so we press 2 [ Enter ]


===============================================================================
Configure Web Servers
---------------------

Please configure your web server(s).  If you do not configure a web server the
built-in web server will be used on port 8500 or the next available port.

    1- Add Web Server Configuration
  ->2- Continue with installation

Choice:

We are going to configure later, as we have to modify the configuration script… so press
2 [ Enter ]


===============================================================================
Runtime User
------------

Enter the name of the runtime user.   This user must already exist on the system.

User Name: (DEFAULT: nobody):

This is where you enter the cold fusion user you setup earlier.
In our case, the user was cfusion9
So type in
cfusion9        [ Enter ]


===============================================================================
Configure ColdFusion with OpenOffice
------------------------------------

Configuring OpenOffice installation with ColdFusion will enable Office documents to be processing using OpenOffice. If OpenOffice is not configured ColdFusion will not be able to convert some Microsoft Office Documents to PDF. Check the documentation for more details.

    1- Configure ColdFusion with local Openoffice installation
  ->2- Skip

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

We do not want OpenOffice, but its up to you if you want it, so I will press 2  [ Enter ]


===============================================================================
Administrator Password
----------------------

Enter the password that you will use to restrict access to the ColdFusion
Administrator.

This field is required.

Password:    

Enter your choice for your Admin Password
IAmNotThatEasy      [ Enter ]
Confirm the password and proceed


===============================================================================
Enable RDS
----------

The ColdFusion Remote Development Service (RDS) lets developers using Adobe
tools remotely connect to this server for development purposes. RDS is required
for Line Debugging, Report Builder, and Dreamweaver Extensions.

If this is a production server, Adobe recommends that you disable RDS.
Note, however, that disabling RDS also disables debugging, the directory
browsing applets in the ColdFusion Administrator and some of the functionality
in the Report Builder.

Enable RDS  (Y/N):

This is your choice… but usually it is recommended to turn off RDS… for security reasons.
If you say yes, it will ask you for a password.

N        [ Enter ]


===============================================================================
Pre-installation Summary
------------------------


Installation Type:
  Server configuration

Licensing:
  30-day trial

Installation Directories:
  Product: /opt/coldfusion9
  Web root: /opt/coldfusion9/wwwroot

Server Information:
  Web Server: Built-in web server
  Port: 8500
  ColdFusion Solr Search Services: installed
  Documentation: not installed
  RDS: disabled

Disk Space Information (for Installation Target):
  Required: 590,261,953 bytes
  Available: 48,155,537,408 bytes

PRESS <ENTER> TO CONTINUE:
Press [ Enter ] to continue, or if its wrong, I believe you can type quit [ Enter ] or press CTRL C to cancel it. You will have to start again with the installation, there is no way to change a setting.
Now, it will install.
You can see pretty console progress bars, and everything is good in the world :)


===============================================================================
Installation Complete
---------------------

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

To continue with your installation, go to /opt/coldfusion9/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

Press Enter to exit the installer:
Press [ Enter ] to exit.


Start the server.
cd /opt/coldfusion9/bin
./coldfusion start

if your server has a firewall, unblock port 8500, and then view the cf admin at http://[machinename]:8500/CFIDE/administrator/index.cfm

Sometimes, it takes a while for the first request.
You might get a 500 There is no web application configured to service your request.

Try again shortly.
Login with the CF Admin password you made.
After a couple of minutes, you'll see the Admin Interface come up, and we're installed.

Next, we want to update CF.
We are using 9.0.2, the latest major update (Aarons article only refers to 9.0.0 and 9.0.1 )
It helps you maintain security updates, and is  Unofficial Updater 2… http://www.uu-2.info/
Scott Stroz (from cfhour ) swears by it… although he swears by and about a lot of things :) Check out cfhour.com - quality show - if you can get past the self indulgent dribble (running joke).

ColdFusion on Startup

You can write your own startup script, the CF one isn't bad, but if you want to write your own, you can follow this.

Next we'll set it up so cold fusion starts on boot
Since we're doing a single install, not multi like Aarons article, this is different.
These are the 3 commands that you can use with your cold fusion setup now, lets make them into a service.
/opt/coldfusion9/bin/coldfusion start
/opt/coldfusion9/bin/coldfusion stop
/opt/coldfusion9/bin/coldfusion restart
# Navigate to the /etc/rc.d/init.d directory
cd /etc/rc.d/init.d

# Create a new file that functions as the service.
# Use cfusion9 where that will be the name of your service.
nano cfusion9
# ---------------- start of file below this line
#!/bin/bash
#
# Startup script for ColdFusion
# chkconfig: 345 90 14
# description: Start/stop ColdFusion as service
#
#INSTANCE_NAME="your_instance_name"
# Source function library.
. /etc/rc.d/init.d/functions
#
case "$1" in
start)
echo -n "Starting CFUSION9: "
/opt/coldfusion9/bin/coldfusion start &
echo
;;
stop)
echo -n "Shutting down CFUSION9: "
/opt/coldfusion9/bin/coldfusion stop
echo
;;
restart)
echo -n "Restarting CFUSION9"
/opt/coldfusion9/bin/coldfusion restart &
;;
*)
echo "Usage: $0 {start|stop|restart}"
exit 1
esac
exit 0
# ---------------- end of file above this line

Update the paths where necessary if you chose to install cold fusion in another location.
Close and save the file
CTRL X
y [ Enter ]

Make it executable
chmod +x cfusion9

add the script as a service
chkconfig --add cfusion9

reboot the machine, and test to see if it is working.
Reboot

when it boots back up, you can type
service cfusion9 status
since we did not create a status command, it just shows you how to use it… and lets you know you can use start, stop, or restart.
You can edit the echoes to make them more readable

What's Next?

We still need to configure apache, so we can use coldfusion9 for the vhosts we want it to run.
We'll do that in a future article, along with the other engines, and show you how to setup apache to use different engines for different websites.

Blog Search