Sun Java System Web Server 6.1 SP10 Installation and Migration Guide

Installing on Windows

The following sections describe the installation of the Sun Java System Web Server.

Any errors that occur when the server starts are logged in the Event Viewer. Once started, the server logs errors to the normal error log file.

Note –

Unpacking the Files

To get the Sun Java System Web Server files and unpack them, follow these steps:

ProcedureTo install from a Sun Java System Web Server Enterprise Edition CD

  1. Insert the Sun Java System Web Server CD in the drive. Click the icon representing your CD-ROM drive.

  2. Double-click the Windows folder.

  3. Double-click the setup folder.

    The setup.exe file is inside this folder.

ProcedureTo install a downloaded Server

  1. Download and unzip the file and save it in a temporary directory.

  2. Double-click the setup.exe file to extract the files and launch the installation program.

ProcedureTo run setup.exe

Run the setup.exe program to install Sun Java System Web Server.

  1. Double-click the setup.exe file.

  2. The Welcome screen appears. After reading the Welcome screen, click Next.

  3. The Software License Agreement text appears. Click Yes to accept the license.

  4. The Select Installation Type screen appears. Choose the type of installation you want: Express, Typical or Custom.

    Express installation is for users who have little experience or are evaluating the product. It makes assumptions about port number and which components to install. This option is not recommended if you are using your server in a production environment.

    Typical and Custom installation give you more options.

    If you chose Express installation, the following settings are set automatically for you. By default, the Java Developer’s Kit (JDK) used is the bundled JDK. If you want to have different values for these settings, choose Typical or Custom installation.

    Installation Setting  


    administration port 


    administration URL 

    http://machine name:administration port

    HTTP port number 


    document root 



    All default subcomponents installed 

    Caution – Caution –

    Do not use Express Installation if you already have another web server running on port 80.

  5. Click Next.

  6. The Location of Installation dialog box appears. The default location for the server files is C:\Sun\WebServer6.1.

    If you want to install the Sun Java System Web Server in a non-default location, use Browse to navigate to the folder you want, or type the name in the field. If you choose a folder that does not exist, the installation program asks if you want to create the folder.

    Caution – Caution –

    Ensure that the path to which you install the Web Server has no spaces in its name. For example, do not choose the C:\Program Files directory to install the product, since this directory contains a space in its name.

    Click Next.

  7. The Components to Install dialog box appears. Select Web Server from the list.

    Note that because the Administration Server is now a Sun Java System Web Server instance, it is installed automatically when you install Sun Java System Web Server, and is not a choice on this product list.

    If you did not change subcomponents or if you have completed your subcomponent selections, click Next to continue to To run setup.exe.

    If you are migrating from iPlanet Web Server 4.1, you must install all the subcomponents that you installed for 4.1, otherwise they may not work. You can install additional subcomponents as well.

  8. If you clicked Change on the previous screen, the Select Sub-Components dialog box appears. By default the following subcomponents are installed:

    • Server Core. Installs the Administration Server and the first instance of Sun Java System Web Server.

      • Java Development Kit. Sun Java System Web Server 6.1 provides JDK version 1.4.2_13 as a bundled product. You can install the provided JDK, or supply your own.

        Click Continue when you are through choosing subcomponents, to return to the Components to Install dialog box (To run setup.exe).

  9. Type the user name for Administration Server access; the default is admin. Type the Administration Server access password; type it again for verification.

    If you are using LDAP-based authentication, you must make sure that this user has access permissions to the LDAP server to perform user/group management tasks.

    If you chose Express Installation, skip to To run setup.exe.

    Click Next.

  10. Type the port number the Administration Server runs on. This can be any number from 1 to 65535. The URL for administration access is displayed. Make a note of this URL. The default port is 8888.

    If iPlanet Web Server 4.x is installed on your system, do not use the same Administration Server port number for Sun Java System Web Server 6.1 as you used for iPlanet Web Server 4.x.

    For more information on ports, see Choosing Unique Port Numbers.

    Click Next.

  11. The Default Web Server dialog box appears. A default instance of Sun Java System Web Server is installed automatically.

    Type a port number for the default instance of your Sun Java System Web Server. This port should be different than the Administration Server port. If you use a port other than the default port (port 80), the URL used to gain access to your home page will change. For example, if your computer is called and you choose port 9753, URL of the server will be

    For more information on ports, see Choosing Unique Port Numbers.

    Type the path for the default primary document directory of the server , where server’s content files (the images, HTML documents and data you want to present to users accessing the server) will reside. The default is C:\server_root\docs. Click Browse to navigate your file system.

  12. The JDK Configuration dialog box appears.

    You can use the JDK included with Sun Java System Web Server (JDK 1.4.2_13) or you can use a custom JDK that already resides on your system.

    Java support in the Sun Java System Web Server 6.1 requires a JDK version that is at least JDK version 1.4.

    To use your own JDK, click the Use Custom Java Development Kit checkbox and enter the absolute path to the folder where you installed the JDK on your system. For example, D:\jdk1.4\ If the custom JDK is located in a directory with a non-standard tree structure, then enter the full path to the directory where jvm.dll is located.

  13. The Configuration Summary dialog box appears.

    You can review your settings in this dialog box. It also contains a list of the Sun Java System Web Server components you selected for installation.

    This dialog box gives you the opportunity to review your settings before the installation is complete. If they are correct, click Install. If you want to change some of the settings, click Back and correct the information.

    The server files are installed.

    Note –

    You should not cancel the installation process while the files are being copied. If you do, you will have a partial installation you need to clean up. If an uninstaller for Sun Java System Web Server exists, use it to uninstall the portion of Sun Java System Web Server you installed.

  14. The Setup Complete dialog box appears.

    To view the Readme file, keep the View Readme checkbox checked (by default), and click Finish.

    The Readme file contains a pointer to the latest Release Notes for Sun Java System Web Server 6.1.

    You can start the Administration Server in either of the following ways:

    • Select Start Menu -> Programs -> Sun Java System Web Server, and choose Start Web Server Administration Server.

      • From the Control Panel’s Services item.

        To start the servers automatically after reboot, change the Startup Type of the services to Automatic from the Control Panel’s Services item, as shown in the Figure 4–1: Changing the Services Startup Type

    Figure 4–1 Changing the Services Startup Type

    Changing the Services Startup Type

  15. Restart your machine or use the Services Control Panel to start the Sun Java System Web Server.

  16. To configure your Sun Java System Web Server, use the URL:

    http:// server_name:administration_port

    For example:

    Enter your administration user name and password to administer the server.

    You can now configure your server. For more information, see the Sun Java System Web Server 6.1 SP10 Administrator’s Guide.