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
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
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.