Solaris for ISPs Installation Guide

Installing and Uninstalling from the Command Line

The sections in this chapter will help you install and uninstall SolarisTM for ISPsTM platform extensions and services from the command line.

If you choose to install from the command line, you will not get the benefits of the host configuration software. The host configuration software allows you to perform, as part of the installation process from a browser, some tuning and security modifications. It allows you to save the configuration specifications you provide during installation as a configuration scenario.

A scenario is the combination of the current state of the server plus the specifications you provided; in other words, the desired final state of the server. If you save the scenario using the host configuration software, you can use it for setting up JumpStartTM scripts to duplicate the scenario on other servers. The host configuration software also allows you to execute some non-interactive post-installation commands or a script.

We recommend installing Solaris for ISPs from a browser using the host configuration software. Please install from the command line only if you are completely familiar with the product and its various component dependencies.

Preinstallation Tasks

To properly prepare for installing Solaris for ISPs, you must understand how the various platform extensions and services fit together and depend upon one another. Chapters 1 through 4 of the Solaris for ISPs Administration Guide provide an overview of the product and explain in detail the hardware and operating system requirements for each software component.

Planning Your Installation
  1. Read the overview documentation, Chapters 1 through 4 of the Solaris for ISPs Administration Guide, and perform the steps outlined there.

    • Chapter 1, "Solaris for ISPs Overview," discusses product features and benefits.

    • Chapter 2, "How to Plan your Installation," presents in detail the steps in planning, preparing, and installing the product.

    • Chapter 3, "Setup Guidelines," presents configuration guidelines.

    • Chapter 4, "Installation Requirements," lists RAM, disk space, and OS requirements, for the product software. This chapter also discusses the component dependencies on bundled and unbundled software.

  2. Check the README, at media_root/docs/README.1st, for any late breaking corrections to this documentation.

The Solaris for ISPs overview documentation is available in several formats for your convenience.

Installing the Software

This section discusses the steps involved in the installation of Solaris for ISPs from the command line.

Installing Solaris for ISPs Components
  1. Log into the computer where you want to install the software and give yourself root access.

    If you are installing remotely, enter:

    • % rlogin remotehostname
    • % password
    • % su
    • Password: rootpassword

  2. Change directory to the root of the media from which you are installing.

    Change to either the directory where you unwrapped the electronic distribution or the root directory of the mounted CD-ROM.


Note -

Please proceed to the individual component installation section to install the component.


Installing Solaris for ISPs Platform (SUNWisp)

The Solaris for ISPs platform provides the platform extensions with configuration management tools and enhancements for logging. If this is the first instance of a Solaris for ISPs installation on this machine, you must install this software.

  1. Change directory to components/SUNWisp/.

  2. Enter ./install

    The script will ask for a few configuration information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWisp/).

  4. Do you want to install the Solaris for ISPs Administration Guide?

    Press Return for yes or enter b for no. If you select yes, the Solaris for ISPs Administration Guide in HTML format is installed.

  5. Do you want to install the Host Configuration manual pages?

    Press Return for yes or enter b for no. If you select yes, the manual pages for the host configuration command-line tools are installed.

Proceed to "Determining That Installation Was Successful".

Installing JDK 1.1.5 (SUNWjdk)

JDK 1.1.5 provides the Java classes needed by several of the Solaris for ISPs components. You cannot customize installation of this software. You must install the Solaris for ISPs platform (SUNWisp) before installing JDK 1.1.5.

  1. Change directory to components/SUNWjdk/.

  2. Enter ./install

    The script requests information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWjdk/).

Proceed to "Determining That Installation Was Successful".

Installing HotJava 1.1.4 (SUNWdthj)

This is the Web browser you must use to access SunTM Internet Administrator. You cannot customize installation of this software. You must install Solaris for ISPs platform (SUNWisp) before installing HotJavaTM.

  1. Change directory to components/SUNWdthj/.

  2. Enter ./install

    The script requests information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWdthj/).

Proceed to "Determining That Installation Was Successful".

Installing the License Server for Solaris for ISPs (SUNWlicsw)

FlexLM server for Solaris for ISPs. You cannot customize installation of this software. You must install Solaris for ISPs platform (SUNWisp) before installing this license server. Use the license certificate for this software to obtain a license key to initialize more entries in Sun Directory Services. To install:

  1. Change directory to components/SUNWlicsw/.

  2. Enter ./install

    The script requests information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWlicsw/).

Proceed to "Determining That Installation Was Successful".

Installing Sun Directory Services (SUNWconn)

This Lightweight Directory Access Protocol (LDAP) implementation provides a shared repository for user (administrator), service configuration, and subscriber information in SunTM Directory Services. You must install Solaris for ISPs platform (SUNWisp) and JDK 1.1.5 (SUNWjdk) before installing Sun Directory Services.

For more information about the configuration fields, refer Sun Directory Services 3.1 Administration Guide, Sun Directory Services 3.1 User's Guide, and chapters 5 and 6 of the Solaris for ISPs Administration Guide.

  1. Change directory to components/SUNWconn/.

    Before installing the component, verify component dependencies by referring to Chapter 4 of the Solaris for ISPs Administration Guide.

  2. Enter ./install

    The script will ask for a few configuration information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWconn/).

  4. Do you want to run the RADIUS server included with Solaris for ISPs?

    Press Return for yes or enter b for no. If you select no, the RADIUS server bundled with Solaris for ISPs will only be installed and will not be started.

  5. What country do you wish to specify as your root for this install of Sun Directory Services?

    Enter your two-character country code. You can accept the default [US] by pressing Return and specify your two-character country code.

  6. Organization name for root of Sun Directory Services

    Enter your organization name (for example, Sun).


    Note -

    The values entered in steps two and three are used to define your top level distinguished name in the OSI tree. For example, o=sun,c=us.


  7. Root DN (distinguished name) for Sun Directory Services?

    Enter the distinguished name of the server administrator for binding to the directory services. Use the format cn=admin,o=sun,c=US, where cn is the commonName, o is the organizationName, and c is the countryName.


    Note -

    Here, c and o must match the values specified in Step 5 and Step 6 respectively.


  8. Top level domain for Sun Directory Services?

    Enter the top level domain for Sun Directory Services DITs (for example, COM).

  9. What do you wish to use as youradministrative root password?

    Enter the server administrator, specified in Step 7, password for binding to the directory services.


    Note -

    Make a note of the information you entered in steps two through six if you want Sun Internet Administrator to contact this directory services server.


  10. Do you wish to have the Web Gateway server automatically started and monitored?

    The Web gateway allows you to browse entries in the directory through an HTML interface. Press Return for yes or enter b for no.

  11. Do you wish to have the Sun Directory Services administration server automatically started and monitored?

    Press Return for yes or enter b for no.


    Note -

    Monitoring the daemons enables automatically restarting the daemons if they die. If you do not choose to start and monitor the daemons after installation, you can also manually start these daemons at another time by referring to "Starting the Directory Services". For more information on how you should start the daemons, refer Sun Directory Services 3.1 Administration Guide.


Proceed to "Determining That Installation Was Successful".

Installing SKIP (SUNWicg)

Simple key-management for Internet Protocols (SunscreenTM SKIP) is the recommended standard of key management for IP encryption. You cannot customize installation of this software. You must install Solaris for ISPs platform (SUNWisp) before installing SKIP.

  1. Change directory to components/SUNWicg/.

  2. Enter ./install

    The script requests information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWicg/).

Proceed to "Determining That Installation Was Successful".

Installing Sun Internet FTP Server (SUNWftp)

You cannot customize installation of the FTP server. You must install Solaris for ISPs platform (SUNWisp) and JDK 1.1.5 (SUNWjdk) before installing SunTM Internet FTP ServerTM. After installation, to access the browser-based graphical user interface of this software, ensure that you register this Sun Internet FTP Server with a Sun Internet Administrator console on the network. To install:

  1. Change directory to components/SUNWftp/.

  2. Enter ./install

    The script requests information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWftp/).

Proceed to "Determining That Installation Was Successful".

Installing Sun Internet News Server (SUNWsns)

This is a highly-scalable multi threaded news server. You must install Solaris for ISPs platform (SUNWisp) and JDK 1.1.5 (SUNWjdk) before installing SunTM Internet News ServerTM. After installation, to access the graphical user interface of this software, ensure that you register this Sun Internet News Server with a Sun Internet Administrator console on the network. To install:

  1. Change directory to components/SUNWsns/.

    Before installing the component, verify component dependencies by referring to Chapter 4 of the Solaris for ISPs Administration Guide.

  2. Enter ./install

    The script will ask for a few configuration information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWsns/).

  4. Select the desired News server configuration

    Press Return for Reader and Feeder Services which is the default [c] option. Or, enter:

    • a for Reader Service Only (Remote feed). Or,
    • b for Feeder Service Only.


    Note -

    These three choices allow you to specify the type of service you wish to provide from this news server.


  5. Enter the UNIX user name of the News service administrator

    Press Return and accept the default UNIX user name of the news service administrator responsible for this news server. The default uid is root. Sun Internet News Server can be accessed only by root.

  6. Enter the Unix group name of the News service administrator

    Press Return and accept the default UNIX group name of the news service administrator responsible for this news server. The default gid is sys.

Proceed to "Determining That Installation Was Successful".

Installing Sun WebServer (SUNWhttp)

This is used by some Solaris for ISPs components and can be used for standard Web service. You must install Solaris for ISPs platform (SUNWisp) and JDK 1.1.5 (SUNWjdk) before installing SunTM WebServerTM. To install:

  1. Change directory to components/SUNWhttp/, where componentid is the package name of the Solaris for ISPs component you want to install.

  2. Enter ./install

    The script will ask for a few configuration information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWhttp/).

  4. Do you want SSL support?

    This allows you to have secure communication with the Sun Internet Administrator via Secure Socket Layer (SSL). SSL supports Verisign certificates for protected, encrypted communications. Press Return for yes or enter b for no. If you select no, the SSL packages will not be installed.

  5. Do you want Java(TM) Servlet support?

    Using servlets rather than CGI scripts provides the cross-platform advantages of Java on the server side while improving processing speed. Java Servlet support requires installation of the JDK 1.1.5 component. Press Return for yes or enter b for no.

  6. Do you want Apache configuration emulation so that Microsoft FrontPage Server Extensions may be installed?

    This option allows your customers to use Microsoft FrontPage for authoring, administration, and dynamic content.

    Press Return for no or enter b for yes


    Note -

    The FrontPage Server Extensions are currently not available for x86.


  7. Do you want this installation to create and populate a web server and site in /var/http/sws_server?

    Press Return for yes or enter b for no. If you select yes, a web server and a customizable web site are created.

  8. Under what user name should a Web server daemon operate by default?

    Specify the user name under which you want this Web server daemon to operate.


    Note -

    For security reasons, do not run Sun WebServer as user root, or user nobody. We recommend creating a second user and executing the Sun WebServer daemon under that name.


Proceed to "Determining That Installation Was Successful".

Installing Sun Internet Administrator (SUNWixamc)

This provides secure central management for distributed Internet services. If you install Sun Internet FTP Server (SUNWftp) or Sun Internet News Server (SUNWsns), you must install this software to access their user interfaces. You must install Solaris for ISPs platform (SUNWisp), JDK 1.1.5 (SUNWjdk), and Sun WebServer (SUNWhttp) before installing Sun Internet Administrator.

The configuration information you enter here is stored in /var/opt/SUNWixamc/awsconf/aws.conf. To install:

  1. Change directory to components/SUNWixamc/, where componentid is the package name of the Solaris for ISPs component you want to install.

  2. Enter ./install

    The script will ask for a few configuration information for installing the component.

  3. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWixamc/).

  4. Install the Solaris for ISPs manual pages?

    This option allows you to install the on-line Solaris for ISPs man pages. Press Return for yes or enter b for no.

  5. Enter the host name of the Sun(TM) Directory Services servers

    Enter the host name of the Sun Directory Services server this Sun Internet Administrator will contact to make initial entries.

  6. Enter Sun(TM) Directory Services administrator's DN (Eg, cn=admin,o=sun,c=US). This value must match what you specified for Sun Directory Services

    Enter the distinguished name of the data store administrator you specified (in Step 7) when installing Sun Directory Services. To specify, use the format: cn=admin,o=sun,c=US where cn is the commonName, o is the organizationName, and c is the countryName.

  7. Enter Sun Directory Services administrator's password.

    Enter the password of the data store administrator specified in Step 6.

  8. Enter the Sun(TM) Directory Services top level DN (for example, o=sun,c=US). This value must match the Country and Organization name that were specified for Sun Directory Services.

    Enter the top level distinguished name of the root domain you specified (in Step 5 and Step 6) when installing Sun Directory Services. To specify, use the format: o=sun,c=US where o is the organizationName and c is the countryName.


    Note -

    The values you enter in steps two through five must match the values you entered at the time of installing the directory services this Sun Internet Administrator will contact to make initial entries.


  9. Enter a user name for the administrator of Sun(TM) Internet Administrator

    Enter the user login name for the administrator of the Sun Internet Administrator console.

  10. Enter a password for the administrator of Sun(TM) Internet Administrator

    Enter a password for the administrator of Sun Internet Administrator, specified in Step 9.


    Note -

    You will need the information you entered in steps six and seven to log into the Sun Internet Administrator console.


Proceed to "Determining That Installation Was Successful".

Installing Sun Internet Services Monitor (SUNWixmon)

This performance monitoring software allows you to set up special client machines that emulate a subscriber's experience with the services. You must install Solaris for ISPs platform (SUNWisp) and Sun WebServer (SUNWhttp) before installing SunTM Internet Services MonitorTM. To install:

    Change directory to components/SUNWixmon/.

    Enter ./install

    The script will ask for a few configuration information for installing the component.

    Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are installing. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM based on the media you are installing from (for example, DistributionMediaPath/components/SUNWixmon/).

    What port should the monitor use?

    Press Return to accept the default port. The default port number Sun Internet Services Monitor uses is 2381.


    Note -

    You must not change the port of the SUNWixmon Web server process after registering it with Sun Internet Administrator. Changing the port will invalidate information required by Sun Internet Administrator. If you must change the port, refer to Sun Internet Administrator on-line help.


Proceed to "Determining That Installation Was Successful".

Installing LDAP Client Library Packages (SUNWlldap)

You can install the LDAP (lightweight directory access protocol) client library on any machine on your network to enable access to LDAP libraries. After installation, install the LDAP manual page patch (106497-01 or 106498-01) to access the manual pages. To install:

  1. If you are installing using a CD-ROM, load the CD-ROM and log into the computer where you want to install the software. Or, log into the computer where you unwrapped the electronic distribution.

  2. Give yourself root access. To get root access, enter:

    • % su
    • Password: rootpassword

  3. Change directory to the root of the media from which you are installing.

    Change to either the directory where you unwrapped the electronic distribution or the root directory of the mounted CD-ROM.

  4. Change directory to /components/SUNWisp/pkgs.

  5. Enter # tar -cvf SUNWlldap /tmp/SUNWlldap.tar

    This stores SUNWlldap.tar package in the /tmp directory. You must tar the file only if you are going to copy this file on to another machine.

  6. If you are installing from a CD-ROM, proceed to step 7. If you are installing from an electronic distribution, you must log out of the machine where you unwrapped the electronic distribution and log into the machine where you want to install the package. Give yourself root access and proceed to step 6.

  7. Get SUNWlldap.tar and enter # tar -xvf SUNWlldap.tar to untar the file.

  8. Enter # pkgadd -d . SUNWlldap

    The LDAP client library package is installed.

Determining That Installation Was Successful

The packages that are installed for the component are displayed. To determine if the component has been successfully installed, wait for one of two messages:


Note -

Here, Componentid is the primary package name of the component installed.


The primary package name (Componentid) that is displayed to indicate successful installation of:

Uninstalling Solaris for ISPs Components

This section discusses the steps to uninstall a Solaris for ISPs component from the command line. You can also uninstall these components from the browser using the host configuration software. The host configuration software allows you to uninstall multiple components at the same time. Refer "Uninstalling Solaris for ISPs" to uninstall using the host configuration software.

To Uninstall from the Command Line
  1. Change the directory to /var/opt/SUNWisp/hc/media/components/componentid/ where componentid is the primary package name of the Solaris for ISPs component you want to uninstall.

    Verify component dependencies and ensure that you do not uninstall components that other installed components depend upon.


    Note -

    Do not uninstall a component that other installed components depend upon. The script will not remove the packages of the component you are uninstalling that are shared by other installed components.


  2. Enter ./uninstall

    Wait until you get the message: Removal of <Package> was successful where Package is the package name of the component you are uninstalling. The command prompt # is displayed after successful removal of the component.

    • The Solaris for ISPs platform packages are: SUNWfixm, SUNWisp, SUNWixhws, SUNWlldap, SUNWixpl, SUNWixvh, SUNWixds, SUNWixamr, SUNWixdoc, SUNWisph, SUNWispm.


      Note -

      Uninstall all other Solaris for ISPs components before uninstalling SUNWisp.


    • The JDK 1.1.5 package is SUNWixinh. The shared packages, SUNWjvrt, SUNWjvdem, SUNWjvdev, SUNWjvjit, SUNWjvman, are not removed if another component requires them.

    • The HotJava 1.1.4 package, SUNWdthj, is not removed if another component requires it.

    • The FlexLM licenser server packages are SUNWlit, SUNWlicsw

    • Sun Directory Services packages are SUNWsds, SUNWsdsc, SUNWixsds. The shared packages, SUNWski, SUNWskicw, SUNWskild, SUNWssld, SUNWskimu, SUNWskimc, SUNWskica, SUNWfns, are not removed if another component requires them.

    • The SunScreen SKIP packages are SICGkdsup, SICGcsafe, SICGcdes, SICGc3des, SICGkisup, SICGkeymg, SICGes, SICGcrc4, SICGcrc2, SICGbdcdr.

    • Sun Internet FTP Server packages are SUNWftpu, SUNWixftpr. The shared packages, SUNWixfta, SUNWixjnd, SUNWOirun, SUNWixtnm, SUNWftpm, SUNWixklg, SUNWixavm, are not removed if another component requires them.

    • The Sun Internet News Server packages are SUNWsnsf, SUNWsnsr, SUNWsnsc. The shared packages, SUNWixsna, SUNWOirun, SUNWixtnm, SUNWsnsm, SUNWixklg, SUNWixavm, are not removed if another component requires them.

    • The Sun WebServer packages are: SUNWhttpc, SUNWhtdoc, SUNWhtman. The shared packages, SUNWhtadm, SUNWhttp, SUNWski, SUNWskicw, SUNWskild, SUNWssld, SUNWskimu, SUNWskimc, SUNWskica, SUNWixavm, SUNWixklg, SUNWhtsvl, are not removed if another component requires them.

    • The Sun Internet Administrator packages are SUNWixamh, SUNWixamc. The shared packages, SUNWixfth, SUNWixsnh, SUNWixfta, SUNWixsna, SUNWixjnd, SUNW0irun, SUNWhtman, SUNWsnsm, SUNWixmm, SUNWispm, SUNWixamm, SUNWftpm are not removed if another component requires them.

      The configuration information is backed up in /var/opt/SUNWixamc/awsconf.bak.0 and the servlet and access logs are backed up in /var/opt/SUNWixamc/logs.bak.0. The same numbers (for example, 0) are selected for the backup of the configuration and the log files. Every time the component is uninstalled, an incremental number is inserted starting with 0.

    • The Sun Internet Services Monitor packages are SUNWixmon, SUNWixmh.