Macromedia ColdFusion - 2016 Installation Manual

Installing

ADOBE®

COLDFUSION  SFMFBTF

Legal notices

For legal notices, see http://help.adobe.com/en_US/legalnotices/index.html.

Last updated 2/17/2016

Understanding ColdFusion Server Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

Preparing to Install ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Installing the Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Installing the JEE Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Installing ColdFusion Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Installing Integrated Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Configuring your System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Troubleshooting installation issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

iii

Last updated 2/17/2016

Understanding ColdFusion Server Profiles

To develop and deploy ColdFusion applications, you can use one of the multiple server profiles available when you install ColdFusion. The ColdFusion installer allows you to install the ColdFusion Server in the following profiles (modes):

1 Development profile

2 Production profile

3 Production profile (secure)

Depending on the type of profile selected during the installation, the server will be automatically configured with the appropriate settings. Choose the right profile in the installer:

Last updated 2/17/2016

Once you install the Server using a particular profile, you can't change the profile later.

The following table shows the difference between the 3 supported Server profiles:

Feature Development Profile Production Profile Production Profile (Secure)

Support for all types of debugging

Support for remote inspection Yes No No

Support for strict enforcement of complex passwords

Support for remote start/stop Yes No No

Support for Weinre and other bundled servers (For instance, Node.js)

Support for enabling unused servlets

Support for Secure Profile . No No Yes

Yes No No

No Yes Yes

Yes No No

Depending upon the option selected, a few settings will be pre-configured in the Administrator. You have no choice to change these settings during installation. However, you can modify these settings later from the Administrator (NOT RECOMMENDED).

Note: For the Production Profile, only the basic security settings are pre-configured by the installer. If you need a highly secure producture server, use the Production Profile (Secure) or manually configure the security settings.

Preparing to Install ColdFusion

Last updated 2/17/2016

Note:Understand the various ColdFusion Server Profiles. Understanding ColdFusion Server Profiles.

Preparing to Install ColdFusion

Just before installing Adobe ColdFusion, review the ColdFusion product editions, system requirements, and other high-level considerations.

About the ColdFusion installation

ColdFusion provides a powerful and flexible installation and upgrade process. The ColdFusion installation process includes the following phases:

1 Plan the installation by determining your installation, configuration, and upgrade options.

2 Run the ColdFusion installer.

3 (JEE configuration only) Deploy and configure ColdFusion on your JEE application server. The ColdFusion

installation process supports the following scenarios:

• New installation Install ColdFusion on a computer with no earlier ColdFusion installation.

• Upgrade installation You can upgrade from ColdFusion 11 or ColdFusion 10. When upgrading, the installer

preserves the existing settings and installs in a new directory, automatically assigning ports that do not conflict with the existing installation.You can install ColdFusion 2016 in any of the following configurations:

• Server configuration Lets you install ColdFusion with an embedded JEE server. This was formerly known as the

stand-alone configuration. For enterprise and developer licenses, you can create and manage new ColdFusion instances. For information on installing the server configuration, see

Note: ColdFusion does not offer a separate multi-server mode of installation.

Installing the Server Configuration.

• JEE configuration (Enterprise Edition only) Lets you deploy ColdFusion 2016 as a Java application running on

a Java Enterprise Edition (JEE) application server, using a third-party JEE server, such as IBM WebSphere or Oracle WebLogic. When you use the JEE configuration, you can deploy ColdFusion multiple times on a single computer. For information on installing the JEE configuration, see

Installing the JEE Configuration.

Installing ColdFusion

ColdFusion product editions

The ColdFusion product editions are available on the Adobe website. To view the product editions, go to

www.adobe.com/go/learn_cfu_cfeditions_en.

System requirements

The ColdFusion system requirements are available on the Adobe website. To view the system requirements, including a list of supported JEE application servers, see

www.adobe.com/go/learn_cfu_cfsysreqs_en.

Installation considerations

Before installing ColdFusion, review the considerations for installing or upgrading on your platforms.

Note: To use VisiBroker for CORBA connections in ColdFusion, see Enabling CORBA support (refer to Configuring your System) .

• Adobe ColdFusion (2016 release), ColdFusion 11, ColdFusion 10, and ColdFusion 9 can co-exist on the same

system.

Last updated 2/17/2016

• In the case of ColdFusion cluster setup, any changes to the cluster settings, for example, adding a new member, or

changing member port (in the ColdFusion Administrator) causes web server restart. This may result in page timeout.Refresh the page to resolve this issue.

• If ColdFusion uninstaller is not able to remove the connector for Apache (for example, in the case of Mac OS X), do

the following to manually remove it:

1 Delete the mod_jk.conf found in {apache_install_location}/conf/ directory.

2 Delete {cfroot}/config/wsconfig/<magic_number> folder which has the Apache connector file, mod_jk.so.

3 Remove the following line from {apache_install_location}/conf/httpd.conf file:Include

"{apache_install_location}\conf\mod_jk.conf".

4 From the ColdFusion Administrator, when you wish to start multiple instances, start the cfusion instance first, and

then start the other instances..

5 When you run the ColdFusion uninstaller, the logs folder (ColdFusion_Home/cfusion/) is deleted.

6 When you install ColdFusion, you can install the Administrator Component to start and stop remote server. Use the

Remote Instance Administrator Component credentials to remotely start/stop the server from applications such as Server Manager, Instance Manager in ColdFusion Administrator, or ColdFusion Builder.

7 JEE deployment of ColdFusion EAR or WAR on JRun is not supported. The EWS.jar }}must be present in the

{{systemclasspath while deploying on a JEE server.

Installation considerations for all platforms

The following are installation considerations for all platforms:

Installation considerations for Windows

The following installation considerations are for Windows systems only:

• Do not configure the server running ColdFusion as a Primary Domain Controller (PDC) or Backup Domain

Controller (BDC). Adobe follows the Microsoft network model, in which the first level is the PDC or BDC. These systems only manage the network or domain and are not designed to run application servers. ColdFusion should reside on the second level of Microsoft Windows stand-alone systems. Stand-alone servers can participate in a network or domain.

• Microsoft Windows XP handles only ten incoming TCP/IP connections concurrently. Therefore, Adobe does not

recommend using this operating system in a production environment; use Microsoft Windows 2003 Server and Windows 2008 Server instead.

Installation considerations for UNIX

The following are installation considerations for UNIX systems only:

• For troubleshooting purposes, the installer creates the following log file during an installation or upgrade in UNIX:

cf_root/Adobe_ColdFusion_2016_InstallLog.log. If you contact AdobeTechnical Support for installation support, send them this file.

• If you are deploying the JEE configuration on a platform other than Linux or Solaris, use the

ColdFusion_2016_WWEJ_java.jar. This Java-only installer does not include features that require platform-specific binary files, such as C++ CFX support.

Installing the Server Configuration

Installing the Server configuration

Last updated 2/17/2016

The ColdFusion server configuration contains an embedded copy of Tomcat and is most similar to earlier versions of ColdFusion.

Note : The cf_root directory refers to your installation directory. By default, this directory is C:\ColdFusion2016 in Windows, and /opt/ColdFusion 2016 in UNIX.

Although the Adobe ColdFusion (2016 release) installer provides an intuitive interface, it helps to plan your answers to the questions asked by the installer. Use the steps below to install the server configuration of Adobe ColdFusion (2016 release).

Accept the license agreement.

Last updated 2/17/2016

Enter the serial number.

Choose the type of installation:

• Server configuration

• JEE configuration

Enable the API Manager check-box and continue with the installation process.

You can view this option only if you have entered a valid serial number or chosen 30-day trial.

Last updated 2/17/2016

Select one of the supported Server profiles. For more information on the profiles, see Und erst anding C oldFusion Ser ver

Profiles.

Select the sub-components to install.

Last updated 2/17/2016

Enable/disable the servlets to use.

Note: this option is valid only for the following profiles:

• Production profile

• Production + Secure Profile

Specify the credentials to log in to ColdFusion administrator.

Last updated 2/17/2016

Note: For the Production Profile and Production + Secure Profile, there is a certain amount of password strength that is expected. If the password is not string enough, you get the following warning message:

Access add-on services remotely by allowed certain IP addresses.

Last updated 2/17/2016

Enter the installation folder for ColdFusion.

Choose an option if there is a previous version of ColdFusion in your server.

Last updated 2/17/2016

• Configure web server for ColdFusion

• Enable ColdFusion in-built web server

Configure the IIS web server.

Last updated 2/17/2016

Specify the port of the built-in web server.

Confirm the administrator password.

Last updated 2/17/2016

Enable or disable RDS.

RDS allows the server to interact with remotely connected developers. Adobe recommends that you disable RDS for production servers.Disabling RDS also disables the directory browsing applets in the ColdFusion Administrator.

Specify if you want to check for server updates.

Last updated 2/17/2016

View the pre-installation details.

Exit the installation and verify the installation by logging in to the administrator.

Installing ColdFusion using the server configuration

Once you have determined the answers to the questions in the above section Gathering information necessary to install the server configuration, you can install the ColdFusion server configuration in Windows or UNIX, as applicable.

Installing ColdFusion server configuration in Windows or MAC

Last updated 2/17/2016

Note: (Windows only) The Windows installer requires a computer that supports at least 256 colors.

Install ColdFusion in Windows or MAC

1 Read the online version of the Release Notes for any late-breaking information or updates. For more information,

www.adobe.com/go/learn_cfu_releasenote_en.

see

2 Ensure that your operating system meets the system requirements described on the Adobe website at

www.adobe.com/go/learn_cfu_cfsysreqs_en.

3 Review Installation considerations for Windows and Installation considerations for all platforms (Refer to the

Installing Adobe ColdFusion ).

4 Determine the answers to the questions in the above table in "Gathering information necessary to install the server

configuration" section.

5 Close any applications that are currently running on your computer.

6 If you plan to configure an external web server, ensure that the web server is running.

7 Insert the DVD or download the setup file from the Adobe website.

8 If the installation wizard does not start automatically when you insert the DVD, locate the appropriate installer file

on the DVD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion installer *Windows only:* coldfusion_2016_WWEJ_win32.exe/coldfusion_2016_WWEJ_win64.exe and double- click it.*MAC only:*Extract the coldfusion_2016_WWEJ_osx2016.dmg file and double-click the installer.

9 Follow the instructions in the installation wizard, and let it run to completion.

10 Click OK to open the ColdFusion Administrator and configure the server.

11 To install any other integrated Adobe or third-party technologies, see Installing Integrated Technologies.

12 Configure and manage your system, as described in Configuring your Systemyour System.

13 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the

Resources page of the ColdFusion Administrator.

Installing the ColdFusion server configuration in UNIX

By default, ColdFusion installs into the /opt/coldfusion2016 directory. You can also choose to install ColdFusion in a different directory.

Note: The default user is nobody for the UNIX installer running ColdFusion.

Install the ColdFusion server configuration in UNIX

1 Read the online version of the Release Notes for any late-breaking information or updates. For more information,

www.adobe.com/go/learn_cfu_releasenote_en.

see

2 Ensure that your operating system meets the system requirements described on the Adobe website at

www.adobe.com/go/learn_cfu_cfsysreqs_en.

3 Review Installation considerations for UNIX and Installation considerations for all platforms (Refer to the Installing

Adobe ColdFusion ).

4 Determine the answers to the questions in the above section "Gathering information necessary to install the server

configuration".

5 If you plan to configure an external web server, ensure that the web server is running.

Last updated 2/17/2016

6 Log in as root. Copy the installation file that is appropriate for your platform and locale from the DVD or Adobe

website, and save it to a directory on your local disk. The following installation files are those for the supported server configuration platforms:

Platform File

Linux

• ColdFusion_2016_WWEJ_linux32.bin (for 32-bit systems)

• ColdFusion_2016_WWEJ_linux64.bin (64-bit systems)

Solaris ColdFusion_2016_WWEJ_solaris64.bin

1 Using the cd command, go to the directory that contains the installation file.

2 Ensure that you have executable permission for the installation file. You can change permissions on the file by using

the following command:

chmod 777 ColdFusion_2016_WWEJ_solaris64.bin

3 Start the installation with the following command:

./<filename>

Note: To run the Linux installer in GUI mode, type ./<filename> -i gui.

4 Follow the prompts in the installation program, and let it run to completion.

Note: For security reasons, it is crucial that you do not use root for the runtime user.

5 Start ColdFusion with the following command:

/cf_root/cfusion/bin/coldfusion start

If you specified the use of an external web server when you ran the installer, ColdFusion automatically runs the cf_root/cfusion/bin/cf-connectors.sh script when it starts the first time. This shell script runs the Web Server Configuration Tool by using the settings that you specified during the installation. If there are problems running this script, review the configuration and bin directory specifications, modify as necessary, and rerun the script. You can also configure your web server by using the scripts in cf_root/cfusion/bin/connectors, as appropriate. To stop ColdFusion, use the following command:

/cf_root/cfusion/bin/coldfusion stop

For more information on managing processes, see Managing the ColdFusion process in UNIX.

Last updated 2/17/2016

6 Open ColdFusion Administrator to run the Configuration wizard.

7 Configure and manage your system, as described in Configuring your System.

8 To install any other integrated Adobe or third-party technologies, see Installing Integrated Technologies.

9 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the

Resources page of the ColdFusion Administrator.

ColdFusion installation directory structure

By default, ColdFusion2016 is your installation directory. The following table describes the directory structure:

Last updated 2/17/2016

Directory Description

Last updated 2/17/2016

cfusion Contains the following directories:

• bin: Programs for starting, stopping, and viewing

information for ColdFusion, and to run Crystal Re ports ( Wind ows only ). It als o c ontain s the passw ord reset scripts for server administrator and Admin Component for remote server start and stop.

• cache: Repository for temporary files from

ColdFusion.

• cfx: Sample C++ and Java CFX files with their

supporting files. You can also store your CFX files in this directory (although you can put them in any location that is defined in your classpath).

• charting: Files for the ColdFusion graphing and

charting engine.

• CustomTags: Repository for your custom tags

• db: The sample Apache Derby databases for all

platforms.

• gateway: Files for ColdFusion event gateways.

• jetty: Solr configuration files and files related to

remote instance start and stop.

• jintegra: (Applies only to Windows) 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). (Applicable only for Windows.)

• jnbridge: Files for .NET Integration Services.

• lib: JAR, XML, property, and other files that are the

foundation of ColdFusion, for functionality such as queries, charting, mail, security, Solr, and system probes.

• logs: Repository for ColdFusion log files. JRE-specific

log files are in the runtime/logs directory. Console outputs are logged in to coldfusion-out.log instead of cfserver.log.

• Mail: Repository for spooled mail and mail that cannot

be delivered.

• META-INF: XML metadata for the ColdFusion

Administrator.

• MonitoringServer: Contains {{crossdomain.xml

}}used for multi-server monitoring.

• registry: (UNIX only) Flat file to store registry settings

• runtime: Programs and supporting files for the

ColdFusion runtime. Also, contains the Tomcat

Last updated 2/17/2016

libraries. The conf directory in runtime contains all Tomc a t con f ig u rat i on f il e s.

• stubs: web services.

config Contains instances.xml and connector configuration files. Also,

jre Java runtime files.

uninstall Files to uninstall ColdFusion.

contains cluster configuration file, cluster.xml.

Note: The ColdFusion_install\cfusion\bin directory contains the Jvm.config file.

Using the built-in web server

ColdFusion provides in-built Tomcat application server that you can use to develop ColdFusion applications.

Note that the version of Tomcat application server bundled with Sdobe ColdFusion (2016 release) is 8.0.27.

During the ColdFusion installation, choose a web server. If you select the built-in web server, your web root directory is located in the cfroot/wwwroot directory. By default, the web server runs on port 8500. It means that to display a page in your application, append:8500 to the host name or IP address in the URL; for example,

http://localhost:8500/YourApp1/index.cfm. If the page does not appear, ensure that the document is located in the

built-in web server's web root directory; for example, C:\ColdFusion2016\cfusion\wwwroot\YourApp1\index.cfm.

Note: If port 8500 is in use, the installer checks up to 100 ports (starting with 8501) to find a port that is not used. ColdFusion uses that port and displays a message to indicate the selected port.

If you select an external web server during installation, the built-in web server is deactivated.

Change the port of the built-in web server

1 Back up the server.xml file. This file is in the cfroot\cfusion\runtime\conf directory.

2 Open the original server.xml file for editing.

3 Search for internal webserver start.Update the port number.

port="8500" protocol="org.apache.coyote.http11.Http11Protocol" connectionTimeout="20000" redirectPort="8445" compression="on" useSendfile="no" compressableMimeType="text/html,text/xml"/>

4 Save the file and then restart ColdFusion.

Configuring the built-in web server (Tomcat)

While installing, if you have configured ColdFusion on an external web server, do the following to configure ColdFusion on in-built Tomcat:

1 Open the cfroot\cfusion\runtime\conf\server.xml file.

2 Search for internal webserver start.Uncomment the following connector XML.

port="8500" protocol="org.apache.coyote.http11.Http11Protocol" connectionTimeout="20000" redirectPort="8445"/>

Save the file, and then restart ColdFusion.

Last updated 2/17/2016

To enable OS Symbolic links after switching to Tomcat, edit the context.xml file found in /cfusion/runtime/conf/ to add allowLinking="true" attribute to the context element.

Starting, stopping, and restarting ColdFusion

On Windows

At prompt, go to the directory cfroot\cfusion\bin and run the following command: coldfusion.exe -start -console. To stop ColdFusion, use the command coldfusion.exe -stop -console. To restart, use the command coldfusion.exe restart -console.Alternatively, you could also start, stop, and restart ColdFusion server using Windows Services.

Note: Paused tasks misfire when restarting ColdFusion.

Note: As possible in previous versions of ColdFusion, you can also use the cfstart script to start/stop the ColdFusion sever.

Note: The -console argument is optional. If it is not provided, the logs are saved in the cfroot\cfusion\logs directory.

On UNIX/Linux/Solaris/MAC OSX

At prompt, go to the directory cfroot\cfusion\bin and run the following command: ./coldfusion start}}To stop ColdFusion, use the command ./{{coldfusion stop. }}To restart, use the command {{./coldfusion restart.

Note: Paused tasks misfire when restarting ColdFusion.

Note: Use the status command to find the status of ColdFusion server.

Editing the JVM settings

To edit the JVM settings, open the cfroot\cfusion\bin\jvm.config file and update the following details:

• java.home: Java home. If not set, ColdFusion verifies the default JRE in the cfroot\jre folder, in the registry, or in the

J{{AVA_HOME}} environment variable.

• java.args: Settings for -Xmx, ColdFusion classpath, and so on.

• java.library.path: Settings for library path.

• java.class.path: Additional classpath settings in a comma-separated list.

• application.home: Default is cfroot\cfusion

•

Creating and editing a new ColdFusion instance

Last updated 2/17/2016

+ 56 hidden pages

Macromedia ColdFusion - 2016 Installation Manual

Legal notices

Contents

Understanding ColdFusion Server Profiles

Preparing to Install ColdFusion

Installing the Server Configuration