Overview
Adobe ColdFusion (2021 release) comes with an all new, lightweight installer, via which you can install ColdFusion with bare minimum services.
Standalone Installation
- 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.
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
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:
- Create the folder cf2018settings in <cf2021_home>/cfusion/lib.
- Copy the neo-* files and seed.properties in the location.
- Stop ColdFusion server.
- In adminconfig.xml, change the following:
- <migratecf2018>true</migratecf2018>
- <runsetupwizard>true</runsetupwizard>
- <runmigrationwizard>true</runmigrationwizard>
- Using CFPM, install the packages.
- 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/
When you run cfinstall script with the absolute path, specify the path of ColdFusion till WEB-INF folder.
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.
- Enter your choice of reset- Admin or jetty.
- Enter the new passwords for Admin and RDS and confirm these.
- Restart the server for the changes to take effect.