User guide

15
INSTALLING COLDFUSION 9
Installing the Multiserver Configuration
Last updated 1/20/2012
10 When the installation completes successfully, start the JRun cfusion server:
jrun_root/bin/jrun -start cfusion
11 If you specified external web server settings when you ran the installation wizard, run the jrun_root/bin/cfmx-
connectors.sh shell script. The script runs the Web Server Configuration Tool, which configures the web server for
use with ColdFusion. The web server should also be running.
If there are problems running this script, review the configuration and bin directory specifications, modify as
necessary, and rerun the script. You can also configure your web server using the scripts in
jrun_root/bin/connectors, or through java -jar jrun_root/lib/wsconfig.jar, as appropriate.
Note: This step is important, because if you specified the use of an external web server when you ran the installation
wizard, the CFIDE and cfdocs directories are placed under that web server’s root directory, and you must successfully
configure the web server before you open the ColdFusion Administrator.
12 Open ColdFusion Administrator to run the configuration wizard.
13 Configure and manage your system, as described in “Configuring Your System” on page 58.
14 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the
Resources page of the ColdFusion Administrator.
15 Code ColdFusion CFM pages.
If you configured an external web server, store CFM pages under your web root directory. If you are using the built-
in web server, store CFM pages under the web application root (jrun_root/servers/cfusion/cfusion-ear/cfusion-
war) and access these pages using a URL of the form http://hostname:8300/context-root/filename.cfm, as follows:
• hostname The machine name, IP address, or localhost.
• contextroot The context root for the ColdFusion web application. For more information, see “Context root”
on page 19.
• filename The directory path and file to display. The path is relative to the cfusion-war directory.
For example, to display a CFM file located at /opt/jrun4/servers/cfusion/cfusion-ear/cfusion-
war/eisapp/index.cfm using the built-in JRun web server and a context root of cfmx, you specify the URL as
http://localhost:8300/cfmx/eisapp/index.cfm.
Configuration
In addition to enabling sandbox security in the ColdFusion Administrator, the application server must be running a
security manager (
java.lang.SecurityManager) and you must define the following JVM arguments:
-Djava.security.manager
-Djava.security.policy="cf_webapp_root/WEB-INF/cfusion/lib/coldfusion.policy"
-Djava.security.auth.policy="cf_webapp_root/WEB-INF/cfusion/lib/neo_jaas.policy"
You configure these settings by using a text editor to modify the jrun_root/bin/jvm.config file. or through the Settings
panel of the JRun Management Console (JMC).