|
| |
| Sun Java System Applications Server Platform Edition 8.1 2004Q4 Beta Installation Guide | |
Chapter 1
Installing Application Server 8 SoftwareThis guide provides instructions for installing the Sun Java System Application Server Platform Edition 8 software. The following topics are discussed:
What You’re InstallingThe Application Server product is made up of the following components:
The Java™ 2 Platform, Enterprise Edition (J2EE™) 1.4 product includes the following components:
Installing the Application Server SoftwareAfter you have verified that your system meets the requirements specified in the Release Notes, use either of the following sets of steps to install the Application Server product:
Installing on UNIX and Linux
- Navigate to the directory where you downloaded the bundle file.
- Change the permission of the bundle file so that you have execute access:
chmod +x bundle_filename
- Run the installation program.
- To run the installation program that uses a graphical interface, at the command prompt type the name of the bundle file:
./ bundle_filename
- To run the installation program that uses the command-line interface, at the command prompt type the name of the bundle file followed by the -console option:
./ bundle_filename -console
- Upgrade your installation using Chapter 2, "Upgrading an Application Server Installation," if applicable.
- Set the PATH environment variable to include the Application Server install_dir/bin directory.
- Verify the installation by following the instructions in the Quick Start Guide, located in install_dir/docs/QuickStart.html.
Installing on Windows
- Navigate to the directory where you downloaded the .exe file.
- Double click the .exe file to start the installation program.
- Follow the instructions on the wizard screens of the installation program. Upgrade your installation using Chapter 2, "Upgrading an Application Server Installation."
- If you did not select the corresponding option on the Installation Options screen, set the PATH environment variable to include the Application Server install_dir/bin directory.
- Verify the installation by following the instructions of the Quick Start Guide, located in install_dir/docs/QuickStart.html.
Installing in Silent ModeSilent mode installation runs without any user input checking a configuration file to obtain the installation information. The following topics are discussed:
Creating the Installation Configuration File
The installation configuration file is created when you use the savestate option with the setup command to start a interactive installation. During the interactive installation, your input is collected and stored in the configuration file you specified. This forms the template for silent installation, which you can use later to install the product on one or more machines. If needed, you can modify the installation configuration file.
The following topics are addressed:
Syntax for Creating the Installation Configuration File
The syntax for creating an installation configuration file is as follows:
For graphical method: ./bundle_filename -savestate filename
For command-line method: ./bundle_filename -console -savestate filename
Refer to Installation Methods for more detailed information.
Example Installation Configuration
Modifying the Installation Configuration File
You can modify the installation configuration file by editing the variables and values described in Table 1-1.
Table 1-1 Installation Configuration File Variables
Variable Name
Valid Values (if applicable)
Content
Comments
defaultInstallDirectory
Default installation directory path
currentInstallDirectory
Selected installation directory path
JDK_LOCATION
Selected J2SE installation directory path
This entry is needed only for distributions that do not contain a bundled J2SE.
INST_ASADMIN_USERNAME
Administrator user name for initial server instance
INST_ASADMIN_PASSWORD
Administrator password for initial server instance
This entry is obfuscated by default.
See also description of ADMIN_PASSWORD_ENCRYPTED variable.
INST_ASADMIN_PORT
0 -65535
Administration server port number for initial server instance
INST_ASWEB_PORT
0 -65535
HTTP port number for
initial server instance
INST_HTTPS_PORT
0 -65535
HTTPS port number for initial server instance
INST_JMS_PORT
0 -65535
JMS port number for initial server instance
If the configuration file does not include this entry, default value of 7676 is used.
INST_ORB_PORT
0 -65535
ORB port number for initial server instance
If the configuration file does not include this entry, default value of 3700 is used.
INST_ORB_SSL_PORT
0 -65535
Secure ORB port number for initial server instance
If the configuration file does not include this entry, default value of 3820 is used.
INST_ORB_MUTUALAUTH_PORT
0 -65535
Mutual authentication ORB port number for initial server instance
If the configuration file does not include this entry, default value of 3920 is used.
INST_JMX_PORT
0 -65535
JMX port number for initial server instance
If the configuration file does not include this entry, default value of 8686 is used.
INST_POINTBASE_PORT
0 -65535
PointBase server port number
If the configuration file does not include this entry, default value of 9092 is used.
ADMIN_PASSWORD_ENCRYPTED
TRUE
FALSEObfuscated admin password flag
In initial statefile created by product installer this flag is set to TRUE, since the admin password value is obfuscated for security reasons.
To override the value for admin password, enter INST_ASADMIN_PASSWORD value in clear text and set this flag to TRUE to enable silent installation to process it correctly.
STORE_ADMIN_AUTH
TRUE
FALSEWhether to create admin authentication user preference file
CREATE_SAMPLES_DOMAIN
TRUE
FALSEWhether to create additional samples server domain.
CREATE_DESKTOP_SHORTCUT
TRUE
FALSEWhether to create autodeploy folder desktop shortcut.
Valid for Windows platforms only and is disregarded otherwise.
UPDATE_PATH
TRUE
FALSEWhether to update PATH environment variable to include Application Server bin directory.
Valid only for Windows platforms and is disregarded otherwise.
If this entry is not present, default value of FALSE is used.
Installing in Silent Mode
To install the Sun Java System Application Server software in silent mode:
- Review configuration file and verify that it contains what you want to use for your silent installation.
- Copy your installation configuration file to each machine where you plan to install the Sun Java System Application Server software.
- Copy the Sun Java System Application Server distribution file to each machine where you plan to install the Application Server software.
- Navigate to the directory where you copied the distribution file and your installation configuration file.
- Start silent installation at the command line using the following command format: ./bundle_filename -silent config_file
The installation program reads the specified config_file, checks for adequate disk space, then installs the product based on the data in config_file.
When the prompt is returned, the silent installation is complete and the installation components are installed on your systems.
- You can start the Application Server software by using the instructions in the Sun Java System Application Server Platform Edition 8 Administration Guide.
When the Admin Console is started, the initial page of the Application Server graphical interface is displayed.