Table of Contents
Advertisement
Quick Links
Advertisement
Table of Contents
Related Manuals for MACROMEDIA COLDFUSION MX 61 - INSTALLING COLDFUSION MX FOR IBM WEBSPHERE APPLICATION SERVER
Summary of Contents for MACROMEDIA COLDFUSION MX 61 - INSTALLING COLDFUSION MX FOR IBM WEBSPHERE APPLICATION SERVER
- Page 1 Installing and Using ColdFusion MX for WebSphere Application Server ® ®...
- 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 ......29 Installing and deploying Macromedia ColdFusion MX ..... 30 Installing the ColdFusion MX files .
-
Page 5: Introduction
Installing and Using ColdFusion MX for IBM WebSphere Application Server is intended for anyone who needs to configure and manage their ColdFusion development environment. About Macromedia ColdFusion MX documentation The ColdFusion MX documentation is designed to provide support for the complete spectrum of participants. -
Page 6: Viewing Online Documentation
Viewing online documentation All ColdFusion MX documentation is available online in HTML and Adobe Acrobat Portable Document Format (PDF) files. Go to the documentation home page for ColdFusion MX on the Macromedia website: www.macromedia.com. Introduction... -
Page 7: Chapter 1: Essential Information
CHAPTER 1 Essential Information This chapter describes Macromedia ColdFusion MX for IBM WebSphere Application Server and provides information that applies to all WebSphere installations. Contents About ColdFusion MX for IBM WebSphere Application Server ......8 System requirements . -
Page 8: About Coldfusion Mx For Ibm Websphere Application Server
For any updates, see www.macromedia.com/go/cfmxj2ee-cert. Note: If you use Macromedia ColdFusion Studio to develop your web applications, note that ColdFusion MX supports ColdFusion Studio versions 4.5.2 and 5.0 only. Chapter 1: Essential Information... -
Page 9: Operating System And Java Requirements
The supported Java runtime environment is the default runtime installed with the application server. • Additional system update requirements follow the table. For the most up-to-date list of certified platforms, see the Macromedia support site, www.macromedia.com/support/coldfusion. Edition Operating systems IBM WebSphere 4 Windows NT 4.0 Server SP6A... -
Page 10: Additional Requirements And Software Support
Additional requirements and software support The following table lists the hardware requirements, supported browsers, specific supported application server editions, and supported databases for the various ColdFusion MX for IBM WebSphere Application Server editions: Category J2EE server Requirement Minimum hardware Processor requirements Windows and Linux: Pentium... -
Page 11: Directory Structure
The ColdFusion root directory, referred to as cf_root, contains all ColdFusion software except for Remote Development Services (RDS) support, which enables Macromedia Dreamweaver MX and Macromedia HomeSite+ to access ColdFusion directly. RDS support is not recommended on production servers. If you install RDS support, it is located in a rds.war directory in the same parent directory as the ColdFusion root directory. -
Page 12: Differences Between Coldfusion Mx And Coldfusion Mx On Websphere
ColdFusion MX: the J2EE configuration and the server configuration. ColdFusion MX for IBM WebSphere supports the J2EE configuration. Editions of ColdFusion MX available directly from Macromedia also support the server configuration. These differences include: General ColdFusion MX feature differences Differences in directory locations... -
Page 13: Differences In Directory Locations
• ColdFusion MX for IBM WebSphere Application Server requires a redirector web application for RDS access if you do not deploy the ColdFusion MX web application at the / context root. For more information, see “Using RDS” on page • ClusterCATS is not available;... -
Page 14: Differences In The Coldfusion Mx Administrator
The following table lists the location of the root directory for the application servers: Application server Windows location UNIX location WebSphere 5 websphere_root\AppServer\ websphere_root/AppServer/ installedApps\node_name\ installedApps/node_name/ Macromedia ColdFusion Macromedia ColdFusion MX.ear/ MX.ear\cfusion.war cfusion.war WebSphere 4 websphere_root\AppServer\ websphere_root/AppServer/ installedApps\cfusion.ear\ installedApps/cfusion.ear/ cfusion.war cfusion.war... -
Page 15: Installing Coldfusion Mx For Ibm Websphere Application Server
• To interact with ColdFusion pages, components, and server-side ActionScript from a Macromedia Flash movie, use the Macromedia Flash Remoting MX service in ColdFusion MX. Although no special installations are required to develop ColdFusion applications for the Flash Remoting MX service, you must install the Flash Remoting Components in the Macromedia Flash MX authoring environment. -
Page 16: Creating And Migrating Applications On Coldfusion Mx
Resources, including tutorials and example applications, that you can access from the Home page of the ColdFusion MX Administrator • The Get Started with ColdFusion MX page on the Macromedia website at www.macromedia.com/go/cfresources. Migrating existing ColdFusion applications For information on migrating existing ColdFusion MX applications, including ColdFusion applications to ColdFusion MX 6.1on IBM WebSphere, see Migrating ColdFusion Applications,... -
Page 17: Chapter 2: Installing On Websphere V5
Contents Installing and deploying Macromedia ColdFusion MX ......18 Enabling and configuring specific ColdFusion MX functionality ..... . . 23... -
Page 18: Installing And Deploying Macromedia Coldfusion Mx
Installing and deploying Macromedia ColdFusion MX Before you can run ColdFusion applications, you must complete the following procedures to install and deploy ColdFusion MX to your application server: Installing the ColdFusion MX files Deploying ColdFusion MX on WebSphere Running the Configuration and Settings Migration Wizard Note: This chapter describes how to install ColdFusion MX directly from the cfusion.ear file. - Page 19 ColdFusion asks you for the directory in which to install the files. These files are required to deploy ColdFusion on WebSphere, but are not required afterward. Therefore, you can specify a staging area or temporary file location. Installing and deploying Macromedia ColdFusion MX...
-
Page 20: Deploying Coldfusion Mx On Websphere
ColdFusion MX ODBC server and the ColdFusion MX ODBC agent are stopped. On the WebSphere Administrative Console Applications > Enterprise Applications page, select the ColdFusion application (the default name is Macromedia ColdFusion MX). If the application is running, click stop; when it has stopped, select it again. Click Uninstall. - Page 21 Install New Application procedure, if appropriate for your WebSphere configuration. Click Next. Note: You might want to change the application name in this step. The default name, Macromedia ColdFusion MX, is long and results in an application deployment directory name (Macromedia ColdFusion MX.ear) that is long and has spaces.
-
Page 22: Running The Configuration And Settings Migration Wizard
Start the ColdFusion Application in the Enterprise Applications panel. Select the box next to Macromedia ColdFusion MX, and click Start. You might have to stop and restart the application server on which the ColdFusion application runs before you can start ColdFusion Continue with the next section of the instructions, “Running the Configuration and Settings... -
Page 23: Enabling And Configuring Specific Coldfusion Mx Functionality
ColdFusion MX access ODBC data sources. • Specify whether to install example applications and supporting files (including data sources) for the ColdFusion MX Getting Started tutorial. For security reasons, Macromedia recommends that you do not install example applications on production servers. •... - Page 24 \WEB-INF\cfusion\ lib\_nti40\bin Replace with the path to your cf_root directory; for example, enter the following: SET CFMX_APPS_PATH=%WAS_HOME%\installedApps\%WAS_NODE%\ Macromedia ColdFusion MX.ear\cfusion.war\WEB-INF\cfusion\lib; %WAS_HOME%\installedApps\%WAS_NODE%\Macromedia ColdFusion MX.ear\ cfusion.war\WEB-INF\cfusion\lib\_nti40\bin Add the CFMX_APPS_PATH variable to the WAS_CLASSPATH by appending the following text to the path statement: ;%CFMX_APPS_PATH%...
-
Page 25: Enabling Access To Com Objects (Windows Only)
Open the original file for editing, and in the PLATFORM case block, just above the LD_LIBRARY_PATH line, add the following entry on a single, long line: Note: The path specifications in these instructions assume you deployed ColdFusion using the standard application name (Macromedia ColdFusion MX) and did not rename the application. On Solaris: CFMX_APPS_PATH=... -
Page 26: Enabling Charting And Graphing (Unix)
Click OK. Disabling RDS For security reasons, Macromedia recommends that you disable RDS on a production server. If you install and enable RDS support, you can disable it later. Note: If you disable RDS, the Browse Server button does not work in the ColdFusion MX Administrator (for example, on the ColdFusion Mappings page). - Page 27 In the WebSphere Administrative Console, select Node_name > Applications > Enterprise Applications. Stop the Macromedia ColdFusion MX application if it is running. Click the Macromedia ColdFusion MX Application link to display the Configuration page, then select the Local Topologies tab. Enabling and configuring specific ColdFusion MX functionality...
-
Page 28: Undeploying Coldfusion Mx
Open the WebSphere Administrative Console. Open the Node_name > Applications > Enterprise Applications page. If the ColdFusion application status is Started, select the check box next to the Macromedia ColdFusion MX entry and click Stop. When the ColdFusion application server has stopped, select the check box next to the Macromedia ColdFusion MX entry again and click Uninstall. -
Page 29: Chapter 3: Installing On Websphere V4
Contents Installing and deploying Macromedia ColdFusion MX ......30 Enabling and configuring specific ColdFusion MX functionality ..... . . 36... -
Page 30: Installing And Deploying Macromedia Coldfusion Mx
Installing and deploying Macromedia ColdFusion MX Before you can run ColdFusion applications, you must complete the following procedures to install and deploy ColdFusion MX to your application server: Installing the ColdFusion MX files Deploying ColdFusion MX on WebSphere Running the Configuration and Settings Migration Wizard Note: This chapter describes how to install ColdFusion MX directly from the cfusion.ear file. - Page 31 Update option, the installer backs up your application files, including configuration files. This is required because you must undeploy your ColdFusion application as part of the update procedure. You then use the backup files to restore the application. Installing and deploying Macromedia ColdFusion MX...
-
Page 32: Deploying Coldfusion Mx On Websphere
Note: Do not specify a backup directory that is inside your current application directory. For example, do not specify a directory such as C:\Program Files\WebSphere\AppServer\ installedApps\MyNode\Macromedia ColdFusion MX.ear. When you deploy the updated version of ColdFusion MX, you first undeploy your old version of ColdFusion, which deletes files in the application directory. - Page 33 On the WebSphere Administrative Console Nodes > node_name > Enterprise Applications page, select the ColdFusion application (the default name is Macromedia ColdFusion MX). If the application is running, click stop; when it has stopped, select it again. Click Uninstall. WebSphere might display the warning “The operation did not complete in the expected amount of time.
- Page 34 ColdFusion MX ODBC server and the ColdFusion MX ODBC agent are stopped. On the WebSphere Administrative Console Applications > Enterprise Applications page select the ColdFusion application (the default name is Macromedia ColdFusion MX). If the application is running, click stop; when it has stopped, select it again. Click Uninstall.
-
Page 35: Running The Configuration And Settings Migration Wizard
Administrator” on page When you first access the Administrator, ColdFusion runs the Configuration and Settings Migration Wizard. Note: When you upgrade a ColdFusion MX installation, the wizard might skip some of the following steps. Installing and deploying Macromedia ColdFusion MX... -
Page 36: Enabling And Configuring Specific Coldfusion Mx Functionality
ODBC data sources. • Specify whether to install example applications and supporting files (including data sources) for the ColdFusion MX Getting Started tutorial. For security reasons, Macromedia recommends that you do not install example applications on production servers. •... - Page 37 Enabling features with operating system-specific binaries This step is required to support the following features that use binaries that are specific to your operating system: • Verity search engine and the , and tags cfcollection cfindex cfsearch • CFX tags written in C++ •...
-
Page 38: Enabling Sandbox Security (Aix)
Replace cf_root with the path to your cf_root directory; for example, enter the following: CFMX_APPS_PATH=/opt/WebSphere/AppServer/installedApps/cfusion.ear/ cfusion.war/WEB-INF/cfusion/lib:/opt/WebSphere/AppServer/installedApps/ cfusion.ear/cfusion.war/WEB-INF/cfusion/lib/_ilnx21/bin On Solaris: CFMX_APPS_PATH= /WEB-INF/cfusion/lib: /WEB-INF/cfusion/ lib/_solaris/bin Replace with the path to your cf_root directory; for example, enter the following: CFMX_APPS_PATH=/opt/WebSphere/AppServer/installedApps/cfusion.ear/ cfusion.war/WEB-INF/cfusion/lib:/opt/WebSphere/AppServer/installedApps/ cfusion.ear/cfusion.war/WEB-INF/cfusion/lib/_solaris/bin Append the CFMX_APPS_PATH environment variable to the LD_LIBRARY_PATH entry. The resulting line should be similar to the following: LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CFMX_APPS_PATH Make sure that LD_LIBRARY_PATH is exported... -
Page 39: Enabling Charting And Graphing (Unix)
Replace with the path to your cf_root directory; for example, enter the following: SET PATH=%PATH%;%WAS_HOME%\installedApps\cfusion.ear\cfusion.war\WEB-INF\ cfusion\jintegra\bin;%WAS_HOME%\installedApps\cfusion.ear\cfusion.war\ WEB-INF\cfusion\jintegra\bin\international Save the file and restart your computer. Enabling charting and graphing (Unix) This section describes how to configure your application server to use ColdFusion MX charting and graphing ( , and tags) on Unix. -
Page 40: Supporting Messages From A Pop Mail Server (Pre-Fixpak 4)
To remedy this, install IBM WebSphere 4 Fixpack 4. Disabling RDS after installation For security reasons, Macromedia recommends that you disable RDS on a production server. If you install and enable RDS support, you can disable it later. Note: If you disable RDS, the Browse Server button does not work in the ColdFusion MX Administrator (for example, on the ColdFusion Mappings page). -
Page 41: Undeploying Coldfusion Mx
Open the WebSphere Administrative Console. Open the Node_name > Applications > Enterprise Applications page. If the ColdFusion application status is Started, select the check box next to the Macromedia ColdFusion MX entry and click Stop. When the ColdFusion application server has stopped, select the check box next to the Macromedia ColdFusion MX entry again and click Uninstall. - Page 42 Chapter 3: Installing on WebSphere V4...
-
Page 43: Chapter 4: Enabling And Using Coldfusion Mx Features
C:\WebSphere\AppServer\installedApps\My_system\Macromedia ColdFusion MX.ear\cfusion.war for WebSphere in Windows, and /opt/WebSphere/AppServer/ installedApps/My_system/Macromedia ColdFusion MX.ear/cfusion.war on UNIX. Contents Enabling ColdFusion MX functionality ......... . 44 Managing ColdFusion MX . -
Page 44: Enabling Coldfusion Mx Functionality
ColdFusion uses LinguistX technology from Inxight, and for Asian languages, ColdFusion uses IBM Classes for Unicode (ICU) technology. This section describes how to install a Verity Search Pack from the Macromedia website, and how to switch to a different Verity Search Pack. - Page 45 System requirements You must have all of the following components installed on your computer before you can make CORBA invocations from ColdFusion MX: • Borland VisiBroker 4.5.1 for Java • Java Runtime Environment (JRE) 1.2 or higher for the VisiBroker Interface Repository Installing and configuring VisiBroker for CORBA connections This section describes how to use VisiBroker for CORBA connections.
-
Page 46: Enabling Web Services Access For Flash Remoting
If you must connect to an osagent in another subnetwork, include the following lines in the vbjorb.properties file: vbroker.agent.addr=<IP address of computer running OSAGENT> vbroker.agent.port=<port> Start the Interface Repository and load it with the IDL file that you plan to use, by entering command, as in the following example: irep irep myir MyIDLFile.idl... -
Page 47: Managing Coldfusion Mx
Data sources that you configure in the WebSphere default JNDI location are also available in ColdFusion MX. The data sources appear in the ColdFusion MX Administrator Data Source page, and you can use them in your CFML code. You cannot use the ColdFusion MX Administrator to add or modify WebSphere data sources. -
Page 48: Using The / Context Root
Starting and stopping services This section explains how to start or stop ColdFusion MX services. To start or stop a ColdFusion MX service: Open the Services dialog box: In Windows NT 4.0, select Start > Settings > Control Panel > Services. In Windows 2000, select Start >... -
Page 49: Accessing The Coldfusion Mx Administrator
However, you cannot have multiple J2EE web applications at the / context root. Therefore, if there is already a web application at the / context root, you cannot also have ColdFusion MX there. For example, when you install WebSphere 4 Single Server, the Sample Application default_app.war web module is put at the / context root. -
Page 50: Using Rds
“Differences in the ColdFusion MX Administrator” on page Using RDS If you use Macromedia Dreamweaver MX or HomeSite+ to develop your applications, Remote Development Services (RDS) lets you access a remote ColdFusion MX server using HTTP. Using RDS, IDE users can securely access remote files and data sources, build SQL queries from these data sources, and debug CFML code. -
Page 51: Configuring Rds For A New Coldfusion Mx Context Root
ColdFusion MX context root, cf_root. For example, in Windows, the RDS root directory might be C:\WebSphere\AppServer\installedApps\My_system\Macromedia ColdFusion MX.ear\rds.war. The rds.properties file has one line, with the following format:... - Page 52 Chapter 4: Enabling and Using ColdFusion MX Features...