Install ColdFusion (2021 release)

Overview

Adobe ColdFusion (2021 release) comes with an all new, lightweight installer, via which you can install ColdFusion with bare minimum services.

Standalone Installation

Note:

  • To install ColdFusion, you must sign in as Administrator.
  • You must first install VC 2012 Runtime. Without this runtime, the connector and the htmltopdf package will not work a expected.

The ColdFusion installer comes with a signed zip file for Windows and non-Windows. Follow the steps below according to the platform.

Windows

  • Unzip the file ColdFusion_2021_Express_WWEJ_win64.zip.
  • Unzip ColdFusion2021.zip.
  • Navigate to ColdFusion/cfusion/bin.
  • Enter cfinstall.bat and follow the on-screen instructions.

Solaris and Linux

  • Unzip ColdFusion_2021_WWEJ_linux64.zip/ColdFusion_2021_WWEJ_solaris64.zip file.
  • Unzip ColdFusion2021.zip.
  • Navigate to ColdFusion/cfusion/bin.
  • Enter ./cfinstall.sh and follow the on-screen instructions.

Mac OS X

  • Unzip ColdFusion_2021_WWEJ_osx10.zip file.
  • Unzip ColdFusion2021.zip.
  • Navigate to ColdFusion/cfusion/bin on the terminal.
  • Enter ./cfinstall.sh and follow the on-screen instructions.

Help

In the prompt, type cfinstall.bat/cfinstall.sh help and enter.

Note:

To start ColdFusion server it is mandatory to accept EULA agreement. To accept EULA terms and conditions, navigate to <CFHome/cfusion/bin> and run cfinstall script.

Installer properties

Using cfinstall.bat or cfinstall.sh utility you can configure various properties:

  • Acceptance of the EULA. The EULA file: CF_HOME/Readme/en/license.txt.

Note: The zip installer does not display the correct EULA acceptance path when you specify an absolute path to the cfinstall script.

  • Install type: 
    • Install a new version of ColdFusion (2021 release)
    • 30-day trial
    • Developer edition
  • ColdFusion server profile:
    •  Production profile+Secure profile
    • Production profile
    • Development profile
  • Internal web port 
  • Admin password 
  • RDS password 
  • Service name for Windows 
  • Runtime user for Linux and Solaris
  • Deployment Type

For more information, see ColdFusion licensing and activation.

Silent installation

To silently install the service, enter the following command:

Windows

  • Execute cfinstall.bat --file-name <file name> --installer-mode silent
  • Execute cfinstall.bat -f <file name> -i silent

Non-Windows

  • Execute ./cfinstall.sh --file-name <file name> --installer-mode silent
  • Execute ./cfinstall.sh -f <file name> -i silent

The file requires the below properties to be mentioned in a specific format to install the service silently.

For example,

Windows

# Use it when upgrading from Standard to Enterprise OR from ColdFusion 2018 to ColdFusion 2021
PREVIOUS_SERIAL_NUMBER=

# ColdFusion Administrator password
COLDFUSION_ADMIN_PASSWORD=Adm1n$123

# Internal webserver port
COLDFUSION_ADMIN_PORT=8500

# Install type - 1-Install new version of Adobe ColdFusion 2021 with a serial number , 2-30-day trial, 3-Developer Edition
INSTALL_TYPE=1

# Accept EULA- true. To proceed, you must accept the EULA
EULA_ACCEPTED=true

# Enter the serial number
SERIAL_NUMBER=

# IP address from which Administrator can be accessed
IP_ADDRESSES=

# Specify the deployment type- Production, Development, Staging, Testing, Disaster recovery
DEPLOYMENT_TYPE=Production

# Name of the ColdFusion service
COLDFUSION_WIN_SERVICE_NAME=cf2021

# Server profile - 1-Production+Secure, 2-Production, 3-Development.
SERVER_PROFILE=1

# Specify the RDS password
COLDFUSION_RDS_PASSWORD=Adm1n$123

# ColdFusion install location
COLDFUSION_INSTALL_LOCATION=C\:\\ColdFusion_2021_WWEJ_win64\\ColdFusion\\

Non-Windows

# The serial number of the previous version of ColdFusion. Use it when it is for upgrade
PREVIOUS_SERIAL_NUMBER=

# ColdFusion Administrator password
COLDFUSION_ADMIN_PASSWORD=Adm1n$123

# Internal webserver port
COLDFUSION_ADMIN_PORT=8500

# ColdFusion runtime user. Applicable for Linux and Solaris
COLDFUSION_RUNTIME_USER=

# Install type - 1-Install new version of Adobe ColdFusion 2021 with a serial number , 2-30-day trial, 3-Developer Edition
INSTALL_TYPE=1

# Accept EULA- true. To proceed, you must accept the EULA
EULA_ACCEPTED=true

# Serial number of the new version of ColdFusion
SERIAL_NUMBER=

# IP address from which Administrator can be accessed
IP_ADDRESSES=

# Specify the deployment type- Production, Development, Staging, Testing, Disaster recovery
DEPLOYMENT_TYPE=

# Server profile - 1-Production+Secure, 2-Production, 3-Development.
SERVER_PROFILE=1

# Specify the RDS password
COLDFUSION_RDS_PASSWORD=Adm1n$123

# ColdFusion install location
COLDFUSION_INSTALL_LOCATION=

The file path is shown below:

Windows

  • COLDFUSION_INSTALL_LOCATION= C\:\\ColdFusion_2021_WWEJ_win64\\ColdFusion\\

Linux and Solaris

  • COLDFUSION_INSTALL_LOCATION=/opt/ColdFusion/

Mac OS X

  • COLDFUSION_INSTALL_LOCATION=/Applications/ColdFusion/

Uninstall ColdFusion

Windows

  • cfuninstall.bat

Non-Windows

  • ./cfuninstall.sh

Note:

The cfuninstall script will only unconfigure the Windows service. On Linux, it will remove the init script.

You must:

  • Remove/delete the ColdFusion folder.
  • If instances are configured, the service must be removed.
  • Unconfigure the connector (if configured).
  • Remove the ODBC services (if installed).
  • Save the log files and any files in wwwroot folder that user may have created.

Migration

The installer migration window does not appear as expected.

As a work-around, perform the following:

  1. Create the folder cf2018settings in <cf2021_home>/cfusion/lib.
  2. Copy the neo-* files and seed.properties in the location.
  3. Stop ColdFusion server.
  4. In adminconfig.xml, change the following:
    1. <migratecf2018>true</migratecf2018>
    2. <runsetupwizard>true</runsetupwizard>
    3. <runmigrationwizard>true</runmigrationwizard> 
  5. Using CFPM, install the packages.
  6. Restart ColdFusion and launch the ColdFusion Administrator.

JEE installation

In this mode of installation, ColdFusion no longer supports JEE configuration. In earlier installers, you could install JEE (WAR file and EAR file) or install Add-on services for JEE installation.

Now, you get the war zip file. For more information, see JEE configuration.

  • In case of app server where the war gets expanded only after the app server is started, stop the app server, accept the EULA, and then restart the app server.
  • In case of app server where you need to expand the war manually, run the cfinstall script, accept the EULA, and start the app server.

Silent properties- Wildfly

# Serial number of the new version of ColdFusion
SERIAL_NUMBER=

# Accept EULA- true. To proceed, you must accept the EULA
EULA_ACCEPTED=true

IP_ADDRESSES=

# Specify the deployment type- Production, Development, Staging, Testing, Disaster recovery
DEPLOYMENT_TYPE=Production

COLDFUSION_ADMIN_PASSWORD=Admi1n$123

# Server profile - 1-Production+Secure, 2-Production, 3-Development. Valid value are 1/2/3.
SERVER_PROFILE=1

COLDFUSION_RDS_PASSWORD=

# Install type - 1-Install new version of Adobe ColdFusion 2021 with a serial number , 2-30-day trial, 3-Developer Edition
INSTALL_TYPE=1

# Select the path till WEB-INF
COLDFUSION_INSTALL_LOCATION=/opt/wildfly-20.0.0.Final/standalone/deployments/cfusion.war/WEB-INF/

Note:

When you run cfinstall script with the absolute path, specify the path of ColdFusion till WEB-INF folder.

Note:

Unlike Wildfly, JBoss, etc, in Tomcat, the war gets expanded only after app server is started. If you do not accept the license, the app server will fail to start. You must first start the app server once, kill it, accept the EULA, and then restart the server.

Change Administrator password

To change the Administrator password, enter the following command, passwordreset.bat.

  1. Enter your choice of reset- Admin or jetty.
  2. Enter the new passwords for Admin and RDS and confirm these.
  3. Restart the server for the changes to take effect.