Before You Begin the Installation

This section contains the following pre-installation instructions:

Required operating system patches

The following table lists the patches and packages that must be installed before installing ColdFusion Server 5:

Operating System

Patch

Description

Solaris 2.6
105181-17 or higher
Kernel patch

105591-09 or higher
LibC: Shared library patch for C++

105210-25 or higher
LibC: Shared library patch for C/C++

105568-14 or higher
libthread: Shared library patch

Solstice Enterprise Agent (SEA) Runtime 1.0.3
Required only for MIB functionality. For instructions, see "Installing SNMP in Solaris".

Solaris 7
106541-08 or higher
Kernel patch

106327-08 or higher
LibC: Shared library patch for C++

106980-07 or higher
libthread: Shared library patch

107709-10 or higher
Required only for MIB functionality. For instructions, see "Installing SNMP in Solaris".

Solaris 8
108869-03 or higher
Required only for MIB functionality. For instructions, see "Installing SNMP in Solaris".

en_US locale
U.S. English language pack

Operating System	Patch	Description
Solaris 2.6	105181-17 or higher	Kernel patch
105591-09 or higher	LibC: Shared library patch for C++
105210-25 or higher	LibC: Shared library patch for C/C++
105568-14 or higher	libthread: Shared library patch
Solstice Enterprise Agent (SEA) Runtime 1.0.3	Required only for MIB functionality. For instructions, see "Installing SNMP in Solaris".
Solaris 7	106541-08 or higher	Kernel patch
106327-08 or higher	LibC: Shared library patch for C++
106980-07 or higher	libthread: Shared library patch
107709-10 or higher	Required only for MIB functionality. For instructions, see "Installing SNMP in Solaris".
Solaris 8	108869-03 or higher	Required only for MIB functionality. For instructions, see "Installing SNMP in Solaris".
en_US locale	U.S. English language pack

Note

All versions of Solaris require the SUNWxcu4 -- XCU4 Utilities package. To download all patches and packages, go to http://sunsolve.sun.com.

Installing SNMP in Solaris

Managed data is accessible in ColdFusion Server 5 Enterprise Edition through the Simple Network Management Protocol (SNMP) Management Information Base (MIB) for Advanced ColdFusion Application Management features. You can integrate this information with your third-party system management tools. These tools provide a way for you to manage diverse components of your enterprise from a management station in your network.

If you want to use the ColdFusion Server MIB features, you must install SNMP before installing ColdFusion Server. For instructions, see the following procedures.

To install SNMP in Solaris 2.6:

Download the Solstice Enterprise Agent (SEA) 1.0.3 Runtime from:
http://www.sun.com/software/entagents/download/

Uninstall the following components from your system:

pkgrm SUNWsacom

pkgrm SUNWmibii

pkgrm SUNWsadmi

pkgrm SUNWsasnm

Install the SEA Runtime by performing the following steps:
1. Uncompress the SEA file by entering the following command:
```
uncompress solaris2.6-sparc-rt.tar.Z 

tar -xvf solaris2.6-sparc-rt.tar
```
2. Install the SEA packages, in sequence, as follows:
```
pkgadd -d . SUNWmibii

pkgadd -d . SUNWsasnm

pkgadd -d . SUNWsadmi

pkgadd -d . SUNWsacom
```
Note
For more information on installing the SEA packages, see Chapter 2, "Installing Solstice Enterprise Agent" in the SEA User Guide Release 1.0 (docs/UGhtml/install_solaris.doc.html).
Apply Solaris patch 106787-12 or higher.
Restart the SNMP process.

To install SNMP in Solaris 7 and 8:

For Solaris 7. install Solaris patch 107709-10 or higher
For Solaris 8. install Solaris patch 108869-03 or higher

After finishing the ColdFusion Server installation, you must configure your system to use the MIB features. For more information, see "Configuring SNMP MIB".

Important Network Considerations

The following table includes important considerations to keep in mind when configuring your network before the ColdFusion Server installation:

In order to install and configure Advanced Security for ColdFusion Server, you must have an installed and running LDAP server available on your network. You must have the Directory Manager DN, password, IP/port, and Root DN for this server.
If you intend to install ClusterCATS, you must first prepare your cluster. For instructions, see "Preparing Your Server for ClusterCATS".
ClusterCATS requires that the group btcats exist. It attempts to create this group during the ColdFusion installation using groupadd. If you are using NIS or NIS+, ensure that either nsswitch.conf allows for group resolution from the group file, or the group btcats gets created in NIS/NIS+ before installing ClusterCATS.
In an optimal production environment, each ColdFusion Server application is hosted on a dedicated server. A database, mail, or other server reside on the same server as ColdFusion Server.
Note the location and version number of your installed Web server. The pkgadd utility prompts you for this information.

Upgrading from a previous version

The ColdFusion Server 5 installation upgrades your current version of ColdFusion Server automatically. However, keep in mind the following important instructions when upgrading from a previous release of ColdFusion Server:

If you are upgrading from ColdFusion Server 4.0 or an earlier release, you must first run the registry migration utility cfregup.sh to preserve your registry settings. You must uninstall the old version by running the pkgrm utility. For details, see the README.cfregup file.
If you are upgrading from ColdFusion 4.5 and depending on the installation defaults of your pkgadd utilities, you may have to edit the package installation defaults file before running the pkgadd utility. The package installation defaults file is located at /var/sadm/install/admin/default. Change the value of the instance from quit or unique to overwrite. Setting the value of the instance from unique to overwrite allows the new version of ColdFusion Server to overwrite the existing version.
Using the ClusterCATS Explorer or btcluadm, you must remove cluster member servers before upgrading them to ColdFusion Server 5. In addition, some ClusterCATS management operations using the btcluadm utility require a license key. The license key is "GoColdFusion".
To continue to use VisiBroker for CORBA connections in ColdFusion Server 5, copy the libraries bundled with ColdFusion Server 4.5.1 into the appropriate directory. If you uninstall a previous release of ColdFusion Server before installing ColdFusion Server 5, these libraries are removed from your system. Copy the libraries to a safe location before the uninstall.

Note

Before proceeding with the upgrade, backup your ColdFusion Server Web applications.

Verifying that a Web server is running

Before installing ColdFusion Server, check that your Web server is installed and running.

To check that your local Web server is running:

Enter the URL for a Web page or site from your local Web server in your browser's Address field and press Enter.

For example, if the file myindex.htm is in your Web document root directory, load the page in your browser using the localhost URL:

http://127.0.0.1/myindex.htm

If your Web server is not running, you will receive an error message.

Uninstalling ColdFusion Server 5

Use the pkgrm utility to remove an installed version of ColdFusion Server.

Note

The uninstall script removes your odbc.ini file and all Verity collections. To preserve them, copy them to a new location before uninstalling ColdFusion Server.

To uninstall ColdFusion Server:

Log in as root.
Enter the following command at the prompt:
```
pkgrm cfusion
```
ColdFusion Server is deleted from your system.

Installing and Configuring ColdFusion Server
Installing ColdFusion Server in Solaris