The procedure for installing Adobe® ColdFusion® Builder™ varies according to your platform (Microsoft® Windows® or Apple® Mac OS® X) and ColdFusion Builder configuration (standalone 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 3.4.2 or higher installed, select the plug-in configuration.
If you do not have Eclipse 3.4.2 or higher installed, select the standalone 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 www.adobe.com/go/learn_cfb_cfsysreqs_en
Installation considerations for all platforms
Before installing ColdFusion Builder, review the following considerations:
Adobe supports installing ColdFusion Builder side-by-side with ColdFusion MX7 and above.
If you are installing ColdFusion Builder as a plug-in to Eclipse, ensure that Eclipse 3.4.2 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 standalone 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.
Install the ColdFusion Builder standalone configuration
Install ColdFusion Builder on Windows
Before installing, uninstall any prerelease versions of ColdFusion Builder, if it exists.
Ensure that you meet the system requirements.
Ensure that you are logged in as the computer administrator (a user account with administrator privileges).
If you have the ColdFusion Builder DVD, insert it into the drive. Otherwise, download the ColdFusion Builder installer file for the Windows platform from the Adobe website - www.adobe.com/go/learn_cfu_cfbuilder_en.
Open or double-click the ColdFusion Builder installer to begin the ColdFusion Builder installation process.
Accept the license agreement and follow the instructions in the Installation wizard.
In the Select Install Type screen, select Standalone 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 isC:\Program Files\Adobe\Adobe ColdFusion Builder.
Click Done to start 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 ColdFusion Builder on Mac OS X
Before installing, uninstall any prerelease versions of ColdFusion Builder, if it exists.
Ensure that you meet the system requirements.
Ensure that you are logged in as the computer administrator (a user account with administrator privileges).
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 - www.adobe.com/go/learn_cfu_cfbuilder_en.
Open or double-click the installer DMG file. The installer image is mounted. Double-click the installer image.
Accept the license agreement and follow the instructions in the installation wizard.
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.
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 Beta release, 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 3.4.2 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
Before installing, uninstall any prerelease version of ColdFusion Builder, if it exists, and clean and reinitialize the workspace.
Ensure that you meet the systems requirements.
Ensure that you are logged in as the computer administrator (a user account with administrator privileges).
If you have the ColdFusion Builder DVD, insert it into the drive. Otherwise, download the ColdFusion Builder installer file for the Windows platform from the Adobe website - www.adobe.com/go/learn_cfu_cfbuilder_en.
Double-click the ColdFusion Builder installable file.
Accept the license agreement and follow the instructions in the installation wizard.
In the Select Install Type screen, select Adobe ColdFusion Builder Plug-ins Within Eclipse.
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 isC:\Program Files\Adobe\Adobe ColdFusion Builder Plugins
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.
Open Eclipse, or select Start > Programs > Adobe > Adobe ColdFusion Builder Plugins. The ColdFusion Builder perspective is available in Eclipse.
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 OS X
Before installing, uninstall any prerelease version of ColdFusion Builder, if it exists, and clean and reinitialize the workspace.
Ensure that you meet the systems requirements.
Ensure that you are logged in as the computer administrator (a user account with administrator privileges).
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 - www.adobe.com/go/learn_cfu_cfbuilder_en.
Open or double-click the installer DMG file. The installer image is mounted. Double-click the installer image.
Accept the license agreement and follow the instructions in the Installation wizard.
In the Select Install Type screen, select ColdFusion Builder Plug-ins Within Eclipse.
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
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.
Open Eclipse. The ColdFusion Builder perspective is available in Eclipse.
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 version 7.0.2, 8.0.1
Unzip the file AdminServerComponents.zip to {CFHome}
The following files are copied to {cfhome}/runtime/bin:
adminstart.bat
admin_jvm.config
adminstart.sh
The Admin Server instance is copied to {cfhome}/runtime/servers
Go to {cfhome}/runtime/bin and run adminstart.bat (for Windows) or adminstart.sh (for Mac OS)
Multi-server/J2EE remote server version 7.0.2, 8.0.1
In the AdminServerComponents.zip file, unzip the following files to JRun_Home/bin:
admin_jvm.config
adminstart.bat (for Windows) or adminstart.sh (for Mac OS)
Go to JRun_Home/bin and run adminstart.bat (for Windows) or adminstart.sh (for Mac OS)
Standalone/multi-server/J2EE remote server version 9
For version 9 of the remote server, the Admin Server components are shipped, by default.
For standalone server configuration, go to {cfhome}/runtime/bin and run the adminstart script file.
For multi-server or J2EE server configurations, go to JRun_Home/bin and run the adminstart script file.
Update security properties for the remote ColdFusion server
Go to {CFHome}/runtime/lib/security.properties
Update the values of jrun.subnet.restriction and jrun.trusted.hosts with the IP address of computer where ColdFusion Builder is installed. Alternatively, you can use the asterisk wildcard (*) as the IP address value, to allow the server to start and stop without any restriction.
Uninstalling ColdFusion Builder
The steps for uninstalling ColdFusion Builder depend on how you have installed ColdFusion Builder – as a standalone configuration or as a plug-in within Eclipse.
Note: Before uninstalling ColdFusion Builder, Adobe recommends that you deactivate your ColdFusion Builder license by selecting Help > Adobe ColdFusion Builder Deactivation.
Uninstall ColdFusion Builder on Windows
Uninstall ColdFusion Builder standalone configuration
Select Start > Control Panel.
Select Add Or Remove Programs (Windows® XP) or Add Or Remove Programs Or Features (Windows® Vista®).
Select Adobe ColdFusion Builder.
Click Change/Remove.
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:
Select All Programs > Adobe > Adobe ColdFusion Builder > Uninstall Adobe ColdFusion Builder.
Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.
Uninstall ColdFusion Builder plug-in configuration
Close Eclipse or Flash Builder, if it is currently running on your computer.
Select Start > Control Panel.
Select Add Or Remove Programs (Windows® XP) or Add Or Remove Programs Or Features (Windows® Vista®).
Select Adobe ColdFusion Builder Plugins.
Click Change/Remove.
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:
Select All Programs > Adobe > Adobe ColdFusion Builder Plugins > Uninstall Adobe ColdFusion Builder Plugins.
Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.
Uninstall ColdFusion Builder on the Mac OS X platform
Uninstall ColdFusion Builder standalone configuration
Go to the Uninstall Adobe ColdFusion Builder directory within the Adobe ColdFusion Builder installation.
Double-click the"Uninstall" executable file.
Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.
Uninstall ColdFusion Builder plug-in configuration
Close Eclipse or Flash Builder, if it is currently running on your computer.
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.
Double-click the"Uninstall" executable file.
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.
Note: This operation does not remove or alter projects that exist in the workspace in any way.
Clean and reinitialize workspace for standalone configuration
Windows and Mac OS X platform
Close ColdFusion Builder.
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 X platform
Close the ColdFusion Builder perspective in Eclipse, and then close Eclipse.
Go to the directory that contains the ColdFusion Builder plug-ins installation.
In the Uninstall Adobe ColdFusion Builder Plug-ins directory, double-click the Uninstall Adobe ColdFusion Builder Plug-ins executable file.
Click Uninstall in the Uninstall Adobe ColdFusion Builder wizard.
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
Close Eclipse.
Install the ColdFusion Builder plug-ins.
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
