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



Installing on Windows

This section describes the steps required to install the Sun™ ONE Web Services Platform Developer Edition software on the Windows 2000 platform.

This section contains the following topics:

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, and the Sun ONE Web Server).
  • After uninstalling, check to make certain that all products were uninstalled.


  • Note

    IMPORTANT: See Uninstalling From Windows.



Required Privileges and Login

To run the Sun ONE Web Services Platform Developer Edition installer on Windows 2000, you must log in as Administrator, or as a user with administrator privileges.

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 Windows 2000 environment.

Before installing the Sun ONE Web Services Platform Developer Edition software, you must check for a fully qualified domain name.

To check for a fully qualified domain name:

  1. Right-click the My Computer icon located on your desktop.
  2. Click Properties.
  3. The System Properties window appears.

  4. Click Network Identification.
  5. Click Properties.
  6. The Identification Changes window appears.
  7. Click More.
  8. The DNS Suffix and NetBIOS Computer Name window appears.
  9. This window has a text box labeled Primary DNS suffix of this computer.
  10. If the text box is blank, enter a valid <domain_name>.
  11. Click OK.
  12. A window appears with a message prompting you to reboot the machine.



    Note

    Rebooting your machine at this point is required to effect the changes you made.



Install

Before installing, you must uninstall any previously installed versions of the Sun ONE Web Services Platform Developer Edition software.

Additionally, you must uninstall any previously installed versions of the components that come with the Sun ONE Web Services Platform Developer Edition software (Sun ONE Studio, Sun ONE Application Server, Sun ONE Identity Server, and Sun ONE Web Server).



Note

See Uninstalling From Windows.



  1. Check your system to see if any of the following still exist from previous installations:
    • Services
    • Registry entries (use regedit)
    • Start Menu entries
    • Files/Folders



    Note

    See Removing Leftover Files, Registry Entries, and Services from Previous Windows 2000 Installations.



  2. Reboot your machine.
  3. Check the Windows 2000 System Requirements section of this installation guide to see if your machine meets the requirements.
  4. Insert the CD or the DVD.
  5. The DOS Window appears.

    A message appears on the DOS prompt as follows:

    Sun[tm] ONE Web Services Platform Developer Edition.
    Please review the Installation Guide on the product CD/DVD before installing.
    Do you want to begin installing now? [Y/N]:

  6. To continue, enter Y.
  7. Press Enter.
  8. The installation automatically begins.

    The Welcome page appears.


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

  9. Read the Welcome message.
  10. Click Next to continue.


  11. 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 system requirements for the Sun ONE Web Services Platform Developer Edition software.

  12. If your system has the minimum system requirements, click Next to continue.
  13. The Software License Agreement page appears.


    This screen capture shows the Software License Agreement page.

  14. Read the license agreement.
  15. Click Yes (Accept License) to accept and continue.
  16. 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  use an existing copy of the J2SE SDK (version 1.4.0_02), or you can install a copy.

  17. To locate an existing copy of the J2SE SDK (version 1.4.0_02), click Browse.
  18. Click Next to continue.
  19. 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 software.

  20. Accept the default location to install the Sun ONE Web Services Platform Developer Edition software, or click Browse to select a directory.
  21. Depending upon 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 (C:\Sun\WebServicesPlatform), the products are installed in their default locations as follows:
    • C:\Sun\WebServicesPlatform\
      C:\Sun\AppServer7
      C:\Program Files\Sun\Connector Builder
      C:\Sun\IdentityServer
      C:\Program Files\studio\ee
      C:\Sun\ASPolicyAgent

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


    • Note

      It is best to limit the length of the install location to be similar to that of the default install location (C:\Sun\WebServicesPlatform). When the install location is long, samples (for example, Dining Guide) might throw a com.iplanet.ias.util.zip.ZipFileException.

      This happens when the absolute pathname of generated Web services class files exceed 255 characters (Windows limitation).



    • If the default is not accepted:
    • If the user input is d:\<install_dir>,
      s1dp-root : d:\install_dir\WebServicesPlatform :

      d:\<install_dir>\WebServicesPlatform\AppServer7
      d:\<install_dir>\WebServicesPlatform\Connector Builder
      d:\<install_dir>\WebServicesPlatform\IdentityServer
      d:\<install_dir>\WebServicesPlatform\studio\ee
      d:\<install_dir>\WebServicesPlatform\ASPolicyAgent

    • If this is a reinstallation of the Sun ONE Web Services Platform Developer Edition, the installer defaults to the directory from the previous installation.

  22. Click Next.
  23. 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 small description of each product.

  24. Select the software products you want to install.
  25. Click Info next to any product to read a brief product description in the text box at the bottom of the page.
  26. After you have made your selections, click Next.
  27. 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 16 above.




    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.

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

      This should match your primary DNS suffix as mentioned in the first step of Running the Installation Program.

    • IP Address
    • Accept the default.

  29. Click Next.
  30. 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.

    To prevent installation failure, the installation program also checks for any previous installation of the selected products that were not installed by the Sun ONE Web Services Platform Developer Edition installer.

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



      Note

      When using an unsupported operating system, a warning appears.

      You are allowed to continue the installation, but a successful installation of the product is not guaranteed.



    • If the required system updates are not available on your system:
    • a. Click Cancel to abort the installation.

      b. Correct the problems.

      c. Initiate the installation of the Sun ONE Web Services Platform Developer Edition software.

    • If a previous installation of the products is found:
    • a. Exit the installer.

      b. Uninstall/Remove the existing installation.

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

  31. After the system check is complete, click Next to continue.
  32. 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.

  33. Click Install to complete the installation.
  34. The Installing page appears.


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

    The Installation Summary page appears.


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

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


    • Note

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



    • Click View Install Log to view the installation details.

  35. Click Next.
  36. The Ready to Use page appears.


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

  37. Click Finish.
  38. The Sun ONE Web Services Platform Developer Edition Install window appears with the following warning message:

    Do you want to restart your machine now?


    This screen capture shows the message: Do you want to restart your machine now?



    Note

    Restarting your machine at this point is recommended.



  39. Click Yes.
  40. The reboot process automatically begins.



    Note

    Manually remove the disk.



  41. After your machine completely reboots, the Getting Started page automatically launches.
  42. At any future time, you can access the Getting Started page, or any other documents from your Windows Start menu:

    Start > Programs > Sun Microsystems > Sun ONE Web Services Platform Developer Edition >Documentation


This screen capture shows the location of documentation from the Windows start menu.



Note

From the Getting Started page, you can register your product online for product updates and support.



  1. Start all of the servers:
  2. Start > Programs > Sun Microsystems > Sun ONE Web Services Platform Developer Edition > Start Sun ONE Servers


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