Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Web Server 6.1 Installation and Migration Guide

Chapter 4
Installing Sun ONE Web Server on Windows

This chapter tells you how to install Sun ONE Web Server on Windows. It contains the following sections:

Installing on Windows

The following sections describe the installation of the Sun ONE 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.

Please keep the following warnings in mind:

Unpacking the Files

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

Installing from a Sun ONE Web Server, Enterprise Edition CD

  1. Put the Sun ONE 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.

    4. The setup.exe file is inside this folder.

Installing a Downloaded Server

  1. Download and unzip the file sun-webserver61-win.zip and save it in a temporary directory.
  2. Double-click the setup.exe file to extract the files and launch the installation program.

Running setup.exe

Run the setup.exe program to install Sun ONE 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 appears. Click Yes to accept the license.
  4. The Select Installation Type screen appears. Choose the kind of installation you want: Express, Typical or Custom.

    5. Express installation is for users who have little experience or are evaluating the product. It makes assumptions about such things as 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, and for this release, do the same thing.

    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.

    Table 4-1  Express Installation Settings

    Installation Setting

    Values

    administration port

    8888

    administration URL

    http://machine name:administration port

    HTTP port number

    80

    document root

    server_root/docs

    subcomponents

    All default subcomponents installed

    Caution

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

    Click Next.

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

    6. If you want to install Sun ONE 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

    Make sure 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.

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

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

    If you did not change subcomponents or if you’ve completed your subcomponent selections, click Next to continue to Step 8.

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

  7. 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 ONE Web Server.
    • Java Development Kit. Sun ONE Web Server 6.1 provides JDK version 1.4.1_03 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 (Step 6).

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

    9. 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 Step 12.

    Click Next.

  9. 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. You might want to make a note of this URL. The default port is 8888.

    10. If iPlanet Web Server 4.x is installed on your system, do not use the same Administration Server port number for Sun ONE 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.

  10. The Default Web Server dialog box appears. A default instance of Sun ONE Web Server is installed automatically.

    11. Type a port number for the default instance of your Sun ONE 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 www.sun.com and you choose port 9753, your server’s URL will be
    http://www.sun.com:9753/

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

    Type the path for the default server’s primary document directory, where your 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.

  11. The JDK Configuration dialog box appears.

    12. You can use the JDK included with Sun ONE Web Server (JDK 1.4.1_03) or you can use a custom JDK that already resides on your system.

    Java support in Sun ONE 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 you would need to enter the full path to the directory where jvm.dll is located.

  12. The Configuration Summary dialog box appears.

    13. This dialog box contains information about the settings for your Web Server and Administration Server. It also contains a list of the Sun ONE 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 ONE Web Server exists, use it to uninstall the portion of Sun ONE Web Server you installed. If the uninstaller does not exist, manually delete all the files that are in the server root.

  13. The Setup Complete dialog box appears.

    14. 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 ONE Web Server 6.1.

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

    • Select Start Menu -> Programs -> Sun ONE 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 following figure:

      Changing the Services Startup Type
      Figure showing the Control Panel's Services item where the server's Service Type should be set to automatic to start the server automatically after reboot.

  14. Restart your machine or use the Services Control Panel to start the Sun ONE Web Server.
  15. To configure your Sun ONE Web Server, use the URL:
    http://server_name:administration_port

    16. For example: http://www.sun.com:8888

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

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

Using Silent Installation

If you want to install several Sun ONE Web Servers, you can use silent installation to create a file of responses to the setup program’s prompts. You can then edit the file, install.inf, and use it for future Sun ONE Web Server installations.

Silent installation works best when you use the Typical installation and your installations are all similar.

Caution

The install.inf file contains the password used to log on to the Administration server. The password is not encrypted; it is in plain text. If you use silent installation, be sure and delete the install.inf file once you are through with it.

Because Sun ONE Web Server is downloaded as a self-extracting .exe file, you must first extract the files before running setup.exe. To extract the files, follow these steps:

  1. Double-click the self-extracting .exe file to start the installer.
  2. When you launch the installer, it unpacks the files to your TEMP directory. Without exiting the installer, go to the TEMP directory and copy the installation files to another location.
  3. Once the files are copied, exit the installer.

You now have a copy of setup.exe that you can use for creating the install.inf file.

To use silent installation, follow these steps:

  1. From the command line, run setup with the -k option, which creates a file called install.inf that contains all your responses to the installer’s prompts. At the command prompt, type:

    2. setup.exe -k

  2. Answer the installer prompts and install Sun ONE Web Server.
  3. When the server is installed, go to the server_root/setup directory, where you’ll find the install.inf file.
  4. Copy the install.inf file to the directory where you will run setup to install your next Sun ONE Web Server.
  5. Edit the values in the install.inf file to match the values of the next server you want to install.

    6. For example, change the port number, installation directory, etc.

  6. Run setup using the install.inf file for input. For example:

    7. setup.exe -s -f install.inf

  7. The server is installed.

The following is an example of an install.inf file.

[General]

Components=svrcore,WebServer

ServerRoot=d:\servers\s1ws61-0815

[WebServer]

Components=WebCore,JDK,CleanUp

AdminPort=8888

HttpPort=80

HttpDocRoot=d:/servers/s1ws61-0815/docs

AdminName=admin

AdminPassword=admin

UgLdapUse=FALSE

JDK_DIR=d:/servers/s1ws61-0815/bin/https/jdk

JDK_LIBPATH=

JDK_CLASSPATH=

[CleanUp]

Archive=cleanup.zip

The following table shows some useful install.inf parameters to edit. For best results, do not edit any parameters except those listed in the table.

Table 4-2  Silent Installation Parameters

Parameter Name

Use

ServerRoot

The directory where you install the server.

AdminPort

The Administration Server port.

HttpPort

The port of the default Sun ONE Web Server instance.

HttpDocRoot

The document root of the Sun ONE Web Server instance.

AdminName

The user name used to access to the Administration Server’s administration screens.

AdminPassword

The password used to access to the Administration Server’s administration screens.

JDK_DIR

The directory where your JDK is installed.

Default Sun ONE Web Server Directories

When you install the Sun ONE Web Server product, two web server instances are installed by default under the installation directory:

Files for the Web Server instance are stored in the https-host.domain directory under the installation directory.

Files for the Administration Server instance are stored in the https-admserv directory under the installation directory.

For more information about the configuration files that are created, see the Sun ONE Web Server 6.1 Administrator’s Configuration File Reference.

Using Uninstall on Windows

To remove your Sun ONE Web Server:

  1. Select Start Menu -> Control Panel -> Add/Remove Programs -> Sun ONE Web Server

    2. or

    Select Start Menu -> Programs -> Sun ONE Web Server -> Uninstall Web Server.

  2. The Sun ONE Uninstall window appears. This window lists all the Sun ONE installed in this directory. Click the checkbox next to Sun ONE Web Server and click Uninstall. Note that uninstalling Sun ONE Web Server automatically uninstalls the Administration Server, since it is an instance of Sun ONE Web Server.
  3. The uninstall program uninstalls the server. You see a window showing the progress of the uninstall.
  4. When the uninstall is complete, a message appears saying that the configuration files have not been deleted, and that you should rename them before reinstalling the server. Click OK to continue.

    5. Note

    The uninstall program does not remove every server file. For example, it does not remove keys and certificates, configuration files, logs, ACL files or the document root.



Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.