MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER Manual
Summary of COLDFUSION 5 - INSTALING AND CONFIGURING SERVER
Page 1
Macromedia, inc. Installing and configuring coldfusion server coldfusion server 5 install.Book page i thursday, may 10, 2001 12:59 pm.
Page 2: Copyright Notice
Copyright notice © 2001 macromedia inc. All rights reserved. This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The content of this manual is furnished for informational use only, is subject to...
Page 3: Contents
Contents welcome to coldfusion server . . . . . . . . . . . . . . . . . . . Vii intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viii new features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
Page 4: . . .
Iv chapter 2 installing coldfusion server in solaris . . . 23 solaris system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 before you begin the installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 r...
Page 5
V coldfusion server processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 configuring your installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 configuring web servers manually . . . . . . . . . . . . . . . . . ....
Page 6: 109
Vi tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 logs and statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 logging settings . . . . . ....
Page 7: Welcome to Coldfusion Server
Welcome to coldfusion server installing and configuring coldfusion server is intended for server administrators and anyone who is new to coldfusion server and needs to install and configure coldfusion server 5. Contents • intended audience ...............................................................
Page 8: Intended Audience
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 syst...
Page 9
New features ix easy managment application deployment services effortlessly and reliably deploy, archive, or restore entire applications using coldfusion archive files. Enhanced application monitoring keep track of server performance and availability with customizable alerts and recovery. Snmp suppo...
Page 10: Developer Resources
X 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 ...
Page 11: Viewing Online Documentation
About coldfusion documentation xi 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 o...
Page 12: Getting Answers
Xii 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 ho...
Page 13: Contacting Macromedia
Contacting macromedia xiii contacting macromedia corporate headquarters macromedia, inc. 600 townsend street san francisco, ca 4103 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...
Page 14
Xiv welcome to coldfusion server install.Book page xiv thursday, may 10, 2001 12:59 pm.
Page 15: Installing Coldfusion Server
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...............
Page 16: Windows System Requirements
4 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: requirement coldfusion server professional coldfusion server enterprise windows version windows 98 x wi...
Page 17
Before you begin the installation 5 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 previo...
Page 18: Server
6 chapter 1 installing coldfusion server in windows installing snmp in windows nt 4.0 server and windows 2000 server managed data is accessible in coldfusion server 5 enterprise edition through the simple network management protocol (snmp) management information base (mib) for advanced coldfusion ap...
Page 19
Before you begin the installation 7 after finishing the coldfusion server installation, you must configure your system to use the mib features. For more information, see “configuring snmp mib” on page 19 . Important network considerations the following table includes important considerations to keep...
Page 20: Server 5
8 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 ...
Page 21
Before you begin the installation 9 a dialog box displays a list coldfusion server components. 2 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 com...
Page 22
10 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 ente...
Page 23: Coldfusion Server Services
Installing coldfusion server in windows 11 the following table lists important installation options and considerations for coldfusion enterprise edition customers: warning because of potential security concerns, the coldfusion server team recommends that you not install the example applications in p...
Page 24
12 chapter 1 installing coldfusion server in windows starting and stopping coldfusion server services 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, thread count, and s...
Page 25
Installing coldfusion server in windows 13 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 t...
Page 26
14 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 manual...
Page 27
Configuring your installation 15 the mmc displays: 2 in the tree tab, under the internet information services tree, right-click your web site and select properties. The properties dialog box displays: 3 click the home directory tab, then configuration. Note if the configuration button is greyed out,...
Page 28
16 chapter 1 installing coldfusion server in windows the application configuration dialog box displays: 4 in the app mappings tab, select entries for.Cfm and .Dbm, and click remove. 5 click add. The add/edit application extension mappings dialog box displays: 6 click browse and go to c:\cfusion\bin\...
Page 29
Configuring your installation 17 apache web server this procedure assumes that the apache web server is installed in c:\apache. To configure apache for coldfusion server: 1 if it is not already installed, download the apache web server from the apache http server project web site at http://www.Apach...
Page 30
18 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 p...
Page 31: Configuring Snmp Mib
Configuring your installation 19 configuring snmp mib to use the coldfusion server mib features, you must configure these settings: 1 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_l...
Page 32
20 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 applicatio...
Page 33: What To Do Next
What to do next 21 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 p...
Page 34
22 chapter 1 installing coldfusion server in windows install.Book page 22 thursday, may 10, 2001 12:59 pm.
Page 35: Installing Coldfusion Server
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...........
Page 36: Solaris System Requirements
24 chapter 2 installing coldfusion server in solaris solaris system requirements the following table contains the system requirements for the coldfusion server enterprise edition: requirement coldfusion server enterprise solaris version solaris 2.6, 7, 8 x hardware processor sparc minimum ram (mb) 2...
Page 37
Before you begin the installation 25 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 ser...
Page 38
26 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 ca...
Page 39
Before you begin the installation 27 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 in...
Page 40
28 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 yo...
Page 41
Installing coldfusion server in solaris 29 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 th...
Page 42
30 chapter 2 installing coldfusion server in solaris 9 you are prompted to enter y to install the coldfusion server options. For each option that you want to install, enter y . The following table describes the options: 10 after supplying the directory for your web server documentation, entering and...
Page 43: Coldfusion Server Processes
Installing coldfusion server in solaris 31 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 coldfusio...
Page 44
32 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 p...
Page 45
Configuring your installation 33 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 serv...
Page 46
34 chapter 2 installing coldfusion server in solaris 5 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, ...
Page 47
Configuring your installation 35 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 /apache/bin. This is a perl script, so you must have perl in...
Page 48: Configuring Snmp Mib
36 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: 1 stop the snmp process by entering the following command: /etc/init.D/init.Snmpdx stop kill -9 2 in...
Page 49: Configuring Databases
Configuring your installation 37 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 data...
Page 50: What To Do Next
38 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 “...
Page 51: Installing Coldfusion Server
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................
Page 52: Linux System Requirements
40 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: requirement coldfusion server professional coldfusion server enterprise linux distribution red hat linux 6...
Page 53
Before you begin the installation 41 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 ser...
Page 54
42 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. 1 download ucd-snmp 4.2.1 from http://net-...
Page 55
Before you begin the installation 43 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: • usin...
Page 56
44 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 /opt directory. To install coldfusi...
Page 57
Installing coldfusion server in linux 45 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 stud...
Page 58: Coldfusion Server Processes
46 chapter 3 installing coldfusion server in linux coldfusion server processes the coldfusion server installation creates the following processes in linux: starting and stopping coldfusion server processes in general, you should stop and restart coldfusion server after making changes in the coldfusi...
Page 59
Installing coldfusion server in linux 47 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 duri...
Page 60
48 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 configur...
Page 61
Configuring your installation 49 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 ...
Page 62
50 chapter 3 installing coldfusion server in linux to configure suse/cobalt and apache: 1 to check whether your version of apache is built with eapi, run this command: httpd -v if the output contains the line -d eapi , you are running an eapi server. (suse requires an eapi version of mod.Coldfusion....
Page 63: Configuring Snmp Mib
Configuring your installation 51 configuring snmp mib to use the coldfusion server mib features, you must configure the following settings. To configure red hat to use the mib agent: 1 stop the snmp server by entering the following command as root: /etc/rc.D/init.D/snmpd stop 2 for each server that ...
Page 64
52 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...
Page 65: What To Do Next
What to do next 53 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 p...
Page 66
54 chapter 3 installing coldfusion server in linux install.Book page 54 thursday, may 10, 2001 12:59 pm.
Page 67: Installing Coldfusion Server
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..................
Page 68: Hp-Ux System Requirements
56 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: requirement coldfusion server enterprise hp-ux version hp-ux 11.0 x hardware processor pa-risc 1.1 or 2.0 minimum ram 128 mb...
Page 69
Before you begin the installation 57 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 • uninstallin...
Page 70
58 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...
Page 71
Before you begin the installation 59 the cd-rom should be visible under /sd_cdrom . When you finish using the cd-rom, you can unmount it using the following command: /usr/sbin/pfs_umount /sd_cdrom uninstalling coldfusion server 5 use the cfremove utility to remove an installed version of coldfusion ...
Page 72
60 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, ...
Page 73: Coldfusion Server Processes
Installing coldfusion server in hp-ux 61 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 serv...
Page 74
62 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...
Page 75
Configuring your installation 63 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. 6 verify that coldfusi...
Page 76: Configuring Databases
64 chapter 4 installing coldfusion server in hp-ux 5 open src/makefile in a text editor. A find the following line: libs1= -lcl -lm -lpthread if it does not contain -lcl , add it. B save the file. 6 after performing steps 4 and 5, you must rebuild apache and then re-install the new configuration. Fo...
Page 77
Configuring your installation 65 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 softwa...
Page 78: What To Do Next
66 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 “in...
Page 79: Basic Coldfusion Server
Chapter 5 basic coldfusion server administration structured according to coldfusion administrator categories, this chapter explains basic coldfusion server administration tasks. Contents • initial administration tasks .....................................................................................
Page 80
68 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 database connections coldfusion applications r...
Page 81
The coldfusion administrator 69 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 in...
Page 82: Server Settings
70 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...
Page 83: Caching
Caching 71 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 te...
Page 84: Client Variables
72 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 defaul...
Page 85
Client variables 73 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: 1 in the client variables page, select registry. Click apply. 2 to display a page in which to enable the automa...
Page 86
74 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...
Page 87
Client variables 75 create unique index id1 on cdata (cfid,app) create table cglobal ( cfid char(20), data memo, lvisit date ) create index id2 on cglobal (cfid) create index id3 on cglobal (lvisit) install.Book page 75 thursday, may 10, 2001 12:59 pm.
Page 88: Memory Variables
76 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...
Page 89: Locking
Locking 77 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 cflock tag provides granular control of simultaneous access to shared data scope variables, including server, ap...
Page 90
78 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 cflock tag to specify locks. If you specify the name attribute with full checking enabled, coldfusion server respo...
Page 91: Mappings
Mappings 79 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 co...
Page 92: Mail/mail Logging
80 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 ...
Page 93
Mail/mail logging 81 mail logging select preferences for handling mail logs, as described in the following table: coldfusion server writes sent mail and mail error logs to the file: • \cfusion\log, in windows • \opt\coldfusion\log, in solaris, linux, and hp-ux the following table describes the e-mai...
Page 94: Data Sources
82 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...
Page 95: Verity Collections
Verity collections 83 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 ...
Page 96: Managing Collections
84 chapter 5 basic coldfusion server administration to populate a collection: 1 on the verity collections page, in the connected verity collections table, select a collection to populate. 2 click index. The coldfusion administrator page displays with the selected collection name at the top. 3 review...
Page 97
Verity collections 85 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: to repair a collection: 1 on the ve...
Page 98: Verity Supported File Types
86 chapter 5 basic coldfusion server administration to delete a collection: 1 on the verity collections page, select a collection from the connected verity collections table. 2 click delete. A verification message displays warns you that deleting a collection cannot be undone. 3 click ok. When the d...
Page 99
Verity collections 87 presentation corel presentations 7.0, 8.0 lotus freelance 96, 97 microsoft powerpoint 4.0, 95, 97, 2000 document type format or program version * not supported in linux. Install.Book page 87 thursday, may 10, 2001 12:59 pm.
Page 100: Debug Settings
88 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 p...
Page 101: Debugging Ips
Debug settings 89 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. To allow debug output to an ...
Page 102: Automated Tasks
90 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 interactio...
Page 103
Automated tasks 91 4 in the schedule to run section, select one of the options described in the following table: 5 in the operation drop-down list, select an operation for the scheduled task to perform. Httprequest is the only option. 6 if your web server requires a port to connect to the web, enter...
Page 104
92 chapter 5 basic coldfusion server administration the following table lists the optional settings in the schedule task page: to modify a scheduled task: 1 on the schedule task page, in the contents column of the scheduled task table, click a task name. The add/edit scheduled task page displays. 2 ...
Page 105: Extensions
Extensions 93 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 co...
Page 106: Java Applets
94 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 you...
Page 107: Cfx Tags
Extensions 95 the java applet displays in the registered java applets table on the java applets page. To modify a java applet registration: 1 in the registered java applet page, click a java applet name. 2 in the add/registered java applet page, change any setting. 3 click submit changes. The modifi...
Page 108: Cfx Tag Samples
96 chapter 5 basic coldfusion server administration to register java cfx tag: 1 on the cfx tags page, click register java cfx. The add/edit java cfx tag page displays. 2 enter options for the following settings; note the class file must be accessible from the class path set in the jvm and java setti...
Page 109: Custom Tag Paths
Extensions 97 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: 1 on the custom tag paths page, enter the file path to the directory that contains...
Page 110
98 chapter 5 basic coldfusion server administration 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 ad...
Page 111: Security
Security 99 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 col...
Page 112: Basic Security
100 chapter 5 basic coldfusion server administration basic security the basic security section of the administrator provides these pages to configure coldfusion server basic security: cf admin password you use the cf admin password of the administrator page to enable and disable password-restricted ...
Page 113: Cf Studio Password
Basic security 101 warning if you change the directory from the default coldfusion server directory and you disable the cfregistry tag, you cannot use the coldfusion administrator. To regain access to the administrator, modify the registry to return the directory to normal. You can restrict access t...
Page 114: Tools
102 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,...
Page 115: Logs and Statistics
Logs and statistics 103 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: logging settings you use the logging settings page of the administrat...
Page 116: Log Files
104 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...
Page 117: Coldfusion Server Log Files
Logs and statistics 105 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...
Page 118
106 chapter 5 basic coldfusion server administration coldfusion server log file format coldfusion server supports the following log file formats: • coldfusion server 5 format • coldfusion server 4.5 and earlier format coldfusion server 5 format by default, coldfusion server generates a new log file ...
Page 119: Server Reports
Logs and statistics 107 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: note if you use coldfusion server 4.5 or earlier or earlier, you cann...
Page 120
108 chapter 5 basic coldfusion server administration you can filter server reports by time frame, dates, and interval. The following table lists the options: click update to apply your changes. Parameter option timeframe • anytime • specified range (used in conjunction with dates option) • today • l...
Page 121: 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 h...
Page 122
110 chapter 6 managing data sources installing and configuring coldfusion server 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,...
Page 123: Supported Database Drivers
Supported database drivers 111 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...
Page 124
112 chapter 6 managing data sources installing and configuring coldfusion server microsoft access mdac microsoft p p microsoft excel mdac microsoft p p microsoft foxpro mdac microsoft p p microsoft sql server mdac microsoft p p microsoft visual foxpro mdac microsoft p p text mdac microsoft p p nativ...
Page 125: What To Do Next
Supported database drivers 113 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 n...
Page 126: About Odbc Drivers
114 chapter 6 managing data sources installing and configuring coldfusion server 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...
Page 127
Adding data sources for coldfusion 115 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...
Page 128
116 chapter 6 managing data sources installing and configuring coldfusion server the create data source page displays: 5 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...
Page 129
Adding data sources for coldfusion 117 6 (optional) click cf settings and specify coldfusion-specific settings. For more information, see “coldfusion settings” on page 118. 7 click create to create the data source. Coldfusion automatically verifies that it can connect to the data source. If coldfusi...
Page 130: Coldfusion Settings
118 chapter 6 managing data sources installing and configuring coldfusion server 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,...
Page 131
Adding data sources for coldfusion 119 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 s...
Page 132
120 chapter 6 managing data sources installing and configuring coldfusion server 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 availa...
Page 133
Connecting to microsoft sql server databases 121 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 ...
Page 134
122 chapter 6 managing data sources installing and configuring coldfusion server 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 c...
Page 135
Connecting to microsoft access databases 123 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 i...
Page 136
124 chapter 6 managing data sources installing and configuring coldfusion server tips for connecting to microsoft access (windows) whether you use ole db or odbc connections, the following suggestions can improve your access database connectivity: • in the coldfusion administrator: − select server s...
Page 137
Connecting to microsoft access databases 125 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 conc...
Page 138
126 chapter 6 managing data sources installing and configuring coldfusion server 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. 9 select control panel > services > cold fusion applicat...
Page 139: Options (Windows)
Connecting to oracle databases 127 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 ...
Page 140
128 chapter 6 managing data sources installing and configuring coldfusion server 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: connecting to orac...
Page 141
Connecting to oracle databases 129 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: when you complete all the steps in this section, you must stop and restart co...
Page 142: Oracle Troubleshooting
130 chapter 6 managing data sources installing and configuring coldfusion server 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)....
Page 143
Connecting to oracle databases 131 ld_library_path=/lib:/usr/dt/lib:/usr/openwin/lib:$cfhome/ lib:$oracle_home/lib;export ld_library_path 2 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...
Page 144
132 chapter 6 managing data sources installing and configuring coldfusion server 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 passw...
Page 145
Connecting to oracle databases 133 2 enter a new service name and click next. 3 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. 4 in the dialog box, enter the host name of the server where ...
Page 146
134 chapter 6 managing data sources installing and configuring coldfusion server creating the data source in coldfusion now you need to create the data source in coldfusion. To create the data source: 1 open the coldfusion administrator to the data sources, native drivers page. 2 enter a data source...
Page 147: Preparing Your Server For
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. Cont...
Page 148: Configuring Dns Servers
136 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 ...
Page 149
Before you install coldfusion server 137 reverse translation entries (ptr records) are just the opposite and look like this: 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 d...
Page 150
138 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 recor...
Page 151
Before you install coldfusion server 139 round-robin dns distributes the initial domain-level requests across all four servers. Thereafter, clustercats distributes load to avoid failed or overloaded servers. Note when using round-robin dns, do not define a reverse mapping (ptr record) for the site n...
Page 152
140 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 ad...
Page 153
Before you install coldfusion server 141 3 click the protocols tab. 4 click add. The select network protocol dialog box displays. 5 select streams environment from the list of available network protocols and click ok. 6 close the network dialog box. Windows nt prompts you to restart your computer. C...
Page 154: Configuring Firewalls
142 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 acr...
Page 155
Before you install coldfusion server 143 internal 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. 5 you should test name resolution using the following diag...
Page 156
144 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,...
Page 157
Before you install coldfusion server 145 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 defau...
Page 158
146 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 s...
Page 159
After you install coldfusion server 147 administering with the clustercats web explorer if you are using a unix system to administer your cluster with the clustercats web explorer, you must configure your web server to host the web explorer pages. For more information, see advanced coldfusion admini...
Page 160
148 appendix preparing your server for clustercats install.Book page 148 thursday, may 10, 2001 12:59 pm.