User Guide Cancel

Install ColdFusion using zip installer

Overview

Adobe ColdFusion 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_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.

Note: While running ./cfinstall.sh, you may need to grant executable permissions. For more information, see this kb.

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- ZIP installer

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/

Silent installation- GUI installer

The silent.properties file is an ASCII text file that defines the installation parameters. Specify the details as provided in the file. Select only the ones that apply to your installation type.

#Silent properties for ColdFusion 2021
 
INSTALLER_UI=SILENT
 
#Valid Values are full/trial/developer 
SILENT_LICENSE_MODE=full
 
SILENT_SERIAL_NUMBER=
 
#Use when it is upgrade
 
SILENT_PREV_SERIAL_NUMBER=

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

SILENT_DEPLOYMENT_TYPE=Production 
 
#Valid values are ear/war/standalone
 
SILENT_INSTALLER_TYPE=standalone
 
SILENT_INSTALL_ODBC=true
 
SILENT_INSTALL_JNBRIDGE=true
 
#Remote administrator component for server remote start/stop
SILENT_INSTALL_ADMIN=true
 
SILENT_INSTALL_SOLR=true
 
SILENT_INSTALL_PDFG=true
 
#For Linux it would be as /opt/coldfusion2021 (Change it as per your path)
SILENT_INSTALL_FOLDER=C:\\ColdFusion2021
 
#Enable one of Prod(secure/prod)/dev profile. These 3 are mutually exclusive and only one of them can be ture and others are false.
 
SILENT_ENABLE_PROD_SECURE_PROFILE=true
 
SILENT_ENABLE_PROD_DEFAULT_PROFILE=false
 
SILENT_ENABLE_DEV_PROFILE=false
 
#IP addresses from which Administrator can be accessed.
SILENT_ADMIN_IP=
 
#IP address of the CF installed machine through which PDFG/Solr service would be accessed remotely.
SILENT_JETTY_IP=
 
SILENT_ADMIN_USERNAME=admin
 
SILENT_ADMIN_PASSWORD=Adm1n$12
 
SILENT_ENABLE_RDS=true
 
SILENT_RUNTIME_USER=
 
#Provide password when enable RDS is true
 
SILENT_RDS_PASSWORD=Adm1n$12
 
#username/password of remote administrator component for server remote start/stop
 
SILENT_JETTY_USERNAME=admin
 
SILENT_JETTY_PASSWORD=Adm1n$12
 
#Context Root for Jee Installation
 
SILENT_CONTEXT_ROOT=
 
SILENT_AUTO_ENABLE_UPDATES=true
 
#For Linux it would be as /opt/coldfusion2021 (Change it as per your path)
SILENT_PREV_CF_MIGR_DIR=C:\\ColdFusion2021
 
#Enable/Disable the servlets depending on if they are not used by your application or not.
 
#Applicable only if production OR Production+Secure profile is enabled. For Dev profile, all are enabled by default.
 
ENABLE_RDS=false
 
ENABLE_WSRP=false
 
ENABLE_JSDEBUG=false
 
ENABLE_CFR=false
 
ENABLE_CFSWF=false
 
ENABLE_CFFORMS=false

Saving the properties file

If you name your installer properties file silent.properties and save it in the same directory as the ColdFusion installation program, the installer automatically uses the file.

You can use a different name or save it in a different directory. Specify the filepath to use it in an installation.

If you require more than one installer properties file, give each file a descriptive name.

Running the installer

You run the silent installer in one of the following ways:

  • Through the command line.
  • Through a batch file or script.

The following table lists the command line options of running the installer on different operating systems.

OS Command

UNIX

 

./coldfusion_installer.bin [-f propertiesFilePath]

 

Windows

 

 

coldfusion_installer.exe [-f propertiesFilePath]. For example, if you want to install ColdFusion (2021 release) silently, run the command, ColdFusion_2021_WWEJ_win64.exe -f silent.properties.

 

Solaris

 

java -jar jar_name [-f propertiesFilePath]

 

macOS Extract the .zip and install.

After the silent installer completes the installation, open the ColdFusion Administrator to run the configuration wizard. Adobe recommends that you make sure the silent installer has installed the appropriate edition by clicking System Information. If the edition is not correct, enter the serial number in the New License text box and click Submit Changes.

Verify the installation

After the ColdFusion installation completes, open the log file (Adobe_ColdFusion_2021_Install*) in the installation directory to verify the installation. The silent.properties file specifies the destination of the log file.

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.

 Adobe

Get help faster and easier

New user?

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online