Sun ONE logo     Previous      Contents      Index      Next     
Sun ONE Web Services Platform Developer Edition Installation Guide



Installing on Solaris

This section describes the steps required to install the Sun™ ONE Web Services Platform Developer Edition software on the Solaris 8 or 9 platforms.

This section contains the following topics:

Multiple CD Installation

The Sun ONE Web Services Platform Developer Edition installation software for the Solaris platform is contained on two CDs (and on the single DVD that also includes the Windows platform).

  • After you insert CD1 or the DVD, run the installer (see Running the Installation Program in this section).

  • When the first CD is complete, you are prompted to insert CD2.

  • When you insert CD2, the installer continues automatically.


Note

If you choose to install only the Sun ONE Identity Server, the installer prompts you to insert the second CD a few minutes after the installation starts.

Previous Installations of the Sun ONE Web Services Platform Developer Edition Software

  • Uninstall any previously installed versions of the Sun ONE Web Services Platform Developer Edition software.

  • Uninstall any previously installed versions of the components that come with the Sun ONE Web Services Platform Developer Edition software (the Sun ONE Studio, Sun ONE Application Server, Sun ONE Identity Server, Sun ONE Web Server, and the Sun ONE Portal Server).


    • Note

    IMPORTANT: See Uninstalling From Solaris.

Required Privileges and Login

  • You must have superuser privileges.

  • You must log in as root, as follows:

    • su - root


    Note

    Make certain that you use the dash (-), or at runtime there will be problems with the Sun ONE Studio.

Running the Installation Program

The following steps describe how to use the graphical user interface to install the Sun ONE Web Services Platform Developer Edition software on your Solaris environment.

  1. Login as root.

  2. Insert the CD or the DVD.

  3. Enter the following command at the prompt:

    4. cd /cdrom/platformcd1

  4. If necessary, set the DISPLAY environment variable as follows:

  5. To set the DISPLAY environment variable in the C Shell (csh) and T Shell (tcsh):

    6. # setenv DISPLAY <hostname>:0 (or 0.0)

  6. To set the DISPLAY environment variable in the Bourne Shell (sh) or the Korn Shell (ksh):

    7. $ DISPLAY=<hostname>:0 (or 0.0); export DISPLAY

The host name is the computer on which you want your application to display its output.

  • To make sure that your computer accepts the display input, run the command

    • x host +

    on which you want to receive and view the display.

  • To verify that your DISPLAY is set up properly, type admintool at the command prompt.

    • The Admintool UI appears.

    Return to the command prompt to continue.

  • Run the following command at the shell prompt:

    • ./install.sh


    Note

    If you have not logged in as root, the installer displays a warning message.

    To continue the installation:

    • Click Cancel to exit the installation program.

    • Log in as root.

    The Welcome page appears.


    This screen capture shows the Welcome page with a welcome message and the copyright information.


Note

Depending on the speed of your computer system, this process can take a few moments.

  1. Read the Welcome message.

  2. Click Next to continue.


    3. Note

    If you click Cancel, the installation program aborts without installing the Sun ONE Web Services Platform Developer Edition software.

    The System Requirements page appears.


    This screen capture shows the System Requirements page that lists the software system requirements.

  3. If your system has the minimum system requirements, click Next to continue.

    4. The Software License Agreement page appears.


    This screen capture shows the Software License Agreement page.

  4. Read the license agreement.

  5. Click Yes (Accept License) to accept and continue.


    6. Note

    If you click No, the installation program aborts without installing the Sun ONE Web Services Platform Developer Edition software.

    The Java Platform page appears.


    Note

    If the installer finds a suitable JDK in your system, this page does not appear.


    This screen capture shows the Java Platform page where you can choose either to upgrade the J2SE SDK, or use an existing copy.

  6. To locate an existing copy of the J2SE SDK (version 1.4.0_02), click Browse.

    7. Otherwise, select the Install a copy of the J2SE SDK (version 1.4.0_02) option, and specify the installation directory.

  7. Click Next to continue.

    8. The Select Installation Directory page appears.


    This screen capture shows the Select Installation directory page for selecting the directory where you want to install the Sun ONE Web Services Platform Developer Edition software.

  8. Accept the default location to install the Sun ONE Web Services Platform Developer Edition software, or click Browse to select a directory.

    9. Depending on the speed of your computer system, this process can take a few moments.

    • By default, the Sun ONE Studio and the Sun ONE servers are placed each in its own default installation directory.

      • Only content that is unique to the Sun ONE Web Services Platform Developer Edition is placed in the default installation directory (for example, documentation and scripts).

    • If the default is accepted, the products are installed in their default locations as follows:

      • /opt/WebServicesPlatform

      /opt/SUNWappserver7 /etc/opt/SUNWappserver7 /var/opt/SUNWappserver7

      /opt/SUNWps /etc/opt/SUNWps /var/opt/SUNWps

      /opt/SUNWam /etc/opt/SUNWam /var/opt/SUNWam

      /opt/ASPolicyAgent

      /opt/SUNWscb

      /opt/studio/ee

      The following table shows the logical links that are created from /opt/WebServicesPlatform.

      The left column shows the Products. The middle column shows the corresponding logical links. The right column shows the corresponding locations.

      Product

      Logical Link

      Locations

      Sun ONE Application Server

       

      /opt/WebServicesPlatform/SUNWappserver7

       

      /opt/SUNWappserver7

       

      Sun ONE Portal Server

       

      /opt/WebServicesPlatform/SUNWps

       

      /opt/SUNWps

       

      Sun ONE Identity Server

       

      /opt/WebServicesPlatform/SUNWam

       

      /opt/SUNWam

       

      Sun ONE Identity Server Policy Agent

       

      /opt/WebServicesPlatform/ASPolicyAgent

       

      /opt/ASPolicyAgent

       

      Sun ONE Connector Builder

       

      /opt/WebServicesPlatform/SUNWscb

       

      /opt/SUNWscb

       

      Sun ONE Studio

       

      /opt/WebServicesPlatform/studio/ee

       

      /opt/studio/ee

       

    • If the installation directory is changed from the default, everything is placed within the user specified installation directory.

      • The following table shows the products and their locations.

      The left column shows the Products. The right column shows the corresponding locations.

      Product

      Location

      <root>

       

      sldp-root :/<install_root>

       

      Sun ONE Application Server

       

      Appserver: /<install_root>/WebServicesPlatform/SUNWappserver7

       

      Sun ONE Portal Server

       

      Portal Server: /<intall_root>/WebServicesPlatform/SUNWps

       

      Sun ONE Identity Server

       

      Identity Server: /<install_root>/WebServicesPlatform/SUNWam

       

      Sun ONE Identity Server Policy Agent

       

      /<install_root>/WebServicesPlatform/ASPolicyAgent

       

      Sun ONE Connector Builder

       

      Connector builder: /<install_root>/WebServicesPlatform/SUNWscb

       

      Sun ONE Studio

       

      Studio: /<install_root>/WebServicesPlatform/studio/ee

       


Note

The /etc and /var file locations of all products remain as-is.

  1. Click Next.

    2. The Choose Products to Install page appears.


    This screen capture shows the Choose Products to Install page with available products, the size of each, and an Info button for a brief description of each product.

  2. Select the software products you want to install.


    3. Note

    • By default, all products are selected.

    • Products already installed by the Sun ONE Web Services Platform Developer Edition installer are disabled and cannot be selected for installation.

  3. Click the Info button next to any product to read a brief product description in the text box at the bottom of the page.

  4. After you have made your selections, click Next.

    5. The Server Settings page appears.


    Note

    The Server Settings page does not appear if you selected only the Sun ONE Studio 4 update 1, Enterprise Edition for Java from the Select Components page in Step 15 above. In this case, the Checking System Status page appears (see Step 19).


    This screen capture shows the Server Settings page with fields in which you enter the machine name, the server admin password, a confirmation of the password, the domain name, and the IP address.

  5. Enter the following details in the text boxes that are provided:

    • Machine Name

      • Accept the default, or enter a valid machine name.

    • Create Admin Server Password

      • Enter the password to be used by the administrator to log in to the Sun ONE Web Services Platform Developer Edition software.


      Note

      The administrator password must be a minimum of eight alpha-numeric characters.

    • Retype Password

      • Enter the admin server password again to confirm.

    • Domain Name

      • Accept the default, or enter a valid DNS domain name.

    • IP Address

      • Accept the default.

  6. Click Next.

    7. The Checking System Status page appears.


    This screen capture shows the Checking System Status page that verifies available disk space, installed memory, operating system updates, and previous server installations.

    The installation program verifies available disk space, installed memory (RAM), and operating system updates.

    It also checks for any previous installation of the components that form part of the Sun ONE Web Services Platform Developer Edition software.

  7. Click View Report to see the details of any problems.


    8. Note

    • In the event the RAM check detects that available RAM is less than the minimum value suggested, the message Less Than Recommended is shown in the system check panel. The installation can continue, but there can be performance issues, depending on the number of products selected for installation.

    • If the system check fails in terms of Disk Space or Operating System Updates, the system is not ready for installation, and the Next button is disabled.

      In this case, click View Report to see the details of any problems.

      1. Cancel the installation.

      2. Correct the listed problems.

      3. Restart the installation of the Sun ONE Web Services Platform Developer Edition software.

    • If a previous installation of the products is found:

      1. Exit the installer.

      2. Uninstall/Remove the existing installation.

      3. Restart the installation of the Sun ONE Web Services Platform Developer Edition software.

  8. After the system check is successfully complete, click Next to continue.

    9. The Ready to Install page appears.


    This screen capture shows the Ready to Install page that lists the directory location, required disk space, and the products that will be installed.

    This page lists the directory location, required disk space, and the components and software that are to be installed.


    Tip

    Click Back to change the installation settings.

  9. Click Install to complete the installation.

    10. The Installing page appears.


    This screen capture shows the Installing page that displays the progress of the installation.

    The Installing page displays the progress of the installation.

    The CD1 or the DVD completes the installation.

    The Insert Next CD window appears displaying the following message:

    Please insert the second Sun ONE Web Services Platform Developer Edition CD.


This screen capture shows the Insert Next CD window with the message: Please insert the second Sun[tm] ONE Web SErvices Platform Developer Edition CD.

  1. Remove CD1.

  2. Insert CD2.

  3. Click OK.

    4. The Installing page appears.


This screen capture shows the Installing page that displays the progress of the installation.

The installer automatically begins to install the Sun ONE Identity Server 5.1.

The CD2 or the DVD completes the installation.

The Installation Summary page appears.


This screen capture shows the Installation Summary page where you can View Summary or View Install Log.

  1. Click View Summary to view information such as the install location and port numbers for the servers.


    2. Note

    It is recommended that you save this information for future reference.

  2. Click View Install Log to view the installation details.

    3. The path to the log file is displayed at the end of the log.

  1. Click Next.

    2. The Ready to Use page appears.


    This screen capture shows the Ready to Use page where you are pointed to the 'Getting Started' page to register your software and obtain product updates and support.

  2. Click Close to exit the installer.


    3. Note

    From the Getting Started page, register your product online for product support.

  3. Start all of the servers:

    4. <install_dir>/utils/startservers.sh

Previous      Contents      Index      Next     
Copyright 2003 Sun Microsystems, Inc. All rights reserved.

Last Updated May 06, 2003