Download  Print this page

MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX Using Manual

Hide thumbs

Advertisement

COLDFUSION
MX 7
®
Installing and Using ColdFusion MX

Advertisement

Table of Contents
loading

  Also See for MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX

  Related Manuals for MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX

  Summary of Contents for MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX

  • Page 1 COLDFUSION MX 7 ® Installing and Using ColdFusion MX...
  • Page 2 Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally.
  • Page 3: Table Of Contents

    CONTENTS ........... 5 INTRODUCTION CHAPTER 1: Preparing to Install ColdFusion MX 7 .
  • Page 4 CHAPTER 5: Configuring Your System ....... . 45 Overview of configuration tasks ........46 Managing ColdFusion MX 7.
  • Page 5: Introduction

    INTRODUCTION Installing and Using ColdFusion MX is intended for anyone who needs to install and configure Macromedia ColdFusion MX 7. About ColdFusion MX 7 documentation The ColdFusion MX 7 documentation is designed to provide support for the complete spectrum of participants.
  • Page 6 Document Format (PDF) files. Go to the documentation home page for ColdFusion MX on the Macromedia website: www.macromedia.com. In addition, you can view the documentation in LiveDocs, which lets you add comments to pages and view the latest comments added by Macromedia, by going to www.macromedia.com/go/livedocs_cfmx7docs.
  • Page 7: Chapter 1: Preparing To Install Coldfusion Mx

    CHAPTER 1 Preparing to Install ColdFusion MX 7 This chapter describes Macromedia ColdFusion MX 7 product editions, system requirements, and other high-level considerations. Before installing ColdFusion MX 7, you should review the information in this chapter and determine the answers to the questions in the section “Gathering...
  • Page 8: Coldfusion Mx 7 Product Editions

    You can install ColdFusion MX 7 in any of the following configurations: Server configuration Lets you install one instance of ColdFusion MX 7 with an embedded J2EE server. This configuration most closely resembles the ColdFusion MX base release and other releases prior to ColdFusion MX, such as ColdFusion 5 and ColdFusion 4.5.
  • Page 9 • 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 Model (COM), Enterprise Java Beans (EJBs), and Common Object Request Broker Architecture (CORBA).
  • Page 10: System Requirements

    Report Builder, you must install a trial or developer edition of ColdFusion MX 7. System requirements The ColdFusion MX 7 system requirements are available on the Macromedia web site. To view the system requirements, including a list of supported J2EE application servers, go to www.macromedia.com/go/sysreqscf.
  • Page 11: Installation Considerations

    “Using the built-in web server” on page • To interact with ColdFusion pages and components from a Macromedia Flash SWF file, use the Flash Remoting service in ColdFusion MX 7. To develop applications that use Flash Remoting, you must install the Flash Remoting components in the Flash MX authoring environment.
  • Page 12 This Java-only installer does not include features that require platform-specific binary files, such as Verity and C++ CFX support. • Macromedia does not recommend using Apple Mac OS X 10.3 in a production environment Chapter 1: Preparing to Install ColdFusion MX 7...
  • Page 13: Gathering Information Necessary To Install Coldfusion Mx 7

    Gathering information necessary to install ColdFusion MX 7 Although the ColdFusion MX 7 installer provides an intuitive interface, it helps to plan your answers to the questions asked by the installer. Use the following table to help plan for installing ColdFusion MX 7.
  • Page 14 Do you want to enable Yes | No RDS? Note: RDS allows the server to interact with remotely connected developers. Macromedia recommends that you disable RDS for production servers. Disabling RDS also disables the directory browsing applets in the ColdFusion MX Administrator.
  • Page 15: Chapter 2: Installing The Server Configuration

    CHAPTER 2 Installing the Server Configuration This chapter describes how to install and uninstall ColdFusion MX 7 in the server configuration. The ColdFusion MX 7 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 16 “Managing ColdFusion MX 7 services in Windows” on page 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 the setup.exe file on the CD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion MX 7 installation executable file (coldfusion-70- win.exe) and double-click it.
  • Page 17 To install the ColdFusion MX 7 server configuration on UNIX: Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements as described on the Macromedia web site at www.macromedia.com/go/sysreqscf.
  • Page 18 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 following are the installation files for supported server configuration platforms: coldfusion-70-lin.bin...
  • Page 19: Installing The Coldfusion Report Builder

    Go to the webroot/CFIDE/installers directory. The ColdFusion MX 7 CD Use the CD Browser to select the ColdFusion MX reporting option. The Macromedia web site Go to www.macromedia.com/go/cfmx7_reporting/. Double-click the CFReportBuilderInstaller.exe file. Follow the instructions in the installation. Installing the Verity search server separately By default, the installer installs the Verity search server on the same computer as ColdFusion MX 7.
  • Page 20: Coldfusion Mx 7 Server Configuration Directory Structure

    ColdFusion MX 7 server configuration directory structure The following table describes the directories under the cf_root directory when you install the server configuration of ColdFusion MX 7: Directory Description Programs for starting, stopping, and viewing information for ColdFusion MX 7, and to run Crystal Reports (Windows only).
  • Page 21: Using The Built-In Web Server

    Internet Information Server (IIS), Apache, or SunONE. 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 22 If you are using Macromedia Dreamweaver, be sure to reconfigure any sites that you move from one server to another.
  • Page 23: Uninstalling Coldfusion Mx 7

    Uninstalling ColdFusion MX 7 deletes all program files and related components from your computer. To uninstall ColdFusion MX 7 from Windows: Select Start > Settings > Control Panel > Add/Remove Programs > Macromedia ColdFusion MX7. Click Change/Remove. When the program completes, remove any remaining files and directories in the cf_root directory.
  • Page 24 Chapter 2: Installing the Server Configuration...
  • Page 25: Chapter 3: Installing The Multiserver Configuration

    CHAPTER 3 Installing the Multiserver Configuration This chapter describes how to install Macromedia ColdFusion MX 7 in the multiserver configuration. Contents About multiserver configuration ..........25 Installing ColdFusion MX 7 using the multiserver configuration .
  • Page 26: Installing Coldfusion Mx 7 Using The Multiserver Configuration

    Note: The Windows installer requires a computer that supports at least 256 colors. To install the multiserver configuration in Windows: Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements described in “System requirements”...
  • Page 27 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 the setup.exe file on the CD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion MX 7 installation executable file (coldfusion-70- win.exe) and double-click it.
  • Page 28 To install the multiserver configuration on UNIX: Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements described on the Macromedia web site at www.macromedia.com/go/sysreqscf. Review the “Installation considerations for UNIX”...
  • Page 29: Configuration

    Go to the webroot/CFIDE/installers directory. The ColdFusion MX 7 CD Use the CD Browser to select the ColdFusion MX reporting option. The Macromedia web site Go to www.macromedia.com/go/cfmx7_reporting/. Double-click the CFReportBuilderInstaller.exe file. Follow the instructions in the installation. Installing the ColdFusion Report Builder...
  • Page 30: Installing The Verity Search Server Separately

    To uninstall ColdFusion MX 7 from Windows: Select Start > Settings > Control Panel > Add/Remove Programs > Macromedia ColdFusion MX 7 with JRun 4. Click Change/Remove. When the program completes, remove any remaining files and directories in the cf_webapp_root directory.
  • Page 31: Chapter 4: Installing The J2Ee Configuration

    CHAPTER 4 Installing the J2EE Configuration This chapter describes how to install, deploy, and undeploy Macromedia ColdFusion MX 7 Enterprise Edition in the J2EE configuration. It includes overview information, specific instructions for installing Macromedia JRun 4 (which automatically deploys and configures ColdFusion MX 7), and general instructions for use with all J2EE application servers.
  • Page 32 Choosing EAR or WAR deployment In the J2EE environment, you deploy applications in one of the following formats: Web application archive file Contains the ColdFusion MX 7 application. A web application archive (also called a WAR) uses a directory structure that contains a WEB-INF/web.xml deployment descriptor, which defines the servlets and context parameters it uses.
  • Page 33 Context root Because the J2EE environment supports multiple, isolated web applications running in a server instance, J2EE web applications running in a server are each rooted at a unique base URL, called a context root (or context path). The J2EE application server uses this initial portion of the URL (that is, the portion immediately following http://hostname) to determine which web application services an incoming request.
  • Page 34: Preparing To Install Using The J2Ee Configuration

    When you install the J2EE configuration, you have the following options: New installation—multiserver configuration Use this option to install a copy of Macromedia JRun 4 with ColdFusion MX 7 deployed and configured as an enterprise application in a JRun server. For installation details, see “Installing ColdFusion MX 7 using the multiserver...
  • Page 35 ColdFusion MX 7” on page 13 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 the setup.exe file on the CD and double-click it.
  • Page 36 To install ColdFusion MX 7 on UNIX (J2EE configuration): Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements described on the Macromedia web site at www.macromedia.com/go/sysreqscf. Review the “Installation considerations for UNIX”...
  • Page 37 Using the command, go to the directory with the installation file. Start the installation with the following command: filename ./< > -i console The installation program starts. To use the coldfusion-70-other.jar file to install on a UNIX platform other than Solaris or Linux, enter the following command (for more information, see “Installation considerations for UNIX”...
  • Page 38: Installing The Coldfusion Report Builder

    Go to the webroot/CFIDE/installers directory. The ColdFusion MX 7 CD Use the CD Browser to select the ColdFusion MX reporting option. The Macromedia web site Go to www.macromedia.com/go/cfmx7_reporting/. Double-click the CFReportBuilderInstaller.exe file. Follow the instructions in the installation. Chapter 4: Installing the J2EE Configuration...
  • Page 39: Installing The Verity Search Server Separately

    You should start by planning the answers to questions asked by the Installer: • "Where would you like to install?" _______________________________ Macromedia recommends that you specify a location that is not a subdirectory of the application server directories. • The IP address of the ColdFusion Server that this machine will accept requests...
  • Page 40 For basic deployment information, see your J2EE application server documentation. ColdFusion MX 7 deployment instructions differ for each J2EE application server. For up-to- date information on deploying ColdFusion MX 7 on a variety of J2EE application servers, see www.macromedia.com/go/cfmx7_j2eecert. For more information, see “Deployment” on page 40 “Configuration”...
  • Page 41 When you deploy ColdFusion MX 7 as a web application on an existing JRun server, you expand the cfusion.war file, deploy it, and optionally modify the context root. For complete information on deploying ColdFusion MX 7 on JRun 4 as a WAR file, see www.macromedia.com/go/ cfmx7_j2eecert. ColdFusion MX 7 J2EE deployment and configuration...
  • Page 42 Configuration After you deploy the ColdFusion MX 7 application, you define JVM arguments. Each J2EE application server has a different method for defining JVM arguments. Depending on your server, you can update variables in a batch file or shell script, define arguments in an administrative interface, modify the java.library.path JVM argument directly, or modify the system path directly.
  • Page 43 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/cfmx7_j2eecert. If the version of the tools.jar file in your application server’s JRE is different from the version of the tools.jar file in the WEB-INF/cfusion/lib directory, you should rename or delete the WEB-...
  • Page 44: Undeploying Coldfusion Mx 7

    Directory Description WEB-INF/cfusion/jintegra JIntegra programs, libraries, and other supporting files (for example, to integrate Java and COM code; manage access to ActiveX controls (OCXs) that are hosted in a graphical user interface (GUI) container; and register the JVM and type libraries). WEB-INF/cfusion/lib and JAR, XML, property, and other files that are the foundation of WEB-INF/lib...
  • Page 45: Chapter 5: Configuring Your System

    CHAPTER 5 Configuring Your System This chapter describes how to manage ColdFusion MX 7 services and processes, how to configure web servers manually, and how to change user accounts and configure databases for ColdFusion MX 7. Note: In this chapter, cf_root refers to your installation directory in the server configuration. By default, this directory is C:\CFusionMX7 in Windows, and /opt/coldfusionmx7 on UNIX.
  • Page 46: Overview Of Configuration Tasks

    Overview of configuration tasks The following table describes when to do the configuration tasks that are documented in this chapter: Configuration task When to do it “Managing You must stop and restart ColdFusion MX 7 after you enable or disable ColdFusion MX 7”...
  • Page 47 The multiserver configuration installation creates the following services in Windows 2000, Windows XP, and Windows 2003: Service Purpose Macromedia JRun Admin Runs the admin JRun server, used by the JRun Management Console Server (JMC). Macromedia JRun Runs the JRun cfusion server.
  • Page 48 To start or stop a ColdFusion service: Open the Services dialog box: In Windows 2000, Windows XP, or Windows 2003, select Start > Settings > Control Panel > Administrative Tools > Services. For other Windows platforms, see the Windows online Help. If a service is running, its status appears as Started in the Status column.
  • Page 49: Configuring Web Servers

    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 described in this section).
  • Page 50 For more information, see the Web Server Management chapter in Configuring and Administering ColdFusion MX. To configure IIS for ColdFusion MX 7 in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool. Click Add.
  • Page 51 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 (multiserver configuration). On IIS6, this file is named jrun_iis6.dll. For each of your IIS websites, verify that application mappings for .cfm, .cfml, .cfc, .cfswf, .cfr, .jsp, and .jws were added, as follows: In IIS, right-click an IIS website and select Properties.
  • Page 52 For more information, see the Web Server Management chapter of Configuring and Administering ColdFusion MX. To configure SunONE or iPlanet for ColdFusion MX 7 in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool. Click Add.
  • Page 53 For more information, see the Web Server Management chapter in Configuring and Administering ColdFusion MX. To configure Apache for ColdFusion MX 7 in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool. Click Add.
  • Page 54 To verify your Apache configuration: Verify that one of the following files was created: cf_root\runtime\lib\wsconfig\number\mod_jrun.so (Apache 1.3.2.7) cf_root\runtime\lib\wsconfig\number\mod_jrun20.so (Apache 2.x) In the multiserver configuration, this file is located under jrun_root/lib/wsconfig. Open the Apache configuration file, httpd.conf, in your Apache conf directory. In Windows, the default is C:\Program Files\Apache Group\Apache\conf\httpd.conf.
  • Page 55 To configure the Apache web server for ColdFusion MX 7 on UNIX: Enter the following command on a single line: wsconfig -server servername -ws Apache -dir <apache config directory> - coldfusion -v Note: You must enter the previous command as a single (long) line. The wsconfig file is in cf_root/runtime/bin (server configuration) or jrun_root/bin (multiserver configuration) The following is a sample command:...
  • Page 56 Configuring SunONE or iPlanet web server on UNIX This section describes how to configure SunONE Web Server or iPlanet web server (4.x or 6.x) for ColdFusion MX 7 on UNIX, and how to verify your configuration. Note: When running the Web Server Configuration Tool on the multiserver configuration, wsconfig.jar is located in jrun_root/lib.
  • Page 57: Installing Verity Locales

    ColdFusion MX 7 lets you do Verity searches for languages other than English. 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 58 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 7 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 59: Disabling Remote Development Services

    Note: The ColdFusion Report Builder uses RDS for the Query Builder and for charting support. However, for security reasons, Macromedia recommends that you disable RDS on a production server. To disable it, you must disable the RDSServlet mapping. To disable the RDSServlet mapping: Back up the web.xml file.
  • Page 60: Disabling Jsp Functionality (Server Configuration Only)

    Comment out the RDSServlet mapping, as the following example shows: <!-- <servlet-mapping id="macromedia_mapping_9"> <servlet-name>RDSServlet</servlet-name> <url-pattern>/CFIDE/main/ide.cfm</url-pattern> </servlet-mapping> --> Save the file. Restart ColdFusion MX 7. RDS is disabled on the ColdFusion MX 7 server. For more information, see “Starting and stopping services” on page 47 for Windows, or “Managing the process”...
  • Page 61: Changing The Coldfusion Mx 7 User Account In Windows

    The ColdFusion services, by default, run under the highly privileged system accounts. For an extra level of security, Macromedia recommends that you create a Windows user under which you run the services and only give privileges needed to run the web application (for example, folder permissions for the web root.)
  • Page 62 Chapter 5: Configuring Your System...
  • Page 63: Chapter 6: Troubleshooting

    CHAPTER 6 Troubleshooting This chapter contains solutions to common installation problems. Contents Common installation problems ..........63 Data source problems.
  • Page 64 Solution: After installing Windows XP Service Pack 2, the Windows Firewall is enabled by default. This prevents ColdFusion MX 6.1 from functioning correctly. For more information see the Tech Note at www.macromedia.com/support/coldfusion/ts/documents/windowsspxp2.htm. Cannot access Flash content locally Problem: You cannot access any Flash content locally after installing ColdFusion MX 7 on IIS.
  • Page 65 Problem: After installing ColdFusion MX 7, you cannot run Macromedia Flex on it. Solution: You must install the J2EE configuration of ColdFusion MX 7 to run Macromedia Flex on ColdFusion MX 7. Browsing a ColdFusion page displays a download window Problem: In prior versions of ColdFusion, you used IIS to map the file extension .cfm to...
  • Page 66: Data Source Problems

    Data source problems Unable to add a Microsoft Access data source Problem: When you try to add a Microsoft Access data source, the following error appears: Unable to update the ColdFusion MX 7 ODBC Server. Timeout period expired without completion of C:\blackstone\db\slserver54\admin\swcla.exe Solution: Install and start up the ODBC service, or use the Microsoft Access with Unicode driver.
  • Page 67: J2Ee Configuration Problems

    J2EE configuration problems Problem: When you install JRun 4, then install the ColdFusion MX 7 WAR, and attempt to open the ColdFusion MX Administrator, the following error appears: 500 The Security service is not available. The security service is not available. Solution: Look at the log files in cfusion/logs to see if a message indicates that you need the Java Crypto Extensions (JCE) on a 1.3 JVM.
  • Page 68: Uninstall Problems

    Virtual mapping resource path of /* does not work Problem: You add a virtual mapping resource path of which does not work Solution: Do not map any directories to wildcard resource paths that contain WEB-INF as a virtual mapping. In ColdFusion MX 6.1, the fact that this worked was a side-effect of the particular way the classloader was configured.
  • Page 69: Index

    INDEX CORBA enabling 57 Apache web server JVM arguments for J2EE 42 configuring in Windows 53 configuring on UNIX 54 application isolation 25, 33 application.xml file, web-uri element 41 data sources applications, hosting 12 connecting to external Type 4 61 migrating 11 deployment app server differences 34...
  • Page 70 UNIX 12 ColdFusion MX 7 Reporting 19, 29, 38 considerations for UNIX 12 considerations for Windows 12 Macromedia Flex 11 extensions for Dreamweaver 16 Microsoft network model 12 general considerations 11 migrating in Windows 16, 26, 35...
  • Page 71 sandbox security, enabling in J2EE 29, 43 Verity security manager 43 installing 30 server configuration 8 locales, installing 57 server instances, multiple 25, 33 requirements 49 servers dedicated 12 services for ColdFusion MX 7 in Windows 47 WAR. See web application archive setup.exe 16, 27, 35 web application archive (WAR) start...
  • Page 72 Index...

This manual is also suitable for:

Colfusion mx 7