Installing and Configuring ColdFusion Server
Installing ColdFusion Server in Linux

Before You Begin the Installation

This section contains the following pre-installation instructions:

• Required operating system patches
• Installing SNMP in Red Hat
• Important Network Considerations
• Upgrading from a previous version
• Verifying that a Web server is running
• Uninstalling ColdFusion Server 5

Required operating system patches

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

Linux Distribution	Patch	Where to find it
Red Hat 6.2, 7.0	compat-libstdc++ RPM	ftp://ftp.redhat.com/pub/redhat/current/
	UCD-SNMP 4.2.1	Required only for MIB functionality. For instructions, see "Installing SNMP in Red Hat".
SuSE 7.0	apache.rpm	ftp://ftp.suse.com/pub/suse/i386/update/
Cobalt RAQ 3, RAQ4, XTR	glibc-2.1.3-22	http://www.cobalt.com/support/download/index.html
	glibc-profile-2.1.3-22	http://www.cobalt.com/support/download/index.html
	glibc-devel-2.1.3-22	http://www.cobalt.com/support/download/index.html
	Red Hat 6.0 glibc patch	ftp://ftp.redhat.com/pub/redhat/current/

Installing SNMP in Red Hat

Managed data is accessible in ColdFusion Server 5 Enterprise Edition through the Simple Network Management Protocol (SNMP) Management Information Base (MIB) for 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 Red Hat:

The ColdFusion Server MIB Agent uses the Dynamic Module approach of UCD-SNMP 4.2. To use the MIB Agent, you must ensure that UCD-SNMP 4.2.1 or higher is installed on your system.

1. Download UCD-SNMP 4.2.1 from http://net-snmp.sourceforge.net(download).

   For Red Hat 6.2, download ucd-snmp-4.2.1-2.rh62.i386.rpm

   For Red Hat 7.0, download ucd-snmp-4.2.1-1.rh7.0.i386.rpm

   
   

   Note By default, UCD-SNMP installs into the /usr/sbin directory.

   
   
2. Install UCD-SNMP 4.2.1 on your system. If installation of UCD-SNMP 4.2.1 RPM requires openssl, you can download it at http://rpmfind.net.

When you install the MIB Agent, the ColdFusion Server installation asks whether you want to replace the current snmpd.conf with a version of snmpd.conf that will make ColdFusion MIB information accessible.

If you answer Yes, the current copy of snmpd.conf in /etc/snmp is renamed to snmp.conf_original, and the ColdFusion version of snmpd.conf is inserted into /etc/snmp. If you answer No, a file called snmpd.conf_macromedia is placed into /etc/snmp. You then have to merge the content from snmpd.conf_macromedia into snmpd.conf to make ColdFusion MIB information accessible.

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:

• 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.
• ClusterCATS requires that you enable multicast on all network adapters. To enable multicast on an adapter, enter the following command:

  ifconfig eth0 multicast
  
  

• In this example, the adapter is eth0; enter the appropriate adapter name for your configuration.
• In an optimal production environment, each ColdFusion Server application should be hosted on a dedicated server. A database, mail, or other server should not reside on the same server as ColdFusion Server.
• If you intend to install ClusterCATS, you must first prepare your server. For instructions, see "Preparing Your Server for ClusterCATS".

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:

• 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.

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

To remove ColdFusion Server, use the remove utility t.

To uninstall ColdFusion Server:

1. Log in as root.
2. Enter the following command at the prompt:

   /opt/coldfusion/uninstall/cfremove
   
   

ColdFusion Server is deleted from your server.

Copyright © 2001, Macromedia Inc. All rights reserved.

---