MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION..., Using Manual

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

Page 2: ...denames of Macromedia 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 link...

Page 3: ...considerations 16 Installation considerations for all platforms 16 Installation considerations for Windows 17 Installation considerations for UNIX 18 CHAPTER 2 Installing the Server Configuration 19...

Page 4: ...ployment 43 Configuration 45 ColdFusion MX J2EE configuration directory structure 46 Undeploying ColdFusion MX 47 CHAPTER 4 Configuring Your System 49 Overview of configuration tasks 50 Managing ColdF...

Page 5: ...oldFusion MX Part I describes how to manage the ColdFusion environment including connecting to your data sources and configuring security for your applications Part II describes Verity search tools an...

Page 6: ...6 Introduction...

Page 7: ...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 9 System requirements...

Page 8: ...lly preservers existing settings You can install ColdFusion MX 6 1 in either of the following configurations Server configuration Lets you install one instance of ColdFusion with an embedded J2EE serv...

Page 9: ...uation purposes only Not licensed for deployment Standard For Windows and Linux Features full ColdFusion Markup Language CFML support including Custom tags and ColdFusion Components Full support for s...

Page 10: ...ocument search Advanced server management capabilities including server log analysis configurable probes and alarms and automated archive and deploy options J2EE support in particular Servlet Java Ser...

Page 11: ...ition SP6A x x x Windows 2000 Professional SP3 or higher Server SP3 or higher Advanced Server and Datacenter Server x x x Windows XP Home and Professional x x x Windows 2003 Web Standard and Enterpris...

Page 12: ...5 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 x x x IBM JVM 1 2 2 1 3 or later x x x Browsers for ColdFusion MX Administrator Internet Explo...

Page 13: ...7 3 8 x SuSE Linux Enterprise Server 8 Install the latest patches including the kernel from ftp ftp suse com pub Verity does not support SuSE Linux 7 3 8 x or SuSE Linux Enterprise Server 8 x x x Turb...

Page 14: ...3 6x x x x iPlanet 4 x SunONE Web Server 6 x formerly iPlanet 6 x x x 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 x x x IBM JVM 1 3 or la...

Page 15: ...a support site www macromedia com support coldfusion Edition Operating systems BEA WebLogic Server 7 0 BEA WebLogic Server 8 1 Windows NT 4 0 Server SP6A Windows 2000 Server SP2 Windows 2000 Advanced...

Page 16: ...Fusion MX 6 1 you must uninstall it before you install the release version Macromedia recommends using the built in internal port based web server for development but not in a production environment I...

Page 17: ...s built in Java and when installing the server configuration the ColdFusion MX 6 1 installer automatically installs the JRE that is appropriate for your platform When installing the J2EE configuration...

Page 18: ...ation 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 co...

Page 19: ...ins an embedded copy of JRun and is most similar to previous ColdFusion versions Note In this chapter cf_root refers to your installation directory By default this directory is C CFusionMX in Windows...

Page 20: ...update New install ColdFusion MX update Planned location of new ColdFusion MX directory ______________________________________________ Will you configure an external web server such as Apache or IIS Y...

Page 21: ...Question Answer Comment Upgrade from ColdFusion MX When upgrading from ColdFusion MX the Configuration Wizard updates the ODBC services but does not ask any questions All other installation types Ena...

Page 22: ...locate the ColdFusion MX 6 1 installation executable file coldfusion 61 win exe and double click it The installation wizard starts 9 Follow the instructions in the wizard and let it run to completion...

Page 23: ...settings 12 Configure and manage your system as described in Chapter 4 Configuring Your System on page 49 13 To learn about ColdFusion MX 6 1 read the documentation which is accessible through the Doc...

Page 24: ...starts Note To run the UNIX installer in GUI mode type filename i gui 11 Follow the prompts and let the installation program run to completion Caution For security reasons it is crucial that you do no...

Page 25: ...ettings later you might overwrite new ColdFusion MX settings 16 Configure and manage your system as described in Chapter 4 Configuring Your System on page 49 17 To learn about ColdFusion MX 6 1 read t...

Page 26: ...C services On UNIX the files for the sample PointBase databases jintegra JIntegra programs libraries and other supporting files for example to integrate Java and COM code manage access to ActiveX cont...

Page 27: ...located in the built in web server s web root directory for example C CFusionMX wwwroot YourApp1 index cfm Switching the port for the built in web server You can change the default port on which the...

Page 28: ...erThreads 8 attribute attribute name minHandlerThreads 1 attribute attribute name maxHandlerThreads 1000 attribute attribute name mapCheck 0 attribute attribute name threadWaitTimeout 20 attribute att...

Page 29: ...When the program completes remove any remaining files and directories in the cf_root directory 4 In some cases the uninstall program may require that you restart the computer ColdFusion MX 6 1 is dele...

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

Page 31: ...ructions for installing Macromedia JRun 4 which automatically deploys and configures ColdFusion MX and general instructions for use with all J2EE application servers Contents J2EE application servers...

Page 32: ...on Contains the ColdFusion MX application A web application also called a WAR uses a directory structure that contains a WEB INF web xml deployment descriptor which defines the servlets and context pa...

Page 33: ...d if you use a context root of When you deploy the ColdFusion MX EAR file it uses the context root specified when you ran the installation wizard which copied your specification to the context root el...

Page 34: ...s For installation details see Installing an EAR file or WAR files on page 39 Update existing ColdFusion MX redeploy existing EAR or WAR Select this option if ColdFusion MX is already deployed in a J2...

Page 35: ...lanet Configuration directory ______________________________________________ Apache Path to server binary ______________________________________________ If using an external web server location of you...

Page 36: ...ings specified in the installation wizard 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 insta...

Page 37: ...e previous URL with the host name or IP address of the remote computer instead of localhost 11 Answer the questions asked by the Configuration Wizard Completion of the Configuration Wizard and display...

Page 38: ...10 Follow the instructions in the installation wizard Make sure that you select Install New Version of ColdFusion MX then J2EE Configuration ColdFusion MX with JRun 4 Tip The installation wizard disa...

Page 39: ...ive to the cfusion war directory For example to display a CFM file located at opt jrun4 servers cfusion cfusion ear cfusion war eisapp index cfm using the built in JRun web server and a context root o...

Page 40: ...etwork or a downloaded file locate the ColdFusion MX 6 1 installation executable file coldfusion 61 win exe and double click it The installation wizard starts 8 Follow the instructions in the wizard a...

Page 41: ...ddoc_releasenotes 2 Make sure that your operating system meets the system requirements described in System requirements for UNIX on page 13 3 Review the Installation considerations for UNIX on page 18...

Page 42: ...ed by your application server s web server contextroot The context root for the ColdFusion MX web application For more information see Context root on page 33 filename The directory path and file to d...

Page 43: ...ur application server the instructions describe deployment of an EAR file or WAR files in either a compressed archive or an expanded directory structure When deploying ColdFusion MX on an existing ver...

Page 44: ...war on UNIX d Change to the cfusion war directory and expand cfusion war with the jar command cd cfusion war java_root bin jar xvf cfusion war This expands cfusion war e If rds war exists Go up one l...

Page 45: ...or by using a text editor to modify the jrun_root bin jvm config file After you deploy the ColdFusion MX for J2EE application you can run basic ColdFusion pages and start the ColdFusion MX Administra...

Page 46: ...ou must define the following JVM arguments Djava security manager Djava security policy cf_root WEB INF cfusion lib coldfusion policy Djava security auth policy cf_root WEB INF cfusion lib neo_jaas po...

Page 47: ...ldFusion 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 cust...

Page 48: ...48 Chapter 3 Installing the J2EE Configuration...

Page 49: ...t this directory is C CFusionMX in Windows and opt coldfusionmx on UNIX Contents Overview of configuration tasks 50 Managing ColdFusion MX 51 Configuring web servers 53 Installing Verity Locales 60 En...

Page 50: ...the production environment Disabling JSP functionality on page 63 When running ColdFusion MX Enterprise Edition in a hosted environment you might want to disable JSP processing Changing the ColdFusio...

Page 51: ...how to start and stop Windows services Note In the ColdFusion MX Administrator if you enable or disable security or change any option in the Java and JVM Settings page you must stop and restart ColdF...

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

Page 53: ...es to take effect This applies to the server configuration only in the J2EE configuration you use application server specific methods to update Java settings To manage the ColdFusion MX process on UNI...

Page 54: ...uration Tool in either GUI or command line mode This discussion describes how to use GUI mode To use the command line open the batch files located in cf_root bin connectors For more information see th...

Page 55: ...igure shows a sample JRunScripts virtual directory 4 Verify that the JRunScripts directory in each of your IIS websites points to the correct location as follows a Right click the JRunScripts director...

Page 56: ...reated cf_root runtime lib wsconfig number jrun_nsapi35 dll server configuration or jrun_root lib wsconfig number jrun_nsapi35 dll JRun J2EE configuration 2 Open the Netscape configuration file obj co...

Page 57: ...wwroot to your web server root directory To verify your Apache configuration 1 Verify that one of the following files was created cf_root runtime lib wsconfig number mod_jrun so Apache 1 3 x cf_root r...

Page 58: ...ws Apache dir etc httpd conf map cfm cfc cfml jsp jws coldfusion v Note For unique configurations such as the pre configured Apache web servers from Redhat or Sun add the bin and script parameters as...

Page 59: ...a sample command opt coldfusionmx jre bin java jar opt coldfusionmx runtime lib wsconfig jar ws NES dir usr netscape server4 https surf config map cfm cfc cfml jsp jws coldfusion v 2 Copy the CFIDE a...

Page 60: ...les packages Asian European and English 3 Extract the ZIP or TAR file in your cf_root directory During extraction the search files are automatically placed in the appropriate directories under the cf_...

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

Page 62: ...an now make CORBA invocations from ColdFusion MX For more information about integrating CORBA objects into ColdFusion MX see Developing ColdFusion MX Applications Disabling Remote Development Services...

Page 63: ...vlet mapping entry for JspLicenseServlet 3 Comment out this entry as the following example shows servlet mapping servlet name JspLicenseServlet servlet name url pattern jsp url pattern servlet mapping...

Page 64: ...your computer appear in the right pane 6 Right click ColdFusion MX Application Server and select Properties The ColdFusion MX Application Server Properties Local Computer dialog box appears 7 On the...

Page 65: ...k and a JDBC Type 2 driver from Jadazoom JDBC is an Application Programming Interface API for Java programs to access data To use a JDBC driver that is not included with ColdFusion MX such as SQLAnywh...

Page 66: ...usion MX 6 1 as follows RedHat 9 for i386 compat libstdc 7 3 2 96 118 i386 rpm RedHat 8 0 for i386 compat libstdc 7 3 2 96 110 i386 rpm RedHat 7 3 for i386 compat libstdc 6 2 2 9 0 16 i386 rpm Users m...

Page 67: ...ndows 51 starting on UNIX 53 stopping in Windows 51 stopping on UNIX 24 53 COM support JVM arguments for J2EE 45 configuration tasks overview of 50 Configuration Wizard J2EE configuration UNIX 39 J2EE...

Page 68: ...deployment 43 installation overview 34 installing 36 installing in Windows 36 installing on Unix 38 JRun Management Console JMC classpath 45 JVM arguments 45 JVM arguments J2EE configuration 45 jvm c...

Page 69: ...60 unsupported on RedHat Linux 7 3 8 and 9 66 unsupported Unix platforms 13 W WAR see web application archive WAR web application archive WAR deploying on JRun 4 45 deployment options 39 directory st...

Page 70: ...70 Index...