Install ColdFusion Builder

The procedure for installing Adobe® ColdFusion® Builder™ varies according to your platform (Microsoft® Windows® or Apple® Mac OS® X) and ColdFusion Builder configuration (stand-alone or Eclipse™ plug-in configuration). Follow the procedure applicable to your platform and configuration.

About the ColdFusion Builder installation

The Adobe ColdFusion Builder Installation wizard guides you through the various steps of the installation with an intuitive interface.

The ColdFusion Builder installer provides the following two configuration options:

If you are not sure which configuration to install, follow these guidelines:

• If you already use and have Eclipse 4.6 or higher installed, select the plug-in configuration.

• If you do not have Eclipse 4.6 or higher installed, select the stand-alone configuration. This configuration also allows you to install other Eclipse plug-ins, so you can expand the scope of your development work in the future.

The two configurations provide the same functionality. However, some menu names and the ways to access the menu commands sometimes differ slightly in the plug-in configuration.

System requirements

The system requirements depend on the operating system of your computer. To view the ColdFusion Builder system requirements, see System requirements.

Installation considerations for all platforms

Before installing ColdFusion Builder, review the following considerations:

• Adobe supports installing ColdFusion Builder side-by-side with ColdFusion 11, (2016 release), and (2018 release).

• If you are installing ColdFusion Builder as a plug-in to Eclipse, ensure that Eclipse 4.6 or a higher version is installed on your computer. You can download Eclipse from http://www.eclipse.org/downloads/.

Installing ColdFusion Builder

You can install ColdFusion Builder as a stand-alone configuration or as a plug-in to an existing Eclipse or Flash Builder installation. Follow the procedure applicable to the configuration that you want to install.

To install ColdFusion Builder as an Eclipse plug-in, use the following URLs:

• ColdFusion Builder (2018 release): https://cfdownload.adobe.com/pub/adobe/coldfusion/cfb32pluginsrepo/
• ColdFusion Builder (2016 release): https://cfdownload.adobe.com/pub/adobe/coldfusion/cfb31pluginsrepo/

Install the ColdFusion Builder standalone configuration

1. Before installing, uninstall any prerelease versions of ColdFusion Builder, if it exists.

2. Ensure that you meet the system requirements.

3. Ensure that you are logged in as the computer administrator (a user account with administrator privileges).

4. Download the ColdFusion Builder installer file for the Windows platform from the Adobe website.

5. Open or double-click the ColdFusion Builder installer to begin the ColdFusion Builder installation process.

6. Accept the license agreement and follow the instructions in the Installation wizard.

7. In the Select Install Type screen, select Stand-alone Adobe ColdFusion Builder Installation, and let the installation wizard run to completion.

   The default location of the installation directory for the standalone configuration of ColdFusion Builder is C:\Program Files\Adobe\Adobe ColdFusion Builder.

8. Click Done to start ColdFusion Builder.

9. When prompted, enter the product serial number or choose the trial option.

   When you enter a valid product serial number, activation happens in the background the first time the software detects an Internet connection.

Install ColdFusion Builder on Mac

1. Before installing, uninstall any prerelease versions of ColdFusion Builder, if it exists.

2. Ensure that you meet the system requirements.

3. Ensure that you are logged in as the computer administrator (a user account with administrator privileges).

4. If you have the ColdFusion Builder DVD, insert it into the drive. Otherwise, download the ColdFusion Builder installer file for the Macintosh platform from the Adobe website.

5. Open or double-click the installer DMG file. The installer image is mounted. Double-click the installer image.

6. Accept the license agreement and follow the instructions in the installation wizard.

7. In the Select Install Type screen, select Standalone ColdFusion Builder Installation to install a standalone IDE. Let the wizard run to completion.

   The default location of the installation directory for the standalone configuration of ColdFusion Builder is/Applications/Adobe ColdFusion Builder.

8. To start ColdFusion Builder, double-click the ColdFusion Builder executable file in the installed location.

   Note: If you are installing ColdFusion Builder with a workspace from a pre-release version, it is recommended to clean and reinitialize the workspace before using ColdFusion Builder.

   When prompted, enter the product serial number or choose the trial option.

   When you enter a valid product serial number, activation happens in the background the first time the software detects an Internet connection.
   

Install the ColdFusion Builder plug-in configuration

Ensure that Eclipse 4.6 or a higher version is installed on your computer. You can download Eclipse from http://www.eclipse.org/downloads/.

Install ColdFusion Builder plug-in configuration on Windows

1. Before installing, uninstall any prerelease version of ColdFusion Builder, if it exists, and clean and reinitialize the workspace.
   

2. Ensure that you meet the systems requirements.

3. Ensure that you are logged in as the computer administrator (a user account with administrator privileges).

4. Download the ColdFusion Builder installer file for the Windows platform from the Adobe website.

5. Double-click the ColdFusion Builder installable file.

6. Accept the license agreement and follow the instructions in the installation wizard.

7. In the Select Install Type screen, select Adobe ColdFusion Builder Plug-ins Within Eclipse.

8. Enter the directory to install the ColdFusion Builder plug-ins. The default location of the installation directory for the plug-in configuration of ColdFusion Builder is C:\Program Files\Adobe\Adobe ColdFusion Builder Plugins

9. Select the root directory of the Eclipse installation to which you want to link the ColdFusion Builder plug-ins, and let the wizard run to completion.

   Note: Ensure that the Eclipse directory path contains the " dropins " directory.

10. Open Eclipse, or select Start > Programs > Adobe > Adobe ColdFusion Builder Plugins. The ColdFusion Builder perspective is available in Eclipse.

11. When prompted, enter the product serial number or choose the trial option.

    When you enter a valid product serial number, activation happens in the background the first time the software detects an Internet connection.

Install ColdFusion Builder plug-in configuration on Mac

1. Before installing, uninstall any prerelease version of ColdFusion Builder, if it exists, and clean and reinitialize the workspace.
   

2. Ensure that you meet the systems requirements.

3. Ensure that you are logged in as the computer administrator (a user account with administrator privileges).

4. Download the ColdFusion Builder installer file for the Macintosh platform from the Adobe website.

5. Open or double-click the installer DMG file. The installer image is mounted. Double-click the installer image.

6. Accept the license agreement and follow the instructions in the Installation wizard.

7. In the Select Install Type screen, select ColdFusion Builder Plug-ins Within Eclipse.

8. Enter the directory to install the ColdFusion Builder plug-ins. The default location of the installation directory for the plug-in configuration of ColdFusion Builder is /Applications/Adobe ColdFusion Builder Plugins

9. Select the root directory of the Eclipse installation to which you want to link the ColdFusion Builder plug-ins, and let the wizard run to completion.

   Note: Ensure that the Eclipse directory path contains the " dropins " directory.

10. Open Eclipse. The ColdFusion Builder perspective is available in Eclipse.

11. When prompted, enter the product serial number or choose the trial option.

    When you enter a valid product serial number, activation happens in the background the first time the software detects an Internet connection.

Configuring Admin Server components for a remote ColdFusion server

To start and stop a remote server from within ColdFusion Builder, an Admin server instance must run on the remote ColdFusion server. The Admin server instance communicates with ColdFusion Builder to start and stop the remote server.

Run the Admin server instance in the remote ColdFusion server

Depending on your remote server version and configuration, do the necessary tasks.

Standalone remote server for versions 2016 and 2018

1. Unzip the file AdminServerComponents.zip to cfusion in CF_HOME.

   The following files are copied to cfusion/runtime/bin:

   • adminstart.bat

   • admin_jvm.config

   • adminstart.sh

   The Admin Server instance is copied to cfusion/runtime/servers

2. Go to cfusion/runtime/bin and run adminstart.bat (for Windows) or adminstart.sh (for Mac OS)

Multi-server/JEE remote server versions 11 and 2016

1. In the AdminServerComponents.zip file, unzip the following files to CF_HOME/ cfusion /bin:

   • admin_jvm.config

   • adminstart.bat (for Windows) or adminstart .sh (for Mac OS)

2. Go to cfusion/bin and run adminstart.bat (for Windows) or adminstart .sh (for Mac OS)

Standalone/multi-server/JEE remote server for versions 2016 and 2018

• For standalone server configuration, go to cfusion /runtime/bin and run the adminstart script file.

• For multi-server or JEE server configurations, go to cfusion /bin and run the adminstart script file.

Uninstall ColdFusion Builder standalone configuration

1. Select Start > Control Panel.

2. Select Add Or Remove Programs or Add Or Remove Programs Or Features.

3. Select Adobe ColdFusion Builder.

4. Click Change/Remove.

5. If the uninstall program prompts you to restart, restart the computer.

Alternatively, you can uninstall ColdFusion Builder using the ColdFusion Builder Uninstall wizard as follows:

1. Select All Programs > Adobe > Adobe ColdFusion Builder > Uninstall Adobe ColdFusion Builder.

2. Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.

Uninstall ColdFusion Builder plug-in configuration

1. Close Eclips ,  if it is currently running on your computer.

2. Select Start > Control Panel.

3. Select Add Or Remove Programs or Add Or Remove Programs Or Features.

4. Select Adobe ColdFusion Builder Plugins.

5. Click Change/Remove.

6. If the uninstall program prompts you to restart, restart the computer.

Alternatively, you can uninstall the ColdFusion Builder plug-ins using the ColdFusion Builder Uninstall wizard as follows:

1. Select All Programs > Adobe > Adobe ColdFusion Builder Plugins > Uninstall Adobe ColdFusion Builder Plugins.

2. Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.

Uninstall ColdFusion Builder on the Mac OS platform

Uninstall ColdFusion Builder standalone configuration

1. Go to the Uninstall Adobe ColdFusion Builder directory within the Adobe ColdFusion Builder installation.

2. Double-click the"Uninstall" executable file.

3. Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.

Uninstall ColdFusion Builder plug-in configuration

1. Close Eclipse, if it is currently running on your computer.

2. Go to the Uninstall Adobe ColdFusion Builder Plugins directory within the Adobe ColdFusion Builder plug-ins installation. The default location of the ColdFusion Builder plug-ins installation is/Applications/Adobe ColdFusion Builder Plugins.

3. Double-click the"Uninstall" executable file.

4. Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.

Clean and reinitialize workspace

If you are using ColdFusion Builder with a workspace from a Beta release, clean and reinitialize the workspace before installing the release version of ColdFusion Builder. In general, when you use existing work spaces with a new installation of ColdFusion Builder, Adobe recommends that you clean and reinitialize your workspace before the installation.

Use the following platform-specific procedures to clean the workspace. In addition to cleaning the workspace, this operation also re-initializes any cached bundle data.

Clean and reinitialize workspace for standalone configuration

Windows and Mac OS platform

1. Close ColdFusion Builder.

2. Clear the cached plug-ins by starting ColdFusion Builder using the-cleanoption.

   (For Windows) Run the following command in the command prompt:

   CFBuilder.exe -clean

   (For Mac OS X) In the terminal, go to ColdFusion Builder Installation directory/CFBuilder.app/Contents/MacOS/, and run the following command:

   ./CFBuilder -clean

Clean and reinitialize workspace for plug-in configuration

Windows and Mac OS platform

1. Close the ColdFusion Builder perspective in Eclipse, and then close Eclipse.

2. Go to the directory that contains the ColdFusion Builder plug-ins installation.

3. In the Uninstall Adobe ColdFusion Builder Plug-ins directory, double-click the Uninstall Adobe ColdFusion Builder Plug-ins executable file.

4. Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.

5. Clear the cached plug-ins by starting Eclipse using the-cleanoption.

   (For Windows) Run the following command in the command prompt:

   eclipse.exe -clean

   (For Mac OS X) In the terminal, go to Eclipse home directory/Eclipse.app/Contents/MacOS/, and run the following command:

   ./eclipse -clean

6. Close Eclipse.

7. Install the ColdFusion Builder plug-ins.

8. Start Eclipse using the-cleanoption.

   (For Windows) Run the following command in the command prompt:

   eclipse.exe -clean

   (For Mac OS X) In the terminal, go to Eclipse home directory/Eclipse.app/Contents/MacOS/, and run the following command:

   ./eclipse -clean