Installing and Configuring ColdFusion Server
Installing ColdFusion Server in Solaris

Installing ColdFusion Server in Solaris

The installation procedure assumes that you are installing from a CD-ROM. If you purchased and downloaded ColdFusion Server, first place the package file (coldfusion-50-solaris.pkg) into its own directory. To start the installation process, use the pkgadd -d coldfusion-50-solaris.pkg shell command and then follow the install procedure below, substituting the location to which you downloaded ColdFusion Server for references to the CD-ROM.

This procedure describes a ColdFusion Server Enterprise Edition installation.

By default, the package file installs ColdFusion Server into the /opt directory. To install ColdFusion Server into a different directory, you must create that directory before running the pkgadd utility.

1. Log in as root.
2. If you are installing from a CD-ROM, copy the gziped tar file, using the coldfusion-50-solaris.tar.gz command, to a directory on your local disk. Using gunzip, uncompress the ColdFusion Server tar file with the following command:

    gunzip coldfusion-50-solaris.tar.gz.
   
   

3. Untar the resulting tar file by entering the following command:

   tar -xvf coldfusion-50-solaris.tar
   
   

4. Using the cd command, go to the resulting directory:

   cd coldfusion-50-solaris
   
   

5. Run the following pkgadd command:

   pkgadd -d coldfusion-50-solaris.pkg
   
   

6. At the prompt, enter cfusion and press Enter.
7. Enter the ColdFusion Server registration ID (license key) when prompted.
   

   Note You can find your ColdFusion Server license key on the product box and the CD-ROM packaging.

   
   
8. After entering the install directory for ColdFusion Server, the installation process prompts you to enter the name of your Web server.
   

   Note If you entered Other or if you have a custom release of Apache, such as usr/local/apache, see "Configuring Web servers manually".

   
   

   At the corresponding prompt, press Enter to let the installation script automatically configure your Web server.

9. You are prompted to enter y to install the ColdFusion Server options. For each option that you want to install, enter y for each option that you want to install. The following table describes the options:

   Option	Description
   Reporting and Archive/Deploy	Accessed through the ColdFusion Administrator, this option provides ColdFusion application reporting statistics and the ability to archive and deploy ColdFusion applications.
   Monitors, Alarms, and Load-Balancer Integration	Accessed through the ColdFusion Administrator, this option provides ColdFusion application performance monitoring, threshold alarms, and hardware load-balancing integration for Cisco LocalDirector. If you select ClusterCATS, these features is provided through the ClusterCATS Web Administrator.
   ClusterCATS	Provides software-based load-balancing and IP failover support for ColdFusion Server. If you want the server on which you are installing ClusterCATS to be able to assume the IP address and HTTP traffic of a failed server in the cluster, enter y to configure this server with failover services. For more information, see "Preparing Your Server for ClusterCATS".
   SNMP MIB	Provides application information to third-party applications. You must install SNMP on Solaris before installing ColdFusion Server. For instructions, see "Installing SNMP in Solaris" and "Configuring SNMP MIB".

10. After supplying the directory for your Web server documentation, entering and confirming passwords for the ColdFusion Administrator and ColdFusion Studio, your are prompted to install Advanced Security. To do this, you must have a functioning LDAP server for policy storage.

    Solaris customers currently using Advanced Security in ColdFusion Server 4.5 encounter a question during installation as to whether SiteMinder is installed. This is referring to the full, retail version of Netegrity SiteMinder and is intended to enable ColdFusion Single Sign-On support in ColdFusion automatically. For details on this SiteMinder feature, see your Netegrity SiteMinder documentation.

    You are prompted for a target LDAP server instance to migrate the SiteMinder policy store. ColdFusion Server 5 requires that you do so. This one-time procedure requires a second properly-configured LDAP server instance. At the conclusion of the migration procedure, the install automatically configures the Advanced Security features to use this second LDAP instance as the SiteMinder policy store.

11. Choose whether to install ColdFusion Server documentation and examples. The documentation is installed in the /cfdocs directory, under the Web root directory.
    

    Warning Because of potential security concerns, the ColdFusion Server team recommends that you not install the example applications in production environments.

    
    
12. Enter the user name under which ColdFusion Server runs or press Enter to run under the default user name ("nobody").
13. Press Enter to begin the installation.

When the installation is complete, a shell script restarts the Web server and starts ColdFusion Server services. If the ColdFusion Server services are not started automatically, you can start them manually using the ColdFusion Server start-up script, which is located in the coldfusion/bin directory.

ColdFusion Server Processes

The ColdFusion Server installation creates the following processes in Solaris

Process	Purpose
cfexec	Starts/stops the other processes and manages page scheduling
cfserver	The main ColdFusion Server service. ColdFusion pages cannot be processed if this service is not running.
cfrdsservice	Provides system support for the Administrator as well as security and debugging services for ColdFusion Studio
cfsecurityproxy	Links ColdFusion Server to the SiteMinder system
smservauth	Provides SiteMinder authentication service
smservaz	Provides SiteMinder authorization service
java	Provides a runtime for the ColdFusion Server graphing and charting features and application management features
ipaliasd	Provides IP failover capability for ClusterCATS
reqmgr	Processes ClusterCATS operations as root
ccmgr	Creates processes to support ClusterCATS
wsprobe	Probes the application server for load and restarts unresponsive Web servers
CANamingAdapter	Controls the data store for application management features
dfp	Provides load-balancing information to LocalDirector

:

Starting and stopping ColdFusion Server processes

In general, you should stop and restart ColdFusion Server after making changes in the ColdFusion Administrator that affect a data source or connection parameter, such as caching or thread count.

ColdFusion Server provides two scripts for starting and stopping ColdFusion Server processes manually in Solaris:

/opt/coldfusion/bin/start

/opt/coldfusion/bin/stop

In addition, ColdFusion Application Manager provides two scripts for starting and stopping ClusterCATS and the Application Manager:

/opt/coldfusion/bin/cfam-start

/opt/coldfusion/bin/cfam-stop

ColdFusion Server also provides the following scripts to start and stop ColdFusion Server during system startup and shutdown

Script	Function
/etc/init.d/coldfusion	Starts or stops ColdFusion Server
/etc/rc1.d/K19coldfusion	Stops ColdFusion Server during system shutdown
/etc/rc3.d/S25coldfusion	Starts ColdFusion Server during system startup
/etc/init.d/btccmgr start	Starts ClusterCATS and application management processes.
/etc/init.d/btccmgr restart	Stops ClusterCATS and application management processes.

:

Copyright © 2001, Macromedia Inc. All rights reserved.

---