|
These installation notes provide instructions for installing the Java 2 Platform, Enterprise Edition (J2EE) 1.4 Application Server. The following topics are discussed here:
What You’re Installing
The J2EE 1.4 Application Server product is made up of the following components:
- J2EE 1.4 Application Server software, including administrative tools and utilities
- Java™ 2 Platform, Standard Edition (J2SE™) software
- Sun ONE Message Queue
- PointBase Database Server
- Blueprints sample files, such as Petstore, Adventure Builder, and SmartTicket
Various combinations of these components can be selected for download. You can download the bundles from:
Installing the J2EE 1.4 Application Server Software
After you have verified that your system meets the requirements specified in the Release Notes, perform the following steps to install the J2EE 1.4 Application Server product:
Installing on Windows
- Navigate to the directory where you downloaded the .exe file.
- Double click the .exe file to start the installation program.
- Optional: Set the PATH environment variable to include the J2EE 1.4 Application Server <INSTALL>/bin directory.
- To verify the installation, follow the instructions of the Quick Start Guide, located in <INSTALL>/docs/QuickStart.html.
Installing on Unix
- 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-file-name>
- 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 at the command prompt.
- 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.
- Set the PATH environment variable to include the J2EE 1.4 Application Server <INSTALL>/bin directory.
- To verify the installation, follow the instructions of the Quick Start Guide, located in <INSTALL>/docs/QuickStart.html.
Upgrading a Sun ONE Application Server 7.0 PE Software Installation
You can use the upgrade wizard to transfer configuration information from a Sun ONE Application Server version 7.0 Platform Edition (S1AS7.0PE) installation to a J2EE 1.4 Application Server installation. Information that is transferred includes data about deployed applications, the file realm, security certificates, and other resource and server configuration settings. The upgrade wizard can used in Graphical User Interface (GUI) mode or in Command Line Interface (CLI) mode.
You can start the upgrade wizard in GUI mode from the command line or from the desktop:
- To start the wizard in GUI mode from the command line, change to the <INSTALL>/bin directory and type asupgrade.
- On Windows, to start the wizard from the desktop, double-click the asupgrade icon in the <INSTALL>/bin directory.
If you selected the Upgrade checkbox during the J2EE 1.4 Application Server installation process, the wizard will automatically display after the installation completes.
Upgrading through the Wizard
From the J2EE 1.4 Upgrade Wizard screen:
- In the Version 7.x Installation Directory field, enter the location of the Sun ONE Application Server version 7.x PE installation from which to import the configuration.
- In the J2EE 1.4 Installation Directory field, Enter the location of the J2EE 1.4 Application Server installation to which you want to transfer the configuration.
If the Upgrade Wizard was started from the Installation Wizard, the default value for this field will be the directory to which the J2EE 1.4 Application Server software was just installed.
- If you do not have any security certificates to transfer, click the Next button and continue with Step 8.
- If you have security certificates that must be transferred, check the Transfer Security Certificates checkbox, click the Next button and the Transfer Security Certificates screen displays.
- From the Transfer Security Certificates screen , press the Add Domain button to add domains with certificates to be transferred.
- From the Add Domain dialog, you select the domain name and the source and target certificate passwords:
- Click on the Source Domain pulldown and select the domain that contains the security certificates to migrate. .In the Passwords panel, enter the password for the Source Certificate File, which is used for NSS trusted database cert7.db and key3.db files.
- Enter the password for the Target User Key Database, which is used for the JSSE keystore.jks file that contains user keypair certificates.
- Enter the password for the Target Certificate Authority Database, which is used for the JSSE cacerts.jks file that contains certificate authority certificates.
- Click the OK button when done.
- Repeat Step 5 and Step 6 until you have added all the domains with certificates you want transferred. When you are done adding domains, click the Next button and continue with Step 8.
- The Upgrade Results screen displays, showing the status of the upgrade operation in the Results field.
- Click the Finish button to close the wizard when upgrading is done.
Upgrading through the Command Line
The Upgrade Wizard can also be run from the command line using the following syntax:
asupgrade [-c] [--help] --source S1AS7.x_installation
--target J2EE1.4_installation
[--domain domain_name --nsspwdfile nss_pwd_file_path
--jkspwdfile jks_pwd_file_path --capwdfile ca_pwd_file]...
The following table describes the command options.
Table: Options of the asupgrade Tool
|
Option
|
Description
|
|
-c
|
Command line utility will be invoked for upgrade
|
|
--source
|
Installation root directory of the S1AS7.0 server
|
|
--target
|
Installation root directory of the J2EE 1.4 Application Server
|
|
--domain
|
Destination domain name for migrated certificates
|
|
--nsspwdfile
|
Path to NSS password file
|
|
--jkspwdfile
|
Path to JKS password file
|
|
--capwdfile
|
Path to CA certificate password file
|
Uninstalling the J2EE 1.4 Application Server Software
All components in the current J2EE 1.4 Application Server installation directory are automatically selected for uninstallation.
NOTE:
- It is important to use the uninstall routine described here. If you attempt another method, problems will arise when you try to reinstall the same version, or when you install a new version.
- If you do not stop all domains before the uninstallation, then orphan processes may exist on your system after the uninstallation.
To uninstall the J2EE 1.4 Application Server software, perform the following steps:
- Make sure that you have stopped all domains.
- Navigate to your machine’s J2EE 1.4 Application Server installation directory.
- Invoke the uninstall program as follows:
- On UNIX, type one of the following commands at the command prompt:
- To use the uninstall that has a graphical interface:
./uninstall
- To use the uninstall that has a command-line interface:
./uninstall -console
- On Windows, under the Sun Microsystems, J2EE 1.4 SDK program group in the Start Programs area of your desktop, click Uninstall.
- On Windows, you can also invoke the uninstall program through the Control Panel:
- Navigate to the Control Panel
- Choose Add/Remove Programs.
- Select Java 2 Platform, Enterprise Edition 1.4 SDK from the list of installed programs.
- Click Remove.
NOTE:
If you did not stop all domains before the uninstallation, orphan processes may be running on your system. On UNIX, you can identify the processes with the ps -ef command and terminate them with the kill command.
|
Print-friendly Version
