|
Installing Silently on
ColdFusion MX Server
A silent installation of the Updater for ColdFusion MX server
does not interact with the user. This is useful when you
must install on multiple computers with the same installation
options. You cannot install the Update silently on ColdFusion
MX for J2EE.
To Install ColdFusion MX silently, you do the following:
- Configure the properties file.
- Stop the servers.
- Run the updater silently.
Configuring the installer properties file
The installer properties file is an ASCII text file that
defines parameters for your installation.
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 Updater
file, when you run the installer from the installer file's
directory, the Updater 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 to use it in an installation.
Note: The name of your installer properties file
must end with .properties, not .txt.
If you require more than one installer properties file for
the Updater—for example, to use different properties for
installing within or outside of your organization—Macromedia
recommends that you give each a descriptive name. Ensure
that the name ends with .properties.
Creating the installer properties file
You must specify the following settings in the installer
properties file:
| INSTALLER_UI |
Must have the value
INSTALLER_UI=silent. |
| REBOOT |
Required for Windows only.
Not used for UNIX. Must have the value REBOOT=1 |
| USER_INSTALL_DIR |
Location of the cf_root directory
in which ColdFusion MX is installed. |
| USER_MAGIC_FOLDER_1 |
Location of the
CFIDE directory on your system. |
A sample installer properties file might contain the following
text on a UNIX system:
INSTALLER_UI=silent
USER_INSTALL_DIR=/opt/coldfusionmx
USER_MAGIC_FOLDER_1=/var/www/html/CFIDE
A sample installer properties file might contain the following
text on a Windows system:
INSTALLER_UI=silent
REBOOT=1
USER_INSTALL_DIR=C:\\CFusionMX
USER_MAGIC_FOLDER_1=C:\\Inetpub\\wwwroot\\CFIDE
The following rules apply to the properties file:
- The directories that the file specifies must exist. Otherwise,
the Updater does not function properly.
- The propreties file must have all three entries.
- If you use backward slashes (\) in file paths in the
properties file, you must escape them by using double backslashes
(\\), as shown in the example.
Stopping the servers
If ColdFusion is running on the system on which you are
installing, your installation script must stop ColdFusion
before you run the Updater. On Windows systems, the script
must also stop IIS services.
Stopping servers on Windows
On Windows systems, the install script must issue the following
commands to stop services before running the silent installer:
NET STOP "ColdFusion MX Application
Server"
NET STOP "ColdFusion MX ODBC Agent"
NET STOP "ColdFusion MX ODBC Server
If you use IIS as your web server for ColdFusion MX, stop
the World Wide Web Publishing Service, as follows:
NET STOP "World Wide Web
Publishing Service"
If you use a web server other than IIS or the ColdFusion
MX built in web server, stop the web server.
Note: To install ColdFusion MX Updater,
the jrun.exe and inetinfo.exe programs must be stopped. In
a small number of cases, requesting Windows to stop the services
might not ensure that these programs are stopped.
Stopping servers on UNIX and Linux
On UNIX and Linux systems, run the following command to
stop ColdFusion:
cf_root/bin/coldfusion stop
You should also stop the web server.
Running the Updater
Note: These instructions use the general
term cfmx_updater_file to refer to the Updater file.
The specific Updater file name differs, based on the operating
system. The file names for Updater 3 are as follows:
| Windows |
cfmx_updater_windows_r3.exe |
| Linux |
cfmx_updater_linux_r3.bin |
| Solaris |
cfmx_updater_solaris_r3.bin |
| HPUX |
cfmx_updater_hpux_r3.bin |
The Updater command has the following format:
On UNIX:
./cfmx_updater_file -i mode [-f propertiesFilePath]
On Windows:
cfmx_updater_windows_r3 -i mode [-f propertiesFilePath]
The mode argument
specifies the mode for the installation. The following table
describes the valid mode values:
| Mode |
Description |
|
silent
|
Do not display any interface (requires an installer
properties file).
|
|
console
|
Display a command-line console interface (default
for UNIX, not supported for Windows).
|
|
gui
|
Display a graphical user interface for the Updater
(default for Windows).
|
To run the Updater silently, you must specify -i
silent.
The propertiesFilePath argument
specifies the installer properties file that contains specific
instructions for the Updater. The path can be an absolute
file path or a path relative to the directory containing
the Updater setup command file.
You do not require the propertiesFilePath argument
if all of the following are true:
- The properties file is called installer.properties.
- The properties file is located in the same directory
as the installer file.
- You are running the Updater setup command file from within
this directory.
If these are true, the Updater uses the installer.properties
file by default.
Use the following command to run from the Updater from within
the directory that contains the ColdFusion MX Updater setup
command file and use the default installer.properties file
located in the same directory:
On UNIX:
./cfmx_updater_file -i silent
On Windows:
cfmx_updater_windows_r3 -i silent
The following sample command shows how you can run the Updater
from outside the installer directory and uses an installer
properties file that is located in a different directory
on a Linux system. You enter the command on a single line;
it spans two lines for display.
/home/jdoe/software/cfmx_updater_linux_r3.bin -i silent
-f /home/jdoe/config/cfmx_updater_installer.properties
The following is a similar command line for Windows:
C:/downloads/CFUpdater/cfmx_updater_windows_r3
-i silent
-f C:/downlads/CFUpdater/config/cfmx_updater_installer.properties
|
