MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER Manual
  1. Manuals
  2. Brands
  3. MACROMEDIA Manuals
  4. Software
  5. COLDFUSION 5 - INSTALING AND CONFIGURING...
  6. Manual
MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER Manual

MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Installing and
Configuring

ColdFusion Server

ColdFusion Server 5
Macromedia, Inc.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the COLDFUSION 5 - INSTALING AND CONFIGURING SERVER and is the answer not in the manual?

Questions and answers

Related Manuals for MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER

Summary of Contents for MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER

  • Page 1: Coldfusion Server

    Installing and Configuring ColdFusion Server ColdFusion Server 5 Macromedia, Inc.

  • Page 2: Copyright Notice

    Macromedia Inc. ColdFusion and HomeSite are federally registered trademarks of Macromedia Inc, HomeSite, and the ColdFusion logo are trademarks of Macromedia Inc. in the USA and other countries. Microsoft, Windows, Windows NT, Windows 2000 Windows 98, Windows ME, Microsoft Access, and FoxPro are registered trademarks of Microsoft Corporation.

  • Page 3: Table Of Contents

    Contacting Macromedia ........
  • Page 4 Chapter 2 Installing ColdFusion Server in Solaris . . . Solaris System Requirements ..........24 Before You Begin the Installation.
  • Page 5 ColdFusion Server processes ........61 Configuring Your Installation .
  • Page 6 Tools ..............102 Logs and Statistics.
  • Page 7 ColdFusion Server and needs to install and configure ColdFusion Server 5. Contents Intended Audience....................viii New Features ......................viii Developer Resources....................x About ColdFusion Documentation ................xi Getting Answers ......................xii Contacting Macromedia..................xiii...

  • Page 8: Welcome To Coldfusion Server

    viii Welcome to ColdFusion Server Intended Audience Installing and Configuring ColdFusion Server is intended for anyone who needs to install, configure, and maintain ColdFusion Server 5. It describes: System requirements Installation processes for all supported operating systems Operating system-specific configuration instructions Basic configuration options using the ColdFusion Administrator New Features The following table lists the new features in ColdFusion 5:...
  • Page 9 New Features Benefit Feature Description Easy Application deployment Effortlessly and reliably deploy, managment services archive, or restore entire applications using ColdFusion archive files. Enhanced application Keep track of server performance and monitoring availability with customizable alerts and recovery. SNMP support Monitor ColdFusion applications from enterprise management systems.

  • Page 10: Developer Resources

    Welcome to ColdFusion Server Developer Resources Macromedia Corporation is committed to setting the standard for customer support in developer education, technical support, and professional services. The Web site is designed to give you quick access to the entire range of online resources, as the following table describes.

  • Page 11: About Coldfusion Documentation

    About ColdFusion Documentation About ColdFusion Documentation ColdFusion Server documentation is designed to provide support for the complete spectrum of participants. The print and online versions are organized to allow you to quickly locate the information that you need. The ColdFusion Server online documentation is provided in HTML.

  • Page 12: Getting Answers

    Welcome to ColdFusion Server Getting Answers One of the best ways to solve particular programming problems is to tap into the vast expertise of the ColdFusion developer communities on the ColdFusion Forums at http://forums.coldfusion.com. Other developers on the forum can help you figure out how to do just about anything with ColdFusion Server.

  • Page 13: Contacting Macromedia

    Tel: 415.252.2000 Fax: 415.626.0554 Web: Technical support Macromedia offers a range of telephone and Web-based support options. Go to http://www.coldfusion.com/support/ for a complete description of technical support services. You can make postings to the ColdFusion Support Forum (http://forums.coldfusion.com/DevConf/index.cfm) at any time.
  • Page 14 Welcome to ColdFusion Server...

  • Page 15: Chapter 1 Installing Coldfusion Server In Windows

    Chapter 1 Installing ColdFusion Server in Windows This chapter explains how to install and configure ColdFusion Server in Windows. Contents Windows System Requirements................. 4 Before You Begin the Installation................5 Installing ColdFusion Server in Windows ............... 10 Configuring Your Installation................... 14 What to Do Next ......................

  • Page 16: Windows System Requirements

    Chapter 1 Installing ColdFusion Server in Windows Windows System Requirements The following table compares the system requirements for the ColdFusion Server Professional and Enterprise Editions: ColdFusion ColdFusion Server Server Requirement Professional Enterprise Windows Version Windows 98 Windows NT 4.0 (Workstation and Server) Windows 2000 (Professional*, Server, and Advanced Server) Hardware...

  • Page 17: Before You Begin The Installation

    Before You Begin the Installation Before You Begin the Installation This section contains the following pre-installation instructions: Required operating system updates Installing SNMP in Windows NT 4.0 Server and Windows 2000 Server Important Network Considerations Upgrading from a previous version Verifying that a Web server is running Removing, modifying, repairing, or updating ColdFusion Server 5 Required operating system updates...

  • Page 18: Installing Snmp In Windows Nt 4.0 Server And Windows 2000 Server

    Chapter 1 Installing ColdFusion Server in Windows Operating System Update Where to find it † Required only for MIB functionality. For SNMP instructions, see “Installing SNMP in Windows NT 4.0 Server and Windows 2000 Server” on page 6 “Configuring SNMP MIB” on page * Windows NT 4.0 Server only †...

  • Page 19: Important Network Considerations

    TCP/IP connections concurrently, Macromedia does not recommend using those operating systems in a production environment. Use Window NT 4.0 Server or Windows 2000 Server. In addition, Macromedia does not recommend using Windows 98 because it is not intended as server platforms.

  • Page 20: Verifying That A Web Server Is Running

    Chapter 1 Installing ColdFusion Server in Windows automatically detects and exports policy store data to an Extensible Markup Language (XML) file named smpolicy451export.xml. It is stored in the \cfusion\database\ directory. To complete the migration process, log into the ColdFusion Administrator and click on the Advanced Security link. Detailed instructions are provided for importing the policy store data.
  • Page 21 Before You Begin the Installation A dialog box displays a list ColdFusion Server components. Select the components that you want removed or added, and click Next. When the program completes, restart your system. To repair/update ColdFusion Server: Use the Repair/update feature to reinstall a component of ColdFusion Server. Repairing ColdFusion Server refreshes the Windows registry, reset settings, and replace missing files.

  • Page 22: Installing Coldfusion Server In Windows

    Chapter 1 Installing ColdFusion Server in Windows Installing ColdFusion Server in Windows Macromedia recommends that you close all open applications before running the Setup program. This ensures proper installation of the Merant ODBC 3.7 drivers. This procedure describes a ColdFusion Server Enterprise Edition installation.

  • Page 23: Coldfusion Server Services

    Installing ColdFusion Server in Windows The following table lists important installation options and considerations for ColdFusion Enterprise Edition customers: If You Select Comment ClusterCATS 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, select Web Server (IP) Failover.
  • Page 24 Monitors the performance and availability of the Service* ColdFusion Server, the HTTP server, and probes that are created. This service supports ClusterCATS and Application Monitoring. ColdFusion Graphing Provides a Java runtime required for Macromedia Server* Generator ( cfgraph ) support. ColdFusion Management...
  • Page 25 Installing ColdFusion Server in Windows To start and stop a ColdFusion Service in Windows 2000: Select Start > Control Panel > Settings > Administrative Tools > Services. If a service is running, its status appears as "Started" in the Status column. If it is not running, no status appears for the service.

  • Page 26: Configuring Your Installation

    Chapter 1 Installing ColdFusion Server in Windows Configuring Your Installation After installing ColdFusion Server, you may have to perform the following actions: Configuring Web servers manually Configuring SNMP MIB Changing the ColdFusion Server user account Configuring Web servers manually If you selected Other Server in the Web Server Selection dialog, or your Web server was not detected by the Install Wizard, you must manually configure it.
  • Page 27 Configuring Your Installation The MMC displays: In the Tree tab, under the Internet Information Services tree, right-click your Web site and select Properties. The Properties dialog box displays: Click the Home Directory tab, then Configuration. Note If the Configuration button is greyed out, click Create, then click Configuration.
  • Page 28 Note In previous versions, ColdFusion Server used the .dbm file extension for ColdFusion Server files. Macromedia recommends that you rename templates that have a .dbm extension to .cfm. Click OK in the Application Configuration dialog box to save your changes.
  • Page 29 Configuring Your Installation Apache Web server This procedure assumes that the Apache Web server is installed in c:\Apache. To configure Apache for ColdFusion Server: If it is not already installed, download the Apache Web server from the Apache HTTP Server Project Web site at http://www.apache.org/. Read the Windows documentation at http://www.apache.org/docs/windows.html.
  • Page 30 Chapter 1 Installing ColdFusion Server in Windows Note Netscape is case sensitive, so add the lines exactly as they appear here . Enter each command one line. If you remove ColdFusion Server, you must undo these changes. Otherwise, the iPlanet/Netscape Web server will not work. O’Reilly WebSite Professional This example uses Windows 2000 Professional as the example operating system and O’Reilly WebSite Professional 3.0 as the Web server.

  • Page 31: Configuring Snmp Mib

    Configuring Your Installation Configuring SNMP MIB To use the ColdFusion Server MIB features, you must configure these settings: For each system, such as a system with the IP address 192.178.64.88, that is to receive trap messages from the local host, open the local host’s Registry to: \\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Paramete rs\TrapConfiguration\public For each system, add a value in the following form:...

  • Page 32: Changing The Coldfusion Server User Account

    Chapter 1 Installing ColdFusion Server in Windows Changing the ColdFusion Server user account By default, ColdFusion Server runs under the host’s System account. However, under this account, ColdFusion application pages may have access rights to interact with remote data sources, other application pages, and COM objects. You may have to run ColdFusion Server under a account that provides the necessary access rights.

  • Page 33: What To Do Next

    What to Do Next What to Do Next After installing ColdFusion Server and configuring your installation, you must perform some initial administration tasks using the ColdFusion Administrator, ColdFusion Server’s Web-based control console. For more information, see “Initial Administration Tasks” on page...
  • Page 34 Chapter 1 Installing ColdFusion Server in Windows...

  • Page 35: Chapter 2 Installing Coldfusion Server In Solaris

    Chapter 2 Installing ColdFusion Server in Solaris This chapter explains how to install and configure ColdFusion Server in Solaris. Contents Solaris System Requirements ................... 24 Before You Begin the Installation................25 Installing ColdFusion Server in Solaris..............29 Configuring Your Installation................... 33 What to Do Next ......................

  • Page 36: Solaris System Requirements

    Chapter 2 Installing ColdFusion Server in Solaris Solaris System Requirements The following table contains the system requirements for the ColdFusion Server Enterprise Edition: ColdFusion Requirement Server Enterprise Solaris Version Solaris 2.6, 7, 8 Hardware Processor SPARC Minimum RAM (MB) Recommended RAM (MB) Free Hard Disk Space (MB) CD-ROM Drive Web Server...

  • Page 37: Before You Begin The Installation

    Before You Begin the Installation Before You Begin the Installation This section contains the following pre-installation instructions: Required operating system patches Installing SNMP in Solaris 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...

  • Page 38: Installing Snmp In Solaris

    Chapter 2 Installing ColdFusion Server in Solaris 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.

  • Page 39: Important Network Considerations

    Before You Begin the Installation Important Network Considerations The following table includes important considerations to keep in mind when configuring your network before the ColdFusion Server installation: To install and configure Advanced Security for ColdFusion Server, you must have an installed, running LDAP server available on your network. You must have the Directory Manager DN, password, IP/port, and Root DN for this server.

  • Page 40: Verifying That A Web Server Is Running

    Chapter 2 Installing ColdFusion Server in Solaris Verifying that a Web server is running Before installing ColdFusion Server, ensure 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.

  • Page 41: Installing Coldfusion Server In Solaris

    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 shell command and then follow pkgadd -d coldfusion-50-solaris.pkg...
  • Page 42 Chapter 2 Installing ColdFusion Server in Solaris You are prompted to enter to install the ColdFusion Server options. For each option that you want to install, enter . The following table describes the options: Option Description Reporting and Accessed through the ColdFusion Administrator, this option Archive/ provides ColdFusion application reporting statistics and the ability Deploy...

  • Page 43: Coldfusion Server Processes

    Installing ColdFusion Server in Solaris 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.
  • Page 44 Chapter 2 Installing ColdFusion Server in Solaris 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 Note To run scripts, you must be logged in with root privileges. ColdFusion Server also provides the following scripts to start and stop ColdFusion Server during system startup and shutdown: Script Function...

  • Page 45: Configuring Your Installation

    Configuring Your Installation Configuring Your Installation After installing ColdFusion Server, you may have to perform the following actions: Configuring Web servers manually Configuring SNMP MIB Configuring databases 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.
  • Page 46 Chapter 2 Installing ColdFusion Server in Solaris Stop and restart the Web server. Note If you run the Netscape/iPlanet Server Manager, the browser-based administrator, you may 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 Apache Web Server ColdFusion Server has been tested with Apache version 1.3.6.
  • Page 47 Configuring Your Installation After you configure mod_so in your Apache binary, the simplest way to configure the ColdFusion Server module is to use the apxs program that is included in the Apache distribution. It installs by default in <apachedir>/apache/bin. This is a Perl script, so you must have Perl installed on your system.

  • Page 48: Configuring Snmp Mib

    Chapter 2 Installing ColdFusion Server in Solaris Configuring SNMP MIB To use the ColdFusion Server MIB features, you must configure the following settings. To configure Solaris use the MIB Agent: Stop the SNMP process by entering the following command: /etc/init.d/init.snmpdx stop kill <the pid of the allaire_mibd process>...

  • Page 49: Configuring Databases

    Configuring Your Installation Configuring databases After the install has completed, but before you can setup data sources in the ColdFusion Administrator, you must edit the /opt/coldfusion/bin/start script to include information about your database(s). 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 environment variable.

  • Page 50: What To Do Next

    Chapter 2 Installing ColdFusion Server in Solaris What to Do Next After installing ColdFusion Server and configuring your installation, you must perform some initial administration tasks using the ColdFusion Administrator, ColdFusion Server’s Web-based control console. For more information, see “Initial Administration Tasks”...

  • Page 51: Chapter 3 Installing Coldfusion Server In Linux

    Chapter 3 Installing ColdFusion Server in Linux This chapter explains how to install and configure ColdFusion Server in Linux. Contents Linux System Requirements..................40 Before You Begin the Installation................41 Installing ColdFusion Server in Linux ..............44 Configuring Your Installation................... 48 What to Do Next ......................

  • Page 52: Linux System Requirements

    Chapter 3 Installing ColdFusion Server in Linux Linux System Requirements The following table compares the system requirements for the ColdFusion Server Professional and Enterprise Editions: ColdFusion ColdFusion Server Server Requirement Professional Enterprise Linux Distribution Red Hat Linux 6.2 and later SuSE Linux 7.0 and later *†...

  • Page 53: Before You Begin The Installation

    Before You Begin the Installation 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...

  • Page 54: Important Network Considerations

    Chapter 3 Installing ColdFusion Server in Linux 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. 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...

  • Page 55: Upgrading From A Previous Version

    Before You Begin the Installation 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 , you must remove cluster member btcluadm...

  • Page 56: Installing Coldfusion Server In Linux

    Chapter 3 Installing ColdFusion Server in Linux Installing ColdFusion Server in Linux This following procedure describes a ColdFusion Server Enterprise Edition installation. Other editions’ procedure might differ. By default, ColdFusion Server installs into the directory. To install ColdFusion /opt Server into a different directory, you must create that directory before running the installation.
  • Page 57 Installing ColdFusion Server in Linux Warning Because of potential security concerns, the ColdFusion Server team recommends that you not install the example applications in production environments. 10 After entering and confirming the passwords for the ColdFusion Administrator and ColdFusion Studio, enter the login name under which ColdFusion Server runs.

  • Page 58: Coldfusion Server Processes

    Chapter 3 Installing ColdFusion Server in Linux ColdFusion Server processes The ColdFusion Server installation creates the following processes in Linux: Process Purpose cfexec Starts and 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.
  • Page 59 Installing ColdFusion Server in Linux ColdFusion Server also provides the following scripts to start and stop ColdFusion Server during system startup and shutdown: Script Function /etc/rc.d/init.d/coldfusion Starts and stops ColdFusion Server. /etc/rc1.d/K19coldfusion Stops ColdFusion Server during system shutdown. /etc/rc3.d/S90coldfusion Starts ColdFusion Server during system startup.

  • Page 60: Configuring Your Installation

    Chapter 3 Installing ColdFusion Server in Linux Configuring Your Installation After installation, you may need to configure Linux to work with ColdFusion Server. This section addresses the following topics: Configuring Web servers manually Configuring SNMP MIB Configuring databases Configuring Web servers manually If you did not configure your Web server automatically duringColdFusion Server installation, you must manually configure the Web server.
  • Page 61 Configuring Your Installation Note If you run the Netscape/iPlanet Server Manager, the browser-based Web server administrator, you may receive a warning about edits to Netscape configuration files. This is normal. To reload the new configuration files, follow the instructions and click Apply. If your server does not restart, check that the pathname for the plug-in you specified in the obj.conf file is correct for your installation and that it is on a single line.
  • Page 62 Chapter 3 Installing ColdFusion Server in Linux To configure SuSE/Cobalt and Apache: To check whether your version of Apache is built with EAPI, run this command: httpd -V If the output contains the line , you are running an EAPI server. (SuSE -D EAPI requires an EAPI version of mod.coldfusion.so.) Shut down Apache with the following command:...

  • Page 63: Configuring Snmp Mib

    Ensure that the destination server, such as server1.macromedia.com, is configured to receive traps from the specified community, such as public. Warning Ensure that the following line does not appear in snmpd.conf more than once: dlmod allaire /usr/lib/btcats/program/allaire_mib.so...
  • Page 64 Chapter 3 Installing ColdFusion Server in Linux 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 LD_LIBRARY_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.

  • Page 65: What To Do Next

    What to Do Next What to Do Next After installing ColdFusion Server and configuring your installation, you must perform some initial administration tasks using the ColdFusion Administrator, ColdFusion Server’s Web-based control console. For more information, see “Initial Administration Tasks” on page...
  • Page 66 Chapter 3 Installing ColdFusion Server in Linux...

  • Page 67: Chapter 4 Installing Coldfusion Server In Hp-Ux

    Chapter 4 Installing ColdFusion Server in HP-UX This chapter explains how to install and configure ColdFusion Server in HP-UX. Contents HP-UX System Requirements................... 56 Before You Begin the Installation................57 Installing ColdFusion Server in HP-UX ..............60 Configuring Your Installation................... 62 What to Do Next ......................

  • Page 68: Hp-Ux System Requirements

    Chapter 4 Installing ColdFusion Server in HP-UX HP-UX System Requirements The following table contains the system requirements for the ColdFusion Server Enterprise Edition: ColdFusion Requirement Server Enterprise HP-UX Version HP-UX 11.0 Hardware Processor PA-RISC 1.1 or 2.0 Minimum RAM 128 MB Recommended RAM 128 MB Free Hard Disk Space...

  • Page 69: Before You Begin The Installation

    Before You Begin the Installation Before You Begin the Installation This section contains the following pre-installation instructions: Required operating system settings Upgrading from a previous version Verifying that a Web server is running Mounting the installation CD-ROM Uninstalling ColdFusion Server 5 Required operating system settings The following list includes patches that must be installed, kernel settings that must be configured, and general issues to consider before installing ColdFusion Server 5:...

  • Page 70: Verifying That A Web Server Is Running

    Chapter 4 Installing ColdFusion Server in HP-UX Warning Before upgrading, backup your ColdFusion Server Web applications. Verifying that a Web server is running Before installing ColdFusion Server, ensure that the 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.

  • Page 71: Uninstalling Coldfusion Server 5

    Before You Begin the Installation The CD-ROM should be visible under . When you finish using the /SD_CDROM CD-ROM, you can unmount it using the following command: /usr/sbin/pfs_umount /SD_CDROM Uninstalling ColdFusion Server 5 Use the utility to remove an installed version of ColdFusion Server. cfremove To uninstall ColdFusion Server: Log in as root.

  • Page 72: Installing Coldfusion Server In Hp-Ux

    Chapter 4 Installing ColdFusion Server in HP-UX Installing ColdFusion Server in HP-UX The installation procedure assumes that you are installing from a CD-ROM. If you purchased and downloaded ColdFusion Server, place the tar.gz file into its own directory, and follow the install procedure below, substituting the location to which you downloaded ColdFusion Server for references to the CD-ROM.

  • Page 73: Coldfusion Server Processes

    Installing ColdFusion Server in HP-UX When the installation is complete, the install program starts the ColdFusion Server services. If you are running a version of the Netscape/iPlanet Web server, the install program also configures the Web server to run ColdFusion Server and restart the Web server automatically.

  • Page 74: Configuring Your Installation

    Chapter 4 Installing ColdFusion Server in HP-UX Configuring Your Installation After installation, may have to configure HP-UX to work with ColdFusion Server. This section addresses the following topics: Configuring Web servers manually Configuring databases Configuring Web servers manually If you did not configure your Web server automatically during ColdFusion Server installation, you must configure it manually.
  • Page 75 Configuring Your Installation Note If you run 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 in “Configuring Your Installation”...

  • Page 76: Configuring Databases

    Chapter 4 Installing ColdFusion Server in HP-UX Open src/Makefile in a text editor. Find the following line: LIBS1= -lcl -lm -lpthread If it does not contain , add it. -lcl b Save the file. After performing Steps 4 and 5, you must rebuild Apache and then re-install the new configuration.
  • Page 77 Configuring Your Installation 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 Yes (Tested using Oracle 8.04 and 8.16 clients) and 8.16 clients) Oracle 7 No (Oracle client software No (Oracle client software unavailable on HP-UX 11.0)

  • Page 78: What To Do Next

    Chapter 4 Installing ColdFusion Server in HP-UX What to Do Next After installing ColdFusion Server and configuring your installation, you must perform some initial administration tasks using the ColdFusion Administrator, ColdFusion Server’s Web-based control console. For more information, see “Initial Administration Tasks”...

  • Page 79: Chapter 5 Basic Coldfusion Server Administration

    Chapter 5 Basic ColdFusion Server Administration Structured according to ColdFusion Administrator categories, this chapter explains basic ColdFusion Server administration tasks. Contents Initial Administration Tasks ..................68 The ColdFusion Administrator ................69 Server Settings ......................70 Caching ........................71 Client Variables......................72 Memory Variables .....................

  • Page 80: Initial Administration Tasks

    Chapter 5 Basic ColdFusion Server Administration Initial Administration Tasks Immediately after installing ColdFusion Server, you may have to perform some or all of the administrative tasks described in the following table: Task Description Establish ColdFusion applications require data source connections to query database and write to databases.

  • Page 81: The Coldfusion Administrator

    The ColdFusion Administrator The ColdFusion Administrator You use the Administrator to perform administrative tasks for the ColdFusion Server, such as adding and configuring a data source, or scheduling application page execution, and configuring security settings. During the ColdFusion Server installation process, you specify an Administrator password that is used to prevent unauthorized access to the Administrator pages.

  • Page 82: Server Settings

    Chapter 5 Basic ColdFusion Server Administration Server Settings The Server Settings page of the Administrator contains configuration options you can set or enable to manage ColdFusion Server. They can significantly affect server performance. Use the following table to learn more about the option: Option Description Limit simultaneous...

  • Page 83: Caching

    Caching Caching The Caching Settings page of the Administrator contains configuration options that you can set or enable to cache templates, queries, and data sources They can significantly affect server performance. Use the following table to learn more about the options: Option Description Template cache...

  • Page 84: Client Variables

    Chapter 5 Basic ColdFusion Server Administration Client Variables Client variables let you perform tasks like determining the IP address of a site visitor’s Web browser. Using information from client variables, you can customize page content for individual users. You enable client variable default settings in ColdFusion Server on the Client Variables page of the Administrator.
  • Page 85 Client Variables Note If you use the registry to store client variables, ensure that enough memory is allocated for it. To enable client variable storage in the registry as the default: In the Client Variables page, select Registry. Click Apply. To display a page in which to enable the automatic deletion of variables that have not been used for a specified number of days, click Registry.

  • Page 86: Migrating Client Variable Data

    Chapter 5 Basic ColdFusion Server Administration Note If a cluster of ColdFusion Servers uses this data source, ensure that only one server is configured to purge client data. Migrating Client Variable Data To migrate your client variable data to another data source, you should know the structure of the database tables used to store this information.
  • Page 87 Client Variables <CFQUERY NAME="data2" DATASOURCE="#DSN#"> CREATE UNIQUE INDEX id1 ON CDATA (cfid,app) </CFQUERY> <CFQUERY NAME="global1" DATASOURCE="#DSN#"> CREATE TABLE CGLOBAL cfid char(20), data memo, lvisit date </CFQUERY> <CFQUERY NAME="global2" DATASOURCE="#DSN#"> CREATE INDEX id2 ON CGLOBAL (cfid) </CFQUERY> <CFQUERY NAME="global2" DATASOURCE="#DSN#"> CREATE INDEX id3 ON CGLOBAL (lvisit) </CFQUERY>...

  • Page 88: Memory Variables

    Chapter 5 Basic ColdFusion Server Administration Memory Variables You use the Memory Variables page of the ColdFusion Administrator to enable application and session variables server-wide. By default, application and session variables are enabled when you install ColdFusion Server. If you disable either type of variable in the Memory Variables page, you cannot use them in a ColdFusion application.

  • Page 89: Locking

    Locking Locking You use the Locking page of the ColdFusion Administrator to configure automatic mechanisms to protect shared data from incorrect access and corruption. In addition, the tag provides granular control of simultaneous access to shared cflock data scope variables, including server, application, and session scopes. For more information on the tag, see Developing ColdFusion Applications cflock...
  • Page 90 Chapter 5 Basic ColdFusion Server Administration Note Apply full checking and automatic read locking only to applications that use the scope attribute, not the name attribute, of the tag to specify locks. If you cflock specify the name attribute with full checking enabled, ColdFusion Server responds with an error on a variable accessed within the scope of a tag scope.

  • Page 91: Mappings

    Mappings Mappings You use the Mappings page of the ColdFusion Administrator to add, update, and delete logical aliases for paths to directories on your server and to change the root "/" mapping. This alias usually points to the Web root. ColdFusion mappings apply only to pages processed by the ColdFusion Server with tags.

  • Page 92: Mail/Mail Logging

    Chapter 5 Basic ColdFusion Server Administration Mail/Mail Logging You use the ColdFusion Administrator Mail page of the ColdFusion Administrator to specify a mail server to send automated e-mail messages. ColdFusion Server supports the Simple Mail Transfer Protocol (SMTP) for sending e-mail and the Post Office Protocol (POP) for retrieving e-mail from your mail server.
  • Page 93 Mail/Mail Logging Mail Logging Select preferences for handling mail logs, as described in the following table: Setting Description Error Log Severity From the drop-down list box, select the type of SMTP-related error message to write to a log file. The options are: Warning, Information, and Error.

  • Page 94: Data Sources

    Chapter 5 Basic ColdFusion Server Administration Data Sources The Data Sources section of the Administrator is the interface between you, ColdFusion Server, databases, and Verity search and indexing features. The following table describes some common tasks that you can perform in the Data Sources sectionof the Administrator: Task Description...

  • Page 95: Verity Collections

    Verity Collections Verity Collections The Verity Development Kit (VDK) provides indexing and searching technology to create, populate, and manage collections of indexed data that are optimized for fast and efficient site searches. It is available on the Verity Collections page. A collection is a logical group of documents and metadata about the documents.

  • Page 96: Managing Collections

    Chapter 5 Basic ColdFusion Server Administration To populate a collection: On the Verity Collections page, in the Connected Verity Collections table, select a collection to populate. Click Index. The ColdFusion Administrator page displays with the selected collection name at the top. Review the extensions in the File Extensions field.
  • Page 97 Verity Collections Note Before performing management operations, ensure that the K2 Server is not using the collections. For more information, see the K2 Server documentation in Advanced ColdFusion Administration book. The following table describes the options: Option Description Repair Re-indexes a collection to fix broken links and update indexes Optimize Reclaims space left by deleted and changed files by consolidating collection indexes for faster searching.

  • Page 98: Verity Supported File Types

    Chapter 5 Basic ColdFusion Server Administration To delete a collection: On the Verity Collections page, select a collection from the Connected Verity Collections table. Click Delete. A verification message displays warns you that deleting a collection cannot be undone. Click OK. When the delete is complete, a confirmation statement displays above the table.
  • Page 99 Verity Collections Document Type Format or Program Version Presentation Corel Presentations 7.0, 8.0 Lotus Freelance 96, 97 Microsoft PowerPoint 4.0, 95, 97, 2000 * Not Supported in Linux.

  • Page 100: Debug Settings

    Chapter 5 Basic ColdFusion Server Administration Debug Settings You use the Debug Setting and Debugging IPs pages of the Administrator to configure ColdFusion Server to provide debugging information for every application page requested by a browser. You specify debugging preferences using these pages: On the Debugging Options page, select debugging output options.

  • Page 101: Debugging Ips

    Debug Settings Debugging IPs You use the Debugging IPs page to restrict debugging output to one or more IP addresses. You can add and remove IP addresses. Warning If you do not specify IP addresses and debugging options are active, debug output displays for all users.

  • Page 102: Automated Tasks

    Chapter 5 Basic ColdFusion Server Administration Automated Tasks You use the Automated Tasks pages of the Administrator to schedule the execution of local and remote Web pages and to generate static HTML pages. The scheduling facility is useful for applications that do not require user interactions or customized output.
  • Page 103 Automated Tasks In the Schedule to Run section, select one of the options described in the following table: Option Description One Time Runs the task once, at a time (HH:MM:SS) in 24 hour format specified in the Start Time text box on the date (MM/DD/YY) specified in the Start Date text box.
  • Page 104 Chapter 5 Basic ColdFusion Server Administration The following table lists the optional settings in the Schedule Task page: Setting Description Username Specifies whether the server to which the URL points requires user authentication Password Specifies whether the server to which the URL points requires user authentication Request A time, in seconds, to wait for a reply...

  • Page 105: Extensions

    Extensions Extensions You use the Extensions pages of the Administrator to configure ColdFusion Server to work with other technologies, such as Java and CORBA. These pages make up the Administrator Extensions section: JVM and Java Settings Java Applets CFX Tags Custom Tag Paths CORBA Connectors JVM and Java Settings...

  • Page 106: Java Applets

    Chapter 5 Basic ColdFusion Server Administration Java Applets The Java Applets page of the Administrator lets you register applets and modify and delete applet registrations. Before you can use Java applets in your ColdFusion applications, you must register them in the Java Applets page. When your applet is registered with ColdFusion Server, using the tag in cfapplet...

  • Page 107: Cfx Tags

    Extensions The Java applet displays in the Registered Java Applets table on the Java Applets page. To modify a Java applet registration: In the Registered Java Applet page, click a Java applet name. In the Add/Registered Java Applet page, change any setting. Click Submit Changes.

  • Page 108: Cfx Tag Samples

    Chapter 5 Basic ColdFusion Server Administration To register Java CFX tag: On the CFX Tags page, click Register Java CFX. The Add/Edit Java CFX tag page displays. Enter options for the following settings; Setting Description Tag Name Tag name, which must be prefaced with CFX_ Class Name File name for the Java class, with no .class extension Description...

  • Page 109: Custom Tag Paths

    Extensions Custom Tag Paths You use the Custom Tag Paths page of the Administrator to add and delete custom tag directory paths. You must register the directories that contain custom tags. To add a custom tag path: On the Custom Tag Paths page, enter the file path to the directory that contains custom tags, or click Browse Server to navigate to the directory.
  • Page 110 Note Macromedia will provide implementations of the connectors for some of the popular Orbs. For those that are not supported, Macromedia will make the source available under NDA to a select group of third-party candidates and/or Orb vendors. To add a CORBA connectors: On the CORBA connections page, click Register CORBA Connector.

  • Page 111: Security

    Security Security The Security section of the Administrator, accessed by clicking the Security tab at the top of the left navigation bar, lets you configure the Basic and Advanced Security frameworks of ColdFusion Server. Basic Security The Basic Security framework activates by default during ColdFusion Server installation, in the Professional and Enterprise editions.

  • Page 112: Basic Security

    Chapter 5 Basic ColdFusion Server Administration Basic Security The Basic Security section of the Administrator provides these pages to configure ColdFusion Server basic security: Page Description CF Admin Password Lets you assign and change passwords for the ColdFusion Administrator Tag Restrictions Lets you restrict the use of specific tag and tag attributes CF Studio Password Lets you assign and change passwords for ColdFusion Studio...

  • Page 113: Cf Studio Password

    Basic Security Warning If you change the directory from the default ColdFusion Server directory and you disable the tag, you cannot use the ColdFusion Administrator. To regain cfregistry access to the Administrator, modify the registry to return the directory to normal. You can restrict access to the following tags: cfcontent cfdirectory...

  • Page 114: Tools

    Chapter 5 Basic ColdFusion Server Administration Tools The Tools section of the Administrator, accessed by clicking the Tools tab at the top of the left navigation bar, provides administrative features in ColdFusion Server Enterprise Edition, for managing Web site specific files, configurations, and applications The following table describes some of the common tasks that you can perform in the Data Sources section:...

  • Page 115: Logs And Statistics

    Logs and Statistics Logs and Statistics The Logs and Statistics section of the Administator includes pages that help you monitor ColdFusion Server and ColdFusion application activity. The following table describes these pages: Page Description Logging Settings Lets you configure administrator e-mail address, change the log directory, control operating system logging, and enable log file format Log files...

  • Page 116: Log Files

    Chapter 5 Basic ColdFusion Server Administration Log files The Log Files page of the Administrator lets you perform operations on log files, such as viewing, downloading, scheduling, archiving, and deleting. The Log File page icons, located in the Controls column of the Available Log Files table, can be used to perform all log file actions.
  • Page 117 Logs and Statistics To archive a log file: In the Available Log Files table, click the Archive Log file icon for a log file. The archive disappears from the Available Log File table. The log is saved in the log directory of ColdFusion Server To delete a log file: In the Available Log Files table, click the Delete Log File icon for the log file.
  • Page 118 Chapter 5 Basic ColdFusion Server Administration Description proxy.log Records messages related to the security server proxy. cfadmin.log Records Administrator operations. install.log* Records installation information. server.stdout* Records the standard output of the process. cfserver rdsservice.stdout* Records the standard output of the process.

  • Page 119: Server Reports

    Logs and Statistics ColdFusion Server 4.5 and earlier format ColdFusion Server 4.5 and earlier releases used file formats in which each column was enclosed by a set of quotation marks. The following table describes the layout: Column Field Order Type Field Description Severity Severity level:...
  • Page 120 Chapter 5 Basic ColdFusion Server Administration You can filter server reports by time frame, dates, and interval. The following table lists the options: Parameter Option Timeframe Anytime Specified Range (used in conjunction with Dates option) Today Last Two Days Last Three Days One Week Two Weeks One Month...

  • Page 121: Chapter 6 Managing Data Sources

    Chapter 6 Managing Data Sources ColdFusion allows you to rapidly develop dynamic Web applications—that is, applications that interact with databases. Before you can use a database in a ColdFusion application, you must register the data source in the ColdFusion Administrator. This chapter describes how to create and configure ColdFusion data sources for SQL Server, Access, and Oracle databases.

  • Page 122: About Coldfusion Data Sources

    Chapter 6 Managing Data Sources About ColdFusion Data Sources For ColdFusion developers, the term data source can refer to a number of different types of structured content accessible locally or across a network. You can query Web sites, LDAP servers, POP mail servers, and documents in a variety of formats. Most commonly though, a database drives your applications, so for this discussion, a data source is defined as the entry point for database operations.

  • Page 123: Supported Database Drivers

    Supported Database Drivers Supported Database Drivers ColdFusion uses Open DataBase Connectivity (ODBC), OLE DB, and native database drivers to interact with data sources. However, not all ColdFusion Server editions support all database drivers. ColdFusion Professional edition is limited to ODBC on Linux and to ODBC and OLE DB on Win32.
  • Page 124 Microsoft Visual MDAC Microsoft FoxPro Text MDAC Microsoft Native IBM DB2 Macromedia 5.2.0 IBM DB2 Macromedia 6.1 Informix Macromedia 7.x, 9.x Oracle 7.3.4 Macromedia 7.3.0 Oracle 8.0 Macromedia 8.0.4.0.0, Sybase Macromedia System 11, 12 OLE DB Microsoft.Jet.ODBC MDAC Microsoft (8.0.4.0.0 client libraries) SQLOLEDB (7.3.3...

  • Page 125: What To Do Next

    Supported Database Drivers What to do next To use an existing database with your ColdFusion applications, you need to register or create the data source using the ColdFusion Administrator. If you are using a DB2, Informix, Oracle, or Sybase database and want to take advantage of the ColdFusion native drivers, you also need to install and configure database client software.

  • Page 126: Choosing The Correct Drivers

    Chapter 6 Managing Data Sources Choosing the Correct Drivers ColdFusion uses ODBC, OLE DB, and native database drivers to communicate with a wide variety of popular database programs. This section introduces each type of driver so you can decide which one best suits your needs. About ODBC drivers Any valid ODBC data source already installed on your system is automatically available to your ColdFusion applications.

  • Page 127: Adding Data Sources For Coldfusion

    Adding Data Sources for ColdFusion Adding Data Sources for ColdFusion The process for adding a data source in the ColdFusion Administrator is the same, whether you use an ODBC, OLE DB, or native driver. The following procedure adds an ODBC data source that uses a SQL Server driver. To add a data source to ColdFusion: Open the ColdFusion Administrator.
  • Page 128 Chapter 6 Managing Data Sources The Create Data Source page displays: Enter the appropriate information about the new data source. The information that you enter depends on the platform on which you installed ColdFusion and on the driver you specify. For information about options for your driver, see the section for your specific database.
  • Page 129 Adding Data Sources for ColdFusion (Optional) Click CF Settings and specify ColdFusion-specific settings. For more information, see “ColdFusion Settings” on page 118. Click Create to create the data source. ColdFusion automatically verifies that it can connect to the data source. If ColdFusion cannot verify the data source, the Status displays Failed.

  • Page 130: Coldfusion Settings

    Chapter 6 Managing Data Sources Note You may have to supply a username and password for data sources that you want to verify. To define a username and password for a data source, edit the data source properties. If you are creating a UNIX data source, you may have to set environment variables for your database client library by editing the ColdFusion start script in <installdir>/ coldfusion/bin.
  • Page 131 Adding Data Sources for ColdFusion Setting Description Connection Timeout Specify the maximum number of minutes after the database connection is made that you want ColdFusion to cache a connection after it is used. This is different from the server setting to Limit database connection inactive time, located under Server Settings >...

  • Page 132: Verifying Coldfusion Data Sources

    Chapter 6 Managing Data Sources Verifying ColdFusion Data Sources When you add or update a ColdFusion data source, the ColdFusion Administrator automatically attempts to verify the connection. A verified connection means that the data source is available to your ColdFusion application pages. The ColdFusion Administrator includes a facility for verifying some or all ColdFusion data sources of a particular type (ODBC, OLE DB, or native drivers) at any time.

  • Page 133: Connecting To Microsoft Sql Server Databases

    Connecting to Microsoft SQL Server Databases Connecting to Microsoft SQL Server Databases ColdFusion lets you access SQL Server databases from Windows NT and UNIX, using ODBC and OLE DB drivers. Configuring Microsoft SQL Server Options (Windows) If you install the ColdFusion Server on a Windows NT server, you can configure Microsoft SQL Server as a ColdFusion data source using an ODBC or an OLE DB driver.

  • Page 134: Configuring Microsoft Sql Server Options (Unix)

    Chapter 6 Managing Data Sources Configuring Microsoft SQL Server Options (UNIX) If you install ColdFusion Server on a UNIX server, you can configure Microsoft SQL Server as a ColdFusion data source using an ODBC driver. The following table describes ColdFusion options for the MERANT MS SQL Server ODBC driver.

  • Page 135: Connecting To Microsoft Access Databases

    Connecting to Microsoft Access Databases Connecting to Microsoft Access Databases ColdFusion lets you access Microsoft Access databases on Windows NT, using ODBC and OLE DB drivers. Microsoft Access is a desktop database, and is not intended or designed for high-volume, multiuser use. For more information about using Microsoft Access in your application, see the Knowledge Base article #564, “Using Microsoft Access Databases in a Production Environment.”For information on securing Access and other file-based databases,...

  • Page 136: Tips For Connecting To Microsoft Access (Windows)

    Chapter 6 Managing Data Sources Option Description Driver Settings Page Timeout The number of milliseconds before a request for a ColdFusion page times out. Buffer Size The total number of bytes that ColdFusion uses to cache application pages. Enter a value to optimize ColdFusion performance.

  • Page 137: Connecting To Remote Access Data Sources

    Connecting to Microsoft Access Databases Connecting to Remote Access Data Sources When you develop your ColdFusion application, your Access data source could be a local one. In many cases, your application might need to connect to data sources that are not local. This section addresses some concerns for remote connections. Note This discussion also applies to many other file-based databases, such as dBASE, FoxPro, and Paradox.
  • Page 138 Chapter 6 Managing Data Sources Note For an Access database, point to the mdb file. For other file-based databases, such as dBASE/FoxPro, point to the directory that contains the database files. Select Control Panel > Services > Cold Fusion Application Server > StartUp > LogOnAs >...

  • Page 139: Connecting To Oracle Databases

    Connecting to Oracle Databases Connecting to Oracle Databases You can configure Oracle ColdFusion data sources for Windows NT and UNIX using ODBC and native drivers. Note ColdFusion supports Oracle 7.3.4 and Oracle 8.0.4 and later. Configuring Oracle 7.3.4/8.0.x options (Windows) If you install ColdFusion Server Enterprise Edition on a Windows NT server, you can configure an Oracle data source using a native driver.

  • Page 140: Connecting To Oracle 7.3.4 And 8.0.X Databases (Unix)

    Chapter 6 Managing Data Sources ODBC drivers: MERANT Oracle 7.3.4 and Oracle 8.0.x options (UNIX) The following table describes ColdFusion ODBC driver options for the MERANT Oracle 7.3.4 and MERANT Oracle 8.0.x ODBC drivers on UNIX: Option Description Data Source Name A name for your data source.
  • Page 141 Connecting to Oracle Databases Example This is an example of a tnsnames.ora file: scup= (DESCRIPTION= (ADDRESS= (PROTOCOL=TCP) (HOST=scup) (PORT=1521)) (CONNECT_DATA=(SID=WG73))) The following table describes the code: Code Description scup= Setting for the connect string name in the ColdFusion Administrator. HOST=scup The IP address, as in HOST=205.185.22.33.

  • Page 142: Connecting To Oracle 8.0.X Through Odbc (Unix)

    Chapter 6 Managing Data Sources The environment variables CFHOME and ORACLE_HOME are assumed to point to the ColdFusion installation directory (usually /opt/coldfusion) and the Oracle Client Software installation directory (for example, /opt/oracle8). Use the genclntsh script provided by Oracle in the $ORACLE_HOME/rdbms/lib directory and follow the Oracle instructions to build the libclntsh.so library in the $ORACLE_HOME/lib directory.

  • Page 143: Troubleshooting The Oracle 7.3.4 Native Driver (Windows)

    Connecting to Oracle Databases LD_LIBRARY_PATH=/lib:/usr/dt/lib:/usr/openwin/lib:$CFHOME/ lib:$ORACLE_HOME/lib;export LD_LIBRARY_PATH From $CFHOME/odbc/src/oracle run the script./genclntsh8. The script generates a new libclntsh.so in CFHOME; move it to $CFHome/lib. Note Oracle 8 users have the original libclntsh.so library in the $ORACLE_HOME/lib directory. Therefore when creating the LD_LIBRAY_PATH in the $CFHOME/bin/ start script, the $CFHOME/lib directory, containing the correct library, must be on the LD_LIBRARY_PATH before $ORACLE_HOME/lib.
  • Page 144 Chapter 6 Managing Data Sources Before you get started, make sure you have the following information handy: The name of the host system where the Oracle database resides The System Identifier (SID) for your Oracle 8 database A login ID and password for connecting to the Oracle 8 database To use the ColdFusion native driver for Oracle 8: Install the required client software.
  • Page 145 Connecting to Oracle Databases Enter a New Service Name and click Next. In the dialog box, select TCP/IP as the networking protocol to connect with. Select the Oracle 8 database that you want to use in your ColdFusion application. In the dialog box, enter the host name of the server where the Oracle 8 database resides.
  • Page 146 Chapter 6 Managing Data Sources Creating the data source in ColdFusion Now you need to create the data source in ColdFusion. To create the data source: Open the ColdFusion Administrator to the Data Sources, Native Drivers page. Enter a data source name and select the Oracle 8 native driver from the drop-down list.

  • Page 147: Chapter 7 Preparing Your Server For Clustercats

    Appendix Preparing Your Server for ClusterCATS This appendix introduces ClusterCATS, the software-based load-balancing features included with ColdFusion Server 5 Enterprise Edition. Read the following sections to learn more about preparing your server for clustering and post-installation tasks. Contents Before You Install ColdFusion Server ..............136 After You Install ColdFusion Server ...............

  • Page 148: Before You Install Coldfusion Server

    Appendix Preparing Your Server for ClusterCATS Before You Install ColdFusion Server Before installing ColdFusion Server 5 and ClusterCATS, you should perform the following pre-installation tasks: Configuring DNS servers Configuring Web server IP address fail-over Using ClusterCATS dynamic IP addressing Enabling the STREAMS protocol (Windows NT only) Configuring firewalls Analyzing Web server content Considering domain controllers (Windows NT only)
  • Page 149 Before You Install ColdFusion Server Reverse translation entries (PTR records) are just the opposite and look like this: IP Address 192.168.0.1 www1.company.com 192.168.0.2 www2.company.com It is important that you configure your Web sites to have forward and reverse DNS entries on your primary DNS server. If you are not responsible for maintaining your primary DNS server, tell your DNS administrator to add both forward and reverse entries for your explicit Web server names (www1.company.com, www2.company.com, and so on).
  • Page 150 Appendix Preparing Your Server for ClusterCATS Configuring the primary DNS server You must configure DNS so that the forward and reverse lookup translation entries are entered and registered correctly with your primary DNS server. To accomplish this, you must define required DNS records (A records and PTR records) for your Web servers on your primary DNS server.

  • Page 151: Configuring Web Server Ip Address Fail-Over

    Before You Install ColdFusion Server Host Name IP Address www.company.com 193.168.0.3 www.company.com 193.168.0.4 www1.company.com 193.168.0.1 www2.company.com 193.168.0.2 www3.company.com 193.168.0.3 www4.company.com 193.168.0.4 IP Address Host Name 193.168.0.1 www1.company.com 193.168.0.2 www2.company.com 193.168.0.3 www3.company.com 193.168.0.4 www4.company.com Round-robin DNS distributes the initial domain-level requests across all four servers.

  • Page 152: Using Clustercats Dynamic Ip Addressing

    Appendix Preparing Your Server for ClusterCATS Using ClusterCATS dynamic IP addressing The ClusterCATS software can be configured to dynamically enable the IP address(es), associated with a Web site(s), while it is running. While the ClusterCATS software is stopped on the local system, the IP address will not be enabled on that system but might migrate to another server participating in the same cluster where IP address fail-over support has been installed.
  • Page 153 Before You Install ColdFusion Server Click the Protocols tab. Click Add. The Select Network Protocol dialog box displays. Select STREAMS Environment from the list of available network protocols and click OK. Close the Network dialog box. Windows NT prompts you to restart your computer.

  • Page 154: Configuring Firewalls

    Appendix Preparing Your Server for ClusterCATS Configuring firewalls Many corporate environments today rely on firewalls to securely control access to proprietary knowledge that resides on public Internet sites, intranet sites, or private extranet sites. You can configure ClusterCATS to work across one or more firewalls. A common technique is to use Network Address Translation (NAT) as a security precaution on your firewall.
  • Page 155 Before You Install ColdFusion Server Internal Forward Reverse Server 1 FQHN www1.company.com 192.168.0.10 192.168.0.10 www1.company.com Server 2 FQHN www2.company.com 192.168.0.20 192.168.0.20 www2.company.com Note Do not set up any internal round-robin entries. Also, static IP addresses are recommended in lieu of dynamic IP address when clustering behind any load-balancing or translating hardware.
  • Page 156 Appendix Preparing Your Server for ClusterCATS If you manage your cluster from behind another firewall, you must open both ports so that the ClusterCATS Explorer can communicate with the cluster. The following diagram illustrates this scenario: As you can see, this scenario involves Company ABC, which has an East Coast and a West Coast group of servers connected to the Internet and protected by several firewalls.

  • Page 157: Analyzing Web Server Content

    Before You Install ColdFusion Server Analyzing Web server content All Web servers, virtual server, or Web sites in the same cluster must have identical content. The default document specified for each Web server in the cluster should be the same on all cluster members; for example, set the default document to default.jsp. Considering domain controllers (Windows NT only) If you are using Windows NT Domain server authentication, then each Web server in a cluster must participate as a member NT server in a domain.

  • Page 158: After You Install Coldfusion Server

    Appendix Preparing Your Server for ClusterCATS After You Install ColdFusion Server After you successfully install ColdFusion Server 5 on all members of the cluster and any administrative systems, you are ready to create your first cluster. If you are administering ClusterCATS from a Windows NT system, then you can use the Cluster Setup Wizard or manually create the cluster.
  • Page 159 After You Install ColdFusion Server Option Description Administering with the If you are using a UNIX system to administer your cluster ClusterCATS Web with the ClusterCATS Web Explorer, you must configure Explorer your Web server to host the Web Explorer pages. For more information, see Advanced ColdFusion Administration.
  • Page 160 Appendix Preparing Your Server for ClusterCATS...

This manual is also suitable for:

Coldfusion server 5

Table of Contents