test

Sun Java Enterprise System 2005Q1 Deployment Example Series: Evaluation Scenario

Chapter 5 Installing the Components

This chapter describes how to install the components used in the evaluation solution. It covers copying the software distribution to the system on which you are installing, performing some necessary preliminary steps, and running the Java ES installer. When you run the installer you input the values you developed in the installation and configuration plan. (For a summary of the input values, see Java ES Installer Details.)

This chapter covers the installation process in the following sections:

Checking Installation Requirements

Before you run the installer, 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.

ProcedureTo Check the Internet Host Table

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

Steps

  1. Log in as root to the system on which you are installing Java Enterprise System.

  2. Open the /etc/hosts file in a text editor.

  3. Confirm that the /etc/hosts file contains the system’s fully qualified host name.

    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.

ProcedureTo Disable the sendmail Process

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

Steps

  1. Run the command to stop the sendmail process:


    /etc/init.d/sendmail stop

  2. Run the command to disable sendmail startup:


    mv /etc/init.d/sendmail /etc/init.d/sendmail.disabled

Installing the Components

This section describes the procedures for running the Java ES installer. You use the installer input values developed in the evaluation installation and configuration plan. (For a summary of the values and explanations of why they were chosen, see Java ES Installer Details

Note –

Throughout this document you see commands that contain the variables evaluation_host and evaluation_domain. When you execute the commands you must substitute the host name or domain name of the computer system that you are using. These variables are defined as follows:

ProcedureTo Begin the Installation Process

Steps

  1. Log in as root to the machine on which you are installing Java Enterprise System.

  2. Obtain the Java ES 2005Q1 software by one of the following means:

    • Download the software from the Java Enterprise System site at http://www.sun.com . 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. 


    ./installer

    The Welcome page is displayed.

  5. Click Next.

    The Software License Agreement page is displayed.

  6. Click Yes, Accept License.

    The Language Support page is displayed.

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

    Click Next. The Component Selection page is displayed.

    Figure 5–1 Component Selection Page

    Screen capture; components listed in text are selected for installation.

ProcedureTo Select Components for Installation

Steps

  1. Select the components that are used in the evaluation solution. Do the following:

    • Select Sun Java System Messaging Server 6 2005Q1

    • Select Sun Java System Calendar Server 6 2005Q1

    • Select Sun Java System Instant Messaging 7 2005Q1

    • Select Sun Java System Portal Server 6 2005Q1

    • Select Sun Java System Communications Express 6 2005Q1

    • Sun Java System Directory Preparation Tool is automatically selected

    • Select Sun Java System Web Server 6.1 SP4 2005Q1

    • Sun Java System Access Manager 6 2005Q1 is automatically selected

    • Sun Java System Directory Server 5 2005Q1 is automatically selected

    • Sun Java System Administration Server 5 2005Q1 is automatically selected

    These selections are shown in Figure 5–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.

    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 5–2.

      Figure 5–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.

    2. The installer might determine that the JavaTM 2 Software Development Kit, Standard Edition (J2SETM 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.

      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 5–3.

      Figure 5–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 installation directories.

    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

    • Operating system resources

  5. Evaluate the result of the system requirements checks.

    • Ignore a low memory warning. The evaluation solution requires less memory than a production solution.

    • 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 Panel page is displayed.

ProcedureTo Select a Configuration Type

Steps

  1. Select Configure Now.

    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.

    The message explains that the Java ES installer does not configure Directory Preparation Tool, Instant Messaging, Calendar Server, Messaging Server, or Communications Express. Chapter 6, Configuring and Verifying the Components describes how to configure Calendar Server, Messaging Server, and Instant Messaging and Communications Express.

    Click Next. The Common Server Settings page is displayed.

    Figure 5–4 Common Server Settings Page

    Screen capture; as described in text, fields are filled with values for the machine on which you are installing.

ProcedureTo Supply Common Server Settings

Step

    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 type password.

    • In the Retype Password text field, type password.

    • 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 5–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.

ProcedureTo Supply Web Server Configuration Values

Steps

  1. Click next to accept the default values.

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

    Figure 5–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.

    Tip –

    The user and group that you specify forWeb Server must be the same user and group you are using for the components that run in Web Server.

ProcedureTo Supply Directory Server Configuration Values

Steps

  1. Click Next to accept the default values.

    Tip –

    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.

    Figure 5–6 Directory Server: Server Settings (2 of 5)

    Screen capture; shows protected input (*) in the Administrator Password and LDAP Password fields as described in text.

  2. Do the following to establish your directory tree’s base suffix.

    • In the Server Identifier text field, confirm that default value is the unqualified form of your evaluation_host. For example, if you are installing on a system named evaluation.example.com, the default Server Identifier is evaluation.

    • In the Server Port text field, accept the default value of 389.

    • In the Suffix text field, type o=examplecorp. This value specifies the base suffix of the evaluation solution’s directory tree.

    • In the Administration Domain text field, accept the default value of evaluation_domain.

    • In the System User text field, accept the default value of root.

    • In the System Group text field, accept the default value of other.

    Tip –

    The Server Identifier identifies your server instance in the Directory Server console.

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

  3. Click Next to accept the default value.

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

  4. Click Next to accept the default value.

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

  5. Click Next to accept the default value.

    Tip –

    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.

ProcedureTo Supply Administration Server Configuration Values

Steps

  1. Click Next to accept the default values.

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

  2. Click Next to accept the default values.

    The Access Manager: Administration (1 of 6) page is displayed.

    Figure 5–7 Access Manager: Administration Page

    Screen capture; shows list of components to be installed. In this case, all components listed on the Component Selection page.

ProcedureTo Supply Access Manager Configuration Values

Steps

  1. Do the following:

    • In the Administrator Password and Retype Password text fields, accept the default value.

      Tip –

      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.

      Tip –

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

    Click Next. The Access Manager: Web Container (2 of 6) page is displayed.

  2. Click Next to accept the default value.

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

  3. Click Next to accept the default values.

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

  4. Click Next to accept the default values.

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

  5. Click Next to accept the default values.

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

  6. Click Next to accept the default value.

    The Portal Server: Web Container page is displayed.

ProcedureTo Supply Portal Server Configuration Values

Steps

  1. Click Next to accept the default value.

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

  2. Click next to accept the default values.

    The Portal Server Web Container Deployment page is displayed.

  3. Click Next to accept the default values.

    Tip –

    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 5–8 Ready to Install Page

    Screen capture; Installation Complete page with Automatically Display Installation Guide cleared.

ProcedureTo Complete the Installation

Steps

  1. Review the list of components to be installed. The list should match Figure 5–8.

    • 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.

    The Installing page is displayed. The installation process takes a few minutes. When the installation is finished, the Installation Complete page is displayed.

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

    The installation process is complete.

  4. Click Close to exit from the installer.

    Tip –

    After you complete the evaluation, you can uninstall the components. For uninstallation procedures, see Uninstalling the Components.

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.

ProcedureTo Review the Installation Log Files

Steps

  1. Change directory to the log file directory:


    cd /var/sadm/install/logs

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


    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.

    For example, the installation log file for Directory Server has a file name that includes a date stamp. It resembles Directory_Server_install.B mmdd9999.

    Tip –

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

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