Accessibility

ColdFusion Documentation

Configuring the installer properties file


Table of Contents

  1. Installing ColdFusion MX 6.1 Silently
  2. Overview of the silent installation
  3. Configuring the installer properties file
  4. Sample installer.properties files
  5. Running the installer
  6. Running the Web Server Configuration Tool from the command line

The installer properties file is an ASCII text file that defines parameters for your installation. The following sections describe the installer properties file and how to define the parameters.

Naming the installer properties file

If you name your installer properties file installer.properties and put it in the same directory as the ColdFusion MX installation program, when you run the installer from the installation program's directory, the installer automatically uses the installer.properties file. You can name it something else or save it in a different directory, but if you do, you must always explicitly reference the properties file on the command line.

Note: The name of your installer properties file must end with .properties, not .txt.

If you require more than one installer properties file—for example, to use different properties for installing inside or outside of your organization—Macromedia recommends that you give each a descriptive filename. Ensure that the filename ends with .properties.

Creating the installer properties file

The following table describes the parameters used in the installer properties file:

Entry

Description

INSTALLER_UI

Must have the value silent.

SAVE_DEBUG_OUTPUT

Specifies whether to save debugging information from the installation procedure to a file. Specify true or false. Because the debugging information contains the ColdFusion MX Administrator password, it is recommended that you set this parameter to false, except when necessary for debugging purposes.

SILENT_WEBROOT_FOLDER

Location of the web root directory. This directory contains CFML files, ColdFusion Components (CFCs), the CFIDE directory, and the cfdocs directory.

(J2EE configuration only) You can omit this parameter.

SILENT_INSTALL_FOLDER

(Server configuration) Location of the directory in which to install the ColdFusion MX application.

(J2EE configuration) Location of the ColdFusion EAR or WAR files.

SILENT_WEB_SERVER_SELECTION

Must have one of the following values:

  • custom External web server. If you are using an external web server, you must configure it manually after the installer completes.
  • internal ColdFusion built-in web server.

(J2EE configuration only) You can omit this parameter.

SILENT_RUNTIME_USER

(UNIX only) Runtime user, typically nobody.

(Windows and J2EE configuration) You can omit this parameter.

SILENT_CONTEXT_ROOT

(J2EE EAR installation only) The context root for the ColdFusion MX web application.

(Server configuration and J2EE WAR configuration only) You can omit this parameter.

SILENT_ADMIN_PASSWORD

The password to use for access to the ColdFusion MX Administrator.

SILENT_CONFIGURE_SYSTEM_INIT

(UNIX only) Specifies whether to start ColdFusion MX when the system starts. Specify true or false.

(Windows and J2EE configuration) You can omit this parameter.

SILENT_INSTALLER_TYPE

Specifies the type of installation:

  • server The ColdFusion MX Server configuration.
  • ear A single enterprise application archive (EAR) file that you deploy on a J2EE application server.
  • war Two web application archive (WAR) files that you deploy on a J2EE application server.

SILENT_UPDATER

Specifies whether to perform a new installation or to update an existing ColdFusion MX installation. Specify false for a new installation (or if upgrading from ColdFusion 4.5/5) or true if updating ColdFusion MX.

SILENT_SERIAL_NUMBER

The ColdFusion MX 6.1 serial number. For the Developer edition, specify developer.

SILENT_PREV_SERIAL_NUMBER

If SILENT_SERIAL_NUMBER is an upgrade serial number, specifies the previous serial number. Otherwise, you can omit this parameter.

SILENT_LICENSE_MODE

When updating ColdFusion MX to ColdFusion MX 6.1, specify updater. Otherwise, you can omit this parameter.

USER_MAGIC_FOLDER_1_1

(Update installation only) Specifies the location of the CFIDE directory. For all other install types, you an omit this parameter.

The following rules apply to the properties file:

  • The directories that the file specifies must exist. Otherwise, the installer does not function properly.
  • If you use backward slashes (\) in file paths in the properties file on a Windows system, you must escape them by using double backslashes (\\), as shown in the example in Full installation, server configuration.