Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java Enterprise System 2004Q2 Deployment Example Series: Evaluation Scenario 

Chapter 2
Installing the Evaluation Deployment

This chapter describes how to install the components used in the evaluation deployment. You copy the software to the system on which you are installing and run the Java ES installer. The installer prompts you for component configuration settings and uses the values you supply to configure most of the components you install.

Some components are not configured by the installer. You configure these components after installation, using component configuration tools.

This chapter contains the following sections:

Checking Installation Requirements

Before you install the evaluation deployment, make sure the system on which you are installing meets the following requirements:

Preliminary Steps

This section describes two tasks you must perform before you run the installer. These tasks prepare your system for a successful installation.

Checking the Internet Host Table

The system’s Internet host table must contain the system’s fully qualified host name.

    To Check the Internet Host Table
  1. Log in as root to the system on which you are installing Java Enterprise System.
  2. Open the /etc/host file in a text editor.
  3. Confirm that the /etc/host file contains the system’s fully qualified host name.

    4. For example, on a system named evaluation.example.com, the /etc/host file includes the following lines:

    #
    # Internet host table
    #

    127.0.0.1         localhost
    192.18.78.28        evaluation.example.com              evaluation

    The fully qualified version of the host name must precede the unqualified name. Your /etc/host file must include similar information for your system.

Disabling the sendmail Process

The sendmail process can conflict with Java Enterprise System communications services. Disable it before you install Java Enterprise System.

    To Disable the sendmail Process
  1. Run the command to stop the sendmail process:

    2. /etc/init.d/sendmail stop

  2. Run the command to disable sendmail startup:

    3. rm /etc/init.d/sendmail

Installing the Components

You install the components used in the evaluation deployment by running the Java ES installer. For the evaluation deployment, you accept most of the default configuration values suggested by the installer.

For a production deployment, you would carefully plan you configuration settings before you run the installer. For more information about the information you supply in the installer, see Chapter 4, “Gathering Installation and Configuration Information,” and Appendix A, “Worksheets for Gathering Information,” in the Java Enterprise System Installation Guide (http://docs.sun.com/doc/817-5760).

    To Begin the Installation Process
  1. Log in as root to the machine on which you are installing Java Enterprise System.
  2. Obtain the Java ES software by one of the following means:
    • Download the software. Create a directory for the software (download-directory). Download and unpack the software. Unpacking the software will create subdirectories of download-directory.
    • Run the installer from a CD or DVD. Put the CD or DVD in the appropriate drive.
  3. Change directory to the platform-directory for the platform on which you are installing. The platform-directory is either Solaris_sparc or Solaris_X86.
    • If you downloaded and unpacked the software, the platform-directory is a sub directory of your download-directory:

      • cd download-directory/platform-directory

    • If you are running the installer from a CD, the platform-directory is a sub directory of your cdrom directory:

      • cd cdrom/platform-directory

    • If you are running the installer from a DVD, locate platform-directory on the DVD.
  4. Run the command to start the Java Enterprise System installer.

    5. ./installer

    The Welcome page is displayed.

  5. Click Next.

    6. The Software License Agreement page is displayed.

  6. Click Yes, Accept License.

    7. The Language Support page is displayed.

  7. Select the languages other than English that you want to support in your evaluation deployment. English is always supported.

    8. Click Next. The Component Selection page is displayed.

    Figure 2-1  Component Selection Page
    Screen capture; components listed in text are selected for installation.

    To Select Components for Installation
  1. Select the components that are used in the evaluation deployment. Do the following:
    • Select Sun Java System Messaging Server 6 2004Q2
    • Select Sun Java System Calendar Server 6 2004Q2
    • Select Sun Java System Portal Server 2004Q2
    • Select Sun Java System Communications Express
    • Select Sun Java System Web Server 6 2004Q1 Update 1 Service Pack 2
    • Select Sun Java System Message Queue 3.5 SP1
    • Select Sun Java System Identity Server 2004Q2
    • Select Sun Java System Directory Server 5 2004Q2
    • Select Sun Java System Administration Server 5 2004Q2
    • Clear Sun Java(TM) System Application Server 7.0 Update 3.

      • These selections are shown in Figure 2-1. Click Next. The installer validates your selections and checks for compatibility between the components you select and the software that is already installed on the system.You see a page that describes the result of the compatibility checks.

  2. Evaluate the installer’s response to your selections.

    3. The installer checks for three types of compatibility. Depending on your system, you see none, one, two, or three of the following pages that report incompatibilities.

    1. The installer might determine that the components you selected are not compatible with components already on the system. You see the Product Dependency Checks dialog box shown in Figure 2-2.

      2. Figure 2-2  Product Dependency Checks Dialog Box
      Screen capture: product dependency dialog box appears above Component Selection page.

      You must resolve the incompatibility described in the dialog box before you can continue. In some cases, you must exit the installer, upgrade or remove the incompatible software, and then restart the installer from the beginning.

      Note

      If the installer determines that the system has an incompatible version of Message Queue, see Appendix A.

    2. The installer might determine that the Java™ 2 Software Development Kit, Standard Edition (J2SE™ SDK) that is already installed on the system is not compatible with the components that you selected for installation. You see the J2SE Software Development Kit Upgrade Required page.

      3. Click OK to accept the default value (Install a Second J2SE SDK for Sun Java(TM) Enterprise System Components).

    3. The installer might determine that the shared components already installed on the system are not compatible with the components that you selected for installation. You see the Shared Components Upgrades Required page shown in Figure 2-3.

      4. Figure 2-3  Shared Components Upgrades Required Page
      Screen capture: list of shared components that must be upgraded is displayed.

      Click Next to upgrade the shared components.

      Note

      Shared components provide local services and technology support for Java ES components. When you install Java ES, the installer automatically installs the shared components that are required by the Java ES components you selected.

    4. The installer might determine that your system is fully compatible with the components you selected. The Installation Directories page is displayed.
  3. Click Next to accept the default values.

    4. The Verify System Requirements page is displayed.

  4. Wait while the Verify System Requirements page checks your system against the following system requirements:
    • Disk space
    • Memory
    • Operating system patches
  5. Evaluate the result of the system requirements checks.
    • Ignore a low memory warning. The evaluation deployment requires less memory than a production deployment.
    • If you receive a patch warning you must close the installer, install the patch, and then restart the installer from the beginning.

      • When the system check is satisfactory, click Next. The Configuration Type page is displayed.

    To Select a Configuration Type
  1. Select Configure Now.

    2. Configure Now lets you supply configuration values for most of the components you install. The installer configures the components according to the values that you supply in the installer pages.

    Click Next. The Custom Configuration page is displayed.

  2. Review the list of components that the installer cannot configure.

    3. The message explains that the Java ES installer does not configure Calendar Server, Messaging Server, or Communications Express. Chapter 3, "Configuring and Verifying the Evaluation Deployment" shows you how to configure Calendar Server, Messaging Server, and Communications Express.

    Click Next. The Common Server Settings page is displayed.

    Figure 2-4  Common Server Settings Page
    Screen capture; as described in text, fields are filled with values for the machine on which you are installing.

    To Supply Common Server Settings
  1. Supply values that are used to configure all the components that are configured by the installer. Do the following:
    • For Host Name, accept the default value.
    • For DNS Domain Name, accept the default value.
    • For Host IP Address, accept the default value.
    • For Administrator User ID, accept the default value.
    • In the Administrator Password text field and the Retype Password text field, type password. The evaluation deployment uses password for all possible passwords.
    • For System User, accept the default value.
    • For System Group, accept the default value.

      • Note

      The default values for Host Name, DNS Domain Name, and Host IP Address are derived from the system on which you are installing.

      Figure 2-4 shows the default values for a system named evaluation.example.com. The Host Name field is the system name, evaluation, and the DNS Domain Name field is example.com. You see similar values for the system on which you are installing.

      Click Next. The Web Server: Administration (1 of 2) page is displayed.

    To Supply Web Server Information
  1. Click next to accept the default values.

    2. The Web Server: Default Web Server Instance (2 of 2) page is displayed.

    Figure 2-5  Web Server: Default Web Server Instance (2 of 2)
    Screen capture; fields are filled with values described in text.

  2. Do the following:
    • In the Runtime User ID text field, type root.
    • In the Runtime Group text field, type other.
    • Select Automatically Start Web Server When System Restarts.

      • Click Next. The Directory Server: Administration (1 of 5) page is displayed.

    To Supply Directory Server Information
  1. Click Next to accept the default values.

    2. Note

    The Administrator Password and Directory Manager Password text fields display asterisks. The values in these text fields are the default password you specified on the Common Server Settings page, which is password.

    The Directory Server: Server Settings (2 of 5) page is displayed.

  2. Click Next to accept the default values.

    3. The Directory Server: Configuration Directory Server (3 of 5) page is displayed.

  3. Click Next to accept the default value.

    4. The Directory Server: Data Storage Location (4 of 5) page is displayed.

  4. Click Next to accept the default value.

    5. The Directory Server: Populate Data (5 of 5) page is displayed.

  5. Click Next to accept the default value.

    6. Note

    The default selection in this page (the Sample Data radio button under the Populate With Data checkbox) ensures that the installer will populate your LDAP database with sample data.

    The Administration Server: Server Settings (1 of 2) page is displayed.

    To Supply Administration Server Information
  1. Click Next to accept the default values.

    2. The Administration Server: Configuration Directory Settings (2 of 2) page is displayed.

  2. Click Next to accept the default values.

    3. The Identity Server: Administration (1 of 6) page is displayed.

    Figure 2-6  Identity Server: Administration Page
    Screen capture; shows protected input (*) in the Administrator Password and LDAP Password fields as described in text.

    To Supply Identity Server Information
  1. Do the following:
    • In the Administrator Password and Retype Password test fields, accept the default value.

      • Note

      The Administrator Password displays asterisks. The value in this text field is the default password, password.

    • In the LDAP Password and Retype Password text fields, type ldappassword.

      • Note

      The LDAP password cannot be the same as the Administrator password.

      Click Next. The Identity Server: Web Container (2 of 6) page is displayed.

  2. Click Next to accept the default value.

    3. The Identity Server: Sun Java System Web Server (3 of 6) page is displayed.

  3. Click Next to accept the default values.

    4. The Identity Server: Web Container for Running Identity Server Services (4 of 6) page is displayed.

  4. Click Next to accept the default values.

    5. The Identity Server: Directory Server Information (5 of 6) page is displayed.

  5. Click Next to accept the default values.

    6. The Identity Server: Directory Server Information (6 of 6) page is displayed.

  6. Click Next to accept the default value.

    7. The Portal Server: Web Container page is displayed.

    To Supply Portal Server Information
  1. Click Next to accept the default value.

    2. The Portal Server: Sun Java System Web Server page is displayed.

  2. Click next to accept the default values.

    3. The Portal Server Web Container Deployment page is displayed.

  3. Click Next to accept the default values.

    4. Note

    Install Sample Portal is selected by default. Installing the sample portal provides a portal desktop that you can use without developing your own portal desktop.

    The Ready to Install page is displayed.

    Figure 2-7  Ready to Install Page
    Screen capture; shows list of components to be installed. In this case, all components listed on the Component Selection page.

    To Complete the Installation
  1. Review the list of components to be installed. The list should match Figure 2-7.
    • If you want to review your input or make changes, click Back. You can go back to any installer page and change any value.
    • If you are ready to install, click Next. The installer upgrades the shared components. This process takes a few minutes. When the installer finishes upgrading shared components, the Product Registration page is displayed.
  2. In the Product Registration page, clear Open Registration Window During Installation, and then click Install.

    3. The Installing page is displayed. When the installation is finished, the Installation Complete page is displayed.

    Figure 2-8  Installation Complete Page
    Screen capture; Installation Complete page with Automatically Display Installation Guide cleared.

  3. Clear Automatically Display the Sun Java Enterprise System Installation Guide.

    4. Note

    Chapter 3, "Configuring and Verifying the Evaluation Deployment" contains the postinstallation configuration instructions for the evaluation deployment.

    Click View Summary and confirm that all components were installed correctly.

    The installation process is complete. Click Close to exit from the installer.

Reviewing the Installation Log Files

If you are interested in the details of the installation, you can review the installation log files. This section describes how to locate the log files.

    To Review the Installation Log Files
  1. Change directory to the log file directory:

    2. cd /var/sadm/install/logs

  2. Run the ls command to list the contents of the directory:

    3. ls

    You see a list of installation log files for the components you installed.

  3. Open any of the installation log files you are interested in.

    4. For example, the installation log file for Directory Server is in a file name that includes a date stamp. It resembles Directory_Server_install.Bmmdd9999.

    Note

    The following log file contains information about the dependencies checking performed by the installer:

    /var/sadm/install/log/installdependencies.txt

Uninstalling the Components

After you complete your evaluation, you can use the Java Enterprise System uninstaller to removing the components that you installed. You can find the uninstaller in /var/sadm/prod/entsys.

    To Uninstall the Java Enterprise System Components
  1. Change directory to the uninstaller directory:

    2. cd /var/sasdm/prod/entsys

  2. Run the command that starts the uninstaller:

    3. ./uninstall

  3. Answer the uninstaller prompts to specify the components to be uninstalled.

Complete instructions for using the uninstaller are contained in Java Enterprise System Installation Guide, which you can find online at http://docs.sun.com/doc/817-5760.



Previous      Contents      Index      Next     

Part No: 817-5417-10.   Copyright 2004 Sun Microsystems, Inc. All rights reserved.