This section describes how to install AquaLogic Data Services Platform using either Console mode or Silent mode. Console mode is an interactive installation that you can use on UNIX systems without a graphics (windowing) workstation.
Silent mode is a non-interactive installation on a Windows or UNIX system. In Silent mode, the installer application uses a properties file to obtain installation parameters.
The chapter includes the following sections:
Figure 3-1 illustrates the current step in the overall installation process.
Before you begin installing ALDSP, confirm that the following conditions are met:
<bea_home>
directory in which you are installing ALDSP.
You must remove ALDSP in cases when it is located in the same <bea_home>
directory to which you plan to install. For details see Uninstalling ALDSP.
bin
directory (for example <bea_home>/JDK 150_10/bin
) must be included in your PATH environment variable setting before any other JDK bin directories.<bea_home>
\aldsp_3.0\tools directory. If you are planning to use an Eclipse version that is not bundled with ALDSP, then you need to manually clean up the Eclipse configuration directory to avoid some known issues in Eclipse 3.2.2. All files except config.ini
and files under .settings
subdirectory should be deleted.For additional information about installation prerequisites, see Installation Prerequisites in Preparing to Install ALDSP.
This section describes the console-mode installation procedure.
Note: | You cannot install ALDSP in console mode on Solaris systems running in a Japanese locale. In cases when you are installing on a Japanese Solaris system, change your locale in the shell in which you are installing to English, and then install the product. After ALDSP is installed, you can run it in a Japanese locale. |
To install ALDSP on a UNIX system in console mode:
The installer file name has the following form:
where filename
is the name of the ALDSP installation program specific to your platform. For example, enter the following to start the Solaris version of the ALDSP installation program:
sh aldsp_300_solaris32.bin -mode=console
Similarly, enter the following to start the Linux version of the ALDSP installation program:
./aldsp_300_linux32.bin -mode=console
A message appears indicating that the software is being extracted, followed by a welcome message, as shown in the following text:
<--------- BEA Installer - BEA AquaLogic Data Services Platform 3.0 --------->
Welcome:
--------
This installer will guide you through the installation of BEA AquaLogic Data Services Platform 3.0. Type "Next" or enter to proceed to the next prompt. If you want to change data entered previously, type "Previous". You may quit the installer at any time by typing "Exit".
Enter [Exit][Next]>
The license agreement is displayed. Review the entire agreement. When you reach the end of the agreement, you are prompted to accept or reject the terms.
Select Option:
1 - Yes, I agree with the terms of the license
2 - No, I do not agree with the terms of the license
Enter option number to select OR [Down][Exit][Previous]>
You are prompted to choose the BEA home directory, as shown in the following text:
<--------- BEA Installer - AquaLogic Data Services Platform 3.0 --------->
Choose BEA Home Directory:
--------------------------
"BEA Home" = [/usr/local/bea]
Input existing BEA Home OR [Exit][Previous][Next]>
The <bea_home>
directory serves as the central support directory for all the BEA products installed on your system. For a detailed description of how this directory is used, see “BEA Home Directory” in “Preparing to Install WebLogic Server” in Installing BEA WebLogic Server.
A warning message is displayed in cases when a previous installation of ALDSP is found, or when WebLogic Server 8.1 is not found in the specified BEA home directory.
When prompted, confirm the directory you selected. You are prompted to choose whether you want to perform a complete or custom installation, as shown in the following text:
<--------- BEA Installer - AquaLogic Data Services Platform 3.0 --------->
Choose Install Type:
--------------------
-> 1|Complete
|Install the complete BEA AquaLogic Data Services Platform 3.0.
2|Custom Installation
|Choose software components to install and perform optional configuration.
Enter index number to select OR [Exit][Previous][Next]>
1
or 2
to choose a complete or custom installation respectively.When you specify a custom installation, the installer enables you to choose the components to install, as shown in the following text:
<--------- BEA Installer - AquaLogic Data Services Platform 3.0 --------->
Choose Components to install:
-----------------------------
Release 3.0.0.0
|_____AquaLogic Data Services Platform [1] x
|_____Data Services Server [1.1] x
|_____Data Services Studio [1.2] x
|_____Samples [1.3]
Enter number exactly as it appears in brackets to toggle selection OR [Exit][Previous][Next]>
Enter the value for the component, for example, 1.1 for the ALDSP Runtime. The installer prompts you for additional component values. Continue selecting components, and press Enter without a value when you are done.
The Windows, UNIX, and Linux versions of the installer provide a noninteractive, or silent-mode installation, that you can use in cases when you want to install ALDSP without needing to supply information from the keyboard during the installation process. Instead, the installer gets the required information from a properties file that you provide.
Before launching a silent-mode installation, make sure that all installation prerequisites are met and that all the information in the properties file is correct. After the silent installer is started, it proceeds in the background and does not report exceptions. Some exceptions are ignored.
However, if a previously installed copy of ALDSP is detected, a dialog box will appear asking if you want to override the old version. Other exceptions cause the installer to fail. For example, if the specified BEA home directory <bea_home>
or the specified ALDSP install directory (USER_INSTALL_DIR
) do not exist or are incorrect, the installer fails.
Note: | On UNIX systems, the installer displays the message Installation Complete when it finishes. This message does not necessarily indicate that the installer was successful; it means only that the process has finished running. |
If a fatal exception occurs during installation, the installer displays a message and no changes are made to the system.
This section describes how to install ALDSP on Windows and UNIX systems using Silent Mode.
The content of the file is described in Exploring the Silent Mode Installer Properties File. You can use any legal file name for the installer properties file. Verify that the <bea_home>
, <USER_INSTALL_DIR>, and other values specified in the properties file are correct and that all requirements have been met.
aldsp_300_win32.exe
where filename.bin
is the name of the ALDSP installation program specific to your platform; for example, aldsp_300_solaris32.bin
for the Solaris version of ALDSP.
You will find similarly-named installer files for all UNIX and Linux versions of ALDSP.
aldsp_300_win32.exe -mode=silent
drive:\properties_file_path
-silent_XML=<>
drive:\log_file_path
-log=<>
where drive
is the letter that identifies the hard disk drive, properties_file_path is the complete pathname of the ALDSP silent installation properties file, and log_file_path is the complete pathname of the log file.
For example, you could enter the following:
aldsp_300_win32.exe -mode=silent
-silent_XML=c:\temp\silent.xml
-log=c:\temp\logfile.txt
You are returned to the command prompt and the ALDSP installation preparation dialog box is briefly displayed. The installation proceeds in the background with the information specified in the installer properties file.
To verify that the installer is running, open the Windows Task Manager. The installer is listed as the javaw.exe
process.
sh aldsp_300_solaris32.bin-mode=silent
-silent_XML=
complete_properties_file_path
-log=
complete_log_file_path
where complete_properties_file_path
is the complete pathname of the properties file and complete_log_file_path
is the complete pathname of the log file. A complete path is required, even when the file resides in the same directory as the aldsp_300_solaris32.bin
file.
The message Preparing to Install is displayed. After the installer decompresses the required files, the installation proceeds with the information specified in the installer properties file. When the process is successful, Installation Complete is displayed.
./aldsp_300_linux32.bin-mode=silent
-silent_XML=
complete_properties_file_path
-log=
complete_log_file_path
where complete_properties_file_path
is the complete pathname of the properties file and complete_log_file_path
is the complete pathname of the log file. A complete path is required, even when the file resides in the same directory as the aldsp_300_linux32.bin
file.
The message Preparing to Install
is displayed. After the installer decompresses the required files, the installation proceeds with the information specified in the installer properties file. When the process is successful, Installation Complete is displayed.
Table 3-1 describes the required installer properties used with a Silent Mode installation.
|
|||
The following shows a sample Silent Mode installer properties file (silent.xml):
<?xml version="1.0" encoding="ISO-8859-1" ?>
- <!-- Silent installer option: -mode=silent -silent_xml=C:\bea\silent.xml
-->
- <!--
Specify values for each data-value name as follows:
BEAHOME Complete pathname to the BEA Home directory that
will contain this installation.
USER_INSTALL_DIR Complete pathname to the product installation
directory in which to install the software.
WLW_INSTALL_DIR Complete pathname for the directory where you
want to install BEA Workshop for WebLogic Platform.
INSTALL_MERCURY_PROFILING_TOOLS
Optionally install Mercury profiling tools.
Possible values are "true","yes","false"
and "no". The default is "true".
INSTALL_NODE_MANAGER_SERVICE Install Node Manager as a Windows
service. The default is "no".
Requires Administrator privileges.
NODEMGR_PORT Node Manager listen port number. If none specified,
installer uses default port 5556.
INSTALL_NODE_MANAGER_SERVICE must be set to "yes"
COMPONENT_PATHS Components and subcomponents to be installed.
To install multiple components, separate the components
with a bar (|).
To install subcomponents, specify a
component/subcomponent combination. For example,
to install Web Server Plug-Ins, use
"WebLogic Server/Web Server Plug-Ins".
INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER
The Windows Start menu folder in which you want the
Start menu shortcuts created.
The user performing the installation must have
Administrator privileges to install the shortcuts
in the All Users folder.
Possible values:
true/yes The shortcuts are created in
the All Users folder (default)
false/no The shortcuts are created in
the local user's folder
ECLIPSE32_HOME
See the Installation Guide for more information.
-->
- <bea-installer>
- <input-fields>
<data-value name="BEAHOME" value="C:/bea922" />
<data-value name="USER_INSTALL_DIR" value="C:/bea922/aldsp_3.0" />
<data-value name="COMPONENT_PATHS" value="AquaLogic Data Services Platform/Data Services Server|AquaLogic Data Services Platform/Data Services Studio|AquaLogic Data Services Platform/Samples" />
<data-value name="INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER" value="yes" />
<data-value name="ECLIPSE32_HOME" value="C:\eclipse" />
</input-fields>
</bea-installer>