MACROMEDIA COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX Using Manual
  1. Manuals
  2. Brands
  3. MACROMEDIA Manuals
  4. Software
  5. COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION...
  6. Using manual
MACROMEDIA COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX Using Manual

MACROMEDIA COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX Using Manual

Hide thumbs Also See for COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Manual
Installing and Using ColdFusion MX

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX and is the answer not in the manual?

Questions and answers

Related Manuals for MACROMEDIA COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX

Summary of Contents for MACROMEDIA COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX

  • Page 1 Installing and Using ColdFusion MX...
  • Page 2 If you access a third-party website mentioned in this guide, then you do so at your own risk. Macromedia provides these links only as a convenience, and the inclusion of the link does not imply that Macromedia endorses or accepts any responsibility for the content on those third-party sites.

  • Page 3: Table Of Contents

    INTRODUCTION About Macromedia ColdFusion MX documentation ..... . . 5 Documentation set ..........5 Viewing online documentation.
  • Page 4 CHAPTER 3: Installing the J2EE Configuration ......31 J2EE application servers ..........32 Choosing EAR or WAR deployment .

  • Page 5: Introduction

    INTRODUCTION Installing and Using ColdFusion MX is intended for anyone who needs to install and configure ColdFusion MX 6.1. About Macromedia ColdFusion MX documentation The ColdFusion MX documentation is designed to provide support for the complete spectrum of participants. Documentation set...
  • Page 6 Introduction...

  • Page 7: Chapter 1: Essential Information

    CHAPTER 1 Essential Information This chapter describes Macromedia ColdFusion MX 6.1 product editions, system requirements, and other high-level considerations. Contents About the ColdFusion MX 6.1 installation ........8 ColdFusion MX 6.1 product editions .

  • Page 8: About The Coldfusion Mx 6.1 Installation

    About the ColdFusion MX 6.1 installation ColdFusion MX 6.1 provides a powerful and flexible installation and upgrade process. The ColdFusion MX 6.1 installation process includes the following phases: Plan the installation You determine your installation, configuration, and upgrade options. Run the installer You run the ColdFusion MX 6.1 installer.

  • Page 9: Coldfusion Mx 6.1 Product Editions

    Features full ColdFusion Markup Language (CFML) support, including: • Custom tags and ColdFusion Components • Full support for server-side ActionScript and Macromedia Flash Remoting • Extensibility and integration with Simple Object Access Protocol (SOAP) and Extensible Markup Language (XML), and with Component Object...

  • Page 10: System Requirements

    ColdFusion MX on a single computer. • Backup mail servers and multithreaded e-mail delivery. • HTTP-based load-balancing and failover using Macromedia ClusterCATS (installed separately) System requirements This section lists the system requirements for ColdFusion MX 6.1 for Windows and UNIX. Chapter 1: Essential Information...

  • Page 11: System Requirements For Windows

    System requirements for Windows This section lists the Windows system requirements for the Macromedia ColdFusion MX 6.1 Developer, Standard, and Enterprise Editions. An “x” in the following table means that the edition supports the requirement in that row. Developer Standard...
  • Page 12 SQLAnywhere£ PostgreSQL£ * ColdFusion MX only supports the built-in web server for this platform. Macromedia does not recommend using the built-in web server in a production environment. † To install ColdFusion MX in Windows NT 4.0, or Windows 2000, Windows XP, or Windows 2003, you must already have the following components installed: MDAC 2.6 SP2 (www.microsoft.com/data/download.htm) and the...

  • Page 13: System Requirements For Unix

    System requirements for UNIX This section lists the UNIX system requirements for the Macromedia ColdFusion MX 6.1 Developer, Standard, and Enterprise Editions. An “x” in the following table means that the edition supports the requirement in that row. Developer Standard...
  • Page 14 Developer Standard Enterprise Requirement Edition Edition Edition Apache web server 1.3.22–1.3.27, 2.0.43 or higher Netscape Enterprise Server 3.6x iPlanet 4.x SunONE Web Server 6.x (formerly iPlanet 6.x Java Virtual Machine (JVM) Note: ColdFusion MX 6.1 ships with the Sun 1.4.2 JVM. Sun JDK/JRE 1.3.1 or later IBM JVM 1.3 or later Browsers for ColdFusion MX Administrator...

  • Page 15: J2Ee Configuration Requirements

    This section lists additional system requirements for Windows and UNIX when running in the J2EE configuration. This information was up-to-date at the time this document was written. For any updates, see www.macromedia.com/go/cfmxj2ee-cert. Operating system and Java requirements The following table lists the J2EE application servers supported by ColdFusion MX when running in the J2EE configuration.

  • Page 16: Installation Considerations

    The following are installation considerations for all platforms: • Macromedia supports upgrading to ColdFusion MX 6.1 from ColdFusion MX (the installation functions as an updater), ColdFusion 4.5, and ColdFusion 5. If you are upgrading, you must back up your existing ColdFusion applications first.

  • Page 17: Installation Considerations For Windows

    • To interact with ColdFusion pages, components, and server-side ActionScript from a Macromedia Flash movie, use the Flash Remoting service in ColdFusion MX. To develop applications that use Flash Remoting, you must install the Flash Remoting components in the Flash MX authoring environment. The Flash MX authoring environment is required to build applications that connect to and interact with the Flash Remoting service in ColdFusion.

  • Page 18: Installation Considerations For Unix

    For troubleshooting purposes, the installer creates the following log file during an installation or upgrade on UNIX: cf_root/Macromedia_ColdFusion_MX_install.log. If you contact Macromedia Technical Support for installation support, you must send them this file. • If you are deploying the J2EE configuration on a platform other than Linux or Solaris, use the coldfusion-61-other.jar installer.

  • Page 19: Chapter 2: Installing The Server Configuration

    CHAPTER 2 Installing the Server Configuration This chapter describes how to install and uninstall ColdFusion MX 6.1 in the server configuration. The ColdFusion MX 6.1 server configuration contains an embedded copy of JRun and is most similar to previous ColdFusion versions. Note: In this chapter, cf_root refers to your installation directory.

  • Page 20: Installing Coldfusion Mx 6.1

    Installing ColdFusion MX 6.1 This section provides installation instructions for the ColdFusion MX 6.1 server configuration on Windows and UNIX. When installing the server configuration, you have the following options: • New installation Select this option if you do not have ColdFusion MX on the computer or if you have ColdFusion 4.5 or 5 on the computer.
  • Page 21 Question Answer UNIX Runtime user Default is nobody (HP-UX must change this value). For security reasons, it is crucial that you do not use root for the runtime user. Start at system startup (Solaris and Yes | No RedHat Linux only) After running the installer, you must complete the installation process by running the Configuration Wizard.

  • Page 22: Installing Coldfusion Mx 6.1 On Windows

    If you plan to configure an external web server, ensure that the web server is running. (Upgrade install only) Shut down all ColdFusion services. Insert the CD or download the setup file from the Macromedia website. If the installation wizard does not start automatically when you insert the CD, locate setup.exe on the CD and double-click it.

  • Page 23: Installing Coldfusion Mx 6.1 On Unix

    Open cf_root/lib/adminconfig.xml (server configuration) or cf_root/WEB- INF/cfusion/lib/adminconfig.xml (J2EE configuration) in a text editor, change (migrate ColdFusion 5 settings) and runmigrationwizard runmxmigrationwizard (migrate the ColdFusion MX ODBC services to ColdFusion MX 6.1) to true, as necessary, and save the file. Restart the ColdFusion MX Administrator from the Windows Start menu. You are prompted again to migrate your settings.
  • Page 24 “Mounting the CD drive on HP-UX” on page Copy the installation file that is appropriate for your platform and locale from the CD or Macromedia website, and save it to a directory on your local disk. The installation files for supported server configuration platforms are as follows: coldfusion-61-lin.bin...
  • Page 25 Documentation link at the top of the ColdFusion MX Administrator. Mounting the CD drive on HP-UX To accommodate long filenames, Macromedia writes ColdFusion MX 6.1 to the CD using the RockRidge format. This format is supported by HP-UX using the Portable File System (PFS) commands, not the standard HP-UX mount/umount commands.

  • Page 26: Coldfusion Mx Server Configuration Directory Structure

    Mount the CD drive, as follows: /usr/sbin/pfs_mount /SD_CDROM The CD appears under /SD_CDROM. When you finish using the CD, you can unmount it using the following command: /usr/sbin/pfs_umount /SD_CDROM ColdFusion MX server configuration directory structure The following table describes the directories under the cf_root directory when using the server configuration: Directory Description...

  • Page 27: Using The Built-In Web Server

    Internet Information Server (IIS), Apache, or iPlanet. Macromedia does not recommend using the built-in web server in a production environment. However, it is more than suitable for development, allowing you to create virtual directories and set the default document (for example, default.cfm or index.cfm).

  • Page 28: Switching From Another Web Server

    Switching from another web server You can switch from an external web server to the built-in ColdFusion MX web server without reinstalling, even if you did not select it during installation. To switch from an external web server to the built-in web server: Back up the jrun.xml file.

  • Page 29: Uninstalling Coldfusion Mx 6.1

    Uninstalling ColdFusion MX 6.1 deletes all program files and related components from your computer. To uninstall ColdFusion MX 6.1 from Windows: Select Start > Settings > Control Panel > Add/Remove Programs > Macromedia ColdFusion MX. Uninstall ColdFusion MX. When the program completes, remove any remaining files and directories in the cf_root directory.
  • Page 30 Chapter 2: Installing the Server Configuration...

  • Page 31: Chapter 3: Installing The J2Ee Configuration

    CHAPTER 3 Installing the J2EE Configuration This chapter describes how to install, deploy, and undeploy Macromedia ColdFusion MX Enterprise Edition in the J2EE configuration. It includes overview information, specific instructions for installing Macromedia JRun 4 (which automatically deploys and configures ColdFusion MX), and general instructions for use with all J2EE application servers.

  • Page 32: J2Ee Application Servers

    You can deploy ColdFusion MX in the J2EE configuration using either the bundled copy of Macromedia JRun 4 or a third-party J2EE application server. If you use the bundled version of JRun (recommended), the installation wizard automatically deploys and configures ColdFusion MX 6.1 on its own JRun server.

  • Page 33: Context Root

    If your J2EE application server supports enterprise applications, you should install and deploy the EAR file. For more information, see “Installing an EAR file or WAR files” on page Note: The instructions in this chapter apply to the ColdFusion MX J2EE configuration. The ColdFusion MX server configuration contains an embedded version of JRun, which uses ColdFusion-specific JRun configuration options and mappings.

  • Page 34: Platforms

    J2EE configuration, you have the following options: • New installation – install JRun 4 Select this option to install a copy of Macromedia JRun 4 with ColdFusion MX deployed and configured as an enterprise application in a JRun server. For installation details, see “Installing the J2EE configuration with JRun”...
  • Page 35 Question Answer JRun4 install JRun Management Console (JMC) ______________________________________________ username and password Planned location of JRun directory? ______________________________________________ Will you configure an external web Yes | No server (such as Apache or IIS)? (Apache and iPlanet) Configuration ______________________________________________ directory? (Apache) Path to server binary? ______________________________________________ If using an external web server, ______________________________________________...

  • Page 36: Installing The J2Ee Configuration With Jrun

    Note: The default JRun web server port for the cfusion server is 8300. Installing the J2EE configuration with JRun in Windows This section explains how to install Macromedia JRun 4 and the ColdFusion MX 6.1 J2EE configuration in a Windows platform.

  • Page 37: Installing The J2Ee Configuration With Jrun On Unix

    JRun web server and a context root of cfmx, you specify the URL as http://127.0.0.1:8300/cfmx/eisapp/index.cfm. Installing the J2EE configuration with JRun on UNIX This section explains how to install Macromedia JRun 4 and the ColdFusion MX 6.1 J2EE configuration on UNIX. Installing the J2EE configuration with JRun...
  • Page 38 Log in as root. Copy the installation file that is appropriate for your platform and locale from the CD or Macromedia website, and save it to a directory on your local disk. The installation files for supported server configuration platforms are as follows: coldfusion-61-lin.bin...

  • Page 39: Installing An Ear File Or War Files

    Open the ColdFusion MX Administrator in a browser, using http://localhost/context- root/CFIDE/administrator/index.cfm (external web server) or http://localhost:8300/context- root/CFIDE/administrator/index.cfm (built-in JRun web server). Because opening the ColdFusion MX Administrator for the first time automatically invokes the Configuration Wizard, it is best to open the Administrator at this time. Note: If you are accessing ColdFusion MX 6.1 from a remote computer, use the previous URL with localhost the host name or IP address of the remote computer instead of...

  • Page 40: Installing An Ear File Or War Files In Windows

    J2EE configuration” on page Close any applications that are currently running on your computer. Insert the CD or download the setup file from the Macromedia website. If the installation wizard does not start automatically when you insert the CD, locate setup.exe on the CD and double-click it.

  • Page 41: Installing An Ear File Or War Files On Unix

    Log in as root. Copy the installation file that is appropriate for your platform and locale from the CD or Macromedia website, and save it to a directory on your local disk. The installation files for supported server configuration platforms are as follows: coldfusion-61-lin.bin...

  • Page 42: Updating From Coldfusion Mx For J2Ee

    Deploy ColdFusion MX 6.1 and configure Java settings, as required by your application server. For more information, see “ColdFusion MX J2EE deployment and configuration” on page Open the ColdFusion MX Administrator in a browser (http://hostname:portnumber/context- root/CFIDE/administrator/index.cfm). Because opening the ColdFusion MX Administrator for the first time automatically invokes the Configuration Wizard, it is best to open the Administrator at this time.

  • Page 43: Coldfusion Mx J2Ee Deployment And Configuration

    “Deployment” on page 43 “Configuration” on page Deployment The instructions at www.macromedia.com/go/cfmxj2ee-cert provide detailed, application-server- specific ColdFusion MX deployment instructions. Depending on your application server, the instructions describe deployment of an EAR file or WAR files in either a compressed archive or an expanded directory structure.
  • Page 44 To deploy ColdFusion MX as an enterprise application on JRun 4: Run the installation wizard for your platform, as described in “Installing an EAR file or WAR files” on page 39. Select the EAR option. When you get to the deployment step, return to these instructions.

  • Page 45: Configuration

    JRun server, you expand the cfusion.war file, deploy it, and optionally modify the context root. For complete information on deploying ColdFusion MX on JRun 4 as a WAR file, see www.macromedia.com/go/cfmxj2ee-cert. Configuration After you deploy the ColdFusion MX application, you define JVM arguments. Each J2EE application server has a different method of defining JVM arguments.

  • Page 46: Coldfusion Mx J2Ee Configuration Directory Structure

    Additionally certain application servers require that you disable server-specific policy-file permissions in order to enable the ColdFusion security manager. For more information, see the application-server-specific instructions at www.macromedia.com/go/cfmxj2ee-cert. If the version of tools.jar in your application server’s JRE is different from the version of tools.jar in WEB-INF/cfusion/lib, you should rename or delete WEB-INF/cfusion/lib/tools.jar to ensure...

  • Page 47: Undeploying Coldfusion Mx

    Directory Description WEB-INF/cfusion/bin Executable files used by ColdFusion MX. WEB-INF/cfusion/cfx CFX tag include file and examples. WEB-INF/cfusion/charting Files for the ColdFusion MX graphing and charting engine. WEB-INF/cfusion/Custom Tags Repository for your custom tags. WEB-INF/cfusion/db Sample databases: in Windows, the files for sample Microsoft Access databases and ODBC services;...
  • Page 48 Chapter 3: Installing the J2EE Configuration...

  • Page 49: Chapter 4: Configuring Your System

    CHAPTER 4 Configuring Your System This chapter describes how to manage ColdFusion MX services and processes, how to configure web servers manually, and how to change user accounts and configure databases for ColdFusion Note: In this chapter, cf_root refers to your installation directory. By default, this directory is C:\CFusionMX in Windows, and /opt/coldfusionmx on UNIX.

  • Page 50: Overview Of Configuration Tasks

    Flash MX 6.1 through web services. You can do this after you install Remoting” on page 65 ColdFusion MX 6.1 and before you begin using Macromedia Flash MX to access ColdFusion MX 6.1 through web services. “Connecting to an external You must do this only if you use a Type 4 database driver that is not JDBC Type 4 data source”...

  • Page 51: Managing Coldfusion Mx

    The JRun 4 with ColdFusion MX J2EE configuration installation creates the following services in Windows NT, Windows 2000, Windows XP, and Windows 2003: Service Purpose Macromedia JRun Admin Runs the JRun admin server, used by the JRun Management Console Server (JMC).
  • Page 52 The program that provides security, directory and file browsing, and debugging services for Remote Development Services (RDS), which lets you access ColdFusion MX from Macromedia Dreamweaver MX, Macromedia HomeSite+, and Macromedia ColdFusion Studio. When ColdFusion MX is running, two icons appear in the taskbar. To stop the ColdFusion Application Server executable, right-click the IDE service icon and select Stop.

  • Page 53: Managing The Coldfusion Mx Process On Unix

    Managing the ColdFusion MX process on UNIX This section describes the ColdFusion MX process and explains how to manage it. Note: This discussion applies to the ColdFusion MX server configuration only. Under the J2EE configuration, you start and stop ColdFusion MX by starting the application server. Overview of the ColdFusion MX process The ColdFusion MX installation creates a single process on UNIX called .

  • Page 54: Configuring Web Servers In Windows

    Note: If you cannot verify your configuration, repeat the procedure. If the problem persists, contact Macromedia Technical Support for assistance, or manually create the element that you cannot verify in the configuration (for example, manually add an entry to the Apache httpd.conf file, as documented in this section).
  • Page 55 To verify your IIS configuration: Verify that the following file was created: cf_root\runtime\lib\wsconfig\jrun.dll (server configuration) or jrun_root/lib/wsconfig/jrun.dll (JRun J2EE configuration). On IIS6, this file is named jrun_iis6.dll. For each of your IIS websites, verify that application mappings for .cfm, .cfml, .cfc, .jsp, and .jws were added, as follows: In IIS, right-click an IIS website and select Properties.
  • Page 56 To configure Netscape or iPlanet for ColdFusion MX in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia ColdFusion MX > Web Server Configuration Tool from the Start menu. Click Add. In the Server drop-down list box, select the host name and the server or cluster name to configure.
  • Page 57 In the Server drop-down list box, select the host name and the server or cluster name to configure. For the ColdFusion MX server configuration, this is always default. Clustering support is only available on the JRun J2EE configuration. Note: The server or cluster does not have to reside on the web server computer. In the Web Server Properties area, select Apache and specify the path to the directory that contains the httpd.conf file.

  • Page 58: Configuring Web Servers On Unix

    Configuring web servers on UNIX This section explains how to configure the following web servers on UNIX: • Configuring Apache web server on UNIX • Configuring Netscape or iPlanet web server on UNIX Configuring Apache web server on UNIX This section describes how to configure the Apache web server for ColdFusion MX on UNIX, and how to verify your configuration.
  • Page 59 Configuring Netscape or iPlanet web server on UNIX This section describes how to configure Netscape Enterprise web server 3.6x or iPlanet web server (4.x or 6.x) for ColdFusion MX on UNIX, and how to verify your configuration. Note: When running the Web Server Configuration Tool on the JRun J2EE configuration, wsconfig.jar is located in jrun_root/lib.

  • Page 60: Installing Verity Locales

    ColdFusion uses ICU (IBM Classes for Unicode) technology. For more information on Verity, see Configuring and Administering ColdFusion MX. This section describes how to install a Verity Locales package from the Macromedia website, and how to switch to a different Verity Locales package.

  • Page 61: Installing Visibroker For Corba Connections

    Installing Visibroker for CORBA connections To install Visibroker for CORBA connections: Install Visibroker on the CORBA server side. For more information, see the Borland Visibroker documentation. Add the vbjorb.jar file to the ColdFusion MX classpath, as follows: In the ColdFusion MX Administrator, select Server Settings > Java and JVM. When using the J2EE configuration, you add the vbjorb.jar file to the J2EE application server classpath, using the server-specific method.

  • Page 62: Disabling Remote Development Services (Rds)

    ColdFusion MX. Using RDS, IDE users can securely access remote files and data sources, build SQL queries from these data sources, and debug CFML code. However, for security reasons, Macromedia recommends that you disable RDS on a production server. To disable it, you must disable the RDSServlet mapping.

  • Page 63: Disabling Jsp Functionality

    Save the file. Restart ColdFusion MX. For more information, see “Starting and stopping services” on page 51 for Windows, or “Managing the process” on page 53 for UNIX. RDS is disabled on the ColdFusion MX server. Disabling JSP functionality ColdFusion MX Enterprise Edition provides support for JavaServer Pages (JSP) technology via the underlying J2EE application server on which it runs.
  • Page 64 In the Open dialog box, browse to compmgmt.msc, the Computer Management console file (usually located in the system or system32 directory). Click Open. The MMC for Computer Management appears: On the Tree tab, under Services and Applications, click Services. All of the services for your computer appear in the right pane. Right-click ColdFusion MX Application Server and select Properties.

  • Page 65: Enabling Web Services Access For Flash Remoting

    Enabling web services access for Flash Remoting By default, Flash Remoting cannot access ColdFusion MX 6.1 through web services. To enable Flash Remoting to access ColdFusion MX 6.1 through web services: Open the cf_root/wwwroot/WEB-INF/web.xml file in a text editor. In the J2EE configuration, open cf_root/WEB-INF/web.xml.

  • Page 66: Configuring Redhat Linux 7.3, 8.0, And 9

    Configuring RedHat Linux 7.3, 8.0, and 9 To use C++ binaries on RedHat Linux 7.3, 8.0, or 9, the Linux installation must have the corresponding RedHat libc compatability libraries to run ColdFusion MX 6.1, as follows: • RedHat-9 for i386 compat-libstdc++-7.3-2.96.118.i386.rpm •...

  • Page 67: Index

    INDEX Numerics Configuration Wizard J2EE configuration - UNIX 39 256 color minimum for installer 22, 35 J2EE configuration - Windows 37 server configuration - Unix 25 server configuration - Windows 23 Apache web server connecting to an external Type 4 data source 65 configuring in Windows 56 context path 33 configuring on UNIX 58...
  • Page 68 installing in Windows 36 installing on Unix 38 failover 33 JRun Management Console (JMC) Flash Remoting, overview 17 classpath 45 JVM arguments 45 JVM arguments, J2EE configuration 45 glibc, Verity requirements 66 jvm.config file, JVM arguments 45 hosting, disabling JSPs 63 Linux HP-UX, mounting CD-ROM drive on 25 configuring web servers in 59...
  • Page 69 using built-in 27 using ColdFusion MX web server 27 tools.jar, renaming 46 Windows Type 4 database drivers 65 ColdFusion MX services 51 installation considerations 17 managing services in 51 undeploying 47 starting ColdFusion MX in 51 uninstalling stopping ColdFusion MX in 51 from UNIX 29 Windows ME/98, running ColdFusion MX in 52 from Windows 29...
  • Page 70 Index...

This manual is also suitable for:

Coldfusion mx

Table of Contents