Sun Java System Web Server 6.1 SP12 Installation and Migration Guide

ProcedureTo install using typical or custom installation

  1. If you are not in the directory already, change to the directory where you unpacked the file.

  2. Type ./setup to start the server installation.


    Note –

    If you are not logged in as the root user (superuser), or if you do not have sufficient write permissions, you will get one or more error messages.


    A welcome screen appears. Press Enter to continue with the installation.

  3. Choose whether you accept the software license agreement by typing Yes to accept, or No to decline. If you have not yet read the license agreement, cancel out of the installation and read the file LICENSE.txt that is in the same directory as the setup program. Type Yes or y to accept the agreement.

  4. Specify the server root directory where the server files and directory structure will be installed or accept the default ( /opt/SUNWwbsvr/) and press Enter.


    Note –

    You need to run the server as a user who has write access to this directory, for example, the directory owner.


  5. Choose all components screen and press Enter.

  6. Install the following subcomponents:

    • 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 Java Developer’s Kit (JDK) version 1.4.2_13 as a bundled product. You can install the provided JDK, or use your own JDK.


      Note –

      If you do not want to install the bundled JDK, type 1 and press Enter. In this case, To install using typical or custom installation is an additional step in the installation process, where you would need to specify the path to the JDK.


  7. Specify the fully qualified domain name of the computer on which you are installing the server and press Enter. Example:

    plaza.sun.com

  8. Enter the UNIX user and group names to use when running the default instance of Sun Java System Web Server and press Enter.

    If you are installing as root, the default user and group on all UNIX systems except Solaris OE, is nobody. On Solaris OE, if you are installing as root, the default user and group is webservd. If the user or group does not exist, it is automatically created during installation.


    Note –

    HP-UX has a UID of -2 for nobody. If you have to run the server as nobody on this platform, change the UID of nobody to a positive unique number less than the UID max.


  9. Enter the UNIX user name to use when running the Administration Server and press Enter.

    In most cases this user is root.

  10. Enter the Administration Server user name and password to use for authentication. You are asked to enter your password twice. Press Enter.

  11. Type the Administration Server port number or accept the default of 8888.

    For maximum flexibility, choose a port number above 1024. If you want to use a port number lower than 1024 for your Administration Server, you must be logged in as root to start the server. Do not use a port that is already in use.

    This Administration Server is not the same as the Administration Server shipped with other Sun Java System servers.

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

  12. Type the port number of Sun Java System Web Server.

    The default is 80. This port should be different than the Administration Server port. Unless you are installing as root, the port must be within the stated range (1024 to 65535). If you are installing as root you can use port numbers below 1024.

    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, the URL of the server will be http://www.sun.com:9753/

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

  13. Type the root directory where content files of your server (the images, HTML documents and data you want to present to users accessing the server) will reside, and press Enter. The default is server_root /docs.

  14. If you are installing Sun Java System Web Server as root (superuser), then the option to start Web Server automatically when the system boots up (Start on Boot) comes up next. If you want to enable Start on Boot, retain the default, which is Yes and press Enter; otherwise, type No and press Enter.


    Note –

    You can disable the Start on Boot option as follows:

    On Solaris and HPUX, you can turn off this option by editing the S1WS_START_ONBOOT variable in the webserver01 script. On Linux, delete the following links to disable it:

    /etc/rc.d/rc3.d/S75webserver01
    /etc/rc.d/rc5.d/S75webserver01

  15. If you chose to use your own JDK, enter the absolute path to the directory where you installed the JDK on your system.

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

    The JDK must already exist in the specified directory.

    If the custom JDK is located in a directory with a standard tree structure, you can press Enter to continue with the installation. If the custom JDK location follows a non-standard tree structure, then at this prompt you would need to enter the full path to the directory where libjvm.so (or libjvm.sl) is located.

  16. After the installation program extracts and installs the Sun Java System Web Server components, press Enter.

  17. Go to the https-admserv directory under your server root directory (for example, /opt/SUNWwbsvr/) and start the Administration Server by typing ./start.

    You can also type ./startconsole in the server root directory.

    startconsole starts the Administration Server and launches a browser to the Administration Server administration pages.

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

    http://server_name:administration_port

    For example: http://www.sun.com:5566

    Enter your administration user name and password.

    You can now configure your Sun Java System Web Server. For more information on configuring and using Sun Java System Web Server 6.1, see the Sun Java System Web Server 6.1 SP12 Administrator’s Guide.