Getting Started With ColdFusion MX

Something I did at work, felt like sharing it, it may be useful to someone:

Server Requirements: Dedicated or Virtual Dedicated Server running Fedora Core operating system with Plesk and Plesk Pro pack add-on.

Plesk ColdFusion Support — This option, available in the Plesk Pro pack, allows administrators to configure ColdFusion paths and enable/disable ColdFusion support in the Hosting setup. Note that ColdFusion software and license must be installed separately.

If you are using a Virtual Dedicated server with Plesk Pro pack, then the ColdFusionMX software is already installed in the /opt/coldfusionmx/ directory. The free Developer Edition license is already installed, so you can get started, but it limited to 2 client machines. If you wish to use ColdFusion in a fully operable state, you must purchase a license from Macromedia and install on your server.

e recommend that you read the ColdFusion 7 Documentation
http://www.macromedia.com/support/documentation/en/coldfusion/index.html

There is a wealth of information available from Macromedia there, including the topics:

Installing and Using ColdFusion MX
Getting Started Building ColdFusion MX Applications
CFML Reference
Developing ColdFusion MX Applications
Configuring and Administrating ColdFusion MX

This articles purpose is to give you the bare bone necessity to get ColdFusion MX 7 running on your Dedicated or Virtual Dedicated Server. If you are using a Dedicated Server with the Plesk Pro pack, you still must install the ColdFusion MX 7 software.

Step 1, install coldfusionmx software (If you have a Virtual Dedicated Server with Plesk Pro Pack, skip this step, you already have the sofware installed).

Point browser to www.coldfusion.com
Download software (requires creating a Macromedia account)
ColdFusion MX 7 Trial Edition English|Linux|275.75 MB
SCP or FTP the file to your server and move to /usr/local/src
chmod 755 coldfusion-701-lin.bin
./coldfusion-701-lin.bin

Go through the terms and conditions, then answer the question like this:

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT?
(Y/N) : Y

===============================================================================
Install Type
————

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

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

Installation Choice: 2

===============================================================================
Installer Configuration
———————–

What kind of installation do you want?

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

Please select one of the following options: 1

===============================================================================
Is Macromedia ColdFusion MX 7 (Server Configuration) Installed?
—————————————————————

You cannot install the server configuration of Macromedia ColdFusion MX 7 if it is already installed on this computer.

Is there already a server configuration of Macromedia ColdFusion MX 7 installed?

1- Yes
->2- No

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

===============================================================================
Sub-component installation
————————–

The following options are available for installation.

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

[X] 1) Getting Started Experience, Tutorials, & Documentation
[X] 2) ColdFusion MX 7 Search Services
[X] 3) Start ColdFusion on system init

4) Continue with installation

Select an option: 4

===============================================================================
Choose Install Folder
———————

Select the directory in which to install Macromedia ColdFusion MX 7.

Directory:

Default Install Folder: /opt/coldfusionmx7

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

INSTALL FOLDER IS: /opt/coldfusionmx7
IS THIS CORRECT? (Y/N): Y

===============================================================================
Earlier Versions of Macromedia ColdFusion installed?
—————————————————-

If you installed an earlier version of ColdFusion on this computer, you can migrate your settings to Macromedia ColdFusion MX 7.

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

1- Yes
->2- No

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

===============================================================================
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: 1

****************************************************

->1- Apache
2- Sun ONE Web 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, or for SuSe Linux, it could be in
/etc/apache2)

Directory: /etc/httpd/conf

****************************************************

Where is the Apache program binary file? (For example, on Red Hat Linux it
could be /usr/sbin/httpd if you installed from an rpm, or for SuSE Linux it
could be located at /usr/sbin/httpd2) 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, /usr/sbin/apache2ctl on SuSe Linux, or it could
be /usr/local/apache/bin/apachectl on hand-compiled versions.)

File: /etc/rc.d/init.d/httpd

****************************************************

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- 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 7. 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): /var/www/html

===============================================================================
Runtime User
————

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

User Name: (DEFAULT: nobody): apache

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

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

This field is required.

Password:
Confirm Password:

===============================================================================
RDS Password
————

The ColdFusion Remote Development Service (RDS) lets developers using
Macromedia tools remotely connect to this server for development purposes.

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

Enable RDS (required for Report Builder and DW Extensions) (Y/N)
: Y
Password:
Confirm Password:

===============================================================================
Installation Confirmation
————————-

Installation Type:
Server configuration

Licensing:
30-day trial

Installation Directories:
Product: /opt/coldfusionmx7
Web root: /var/www/html

Server Information:
Web Server: Apache (/etc/httpd/conf)
Search Service: installed
Sample Apps: installed
RDS: enabled

Disk Space Information (for Installation Target):
Required: 403,194,052 bytes
Available: 104,610,590,720 bytes

PRESS <ENTER> TO CONTINUE:

===============================================================================
Installing…
————-

[==================|==================|==================|==================]
[——————|——————|——————|——————]

===============================================================================
Installation Complete
———————

You have successfully completed the first step in installing Macromedia
ColdFusion MX 7.

To continue with your installation, go to /opt/coldfusionmx7/bin and type
“./coldfusion start” to start your server.

Once the server is started log in to the Configuration Wizard at
http://[machinename]/CFIDE/administrator/index.cfm

PRESS <ENTER> TO EXIT THE INSTALLER:

Step 2: Fix the httpd.conf file to Alias the CFIDE folder to your ColdFusion enabled sites:

Add this line under ‘Alias /icons/ “/var/www/icons/”’ in your /etc/httpd/conf/httpd.conf file:

Alias /CFIDE/ “/var/www/html/CFIDE/”

Then restart apache:

service httpd stop
sleep 5
service httpd start

Step 3: Enable one of your domains to have ColdFusion support, using the Plesk interface. Also, create a MySQL database and user that is allowed to use this database. Remember the database name, username and password you created, we’ll use it later to add it as a data source in ColdFusion.

Step 4: If you are using Virtual Dedicated, you may not be able to access the Administrator pages, until you reset the Admin password. Step by step instructions on how to reset the ColdFusion MX administrator password.
1. Open the the file neo-security.xml. This is in the lib directory of you ColdFusion MX install, so for /opt/coldfusionmx/lib/neo-security.xml
2. Change the admin.security.enabled variable to false.
Before:
<var name=’admin.security.enabled’>
<boolean value=’true’/>
</var>
After:
<var name=’admin.security.enabled’>
<boolean value=’false’/>
</var>
3. Restart the ColdFusion process: service coldfusion restart
4. Access the administrator page immediately, otherwise you leave your system vulnerable: http://[machinename]/CFIDE/administrator/index.cfm
5. Goto the Security, CF Admin Password section and reset the password, be sure to check the “Use a ColdFusion Administrator password.

Step 5: Create a data source that can be used by ColdFusion users.
1. Access the Adminstrative page at http://[machinename]/CFIDE/administrator/index.cfm and login
2. Under “Data & Services”, choose Data Sources, fill in a name, such as mysql_local in the Data Source Name box, choose MySQL as the driver type and click the Add button:

3. Fill in the database name, server, username and password, a short description if you like and submit:

The MySQL data source can now be used inside of your ColdFusion applications. You want to use a program such as Macromedia Dreamweaver to get the full benefit of ColdFusion.

As mentioned before, there is a wealth of information available from Macromedia on Cold Fusion. We recommend that you read the ColdFusion 7 Documentation

http://www.macromedia.com/support/documentation/en/coldfusion/index.html

Topics include:
Installing and Using ColdFusion MX
Getting Started Building ColdFusion MX Applications
CFML Reference
Developing ColdFusion MX Applications
Configuring and Administrating ColdFusion MX

Dave.

Comments are closed.