You configure web servers in UNIX by doing one of the following:
Configuring Apache web server in UNIX
You can configure and verify the Apache web server for ColdFusion in UNIX.
Note: When running the Web Server Configuration Tool on the multiserver configuration, wsconfig.jar is located in jrun_root/lib. On the server configuration only, you can also use the scripts in cf_root/bin/connectors, modifying them, as appropriate for your environment.
Configure the Apache web server for ColdFusion in UNIX
- Enter the following command on a single line:
wsconfig -server servername -ws Apache -dir <apache config directory> -coldfusion -v
Note: You must enter the previous command as a single (long) line.
The wsconfig file is in cf_root/runtime/bin (server configuration) or jrun_root/bin (multiserver configuration)
The following is a sample command:
/opt/coldfusion8/runtime/bin/wsconfig -server coldfusion -ws Apache -dir /etc/httpd/conf-coldfusion -v
Note: For unique configurations (such as the preconfigured Apache web servers from Redhat or Sun), add the -bin and -script parameters, as described in Configuring and Administering ColdFusion.
- Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory. In addition, copy your application's pages from cf_root/wwwroot to your web server root directory. In the multiserver configuration, these files are under the jrun_root/servers/cfusion/cfusion-ear/cfusion-war directory.
Verify your Apache configuration
- Verify that one of the following files was created:
- cf_root/runtime/lib/wsconfig/number/mod_jrun.so (Apache 1.3.x)
- cf_root/runtime/lib/wsconfig/number/mod_jrun20.so (Apache 2.x)
In the multiserver configuration, this file is located under jrun_root/lib/wsconfig.
- Open the Apache configuration file, httpd.conf, in your Apache conf directory. By default it is /etc/httpd/conf/httpd.conf.
Verify that the following code is added to this file:
# JRun Settings
LoadModule jrun_module "/opt/ColdFusion8/runtime/lib/wsconfig/1/mod_jrun.so"
<IfModule mod_jrun.c>
JRunConfig Verbose false
JRunConfig Apialloc false
JRunConfig Ssl false
JRunConfig Serverstore "/opt/ColdFusion8/runtime/lib/wsconfig/1/jrunserver.store"
JRunConfig Bootstrap 127.0.0.1:51000
#JRunConfig Errorurl <URL for errors>
JRunConfig jrun-handler .jsp .jws .cfm .cfml .cfc
</IfModule>
Configuring SunONE or iPlanet web server in UNIX
You can configure and verify SunONE Web Server or iPlanet web server (4.x or 6.x) for ColdFusion in UNIX.
Note: When running the Web Server Configuration Tool on the multiserver configuration, wsconfig.jar is located in jrun_root/lib. On the server configuration only, you can also use the scripts in cf_root/bin/connectors, modifying them, as appropriate for your environment.
Configure Netscape or iPlanet for ColdFusion in UNIX
- Enter the following command on a single line:
wsconfig -server servername -ws sunone | iplanet | nes -dir path_to_config-coldfusion -v
Note: You must enter the previous command as a single (long) line. Specify sunone, iplanet or nes.
The following is a sample command:
/opt/coldfusion8/runtime/bin/wsconfig -server coldfusion -ws sunone -dir path_to_config -coldfusion -v
- Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory. Also, copy your application's CFM pages from cf_root/wwwroot to your web server root directory. In the multiserver configuration, these files are under the jrun_root/servers/cfusion/cfusion-ear/cfusion-war directory.
Verify your Netscape or iPlanet configuration
- Verify that the following file was created:
cf_root/runtime/lib/wsconfig/1/jrun_nsapi35.dll
In the multiserver configuration, this file is located under jrun_root/lib/wsconfig.
- Open the Netscape configuration file, obj.conf, in the web server directory (for example, in /usr/netscape/server4/https-surf/config/obj.conf).
- Verify that the following line is in the file:
NameTrans fn="jrunfilter"
- Verify that #JRun prefixes the following NameTrans line in the file:
#JRun NameTrans fn="pfx2dir" from="/servlet" dir="e:/netscape/servers/docs/servlet"
- Verify that the following object element is at the end of the file:
<Object name="jrun">
PathCheck fn="jrunfilter"
Service fn="jrunservice"
</Object>
Configure Sun Web Server 7 on Solaris
- Launch the cfroot/runtime/bin launch wsconfig tool.
- Click Add, and then select Sun Web Server 7.
- Select conf dir from the Sun Web Server root (created instance).
- Select the Configure Web Server For ColdFusion Applications option and click Add.
- Edit both the magnus.conf file and the obj.conf file (located in the sun_install_dir/server_instance/conf directory) by commenting lines that contain j2ee.
- Go to the sun_install_dir/bin directory.
- Execute the following command:
./wadm pull-config --user=admin --port=(admin_port) --config=(server_instance) admin_instance
Unconfigure Sun Web Server 7 on Solaris
- Launch the cfroot/runtime/bin launch wsconfig tool.
- Select Sun ONE Web Server, and then click Remove.
- Edit both the magnus.conf file and the obj.conf file (located in the sun_install_dir/server_instance/conf directory) by uncommenting lines that contain j2ee.
- Go to the sun_install_dir/bin directory.
- Execute the following command:
./wadm pull-config --user=admin --port=(admin_port) --config=(server_instance) admin_instance
