Slide 1
Installing Multiple Versions
of ColdFusion Together
Daria (Laura Norris)
Philly CFUG
December 10, 2009
cfGothChic.com/blog
twitter.com/cfGothChic
cfGothChic@gmail.com
no notes exist for this slide
Slide 2
Who Am I?
ColdFusion Developer for 13 yrs
Independent consultant for 10 yrs
Currently a Web Developer for the
Free Library of Philadelphia (freelibrary.org)
Passion for Libraries
no notes exist for this slide
Slide 3
Installing Multiple Versions
of ColdFusion Together
Why and How?
Requirements
Things you need to know
Installation Steps
Configuration
Managing your Services
What else you can do
no notes exist for this slide
Slide 4
Why and How?
Why
Try out the new version before committing
Code in different versions for different projects
How
ColdFusion has been built on top of Java since version 6
The multi-server installation separates the Java engine from the ColdFusion server
Consultants
Testing a new version
Preserving a function that needs to be upgraded
Learning server administration
Separating the installations gives you better control
JRun
Slide 5
Requirements
Three things required to run ColdFusion
Web Server (built-in, IIS, Apache)
Java Engine (JRun, Tomcat, any J2EE engine)
ColdFusion Instance (built-in, EAR/WAR file)
EAR - Enterprise Archive
WAR - Web Archive
JAR - Java Archive
CAR - ColdFusion Archive
WAR is inside EAR
Railo
Slide 6
Things you need to know
Install the newest version first
That way you have the most up to date version of the Java engine
Older versions should work on the newest version of Java, but aren't guaranteed
Consult the ColdFusion documentation
documentation can be very confusing
Not recommended for production environments without throughout Functional Testing & Load Testing
Really up to you which you install first
Can be issues with older versions on newer java
There are other ways to do this
Experiment!
ColdFusion and J2EE application servers
Using Multiple Server Instances
Clustering
Windows only
Slide 7
Installation Steps
Install CF9 as Multiserver
no notes exist for this slide
Slide 8
Installation Steps
Only install the services you need
ODBC â MS Access
Applies to all versions you will install
Each version of CF will install own version of these services
Search services can be installed separately
Dedicated server
Slide 9
Installation Steps
CF9 installation:
Multiserver is installed under C:\JRun4
Use the built-in web server.
Enter an RDS password to connect from an IDE (CFBuilder, DW, etc.)
Finish the installation by Launching the Configuration Wizard into the CF Admin
Not the typical CF directory
You can connect the instances to the web server of your choice later.
Web Server Configuration Tool
Very much like a standard CF installation
RDS development use only (CFEclipse)
Wait for initial
Slide 10
Installation Steps
From the CF9 admin, find the Instance Manager
After installation â log into root installation
Root is port 8300
All instances of 1st CF version copied from root instance
Don't touch root unless clustering/common settings
Install Hotfixes b/f creating instances
Only root admin has Enterprise Manager
Click Add New Instance
Slide 11
Installation Steps
Add a new CF9 instance
Enter server name
Check Create Windows Service
Control the CF service from the root admin â root admin must be started first
Uncheck 'Auto Restart service' â just an annoyance
Slide 12
Installation Steps
CF9 is complete!
Working instance
Admin isolation â mimic your client's admin setup
Slide 13
Installation Steps
Install CF8 (and all other versions) as a J2EE EAR
EAR â Enterprise Archive
WAR?
Uncheck the services you don't need
Slide 14
Installation Steps
Enter the context root
Context Root
Let's you use the same domain name for all instances
Context root is tied to this EAR file
Multiple instances will have the same context root
Slide 15
Installation Steps
Select the defaults for the remaining options
Each instance has its own port number
Context root is the /cf8/
Links in html do not know the context root
Slide 16
Installation Steps
CF8 EAR file is created in C:\ColdFusion8
Typically named CF directory, much different inside
EAR encapsulates the CF server
Slide 17
Installation Steps
From the CF9 root admin, Add another Instance
Return to root CF admin (in CF9)
Add another new instance
Server name becomes part of the windows service name
CF8 EAR file
Create Windows Service
Slide 18
Installation Steps
Presto!
Start/Stop CF Services
Access CF Admin for each instance
Slide 19
Configuration
Each instance has its own CF admin
Root: http://localhost:8300/cfide/administrator/
CF9: http://localhost:8301/cfide/administrator/
CF8*: http://localhost:8302/cf8/cfide/administrator/
* Instances created from EAR/WAR files *may* have a context root
no notes exist for this slide
Slide 20
Configuration
Web root directories are located under
c:\JRun4\servers\
{instance name}\
cfusion.ear\cfusion.war
Notice EAR in WAR
/cfusion is root instance
If files missing in instance, copy from root
Slide 21
Configuration
Use the Web Server Configuration Tool* to connect the instances to the web server** of your choice.
(IIS, Apache, etc)
* Read the documentation
** Research your server setup
IIS5 only experience
IIS7 possible problems?
May be different for Apache
RTFM
Disable the embedded web server
Slide 22
Managing your Services
Root services (CF9)
Services for CF Instances
Admin & CFusion work together for the root instance
CFusion required for admin to work
All instance services created through the root administrator will begin with 'Adobe ColdFusion #'
Server name important
JRun EOL?
Slide 23
Managing your Services
Possible Additional Services:
ColdFusion # ODBC Agent (MS Access)
ColdFusion # ODBC Server (MS Access)
ColdFusion # Search Server (Verity)
ColdFusion 9 Solr Service
* Verity & Solr can be installed independently at a later time
http://www.adobe.com/support/coldfusion/downloads.html
,net
LiveCycle
Reporting
Sharepoint
Multiple services for each version of CF
Slide 24
Managing your Services
Set the startup type to 'Manual' for all ColdFusion services
Only start a CF service when you need it
no notes exist for this slide
Slide 25
What else you can do
Connect CFBuilder to the CF instances
Set up RDS sites in Dreamweaver
Install Railo as a CF instance
Create WAR files with server configuration settings for rapid deployment
Upgrade the JVM engine to get the most up to date Java patches
no notes exist for this slide
Slide 26
Links
ColdFusion and J2EE application servers: http://tinyurl.com/ye9jupx
Using Multiple Server Instances: http://tinyurl.com/yf7t3kn
CF9: http://www.adobe.com/cfusion/tdrc/index.cfm?product=coldfusion
CF8: http://www.adobe.com/cfusion/tdrc/index.cfm?product=coldfusion8
CF7: http://www.adobe.com/cfusion/tdrc/index.cfm?product=coldfusion7
Railo: http://www.getrailo.org/index.cfm/download/
no notes exist for this slide
Wow this is great. Favoriting so I remember this - I'm sure it will come in handy in the future as there is always little bits I forget when doing new installs.
Posted By: todd sharp On: 12/10/09 4:10 PM