background image

ColdFusion MX 7 J2EE deployment and configuration

41

c

In cfusion-ear, make a new directory named cfusion-war.

    md cfusion-war (mkdir cfusion-war on UNIX)

d

Change to the cfusion-war directory and expand the cfusion.war file with the 

jar

 

command:

    cd cfusion-war
    

java_root

/bin/jar -xvf ../cfusion.war

This expands the cfusion.war file.

e

(If rds.war exists) Go up one level to cfusion-ear, make a new directory named rds-war.

    cd ..
    md rds-war (mkdir rds-war on UNIX)

f

(If rds.war exists) Change to the rds-war directory and expand rds.war with the 

jar

 

command:

    cd rds-war
    

java_root

/bin/jar -xvf ../rds.war

This expands rds.war.

g

Go up one level to the cfusion-ear file, and delete the cfusion.war and rds.war files:

    cd ..
    del cfusion.war (rm cfusion.war on UNIX)
    del rds.war (rm rds.war on UNIX)

h

Open the cfusion-ear/META-INF/application.xml file in a text editor.

i

Change the 

web-uri

 element from cfusion.war to cfusion-war (or the name of the directory 

that contains the expanded cfusion.war file). Change the 

web-uri

 element for rds.war to 

rds-war. A directory name in the 

web-uri

 element cannot contain a dot.

j

Save the application.xml file.

3.

Deploy ColdFusion MX 7 by copying the cfusion-ear directory structure to the 

jrun_root

/

servers/

servername

 directory. If auto deploy is enabled, JRun 4 either deploys the application 

immediately (if the JRun server is running), or when you start the JRun server.

4.

Review the server log (

jrun_root

/logs/

servername

-event.log) to ensure that ColdFusion MX 7 

deployed successfully.

Expanding and deploying WAR files on JRun 4

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

.

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

Page 1: ...COLDFUSION MX7 Installing and Using ColdFusion MX...

Page 2: ...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 Copyright 1999 2005 Mac...

Page 3: ...tructure 20 Using the built in web server 21 Uninstalling ColdFusion MX 7 23 CHAPTER 3 Installing the Multiserver Configuration 25 About multiserver configuration 25 Installing ColdFusion MX 7 using t...

Page 4: ...bling Remote Development Services 59 Disabling JSP functionality server configuration only 60 Changing the ColdFusion MX 7 user account in Windows 61 Connecting to an external JDBC Type 4 data source...

Page 5: ...for configuring the Verity Search Server engine as well as creating managing and troubleshooting Verity collections To see this manual go to www macromedia com go livedocs_cfmx7docs_configadmin ColdFu...

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

Page 7: ...n MX 7 installation process includes the following phases 1 Plan the installation You determine your installation configuration and upgrade options 2 Run the installer You run the ColdFusion MX 7 inst...

Page 8: ...WebSphere or BEA WebLogic When you use the J2EE configuration you can deploy ColdFusion MX 7 multiple times on a single computer For information on installing the J2EE configuration see Chapter 4 Inst...

Page 9: ...with Component Object Model COM Enterprise Java Beans EJBs and Common Object Request Broker Architecture CORBA Rich forms A built in charting and graphing engine including enhancements in ColdFusion...

Page 10: ...teway support including XMPP Jabber IM Gateway Lotus Sametime IM Gateway Asynchronous CFML Gateway SMS Mobile Cell Gateway and local SMS development toolkit The ability to import and execute Java Serv...

Page 11: ...sion MX 7 Previous versions of ColdFusion MX including ColdFusion MX 6 1 can coexist with ColdFusion MX 7 however you cannot install ColdFusion MX 7 in the directory where ColdFusion MX 6 1 resides Yo...

Page 12: ...Primary Domain Controller PDC or Backup Domain Controller BDC Macromedia follows the Microsoft network model in which the first level is the PDC or BDC These systems only manage the network or domain...

Page 13: ...erience Tutorials Documentation Note Do not install the Getting Started Experience if you are installing in a production environment All JRun installation directory ___________________________________...

Page 14: ...usion MX Administrator password ___________________________________ All Do you want to enable RDS Yes No Note RDS allows the server to interact with remotely connected developers Macromedia recommends...

Page 15: ...ents Installing ColdFusion MX 7 using the server configuration 15 Installing the ColdFusion Report Builder 19 Installing the Verity search server separately 19 ColdFusion MX 7 server configuration dir...

Page 16: ...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 install...

Page 17: ...e your ColdFusion 5 settings later you might overwrite new ColdFusion MX 7 settings Installing the ColdFusion MX 7 server configuration on UNIX This section explains how to install ColdFusion MX 7 on...

Page 18: ...use root for the runtime user 12 Start ColdFusion MX 7 with the following command cf_root bin coldfusion start If you specified the use of an external web server when you ran the installer ColdFusion...

Page 19: ...server side runtime processing and the ColdFusion Report Builder The server side processing is available on any platform however the ColdFusion Report Builder runs on Windows only To install the Cold...

Page 20: ...or 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 lib JAR XML propert...

Page 21: ...YourApp1 index cfm Note If you install the Server configuration of ColdFusion MX 7 with the built in server and port 8500 is in use for example by ColdFusion MX or ColdFusion MX 6 1 the installer star...

Page 22: ...s 1 attribute attribute name maxHandlerThreads 1000 attribute attribute name mapCheck 0 attribute attribute name threadWaitTimeout 20 attribute attribute name backlog 500 attribute attribute name deac...

Page 23: ...3 When the program completes remove any remaining files and directories in the cf_root directory 4 In some cases the uninstall program may require you to restart the computer ColdFusion MX 7 is delete...

Page 24: ...24 Chapter 2 Installing the Server Configuration...

Page 25: ...server instance creation feature of ColdFusion MX 7 you must uninstall it before you install the multiserver configuration of ColdFusion MX 7 When you use the multiserver configuration you can use th...

Page 26: ...nfiguration Tool with the settings specified in the installation wizard Note The default JRun web server port for the cfusion server is 8300 However if you install the multiserver configuration of Col...

Page 27: ...stem as described in Chapter 5 Configuring Your System on page 45 13 To install the ColdFusion MX 7 Extensions for Dreamweaver double click the cfmx7dreamweaverextensions mxp file which is located in...

Page 28: ...llation file 8 Start the installation with the following command filename i console The installation program starts Note To run the UNIX installer in GUI mode type filename i gui 9 Follow the instruct...

Page 29: ...cfm Configuration In addition to enabling sandbox security in the ColdFusion MX Administrator the application server must be running a security manager java lang SecurityManager and you must define t...

Page 30: ...ll program files and related components from your computer To uninstall ColdFusion MX 7 from Windows 1 Select Start Settings Control Panel Add Remove Programs Macromedia ColdFusion MX 7 with JRun 4 2...

Page 31: ...ion servers One of the main advantages of ColdFusion MX 7 is that it can be installed as an integrated server the server configuration or deployed as a Java application on a standards based J2EE appli...

Page 32: ...b application that redirects requests from CFIDE to context root CFIDE It forwards requests to the ColdFusion MX Administrator when ColdFusion MX 7 uses a context root other than a forward slash Enter...

Page 33: ...a server instance must have a unique context root The JRun default web application uses for a context root so if you want to use for the ColdFusion MX 7 context root when you deploy on JRun you must e...

Page 34: ...installation details see Installing an EAR file or WAR files on page 34 Installing an EAR file or WAR files If your computer is already running a J2EE application server the installation wizard create...

Page 35: ...sion MX 7 on page 13 6 Close any applications that are currently running on your computer 7 Insert the CD or download the setup file from the Macromedia website 8 If the installation wizard does not s...

Page 36: ...on MX or ColdFusion MX 6 1 for J2EE on page 38 before you continue By default the ColdFusion MX 7 J2EE installation places files in the opt cfmx7 directory To install into a different directory you mu...

Page 37: ...installed or not enabled edit the rds properties file to match the ColdFusion context root restart the application server and re open the ColdFusion MX Administrator 12 Open the ColdFusion MX Administ...

Page 38: ...the cf_webapp_root WEB INF cfusion lib directory 7 Copy the backed up ColdFusion MX 6 1files settings files to the ColdFusion MX 7 cfusion lib cf6settings directory 8 Edit the ColdFusion MX 7 cfusion...

Page 39: ...which is localhost To install the Verity search server separately 1 Download your platform specific installer from the Macromedia website at www macromedia com go verity or copy it from the ColdFusion...

Page 40: ...are already using an application with an empty context root you must use a context root other than for the cfusion ear file If you specified when you installed ColdFusion MX 7 you can change it by ope...

Page 41: ...on xml file in a text editor i Change the web uri element from cfusion war to cfusion war or the name of the directory that contains the expanded cfusion war file Change the web uri element for rds wa...

Page 42: ...Linux In addition some of these features require server specific environment settings The following list includes platform specific functionality and the steps you must perform to enable their use COM...

Page 43: ...ar file in the WEB INF cfusion lib directory you should rename or delete the WEB INF cfusion lib tools jar file to ensure that your application server s tools jar file is used ColdFusion MX 7 J2EE con...

Page 44: ...cific undeploy functionality In JRun 4 you undeploy by deleting the jrun_root server servername cfusion ear directory 5 If necessary restart the application server WEB INF cfusion jintegra JIntegra pr...

Page 45: ...ionMX7 in Windows and opt coldfusionmx7 on UNIX Jrun_root refers your installation directory in the multiserver configuration By default this directory is C JRun4 in Windows and opt jrun4 on UNIX Cont...

Page 46: ...r meets your needs Enabling CORBA support on page 57 You must do this only if you must make CORBA invocations from ColdFusion MX 7 You can do this after you install ColdFusion MX 7 and before you make...

Page 47: ...or change any option in the Java and JVM Settings page you must stop and restart ColdFusion MX 7 for your changes to take effect This applies to the server configuration only in the multiserver and J2...

Page 48: ...you want to configure and select Properties 3 In the Properties dialog box click the General tab 4 Select one of the following options in the Startup Type frame or drop down list box Automatic Starts...

Page 49: ...r a cluster You configure an external web server connection using the Web Server Configuration Tool which you can run either through a graphical user interface GUI or the command line The Windows disc...

Page 50: ...guration Tool by selecting Start Programs Macromedia ColdFusion MX 7 Web Server Configuration Tool 2 Click Add 3 In the Server drop down list box select the host name and the server or cluster name th...

Page 51: ...the Home Directory tab click Configuration c In the Application Configuration dialog box click the App Mappings tab You should see mappings for cfm cfml cfc cfswf cfr jsp and jws in the Extension colu...

Page 52: ...n the server configuration Note The server or cluster does not have to reside on the web server computer 4 In the Web Server Properties area select SunONE Web Server iPlanet or Netscape Enterprise Ser...

Page 53: ...7 in Windows 1 Start the Web Server Configuration Tool by selecting Start Programs Macromedia ColdFusion MX 7 Web Server Configuration Tool 2 Click Add 3 In the Server drop down list box select the ho...

Page 54: ...fig Ssl false JRunConfig IgnoreSuffixmap false JRunConfig Serverstore c CFusionMX7 runtime lib wsconfig 1 jrunserver store JRunConfig Bootstrap 127 0 0 1 51000 JRunConfig Errorurl optionally redirect...

Page 55: ...s pages from cf_root wwwroot to your web server root directory In the multiserver configuration these files are under the jrun_root servers cfusion cfusion ear cfusion war directory To verify your Ap...

Page 56: ...ws sunone dir path_to_config coldfusion v 2 Copy the CFIDE and cfdocs directories from cf_root wwwroot to your web server root directory In addition copy your application s CFM pages from cf_root wwwr...

Page 57: ...h German Italian Norwegian Bokmal Norwegian Nynorsk Portuguese Spanish and Swedish verity_multilanguage_locale zip 3 Extract the ZIP file in your cf_root directory During extraction the search files a...

Page 58: ...the full Visibroker installation c Click Submit Changes 3 Configure a Visibroker connector in ColdFusion MX 7 as follows a In the ColdFusion MX Administrator select Extensions CORBA Connectors b In th...

Page 59: ...Fusion MX 7 on page 46 You can now make CORBA invocations from ColdFusion MX 7 For more information about integrating CORBA objects into ColdFusion MX 7 see ColdFusion MX Developer s Guide Disabling R...

Page 60: ...JSP code runs outside of the realm of the ColdFusion MX 7 security framework and therefore is not subject to ColdFusion MX 7 sandbox security you do not typically deploy JSPs in a shared hosted envir...

Page 61: ...tion Server and select Restart Caution Do not rename your Windows Administrator account This causes problems with security policies and profiles Connecting to an external JDBC Type 4 data source To us...

Page 62: ...62 Chapter 5 Configuring Your System...

Page 63: ...les in Windows causes the installer to abort after extracting from the archive Solution Change the TEMP or TMP environment variable so it does not include spaces Incomplete download Problem InstallAny...

Page 64: ...r Solution Run the Web Server Configuration Tool to unconfigure and reconfigure your web server connectors as described in Configuring web servers on page 49 Cannot start ColdFusion MX 7 Server Proble...

Page 65: ...ldFusion 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 ICSF dll In ColdFusion MX 7 you have not mappe...

Page 66: ...rsion of ColdFusion to ColdFusion MX 7 your application does not recognize data sources Solution Redefine the data sources CFCs not recognized in Dreamweaver Problem When you migrate from a previous v...

Page 67: ...her jar on Mac OS X in GUI mode the password and confirm password fields on the Administrator Password panel are not editable Solution To be able to enter a password click Next and then click OK when...

Page 68: ...ColdFusion MX 7 the classloader is consistent across all editions the ColdFusion classloader is no longer blended with the application server s classloader This change was made to ensure that ColdFusi...

Page 69: ...ents for J2EE 42 43 configuration multiserver 25 tasks overview of 46 types of 8 connect to an external Type 4 data source 61 context path 33 context root 33 CORBA enabling 57 JVM arguments for J2EE 4...

Page 70: ...12 java args argument 42 java lang SecurityManager 29 43 java library path argument 42 jIntegra binary directories 42 43 JRE 12 JRun EAR deployment 40 installing 26 34 installing in Windows 26 install...

Page 71: ...erations 12 installing on 17 managing process in 48 process for ColdFusion MX 7 48 restarting ColdFusion MX 7 on 48 starting ColdFusion MX 7 on 49 user account changing for ColdFusion MX 61 V Verity i...

Page 72: ...72 Index...

Reviews: