Sun Java System Web Server 6.1 SP10 Installation and Migration Guide

Installing Web Server on UNIX Platforms

The topics in this section describe the installation of Sun Java System Web Server on UNIX platforms.

Caution –

You must install your version Sun Java System Web Server 6.1 in a server root directory separate from the server root directory that contains previous versions of the Web server.

Logging in as the Correct User

It is mandatory that the user ID of the user who runs the installation is same as Admin server user ID. Before you install Sun Java System Web Server, you must log in as root, unless you meet the following conditions:

You plan to install the Sun Java System Web Server on a port higher than 1024.
The location where you plan to install the server (the server root directory) is writable with your non-root login.
You are not planning to use Express installation.

If you meet these conditions, you do not need to log in as root to install the server; instead log in as the user account that the Administration Server will use. However, you may still prefer to log in as root, even though you meet the conditions.

Note –

Only root can bind to ports >= 1024. However, to improve security, do not allow an instance to run as root. You can configure an instance to run as another user. By default, an instance's configuration files are writable by the user that instance runs as. This means a non-root user can modify an instance's configuration file to obtain root access. Therefore, to further improve security, avoid starting an instance as root.

Solaris offers the net_privaddr privilege to allow specific non-root users to bind to ports lesser than 1024. Using this privilege means even instances that bind to ports lesser than 1024 can be started by non-root users.

Unpacking the Files

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

To unpack the files

Insert the Sun Java System Web Server CD in the drive.

Change to the CD-ROM directory. For example:

cd /cdrom

Change to the directory on the CD labeled with your UNIX operating system. For example:

cd Solaris_Sparc

Change to the installation directory. For example:

cd SUNWwbsvr

Copy the tar file, sunw-webserver-6.1.< platform-name >.tar, from the CD to your home directory or a temporary directory. For example:

cp sun-webserver-6.1.sol.tar /tmp/SUNWwbinstall

Note –
Untarring the file will cause the permissions of the destination directory to be modified so that applications can no longer write files to it. To avoid this problem, untar the file in a directory where you can modify the permissions. For example, instead of /tmp, use a subdirectory under /tmp, for example, /tmp/SUNWwbinstall.

Copying the file may take some time.

Change to the directory on your UNIX machine where you copied the file. For example:

cd /tmp/SUNWwbinstall

Untar the file by typing tar -xvf filename. For example:

tar -xvf sun-webserver-6.1.sol.tar

This command unpacks the server files and creates a temporary directory structure under the current directory. Unpacking the file may take a little time. When the files are unpacked, you see a /WebServer and a /lib directory, and the following files:
- README.txt
  - 3RD-PARTY-LICENSE.txt
  - LICENSE.txt
  - setup
  - installWrapper
  - setup.inf
  - template.inf.

To install a Downloaded Server

Download the file from http://www.sun.com/download/ and save it in a temporary directory.

Change to the directory on your UNIX machine where you copied the file. For example:

cd /tmp/SUNWwbinstall

Unpack the . gz file by typing gunzip filename. The file name is in the format:

sun-webserver-6.1.<platform-name>.tar.gz

Example:

gunzip sunw-webserver-6.1.sol.tar.gz.

Untar the unzipped file by typing tar -xvf filename. Example:

tar -xvf sun-webserver-6.1.sol.tar

This command unpacks the server files and creates a temporary directory structure under the current directory. Unpacking the file may take a little time. When the files are unpacked, you see a /WebServer and a /lib directory, and the following files:
- README.txt
  - 3RD-PARTY-LICENSE.txt
  - LICENSE.txt
  - setup
  - installWrapper
  - setup.inf
  - template.inf.
  Note –
  Untarring the file will cause the permissions of the destination directory to be modified so that applications can no longer write files to it. To avoid this problem, untar the file in a directory where you can modify the permissions. For example, instead of /tmp, use a subdirectory under /tmp, for example, /tmp/SUNWwbinstall.

Running Setup

You run the setup program to install Sun Java System Web Server.

During the installation process, you have the choice of three kinds of installation: Express, Typical, or Custom. Most users should choose Typical or Custom. Typical or Custom gives you more flexibility in the components you can install and the settings you can configure.

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. For more information, see To install using express installation.

When running the installer, you can use the following commands:

Press the Enter key to accept defaults specified in brackets (for example [All]).
Press CTRL+B to return to a previous screen (note that this sequence does not work on all screens).
Press CTRL+C to cancel the installation program.
Enter comma-separated lists of numbers when you want to select multiple items (for example, 1, 2, 3).

Note –

For Express installation, you must be logged in as root when running setup.

To install using typical or custom installation

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

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.

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.

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.

Choose all components screen and press Enter.

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.

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

plaza.sun.com

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.

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

In most cases this user is root.

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

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.

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.

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.

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
```

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.

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

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 SP10 Administrator’s Guide.

To install using express installation

The following table lists the assumptions made by the Express installation. If you would like to use different installation settings, use Typical or Custom installation.

Installation Setting	Value
administration port	8888
administration URL	`http://machine name:administration port`
HTTP port number	80
document root	`server_root/docs`
UNIX user to run server	`root`
subcomponents	All default subcomponents installed

Caution –

You must log in as root to use Express installation.

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

Type ./setup to start the server installation.

A welcome screen appears.

Press Enter to continue with the installation.

Choose whether you accept the software license agreement by entering 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.

Choose Express and press Enter.

Type a server root directory or accept the default ( /opt/SUNWwbsvr/).

This directory is where the server files and directory structure will be installed. root must have write access to this directory.

Choose all components.

Press Enter.

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

For Express installation, this user must be root. The group must be the group to which root belongs.

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

In most cases, this user is root.

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

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

Go to the https-adminserv directory under your server root directory (for example, /opt/SUNWwbsvr/) and start 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 pages.

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

http://server_name:administration_port

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

Enter your administration user name and password.

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