Chapter 1 Sun WebServer 2.1 Installation

The installation process is broken up into the following sections:

• Installation Requirements - Lists the minimum system requirements for installing Sun WebServer.

• Planning - Lists issues to think of before installing Sun WebServer.

• Installing Sun WebServer - Gives instructions on installing Sun WebServer in the default and non-default locations.

• Packages - Describes the packages that need to be installed.

• Uninstalling Sun WebServer - Gives instructions on uninstalling the Sun WebServer packages.

Installation Requirements

Before installing Sun WebServer on your machine, check the following minimum system requirements:

Platforms:

• SPARC

• Intel

Operating System:

• Solaris 2.6 or Solaris 7

Disk Space:

• 10 MB for executables and configuration files

• 3 MB or more additional space for web site documents, scripts, and log files depending on number and size of web sites hosted.

Memory:

• 64 MB minimum, 128 MB recommended

Patches (SPARC):

• 105181 Kernel

• 106257 PAM authentication library (/usr/lib/libpam.so.1) patch.

• 105390 SGML man pages update

• 106123 SGML tools for man commands

• 105284 Motif patch for AWT 1.1

Patches (Intel):

• 105182-06 Kernel

• 106258 PAM authentication library (/usr/lib/libpam.so.1) patch.

• 106061 SGML man pages update

• 106124 SGML tools for man commands

• 105285 Motif patch for AWT 1.1

Swap Space:

• SPARC 96 MB minimum, 192 MB recommended

• Swap space should be one and a half to two times the required memory multiplied by the number of processors.

Web Browser Administration:

• Sun Microsystems Solaris HotJava^TM 1.1.4 or 1.1.5

• Java^TM Developers Kit (JDK) 1.1.6

Planning Your Installation

Before you install Sun WebServer, you'll want to think about the following:

• Java^TM Servlet Support - Using servlets rather than the more usual CGI scripts provides the cross-platform advantages of Java on the server side while improving processing speed. Java Servlet Support requires the SUNWhtsvl package and Solaris^TM JDK^TM 1.1.6. You can download the lastest version of Solaris JDK at URL http://www.sun.com/solaris/java/.

• SSL for Secure HTTP Communications - Sun WebServer includes secure-socket layer (SSL 3.0) functionality and support for Verisign certificates for safe, encrypted communications.

• Microsoft FrontPage Support - Sun WebServer supports popular FrontPage 98 server extensions to allow for Microsoft FrontPage authoring, administration, and dynamic content. Support for FrontPage 98requires additional software available on Microsoft's web site at URL http://www.microsoft.com/frontpage/wpp/.

• User name - User name under which the server process runs. Running the server as root could present a possible security risk as CGI scripts could be run as root. Choose the CGI user, CGI suffix enable, CGI maps, publishing, and site restrictions carefully. Running the server as nobody is safe, but limits the system files and resources the server can access.

• Sun WebServer 1.0 - If you have Sun WebServer 1.0 installed, you must uninstall Sun WebServer 1.0 before installing Sun WebServer 2.1. See chapter 4 of this installation guide for upgrade instructions.

Installing Sun WebServer

To install Sun WebServer using the pkgadd command:

1. Become superuser.

   % su

2. Change (cd) to the Sun WebServer directory on the CD or to the directory where you unpacked the archives. For example:

   ---

   Note -

   The packages are located in the directory where you unpacked the archives; however, the actual directory names may vary depending on how you purchased Sun WebServer.

   ---

   # cd /tmp

3. (Optional) If you want SSL support, complete this step. If you do not want SSL support, skip this step and move on to Step 4.

   You should install the packages in the specified order as some packages have dependencies on other packages.

   The installation process is interactive and will prompt you for answers. Answer "yes" to all questions in the pkgadd process.

   ---

   Note -

   You should only install the SUNWhttp packages to custom locations. The security tools packages (SUNWfns, SUNWski, SUNWskica, SUNWskicw, SUNWskimc, SUNWskimu, SUNWssl) should always be installed to their default locations.

   ---

   SSL Installation

   1. Remove the SUNWfns package installed with Solaris 2.6.

      Disregard the warnings regarding the disposal of SUNWfns.

      ---

      Note -

      SUNWfns should be upgraded to the version we supply on Solaris 2.6 systems. On Solaris 7, you do not need to remove or upgrade the exisitng SUNWfns.

      ---

      # pkgrm SUNWfns

   2. Change directories to the directory that contains the SSL packages, and install the updated version SUNWfns along with the SUNWski and SUNWssl packages. On Solaris 7, you do not need to remove or upgrade the exisitng SUNWfns.

      ---

      Note -

      If you have a global export version, install SUNWssl instead of SUNWssld. Also, there is no SUNWskild package to install. The SUNWskild package should be installed after the SUNWski package to ensure the integrity of all symbolic links.

      ---

      # pkgadd -d . SUNWfns SUNWski SUNWskild SUNWskica\ SUNWskicw SUNWskimc SUNWskimu SUNWssld

4. Install the Sun WebServer packages.

   To Install Sun WebServer to Default Directories:

   1. Change directories to the directory containing the Sun WebServer core packages, and install the packages.

      The installation process is interactive and will prompt you for answers. Answer "yes" to all questions in the pkgadd process.

      ---

      Note -

      SUNWhtsvl is the Java Servlet Support package and is only required if you want support for servlets. It requires Solaris^TM JDK^TM 1.1.6. You can download the lastest version of Solaris JDK at URL http://www.sun.com/solaris/java/. SUNWhtadm is the Sun WebServer GUI applet and server package. It is recommended for easy management of Sun WebServer.

      ---

      # pkgadd -d . SUNWhttp SUNWhtsvl SUNWixklg SUNWixavm SUNWhtadm SUNWhttpc

   2. Change directories to the directory containing the Sun WebServer online help and man pages, and install the documentation packages:

      # pkgadd -d . SUNWhtdoc SUNWhtman

Packages

Sun WebServer includes the following packages:

SUNWhtadm

Administration Package

SUNWhtsvl

Servlet Support Package

SUNWhttp

Daemon and Supporting Binaries Package

SUNWhttpc

Configuration Package

SUNWhtdoc

Online Help Package

SUNWhtman

Sun WebServer Man Pages Package

SUNWfns

Federated Naming System

SUNWski

SKI 1.0 Software (User Package)

SUNWskica

SKI 1.0 Software (CA Package)

SUNWskicw

SKI 1.0 Software (Licensing Package for CA)

SUNWskimc

SKI 1.0 Software (CA Manual Page Package)

SUNWskimu

SKI 1.0 Software (CA User Manual Page Package)

SUNWssl

SSL 1.0 Software (Global Version Library)

SUNWskild

SKI 1.0 Software Package (US and Canada Library)

SUNWssld

SSL 1.0 Software (US and Canada Library)

SUNWixklg

KLG classes.

SUNWixavm

JMAPI AVM classes.

Uninstalling Sun WebServer

To uninstall the Sun WebServer software, use pkgrm.

1. Become superuser.

   % su

2. To remove the Sun WebServer core packages, complete the following command.

   If you installed Sun WebServer to default locations, type

   # pkgrm SUNWhttpc SUNWhtsvl SUNWhtadm SUNWhttp SUNWhtdoc \ SUNWhtman SUNWixklg SUNWixavm

   If you installed Sun WebServer to non-default locations, type

   # pkgrm -R <install_root> SUNWhttpc SUNWhtsvl SUNWhtadm SUNWhttp SUNWhtdoc \ SUNWhtman SUNWixklg SUNWixavm

3. To remove the SSL packages, type:

   # pkgrm SUNWski SUNWskicw SUNWskica SUNWskimc SUNWskimu SUNWssl

   ---

   Note -

   In the above example, substitue SUNWssld for SUNWssl, and add SUNWskild if you have the US/Canada version of Sun WebServer.

   ---