Configuring Your Installation

After installation, might have to configure HP-UX to work with ColdFusion Server. This section addresses the following topics:

Configuring Web servers manually

If you did not instruct ColdFusion Server to configure your Web server automatically during the ColdFusion Server installation, you must manually configure your Web server. This section explains how to configure Web servers manually in HP-UX. The following Web servers are covered in this section:

Netscape/iPlanet Web Server

The ColdFusion Server NSAPI plug-in has been tested with Netscape/iPlanet Enterprise Web Server 3.5.1 and 4.1 and the Netscape FastTrack Web Server 3.5.1 and 4.1. The installation script prompts you to configure either of these servers automatically.

The Netscape/iPlanet plug-in

Netscape/iPlanet plug-ins for ColdFusion Server are installed in the opt/coldfusion/webserver/nsapi directory.

The following procedure assumes that you installed the Netscape/iPlanet server in

/usr/netscape/server4 on the system named smurf.

To configure the Netscape/iPlanet plug-in:

Copy the plug-in to a directory named coldfusion in your server directories.

mkdir /usr/netscape/server4/plugins/coldfusion

cp /opt/coldfusion/webserver/nsapi/coldfusion35.so \

  /usr/netscape/server4/plugins/coldfusion/coldfusion.so

Edit the /usr/netscape/server4/https-smurf/config/mime.types file to add a new ColdFusion Server type. Add the line:
```
type=magnus-internal/cold-fusion exts=cfm,dbm,cfml,dbml
```
Edit the /usr/netscape/server4/https-surf/config/obj.conf file to add new service and init directives. Add all of the following on one line:
```
Init fn="load-modules" shlib="/usr/netscape/server4/

plugins/coldfusion/coldfusion.so" funcs="DoCFRequest"
```

Add the following line in the default Object:

Service fn="DoCFRequest" method="(GET|POST)" 

type="magnus-internal/cold-fusion"

Stop and restart the Web server.

Note

If you run the Netscape/iPlanet Server Manager, the browser-based administrator, you get a warning about edits to the Netscape configuration files. This is normal. To reload the new configuration files, follow the instructions and click Apply.

Verify that ColdFusion Server works by following the procedure outline in "Configuring Your Installation".
If your server does not restart, ensure that the path name for the plug-in you specified in the obj.conf file is correct for your installation and that it is on a single line.

Apache Web Server

ColdFusion Server attaches to Apache using a dynamically-loaded shared library (DSO). To use ColdFusion Server with Apache, you must have a version of the ColdFusion DSO that matches the version of Apache you're running.

To install and configure Apache:

Shut down Apache.
To check whether your version of Apache is built with EAPI, run the following command:
```
  httpd -V
```
If the output contains the line -D EAPI, you are running an EAPI version of Apache.
ColdFusion Server includes a version of the ColdFusion DSO that was built with Apache 1.3.6 and that works with Apache 1.3.14. This version is located in /opt/coldfusion/webserver/apache/mod_coldfusion.sl. If you use a version of Apache built with the Extended API (EAPI), you must use the mod_coldfusion-EAPI.sl module.
Copy the appropriate module into the libexec subdirectory of your Apache installation.

Note
For more information, see the Readme file located in /opt/coldfusion/webserver/apache.
For Apache to use the ColdFusion DSO, you must enable Apache DSO support. To check whether DSO support is enabled, enter the following command from within the Apache bin directory:
```
httpd -l
```
If the output does not include a line containing something like mod_so.c, you must enable DSO support by running the configure script with the enable-module option included; for example:
configure --enable-module=rewrite --enable-shared=rewrite
Open src/Makefile in a text editor.
1. Find the following line:
```
LIBS1= -lcl -lm -lpthread
```
  If it does not contain -lcl , add it.
2. Save the file.
After performing Steps 4 and 5, you must rebuild Apache and then re-install the new configuration. For instructions, see the Apache documentation.
Open the file /etc/httpd/httpd.conf in a text editor.
1. If you are not running an EAPI version of Apache, in the section LoadModule, add the following line:
```
  LoadModule coldfusion_module libexec/mod_coldfusion.sl
```
  If you are running an EAPI, add the following line:
  LoadModule coldfusion_module libexec/mod_coldfusion-EAPI.sl
2. In the section AddModule, add the following line:
```
  AddModule mod_coldfusion.c
```
3. Save the file.
Restart Apache.

Configuring databases

After the install is completed, but before you can set up a data sources in the ColdFusion Administrator, you must edit the /opt/coldfusion/bin/start script to include information about the database(s) you use.

Normally this requires two changes per database: setting a database-specific environment variable, and adding the path to the client-side database libraries to your SHLIB_PATH environment variable. The start script provides examples to help you.

After editing the start script, you must stop and restart ColdFusion Server for the changes to take effect. After that finishes, proceed to the ColdFusion Administrator to set up your data sources.

Note

For more information, see "Managing Data Sources".

The following table includes important database compatibility information for ColdFusion Server 5 in HP-UX:

Database

ODBC

Native

Oracle 8
Yes (Tested using Oracle 8.04 and 8.16 clients)
Yes (Tested using Oracle 8.04 and 8.16 clients)

Oracle 7
No (Oracle client software unavailable on HP-UX 11.0)
No (Oracle client software unavailable on HP-UX 11.0.)

Sybase 11
Yes (Tested using Sybase 11.1.1 client. Clientless driver available.)
Yes (Tested using Sybase 11.1.1 client.)

Informix 7and 9
Yes (Tested Informix 9 and with 2.40 client. Clientless driver available for Informix9.)
Yes (Tested Informix 9 and with 2.40 client. Cannot be used simultaneously with ODBC connections.)

IBM DB2
No (ODBC driver unavailable in HP-UX 11.0)
Yes (Tested using 6.1 client. Cannot be used simultaneously with ODBC connections.)

Microsoft SQL Server
Yes (Tested connecting to MS SQL Server 6.5 and 7.0 DBs. Wire protocol, no client required.)
No (No native client libraries available on HP-UX 11.0)

dBase/FoxPro
Yes (Simple "flat file" DB. No client library required.)
No (ODBC-access only)

OpenIngress
No (ODBC driver unavailable in HP-UX 11.0)
Not Applicable

Text
Yes (Comma-separated field text)
Not Applicable

Installing and Configuring ColdFusion Server
Installing ColdFusion Server in HP-UX

Database	ODBC	Native
Oracle 8	Yes (Tested using Oracle 8.04 and 8.16 clients)	Yes (Tested using Oracle 8.04 and 8.16 clients)
Oracle 7	No (Oracle client software unavailable on HP-UX 11.0)	No (Oracle client software unavailable on HP-UX 11.0.)
Sybase 11	Yes (Tested using Sybase 11.1.1 client. Clientless driver available.)	Yes (Tested using Sybase 11.1.1 client.)
Informix 7and 9	Yes (Tested Informix 9 and with 2.40 client. Clientless driver available for Informix9.)	Yes (Tested Informix 9 and with 2.40 client. Cannot be used simultaneously with ODBC connections.)
IBM DB2	No (ODBC driver unavailable in HP-UX 11.0)	Yes (Tested using 6.1 client. Cannot be used simultaneously with ODBC connections.)
Microsoft SQL Server	Yes (Tested connecting to MS SQL Server 6.5 and 7.0 DBs. Wire protocol, no client required.)	No (No native client libraries available on HP-UX 11.0)
dBase/FoxPro	Yes (Simple "flat file" DB. No client library required.)	No (ODBC-access only)
OpenIngress	No (ODBC driver unavailable in HP-UX 11.0)	Not Applicable
Text	Yes (Comma-separated field text)	Not Applicable