background image

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.

Documentation set

The ColdFusion MX documentation set includes the following titles:

Book

Description

Installing and Using 
ColdFusion MX for IBM 
WebSphere 
Application Server

Describes system installation and basic configuration for Windows NT, 
Windows 2000, AIX, Linux, and Solaris.

Configuring and 
Administering 
ColdFusion MX

 

Part I describes how to use the ColdFusion MX Administrator to manage 
the ColdFusion environment, including connecting to your data sources and 
configuring security for your applications, Part II describes Verity search 
tools and utilities that you can use for configuring the Verity K2 Server 
search engine, as well as creating, managing, and troubleshooting Verity 
collections.

Developing ColdFusion 
MX Applications

 

Describes how to develop your dynamic web applications, including 
retrieving and updating your data, using structures, and forms.

Getting Started 
Building ColdFusion 
MX Applications

 

Contains an overview of ColdFusion features and application development 
procedures. Includes a tutorial that guides you through the process of 
developing an example ColdFusion application. 

CFML Reference

 

Provides descriptions, syntax, usage, and code examples for all ColdFusion 
tags, functions, and variables.

CFML Quick Reference

  A brief guide that shows the syntax of ColdFusion tags, functions, and 

variables.

Summary of Contents for COLDFUSION MX 61 - INSTALLING COLDFUSION MX FOR IBM WEBSPHERE APPLICATION...

Page 1: ...Installing and Using ColdFusion MX for IBM WebSphere Application Server ...

Page 2: ...a Inc or other entities and may be registered in certain jurisdictions including internationally This product includes code licensed from RSA Data Security This guide contains links to third party websites that are not under the control of Macromedia and Macromedia is not responsible for the content on any linked site If you access a third party website mentioned in this guide then you do so at yo...

Page 3: ... the ColdFusion MX Administrator 14 Installing ColdFusion MX for IBM WebSphere Application Server 15 Considerations for all platforms 15 Considerations for Windows 15 Installation procedure 15 Creating and migrating applications on ColdFusion MX 16 Learning about ColdFusion MX 16 Migrating existing ColdFusion applications 16 CHAPTER 2 Installing on WebSphere V5 17 Installing and deploying Macromed...

Page 4: ... mail server pre FixPak 4 40 Disabling RDS after installation 40 Undeploying ColdFusion MX 41 CHAPTER 4 Enabling and Using ColdFusion MX Features 43 Enabling ColdFusion MX functionality 44 Installing Verity Search Packs for ColdFusion MX 44 Enabling CORBA support 44 Enabling web services access for Flash Remoting 46 Using a third party JDBC database driver 46 Managing ColdFusion MX 47 Managing the...

Page 5: ...age the ColdFusion environment including connecting to your data sources and configuring security for your applications Part II describes Verity search tools and utilities that you can use for configuring the Verity K2 Server search engine as well as creating managing and troubleshooting Verity collections Developing ColdFusion MX Applications Describes how to develop your dynamic web applications...

Page 6: ...ine 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 ...

Page 7: ...n that applies to all WebSphere installations Contents About ColdFusion MX for IBM WebSphere Application Server 8 System requirements 8 Directory structure 11 Differences between ColdFusion MX and ColdFusion MX on WebSphere Installing ColdFusion MX for IBM WebSphere Application Server 15 Creating and migrating applications on ColdFusion MX 16 ...

Page 8: ...ML in your applications For more information see http java sun com j2ee Overview of ColdFusion MX for IBM WebSphere Application Server The ColdFusion MX for IBM WebSphere Application Server runtime environment is a Java application that takes advantage of the services in the J2EE platform to connect to databases manage security and process application requests It provides the full scripting enviro...

Page 9: ...ta download htm For all UNIX distributions install the latest production level patches including the kernel from the supplier s download sites for Red Hat ftp ftp redhat com pub for SuSE ftp ftp suse com pub for Solaris http sunsolve sun com pub cgi show pl target patches patch access for AIX http www ibm com software webservers appserv support html To use C CFXs with RedHat Linux 8 0 the Linux in...

Page 10: ...eveloper Mode Windows 256 MB All others 512 MB Free hard disk space To deploy 400 MB To run 250 MB CD ROM drive Browsers supported for ColdFusion MX Administrator All Internet Explorer 5 x 6 Netscape 4 6 7 Mozilla 1 0 Supported Databases All JDBC drivers are included for the following databases Oracle 8 1 6 8 1 7 9i R1 R2 Sybase 11 5 11 9 12 12 5 DB2 for Windows UNIX and Linux v7 1 v7 2 v8 1 DB2 f...

Page 11: ...tion servers IBM WebSphere 4 IBM WebSphere Advanced Edition Single Server 4 0 3 4 0 4 or 4 0 5 Advanced Edition 4 0 3 4 0 4 or 4 0 5 Note FixPAK 3 or later is required IBM WebSphere 5 IBM WebSphere Application Server 5 0 or 5 0 1 IBM WebSphere Application Server for Developer 5 0 or 5 0 1 IBM WebSphere Application Server for Network Deployment 5 0 or 5 0 1 Directory Contents cfdocs Documentation f...

Page 12: ...ample databases in Windows the files for sample Microsoft Access databases and ODBC services On UNIX the files for the sample Pointbase databases Also includes software for installing ODBC support and other database system specific files 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 ...

Page 13: ...X and ColdFusion MX for IBM WebSphere Application Server Note If you are developing a ColdFusion application on the ColdFusion MX server and you are deploying it to IBM WebSphere Application Server also see Chapter 4 Migrating a ColdFusion application to IBM WebSphere Application Server on page 49 Location of ColdFusion MX root directory In the ColdFusion MX server the default location of the Cold...

Page 14: ...on ear cfusion war websphere_root AppServer installedApps cfusion ear cfusion war AIX websphere_root AppServer installedApps app_name cfusion war websphere_root AppServer installedApps app_name cfusion war Administrator component Status Notes For all servers and operating systems Server Settings Java and JVM Removed Your application server handles these settings not ColdFusion MX Server Settings A...

Page 15: ... page at www 3 ibm com software webservers coldfusionmx library html Considerations for Windows The following are installation considerations for Windows If you previously added a cf_root bin or cf_root verity _nti40 bin directory to your system path for ColdFusion 5 you must remove it before installing ColdFusion MX for J2EE For instructions see the Microsoft Windows online Help Otherwise ColdFus...

Page 16: ...formation that can help you to quickly begin using ColdFusion MX Getting Started Building ColdFusion MX Applications 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 info...

Page 17: ... cfmxj2ee cert for any updates to these installation instructions or other late breaking information This chapter uses the following conventions websphere_root refers to the directory in which IBM WebSphere Application Server is installed for example C Program Files WebSphere in Windows and opt WebSphere on UNIX cf_root refers to the directory to which ColdFusion is deployed for example C Program ...

Page 18: ...orted operating systems and the files on the product CD that you use to install ColdFusion MX Note The installation files on the IBM website use the product part number as the filename Also the AIX Linux and Solaris installation files on the website are in tar gz zip archives you must unzip these archives to get the installable bin files If you use a downloaded file replace the CD image filename i...

Page 19: ...les 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 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 System Pro...

Page 20: ...rd page enter the password to require for the ColdFusion MX Administrator Review the options in the Pre Installation Summary section and accept them to complete the installation When the installation is complete the EAR file and any backup files are put in the specified locations The installation wizard exits and a product registration page appears Continue with the next section of the instruction...

Page 21: ...ctory browsing on the server file system 6 Accept the default values on the Preparing Application Install page if appropriate for your WebSphere configuration Click Next 7 Accept the default values in the Step 1 Provide Options to Perform the Installation panel of the Install New Application procedure if appropriate for your WebSphere configuration Click Next Note You might want to change the appl...

Page 22: ...ed do the following a Open the Enterprise Applications panel and make sure that the ColdFusion application is stopped b Copy the files in the backup directory that you specified in the Installing the ColdFusion MX files procedure back to your cf_root directory for example C Program Files WebSphere AppServer installedApps Macromedia ColdFusion MX ear cfusion war Ensure that the files from the backu...

Page 23: ...run the wizard click Next See Enabling and configuring specific ColdFusion MX functionality on page 23 for information on the additional configuration steps you must take to enable all available ColdFusion MX features When the wizard displays the Finish page click OK to open the ColdFusion MX Administrator When the Administrator opens you can configure ColdFusion features Running the Administrator...

Page 24: ... on a single long line before the line that starts with SET WAS_CLASSPATH SET CFMX_APPS_PATH cf_root WEB INF cfusion lib cf_root WEB INF cfusion lib _nti40 bin Replace cf_root 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 Macromed...

Page 25: ...media ColdFusion MX ear cfusion war WEB INF cfusion lib WAS_HOME installedApps WAS_NODE Macromedia ColdFusion MX ear cfusion war WEB INF cfusion lib _ilnx21 bin 3 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 WAS_LIBPATH LD_LIBRARY_PATH CFMX_APPS_PATH 4 Save the file and restart your WebSphere Appli...

Page 26: ...re Administrative Console 2 In the left navigation bar select Node_name Servers Application Servers 3 Select your J2EE application server for example Server1 4 On the Configuration tab of the Application server page click the Process Definition link in the Additional Properties box 5 On the Process Definition page click the Java Virtual Machine link in the Additional Properties box 6 In the Additi...

Page 27: ... name servlet class coldfusion bootstrap BootstrapServlet servlet class init param id InitParam_103401311065856789 param name servlet class param name param value coldfusion rds RdsFrontEndServlet param value init param servlet Note Some of the text in the servlet definition might vary 4 Comment out the RDS Servlet mapping as the following example shows servlet mapping id macromedia_mapping_5 serv...

Page 28: ...dure and selecting the Enabled check box Undeploying ColdFusion MX This section describes how to undeploy ColdFusion MX from IBM WebSphere Application Server To undeploy ColdFusion MX 1 Windows only If the ODBC services are installed open the Services panel and ensure that the ColdFusion MX ODBC server and the ColdFusion MX ODBC agent are stopped 2 Open the WebSphere Administrative Console 3 Open ...

Page 29: ...site at www macromedia com go cfmxj2ee cert for any updates to these installation instructions or other late breaking information This chapter uses the following conventions websphere_root refers to the directory in which IBM WebSphere Application Server is installed for example C WebSphere in Windows and opt WebSphere on UNIX cf_root refers to the directory to which ColdFusion is deployed for exa...

Page 30: ...sts the supported operating systems and the files you use to install ColdFusion MX Use the following procedure to install the ColdFusion MX EAR file and installation documentation Note The installation files on the IBM website use the product part number as the filename Also the AIX Linux and Solaris installation files on the website are in tar gz zip archives you must unzip these archives to get ...

Page 31: ...usion MX If you select the 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 System Procedure AIX Set the working directory to the directory that contains the JAR file listed in the preceding table En...

Page 32: ...tion must service an incoming request The default value is cfmx For information see Using the context root on page 48 In the ColdFusion MX Administrator password page enter the password to require for the ColdFusion MX Administrator Review the options in the Pre Installation Summary section and accept them to complete the installation When the installation is complete the EAR file and any backup f...

Page 33: ... empty Click Next 6 Select the virtual host or hosts in which to install the ColdFusion application and Remote Development Services RDS support Click Next 7 Review the installation summary if it is correct click Finish 8 Save the configuration and regenerate the Plug in configuration 9 On AIX systems if you are using the standard WebSphere JVM Version 1 3 1 or any version other than 1 4 2 make sur...

Page 34: ...e logs for details This message indicates that uninstalling the application is taking some time it does not necessarily indicate a problem You can check the J2EE server logs for example C Program Files WebSphere AppServer logs server1 SystemOut log for any errors before proceeding d In the Messages box at the top of the Administrative Console page click the Save link to apply changes to the master...

Page 35: ...n the Installing the ColdFusion MX files procedure back to your cf_root directory for example C WebSphere AppServer installedApps MyHost cfusion ear cfusion war Ensure that the files from the backup directory tree overwrite any files with the same names in the cf_root directory tree 13 Select the application name you specified from the Enterprise Applications list and click the Start button on the...

Page 36: ...ke to enable all available ColdFusion MX features When the wizard displays the Finish page click OK to open the ColdFusion MX Administrator When the Administrator opens you can configure ColdFusion features Running the Administrator confirms that the installation procedure was successful However you must perform the tasks described in the Enabling and configuring specific ColdFusion MX functionali...

Page 37: ...in the websphere_root AppServer bin directory 2 Open the original file for editing and add the following on a single long line before the line that starts with SET WAS_CLASSPATH SET CFMX_APPS_PATH cf_root WEB INF cfusion lib cf_root WEB INF cfusion lib _nti40 bin Replace cf_root with the path to your cf_root directory for example enter the following SET CFMX_APPS_PATH WAS_HOME installedApps cfusio...

Page 38: ... permissions for accessing class files To grant full permissions ensure that you have a websphere_root AppServer properties java policy file with the following contents PERMISSIONS GRANTED TO EVERYONE grant permission java security AllPermission Note Sandbox security cannot restrict Java access to files and network resources on WebSphere 4 Enabling access to COM objects Windows This section explai...

Page 39: ...er Advanced Edition Single Server To enable charting and graphing 1 Open the WebSphere Administrative Console 2 In the left navigation bar select Nodes computer_name Application Servers Default Server Process Definition JVM Settings 3 On the JVM Settings page type the following in the Boot Classpath field On Windows Linux and Solaris cf_root WEB INF lib webchartsJava2D jar On AIX cf_root WEB INF c...

Page 40: ... MX Administrator for example on the ColdFusion Mappings page To disable RDS you must do the following Disable the ColdFusion MX web module RDS Servlet Doing so ensures that ColdFusion MX cannot respond to any RDS requests If your ColdFusion MX application context root is not disable or undeploy the RDS redirector web module For a description of the module see Using RDS on page 50 Disabling the RD...

Page 41: ...tarted select the check box next to the Macromedia ColdFusion MX entry and click Stop 4 When the ColdFusion application server has stopped select the check box next to the Macromedia ColdFusion MX entry again and click Uninstall WebSphere uninstalls the ColdFusion application 5 Save the new configuration by clicking the save link in the messages box The Save panel appears Click Save 6 Stop the Web...

Page 42: ...42 Chapter 3 Installing on WebSphere V4 ...

Page 43: ... WebSphere on UNIX cf_root refers to the directory to which ColdFusion is deployed for example 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 47 Using the context...

Page 44: ...Fusion MX for J2EE in your browser go to the following location on the Macromedia website www macromedia com go verity Enter your serial number on the Verity Search Packs page and click Submit 2 Download the appropriate Verity Search Pack ZIP file for Windows TAR file for UNIX for your operating system and save it to the cf_root WEB INF cfusion directory in Windows and the cf_root WEB INF cfusion ...

Page 45: ...e CORBA Connectors page click Register CORBA Connector c On the CORBA Connector page enter information for the connector The following are values for an example connector The ORB Property File points to a Java properties file that contains the correct ORB settings for VisiBroker The contents of the vbjorb properties file look like the following org omg CORBA ORBClass com inprise vbroker orb ORB or...

Page 46: ...ge 47 You can make CORBA invocations from ColdFusion MX For more information about integrating CORBA objects into ColdFusion MX see Developing ColdFusion MX Applications Enabling web services access for Flash Remoting By default Flash Remoting cannot access web services through ColdFusion MX 6 1 To enable Flash Remoting to access web services through ColdFusion MX 6 1 1 Open the cf_root WEB INF we...

Page 47: ...r online Help You can now use the third party JDBC database driver Managing ColdFusion MX This section explains how to manage ColdFusion MX and the Windows services that are created when you deploy ColdFusion MX Managing the ColdFusion MX application IBM WebSphere Application Server manages the ColdFusion MX web application Therefore to start stop or restart ColdFusion MX start stop or restart the...

Page 48: ...ox In Windows NT 4 0 select Start Settings Control Panel Services In Windows 2000 select Start Settings Control Panel Administrative Tools Services 2 Do one of the following In Windows NT double click the service to configure The dialog box for the service opens In Windows 2000 right click the service that you want to configure and select Properties In the Properties dialog box click the General t...

Page 49: ...MX Administrator documentation describes features that are not available or behave differently in ColdFusion MX for IBM WebSphere Application Server For information on these differences see Differences in the ColdFusion MX Administrator on page 14 Migrating a ColdFusion application to IBM WebSphere Application Server This section describes how to migrate an application that you developed for ColdF...

Page 50: ... on page 14 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 However to maximize security do not install RDS on production servers Note Cold...

Page 51: ...ot directory is typically located in the same directory as the 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 contextRoot ColdFusion_context_root for example contextRoot cfmx When you change the ColdFusion MX ap...

Page 52: ...52 Chapter 4 Enabling and Using ColdFusion MX Features ...

Reviews: