Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java Enterprise System 2005Q1 Installation Guide 

Chapter 7
Installing with the Graphical Interface

This chapter provides instructions for using the interactive graphical interface to install the Sun Java™ Enterprise System (Java ES) software.

This chapter includes the following sections:


Before beginning the procedure in this chapter, you should have developed an installation sequence, surveyed your system for incompatibilities, and fulfilled any necessary prerequisites. Refer to Installation Prerequisites for more specific information.

Running the Installer in Graphical Mode

If you have problems during installation, refer to Chapter 13, "Troubleshooting".

    To Begin Installation
  1. (Optional) Provide access to your local display.
  2. If you are logging in to a remote host, make sure your DISPLAY environment variable is properly set to the local display. If the DISPLAY variable is not set properly, the installer runs in text-based mode.

    • Example for C Shell (host name myhost):
    • setenv DISPLAY myhost:0.0

    • Example for Korn Shell (host name myhost):
    • DISPLAY=myhost:0.0

      You might need to grant display authorization to run the installer on your local display. For example, you can use the following command to grant display authority from myhost to the root user on serverhost:

      myhost> xauth extract - myhost:0.0 | rsh -l root serverhost xauth merge -


      For full instructions on granting such authorization safely, refer to the “Manipulating Access to the Server” chapter in the Solaris X Window System Developer’s Guide (

  3. If you are not logged in as root, become superuser.
  4. Start the graphical installation interface.

  5. Note

    A full description of options for the installer utility can be found in Installation Commands.

    • For CDs. Navigate to a directory that is not on the CD so that you can switch CDs during the installation session. For example:
    • cd /tmp

      Enter the command to start the installer using the fully qualified path to the installer:


      In this command, mount-point is where you mounted the CD and os-arch matches your platform, Solaris_sparc, Solaris_x86 or Linux_x86.

    • For a DVD. Navigate to the DVD directory whose name matches your platform, and enter the command to start the installer:
    • ./installer

    • For a Download. Navigate to the directory where you downloaded the software, and enter the command to start the installer:
    • ./installer

      The Welcome page is displayed.

  6. Click Next to continue.
  7. The Software License Agreement page is displayed.

  8. If you accept all the terms of the License, click Yes, Accept License. The Language Support page is displayed.
  9. If you do not accept all the terms of the License, select Decline. This will end the installation process.

    To Select Languages for Components

The packages for the languages you choose will be installed for all the components you select. Each selection causes additional packages to be installed, adding to the disk space required for installation. English is always installed.

  1. On the Language Support page, select the languages in which you want to install the Java ES components.
  2. Click Next to continue.
  3. The Component Selection page is displayed.


    If the language of the host system is not English, that language is selected by default.

    To Select Components

The Component Selection page displays a list of components, organized in groups of related services. The following points about component selection and the Component Selection page should be noted.

    To Resolve Dependency and Compatibility Issues

The installer performs a dependency check of the selected components. If there is a problem, the installer may display one or more messages informing you of the problem and directing you to take action.

  1. Resolve component dependency issues and click Next. Repeat this process until you are allowed to proceed.
  2. The installer then performs a compatibility check of any shared components already installed.

  3. If any incompatible versions of components are found, you will be asked to remove them from the host. Click Yes to have the installer remove them immediately or click No to remove the components manually.

  4. Caution

    If you select No, you must remove the component before continuing with the installation.

    After the offending component has been removed, the installer performs a compatibility check of any shared components already installed.

  5. If incompatible versions of shared components are detected, the Shared Components Upgrade Required page is displayed. Review this list and determine if it is safe for the installer to automatically upgrade the shared components listed. Click Next to allow the installer to automatically upgrade the shared components listed. This upgrade does not happen until you reach the Ready to Install page.
  6. On Solaris. If an incompatible system-wide version of the J2SE SDK is detected, the J2SE SDK Upgrade Required page is displayed. The installer performs this check only on the Solaris platform because the Linux platform does not have a specific, system-wide installation of the J2SE SDK.


    Do not upgrade shared components without checking the dependencies that exist on the host for non-JES applications. First verify that these existing applications are compatible with the required versions of the shared components.

    The Installation Directories page is displayed.

    To Specify Installation Directories and Initiate the System Check

The Installation Directories page displays the default installation directories for the components you have selected.

Example screen capture of the installer's Installation Directories page.

  1. Examine the default installation directories:
    • Verify that the directories are correct for your deployment.
    • If the default directories are not acceptable, browse for alternative paths and change as needed.
  2. Click Next to initiate the system check.
  3. The installer checks for disk space, memory, operating system patches and operating system resources based on the installation directories provided. The left column of the following table lists the possible results of the system check. The right column specifies what action you should take for each result.

    Table 7-1  System Check Results  

    Message Displayed

    Your Action

    System ready for installation

    Click Next to specify a configuration type.

    System ready for installation
    Includes a warning that memory is not at the recommended level.

    Click Next to proceed with the installation, but add memory when you are done. If you do not add memory, performance might be seriously affected.

    System not ready for installation

    Click View Report for information on the problems that the installer found. If you can fix the reported problems without stopping the installer, do so and then click Check Again to recheck the system.

    If any patches are missing, the patch numbers appear in this report. To install any missing operating system patches, do the following:

    1. Go to the Sunsolve site:
    2. Click Patch Portal.
    3. Enter the patch number in the PatchFinder text box, and click Find Patch.
    4. Download the zip file for the patch.
    5. Expand the zip file.
      For example:
      A directory is created for the patch files.
    6. Apply the patch.
      For example:
      patchadd 117885-44
    7. Back in the Java ES installer, click Check Again.
    8. All system requirements are checked again.

    Solaris 10. If the installer is running in a non-global zone, you will receive a message telling you that memory information is not available.

  4. When the system check is complete and you are satisfied with the state of the system, click Next.
  5. If some of the components you have chosen can be configured during installation, the Configuration Type page is displayed.


    See What Configuration Option Is Best? for information on which components can be configured during installation.

    To Specify a Configuration Type

Specify a configuration type from the following options:

    To Specify Common Server Settings

For a Configure Now installation, you are asked to provide global configuration information. Defaults are displayed, except for passwords (which must be a minimum of 8 characters).


Configuration values are gathered by the installer as you proceed through the configuration panels. After installation is completed, you can access this information in the Installation Summary:

Solaris: /var/sadm/install/logs
Linux: /var/opt/sun/install/logs

  1. Specify common server settings.
  2. Either accept the defaults, or use alternate data to answer the installer questions regarding these global fields. Values that you enter here appear as default values on the following component configuration pages. Refer to Common Server Settings for information on these fields. The following sample screen shows the Common Server Settings configuration page.

    Example screen capture of the installer's Common Server Settings page.

  3. Click Next to proceed
  4. The components configuration pages for each component that can be configured during installation are displayed one by one.

    To Specify Selected Component Settings

For a Configure Now installation, the installer presents one or more configuration pages for the selected components that can be configured during installation.

The following sample screen shows the initial Directory Server configuration page.

Example screen capture of the installer's Directory Server: Administration (1 of 5) page.

For information on the configuration values on each page, refer to:

Some of the fields in a component configuration page display default values from the Common Server Settings page. These values can be edited. For example, the fields in the Directory Server sample screen that contain default values set by the Common Server Settings page are Administrator User ID and Administrator Password. These fields are marked with the note “* Shared default value.”


Although Sun Cluster software itself cannot be configured during installation, you are offered the option of enabling remote support to simplify postinstallation configuration. The default is Yes.

  1. As the individual configuration pages are displayed, you are asked to specify information for the settings.

  2. Tip

    Configuration values are gathered by the installer as you proceed through the configuration panels. After installation is completed, you can access this information in the Installation Summary:

    Solaris: /var/sadm/install/logs
    Linux: /var/opt/sun/install/logs

  3. Click Next to proceed to the next component configuration page.
  4. When you click Next on the final configuration page, installation-time configuration is done.
  5. The Ready to Install page is displayed.

    To Confirm Installation Readiness

Before transferring the software to your system, the installer lists the components that you selected. Although shared components are not explicitly listed, they have already been verified and will be installed if they are needed.

  1. Review the components listed and make any necessary changes.
    1. To return to the particular Component Selection page, click the Back button and continue to click Back on successive pages until the desired Component Selection page is again displayed.
    2. Click Next to move forward through the installer again. You do not need to re-enter previously-entered values.
  2. Click Next when you are satisfied with the Ready to Install list.
  3. The Product Registration page is displayed.

    To Register Products and Begin Installing Software

The Product Registration page provides the option of registering your products while software is being installed.

  1. If you do not want to fill in and submit the registration forms while installation is running, deselect the default option “Open registration window during installation.”
  2. Click Install to begin installing the component packages. During installation, the following occurs:
    • A progress bar displays the overall percentage complete.
    • The names of packages are displayed as they are installed.
    • If you accepted the product registration option, a browser window that enables you to register is displayed.
    • Depending on the size and complexities of your installation, the installation process can be lengthy.


      You can cancel installation by clicking Cancel. This starts the uninstaller and removes any Java ES software that has already been installed.

    To Complete the Installation Session

When installation is complete, the Installation Complete page is displayed. Any issues from the installation, such as insufficient memory, are noted on this page. In addition, you are provided with access to the installation summary and logs.

  1. Click View Summary or View Install Log to examine information about the installation.
    • Installation Summary.    Lists each component installed and the settings you specified. If you chose the Configure Now option, this summary includes all the configuration values.
    • Installation Log.    Displays the installer’s log messages for components.
    • This information is available in the following locations after you exit the installer:

      On Solaris:  /var/sadm/install/logs
      On Linux:  /var/opt/sun/install/logs

  2. To access the postinstallation instructions, click the box to automatically display the Java Enterprise System Installation Guide.
  3. Click Close to exit the installer.
  4. Your installer session is done. Components that were installed will need to be started after you have completed all postinstallation tasks.

  5. Proceed to Next Steps for instructions on how to complete the Java ES installation.

Adding Components

To install additional components, you can run the installer again. The installer detects the newly-installed components and uses them to satisfy the dependencies of other components. Installed components are disabled at the Component Selection page.

For example, suppose you have installed Access Manager and its required components during this installation. Later, you decide to install Portal Server. The existing instance of Access Manager will be used to meet the Portal Server dependency on Access Manager. You will not be asked to reinstall Access Manager.

Next Steps

After you have completed the installer portion of your Java ES installation, proceed to Chapter 10, "Configuring Components After Installation" for final instructions. Although you might have done extensive configuration during your installation, most components require some additional configuration.

Previous      Contents      Index      Next     

Part No: 819-0056-11.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.