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 JumpStart^TM 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 Sun^TM 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:

• You are currently running a version of Sun Directory Services less than Sun Directory Services 3.1, abort this installation. Uninstall the existing version of Sun Directory Services and then install this component.

• You are currently running a version of Sun Directory Services greater than the one selected for installation, abort this installation.

• Your existing version of Sun Directory Services does not meet the configuration requirements of Solaris ISP Server components, abort this installation. See relevant documentation and reconfigure your existing Sun Directory Services before installing this component.

• You do not wish to use data detected on the machine during this installation of Sun Directory Services, abort this installation. This Sun Directory Services will detect, on the system, data:

  • If you manually uninstalled Sun Directory Services from this machine. To use this data, you must manually install Sun Directory Services 3.1 before installing this component.

  • From compatible and incompatible releases of this component. Data from a compatible release will be used to restore previous configurations of this component and data from incompatible release will be preserved, but not used during this installation.

  • In an unrecognized state. This data will be preserved, but not used during this installation.

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 (Sunscreen^TM 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 Sun^TM Internet News Server^TM 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".