test

Solaris ISP Server 2.0 Installation Guide

Upgrading to or Reinstalling Solaris ISP Server 2.0 Software

You can:

When you upgrade to Solaris ISP Server 2.0 software from:

While upgrading or reinstalling, the components will use old configurations. If you do not want the components to use old configuration information,

  1. See "Removing the Files" and move or remove the files.

  2. See Chapter 4, Installing Solaris ISP Server 2.0 Software and follow the instructions to install the software.

You cannot run Solaris ISP Server 2.0 and 1.0 components on the same machine by performing a partial upgrade (that is, upgrade only some components on a machine to 2.0). You must upgrade all the SolarisTM for ISPsTM 1.0 components on a machine. Please follow the instructions carefully to upgrade to Solaris ISP Server 2.0.

Preinstallation Tasks

To properly prepare for upgrading to Solaris ISP Server 2.0 software, you must understand how the various platform extensions and services fit together and depend upon one another. See "Solaris ISP Server Overview" in Solaris ISP Server 2.0 Administration Guide for an overview of the product.

To Start the Installation

  1. Log into the computer where Solaris for ISPs 1.0 components are installed and become superuser (root).

    For example, to connect from a remote machine, enter: 


    % xhost +remotehostname

% rlogin remotehostname

% Password: yourpassword

% su

Password: rootpassword

# DISPLAY=localhostname:0.0

# export DISPLAY

    If you are using a C-shell, remember that your command to set the DISPLAY variable is different.

    Note -

    You must set the DISPLAY environment variable and allow access to your display only if you want to upgrade from the default browser launched by the host configuration software. Set the DISPLAY environment variable before logging in as a different user (su -) or before logging in remotely.

  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.

  3. Select method of installation. If you wish to install from:

Upgrading From a Browser

Once you have ensured that your network hosts meet the installation requirements (see Chapter 3, Installation Requirements), run the Solaris ISP Server 2.0 host configuration software on each computer you are upgrading. The host configuration software:

  1. Uninstalls existing Solaris for ISPs 1.0 components, if found installed, and saves the configuration information for upgrading to Solaris ISP Server 2.0 software.

  2. Enables selecting components for upgrading. If you uninstall the 1.0 components from this instance of the host configuration process, the host configuration software preselects the components for upgrading.

  3. Enables or disables the Solaris services.

  4. Executes the postconfiguration command (or script) you specify towards the end of its batch install process.

  5. Enables reviewing a summary of all the upgrade changes you have specified. At this point, you can use the Back button on the browser to access earlier screens and amend your choices. You can also save the configuration scenario (all your settings) to be used in a repeatable upgrade later.

  6. Enables executing the configuration scenario you specified in steps one through five.

To Start the Host Configuration GUI

  1. Enter # ./hcstartup

    The script asks a few questions before bringing up the host configuration graphical user interface. Steps 2 through 4 will assist you in answering the questions.

    Note -

    If you receive an error message when you run hcstartup, see Chapter 9, Error Messages.

  2. The following parameters in /var/sadm/install/admin/default will not be honored and the values below will be used. Do you want to continue?

    See "Solaris ISP Server admin File" for more information. To proceed with the installation, press Return. Otherwise, enter No and quit the installation.

  3. Enter path to installation media (enter "none" if no media)[current working directory]

    If your current working directory is the root of the installation media, press Return. If it is not, enter the path to the installation media. If you enter none, only uninstall options will be available.

  4. Enter port number for the temporary web server [8000]

    If port 8000 is available, press Return. Otherwise, enter a port that the host configuration software can use for the temporary web server that delivers its GUI. The script checks to see if the port is available and prompts you for another if the port number you enter is in use.

    You will see a series of messages: 


    Unwrapping archives ... done.

Checking for installed components ...

  5. There are Solaris for ISPs 1.0 components installed on this machine. Before installing Solaris ISP Server 2.0, this program will uninstall the old version. The configuration data for these components will be saved and they will be uninstalled (you may then select them for reinstallation and the saved data will be restored). Do you wish to proceed? [y,n]

    You will get this option only if you are currently running Solaris for ISPs 1.0 components on this machine. If you wish to save and use the old configuration information to upgrade to this version, press Return or enter Yes.

  6. Please choose one of the following options:

    Press Return to start HotJavaTM. This is the default option. Enter 2 to access the URL for host configuration from another browser. Enter 3 to abort the installation.

    Note -

    If you did not set the DISPLAY environment variable, to continue the configuration process, you must open the URL in a browser. Refer to Chapter 9, Error Messages for information on how to proceed.

    After a moment, if you selected the default HotJava browser for host configuration, the browser appears and displays the splash screen.

    If you opted to continue the configuration process without HotJava, you must open a browser and access the URL: http://hostname:8000/cgi-bin/splash, where hostname is the host name of the machine on which you are installing the software. If you specified a port other than the default for the host configuration software to use, replace 8000 with that port number.

To Upgrade to Solaris ISP Server 2.0 Software

At this point, you have already performed the steps in the "To Start the Host Configuration GUI". You are looking at the browser displaying the host configuration splash screen.

Tip -

You can also use the online help from this screen to proceed with upgrading to Solaris ISP Server 2.0 software.

  1. Click Begin.

    The Component Configuration screen is displayed.

    For each component listed here, see "Solaris ISP Server Overview" in Solaris ISP Server 2.0 Administration Guide for an overview of the features of the component.

  2. For each Solaris ISP Server component that you wish to install:

    1. Verify installation status in the Installed? column.

      If the status displayed is no, the component is not installed on the host.

    2. Choose Install from the option menu in the Action column.

      By default, components that were uninstalled during this instance of the host configuration process will be preselected for installation. Otherwise, No Action will be executed for the component.

      Note -

      You must install the Solaris ISP ServerTM Platform software at least once on each Solaris ISP Server host on the network.

    3. Select for installation all other components listed as required for the component you wish to install.

      To customize installation of the component, you must select for installation all the other components it depends upon. See "Order Of Installation".

    4. Click Configure (if available), in the Customize Installation column, to set the installation parameters for the selected component.

      The Configure Installation screen for the selected component is displayed.

      Note -

      For the selected component, you must specify the appropriate installation parameters. Do not accept the default customizations without first reviewing them.

    5. Examine the installation parameters for the selected component and set them as appropriate for your environment.

      See online help to specify installation parameters.

      Note -

      Review the screen and ensure that appropriate installation parameters for all components, selected for installation, have been specified.

    6. Click Done when you are finished.

      The Component Configuration screen is displayed.

  3. After selecting components and setting installation parameters on their Configure Installation screen, click Next.

    The Solaris Service Configuration screen is displayed.

See "To Configure Solaris Service Settings".

To Configure Solaris Service Settings

At this point, you have completed selecting components for upgrading. You are looking at the Solaris Service Configuration screen.

The Solaris services on this screen will be enabled or disabled (as displayed) to improve the security and performance of the system. Change settings on Solaris services only if your particular system plan requires it.

Each Solaris service configured on the screen is documented in the online help for the host configuration software and in "Closing Potential Security Holes".

  1. If your system plan requires it, select enable or disable from the option menu in the Desired State column.

    To get maximum benefit from the host configuration software, accept its recommendations.

  2. When the Solaris service settings are as you want them, click Next.

    The Post-Configuration Command screen is displayed.

Proceed "To Specify a Postconfiguration Command".

To Specify a Postconfiguration Command

At this point, you have already selected components and reviewed the Solaris services settings. You are looking at the Post-Configuration Command screen.

The postconfiguration command is optional and completely user-defined. Use this option to add your own standard postinstallation and configuration tasks to the host configuration software for automatic execution.

Some examples of postconfiguration commands that you can use are discussed in "Creating User-defined Scripts".

You can specify any non-interactive command or series of commands separated by a semicolon. If you have no postconfiguration needs, click Next.

  1. If you have a command or script you wish to run at the end of installation and configuration, enter the complete path to it here.

  2. Click Next.

    The Confirm Configuration screen is displayed.

See "To Confirm and Save the Upgrade Scenario".

To Confirm and Save the Upgrade Scenario

See "Solaris ISP Server Platform Software" in Solaris ISP Server 2.0 Administration Guide for information on saving configuration scenarios.

  1. Review and confirm the settings you provided by reviewing the specifications displayed in the various sections.

    Use the Back button in the browser to modify any specification.

  2. If you wish to save this installation and configuration scenario for use in the future,

    1. Enter the path where you wish to store the scenario files.

      This directory, where you want to store the scenario files, will be created and should not exist. However, the parent for the scenario directory must exist. For example, to store the scenario files in /usr/foo/bar, do not create the bar directory and ensure that /usr/foo exists.

      Note -

      If you attempt to save a configuration scenario to an existing directory, you will receive an error message and the software will refuse to export the scenario.

    2. Click Save.

  3. Complete the installation and configuration process. Do one of the following:

    1. Click Execute (with reboot) if you want to perform the installation and configuration and then reboot the computer. We recommend you select this option.

    2. Click Execute (no reboot) if you want to perform the installation and configuration and then perform additional tasks before rebooting the computer.

      Note -

      Remember to reboot when your tasks are complete, as certain configuration settings require a reboot to take effect.

    3. Click Exit, if you do not want to perform the installation and configuration (for example, if you simply wanted to save a scenario for future use).

The following message is displayed if you executed the installation:


The batch installation process has started in the background. 
To view the batch installation status, use the following command: 
tail -f /var/opt/SUNWisp/hc/logs/config.yy-mm-dd.hhmm. 

This will display the contents of the time stamped installation log
file. When the installation completes successfully, the following 
message will be posted to the installation logfile: "Exiting 
SUCCESSFUL batch configuration."

No more interaction with the browser will occur. You may shut the 
browser down at any time. If this is a local browser, it will 
automatically be shut down when the batch installation process has 
completed.

After a few moments, if you installed from the default browser, the browser exits. If you installed using a browser of your choice, you must close the browser window. The host configuration process is complete when the system reboots, or when the final Cleaning up message is entered in the log file.

See "Determining that Upgrade was Successful":

Upgrading From the Command Line

If you choose to upgrade from the command line, you will not get the benefits of upgrading using the host configuration software. The host configuration software enables you to perform, as part of the upgrade process from a browser, some security modifications on your system. It allows you to save the configuration specifications you provide during the upgrade 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 postinstallation commands or a script.

We recommend upgrading Solaris ISP Server from a browser using the host configuration software. Please upgrade from the command line only if you are completely familiar with the product and its various component dependencies.

To Upgrade to Solaris ISP Server 2.0 Software

Before upgrading to Solaris ISP Server 2.0 software, you must uninstall Solaris for ISPs 1.0 components currently installed on the machine and save the configuration data. Then, proceed to install the new version of the component.

  1. Enter # ./uninstall-sisp1.0 media_root where media_root is the root of the installation media.

    This script uninstalls all the Solaris for ISPs 1.0 components currently installed on the machine and saves the data in a component specific directory. See uninstall-sisp1.0(1m) man page for more information.

  2. Change the directory to components/componentid/ where componentid is the unique component identifier of the Solaris ISP Server component you wish to install.

    We recommend installing components in the same order as listed in the "Order Of Installation".

  3. Enter ./install

    The component install script:

    • Prints a message: WARNING: parameters from the system default admin file have been merged with /etc/opt/SUNWisp/hc/adminSee "Solaris ISP Server admin File" for more information.

    • Requires configuration information for upgrading to Solaris ISP Server 2.0 software. Please proceed to the individual component installation procedure to specify the parameters.

To Install Solaris ISP Server Platform Software (SUNWisp)

The Solaris ISP Server Platform software provides the platform extensions with configuration management tools and enhancements for logging. On each Solaris ISP Server software host in the network, you must install this software.

  1. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

  2. Do you want to install the Solaris ISP Server v2.0 Administration Guide?

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

  3. 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.

See "Determining that Upgrade was Successful".

To Install JDK (SUNWjdk)

JDK provides the Java classes needed by several of the Solaris ISP Server components. You cannot customize installation of this software.

    Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

See "Determining that Upgrade was Successful".

To Install HotJava (SUNWdthj)

This is the web browser you must use to access Solaris ISP Server component GUIs. You cannot customize installation of this software.

    Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

See "Determining that Upgrade was Successful".

To Install the License Server for Solaris ISP Server (SUNWlicsw)

This is the FlexLM server for Solaris ISP Server. You cannot customize installation of this software. Use the license certificate for this software to obtain a license key and initialize more entries in Sun Directory Services.

    Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

See "Determining that Upgrade was Successful".

To Install 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.

For more information about the configuration fields, refer Sun Directory Services 3.1 Administration Guide, Sun Directory Services 3.1 User's Guide, and Solaris ISP Server 2.0 Administration Guide.

Solaris ISP Server 2.0 components require Sun Directory Services 3.1. If:

  1. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

  2. This component requires the following patches. Should these patches be installed automatically?

    You must install this patch for this Sun Directory Services to operate with the Solaris ISP Server 2.0 components.

See "Determining that Upgrade was Successful".

To Install SKIP (SUNWicg)

Simple key-management for Internet Protocols (SunscreenTM SKIP) can be used to secure IP communications between network hosts. You cannot customize installation of this software.

    Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

See "Determining that Upgrade was Successful".

To Install Sun Internet FTP Server (SUNWftp)

  1. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

  2. Saved data was found from version 1.0. Do you wish to upgrade to version 1.1?

    If you want to upgrade from Sun Internet FTP Server 1.0 to 1.1, enter a or press Return for no.

  3. If you continue with this installation, existing configuration for FTP will be re-used. Is this ok?

    Press Return for no or enter a for yes. If you select yes, the existing configuration information will be used to upgrade to Sun Internet FTP Server 1.1. If you do not wish to use saved data, abort the installation and remove the files (see "Removing the Files").

See "Determining that Upgrade was Successful".

To Install Sun Internet News Server (SUNWsns)

This is a highly-scalable multi threaded news server. After installation, to access the graphical user interface of this software, ensure that you register this SunTM Internet News ServerTM with a Sun Internet Administrator on the network.

  1. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

  2. If you continue with this installation, existing configuration for news will be re-used. Is this ok?

    Press Return for yes or enter b for no. If you select yes, the existing configuration information will be used to upgrade to Sun Internet News Server 1.1.

See "Determining that Upgrade was Successful".

To Install Sun WebServer (SUNWhttp)

This is the web server used by most Solaris ISP Server components. This can also be used for standard web service.

  1. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

  2. Do you want in-kernel HTTP acceleration to be activated (after reboot) for port 80?

    This option is available only if you are upgrading to or reinstalling Sun WebServer on Solaris 7. The cache in-kernel activator will greatly enhance the performance of the web server for static pages. Press Return for yes or enter b for no.

  3. There are existing web site configurations listed in /etc/http/httpd-instances.conf. If you proceed with this installation, they will be reused. Server configuration files will be converted to support SWS2.1 if necessary. Continue?

    You will get this option if Sun WebServer detects data from a previous installation of this component. Sun WebServer will use the existing data during this installation. If you do not want to use the detected data, enter b to abort this installation. Then remove the files by referring to "Removing the Files". Otherwise, press Return for yes and proceed with the installation.

See "Determining that Upgrade was Successful".

To Install Sun Internet Administrator (SUNWixamc)

This provides secure central management for distributed Internet services.

  1. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

  2. Install the Solaris ISP Server manual pages?

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

  3. If you continue with the this installation, existing configuration for Sun Internet Administrator will be re-used. Is this ok?

    Press Return for yes or enter b for no. If you select yes, the existing configuration information will be used to upgrade to Sun Internet Administrator 1.1.

See "Determining that Upgrade was Successful".

To Install Sun Internet Services Monitor (SUNWixmon)

This performance monitoring software allows you to set up special monitor machines that emulate a subscriber's experience with the services.

  1. Please enter the root of the distribution media:

    Enter the path of the distribution media from which you are upgrading. Enter either the directory path where you unwrapped the electronic distribution or the directory path of the mounted CD-ROM.

  2. What port do you want the monitoring web server to use?

    Press Return to accept the default port. The default port is 2381. Or, specify another port number.

  3. What color do you want to use to display normal results? Provide three integer values (RGB) from 0 to 255, separated by '.'

    By default, green is used to display normal results. Press Return to accept the default. Otherwise, specify the RGB value for the color of your choice.

  4. What color do you want to use to display results that exceed performance thresholds? Provide three integer values (RGB) from 0 to 255, separated by '.'

    By default, yellow is used to display performance that exceed threshold. Press Return to accept the default. Otherwise specify the RGB value for the color of your choice.

  5. What color do you want to use to display errors? Provide three integer values (RGB) from 0 to 255, separated by '.'

    By default, red is used to display errors (such as timeout). Press Return to accept the default. Otherwise specify the RGB value for the color of your choice.

  6. What color do you want to use to display selected bars on the graph? Provide three integer values (RGB) from 0 to 255, separated by '.'

    By default, black is used to display bars selected in the graph. Press Return to accept the default. Otherwise specify the RGB value for the color of your choice.

    Note -

    You can, at any time after the installation, reset the colors by referring to Sun Internet Services Monitor online help.

  7. Found old monitor configuration. Do you want to convert it to the new format (otherwise it will be removed)?

    You will get this option if you are upgrading to Sun Internet Services Monitor 1.1. Press Return for yes or enter b for no. If you select yes, the existing configuration information will be used for upgrading to Sun Internet Services Monitor 1.1.

  8. Found previous monitor configuration. Do you want to use it (otherwise it will be removed)?

    You will get this message only if you are reinstalling Sun Internet Services Monitor 1.1. Press Return for yes or enter b for no. If you select yes, the existing configuration information will be used to reinstall Sun Internet Services Monitor.

See "Determining that Upgrade was Successful".

Determining that Upgrade was Successful

If you are upgrading to Solaris ISP Server 2.0 software from a browser:

To Determine that Browser-Based Upgrade Was Successful

  1. Change directory to /var/opt/SUNWisp/hc/logs.

  2. Find the log file named for the current date. For example, if today is December 1, 1998, find the log file named config.1998-12-01.1845.

  3. Read the log file to:

    1. Determine that installation and host configuration are complete. To determine, find this message at the end: Cleaning up /tmp/hcpid where pid is the host configuration process ID. This indicates that the host configuration batch process is finished and has exited.

      Note -

      If you selected:

      • Execute (no reboot), you may proceed to reboot the computer when your postinstallation tasks are complete, so that all settings of the host configuration can take effect.

      • Execute (with reboot), the machine will be automatically rebooted.

    2. Determine that installation and host configuration was successful. To determine, for each software component selected for upgrade, you will see a section beginning with four greater-than signs (>>>>) and a message including the component identifier. If that section ends with the message: Installation successful, the newer version of that component has been successfully installed.

      If the log file section for any component does not end with the message Installation successful, installation of the component failed. The remainder of the installation is aborted (nothing further is installed). Check the details in the log file and the system requirements for the software component.

If you are upgrading to Solaris ISP Server 2.0 from the command line:

To Determine that Command Line Upgrade was Successful

    Wait for one of two messages: 


    Installation of <Componentid> was successful
    Or, 

    /var/opt/SUNWisp/hc/media/components/CComponentid
done

    Note -

    Here, ComponentId is the unique component identifier (for example, SUNWisp is the component identifier for Solaris ISP Server Platform software).