test

Solaris for ISPs Installation Guide

Installing and Uninstalling Solaris for ISPs from a Browser

Welcome to SolarisTM for ISPsTM. The steps discussed in this chapter will help you in installing Solaris for ISPs platform extensions and services from a graphical user interface. An overview of the installation process is illustrated in Figure 1-1.

Figure 1-1 Overview of the Installation Process

Graphic

Note -

You must perform the steps illustrated in Figure 1-1. For a detailed description of the steps illustrated here, go to Chapter 2 of the Solaris for ISPs Administration Guide.

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, including details on the Solaris service configuration performed by the host configuration software.

    • Chapter 4, "Installation Requirements," lists RAM, disk space, and OS requirements for the product software. It discusses the default ports used by the components and the component dependencies.

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

Installing the Software

Once you have planned your network and ensured that each computer has the required hardware and software for its planned role in the network, run the Solaris for ISPs host configuration software for each computer in the plan.

Note -

Run the host configuration software at least once for each computer that will host Solaris for ISPs software. The host configuration process has five phases:

  1. Choosing software components (and configuring their installation parameters).

  2. Reviewing the Solaris services that the host configuration software will disable (and possibly customizing these settings).

  3. Specifying an optional post-configuration command (or script) that the host configuration software will run towards the end of its batch install process.

  4. Reviewing a summary of all the 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 installation later.

  5. Executing the configuration scenario you specified in steps one through four.

Beginning Host Configuration: Running hcstartup

  1. Log into the computer where you want to install the software and give yourself root access.

    If you are installing remotely, enter:

    • % xhost +remotehostname
    • % rlogin remotehostname
    • % password
    • % 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 -

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

  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. Enter # ./hcstartup

    The script asks a few questions before bringing up the host configuration GUI.

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

    2. Enter port to use [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 for Host Configuration
      • Setting up media database
      • Starting web server
      • Ready to start hotjava

    3. Please choose one of the following options:

      Press Return to start HotJavaTM. This is the default option. Enter 2 to open the URL for host configuration in another browser. At this point, you can also abort the installation by entering 3.

      After a moment,

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

Possible Error Messages

If you receive an error message when you run hcstartup, see "Host Configuration Error Messages".

Note -

You can use the on-line help from this screen to proceed with the installation.

Continue with the "Host Configuration: Choosing Software Components".

Host Configuration: Choosing Software Components

At this point, you have already performed the steps in the "Beginning Host Configuration: Running hcstartup". You are looking at the browser displaying the host configuration splash screen.

For each component listed here, refer to Chapter 1 of the Solaris for ISPs Administration Guide for an overview of the component.

  1. Click on Begin.

    The Component Configuration screen is displayed.

  2. For each Solaris for ISPs component that you want to install on this host:

    1. Verify installation status in the Installed? column

      If the status displayed is no, the component is not installed on the host. If the status displayed is yes, the component is currently installed on the host and you cannot install the same component again on this host.

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

      By default, No Action will be executed for the component.

      Note -

      You must install the SolarisTM for ISPsTM Platform software.

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

      Note -

      To customize installation of the component, you must select for installation all the other components it depends upon.

    4. Click on 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 and must not accept the default customizations.

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

      Note -

      Refer to on-line help to specify installation parameters.

    6. Click on Done when you are finished.

      The Component Configuration screen is displayed.

    Note -

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

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

    The Solaris Service Configuration screen is displayed.

Continue with the "Host Configuration: Solaris Services Settings".

Host Configuration: Solaris Services Settings

At this point, you have completed selecting components for installation. 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 on-line help for the host configuration software and in the "Reconfigurable Settings" section of Chapter 3 of the Solaris for ISPs Administration Guide.

  1. (Optional) 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 on Next.

    The Post-Configuration Command screen is displayed.

Continue with the "Host Configuration: Post-Configuration Command".

Host Configuration: Post-Configuration 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 post-configuration command is optional and completely user-defined. Use this option to add your own standard post-installation and configuration tasks to the host configuration software for automatic execution.

Some examples of post-configuration commands that you can use are discussed in the "User-defined Scripts" section of Chapter 3 of the Solaris for ISPs Administration Guide.

You can specify any non-interactive command or series of commands. If you have no post-configuration needs, click on Next.

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

  2. Click Next.

    The Confirm Configuration screen is displayed.

Proceed to "Host Configuration: Configuration Summary and Saving Scenarios".

Host Configuration: Configuration Summary and Saving Scenarios

See Chapter 1 of the Solaris for ISPs 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. (Optional) If you want to save this installation and configuration scenario for use in the future,

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

      Note -

      This directory, where the scenario files are to be stored, 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.

      Do not create the scenario directory before saving the scenario files. 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 on 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 on 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. You can find the log file for this process in /var/opt/SUNWisp/hc/logs. No more interaction with the browser will occur. You may shutthe browser down at any time. If this is a local browser, itwill automatically be shut down when the batch installationprocess has completed.

After a few moments, the browser exits. The host configuration process is complete when the system reboots, or when the final Cleaning up message is entered in the log file. See the "Determining that Installation and Host Configuration Are Complete" for how to read the log file and to determine whether host configuration is complete.

Determining that Installation and Host Configuration Are Complete

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

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

  3. Read the log file, and find this message at the end: Cleaning up /tmp/hcpid where pid is the host configuration process ID.

If the last entry in the log file is Cleaning up /tmp/hcpid, the host configuration batch process is finished and has exited. .

If you had clicked on Execute (no reboot), remember to reboot the computer when your post-installation tasks are complete, so that all settings of the host configuration can take effect.

Determining that Installation and Host Configuration Are 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 April 1, 1998, find the log file named config.1998-04-01.1845.

  3. Read the log file. For each software component selected for installation (or deinstallation), 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, 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.

Host Configuration Error Messages

At times, you may receive an error message from the host configuration software. These are listed below for easy reference and recovery.

It appears that a session of this program is already running. You may not start a new sessionuntil the other session has completed or is terminated.If you know that a session is not running, remove the files:/tmp/hcstartup.running/tmp/hcbi.running

Ensure that no other legitimate host configuration session is running. Then delete the files listed and run hcstartup again.

Note -

You will get this error message if, during the last time you started the host configuration process,

  • You closed the browser window. Or,

  • The browser crashed.

To exit an installation, always click on Exit and do not close the browser window.

To reenter the host configuration process:

  1. Start the browser.

  2. Access the host configuration software user interface. To access, type URL: http://hostname:8000/cgi-bin/splash, where hostname is the name of the host where another session is running, and please specify port number if you installed on a port other than the default, 8000.

Not enough disk space.You may enter a different directory toinstall a working copy of this software.

By default, hcstartup installs a temporary Web server in /tmp. If there is not enough disk space in /tmp, it will prompt you to specify another directory for it to use. Please ensure that the directory you specify has at least 10MB of free space available.

DISPLAY environment variable is not set.To continue the configuration process, you will need to open thefollowing URL in a web browser:http://host:port/cgi-bin/splashDo you want to continue?

To continue with the configuration process for installing Solaris for ISPs, type y and press Return. Open the URL in a browser.

To exit the installation process, type n and press Return. If you exit the installation process, the Web server will be automatically shut down and the temporary files will be removed.

Cannot find hotjava in /usr/dt/bin. You will need to bring the following URL up in another browser:http://host:port/cgi-bin/splash

The hcstartup script has completed its background tasks. Start a Web browser and access the URL listed. The host is the machine where the host configuration software is running and the port the one you specified to hcstartup.

Uninstalling Solaris for ISPs

To uninstall a component or multiple Solaris for ISPs components, run the host configuration software. During host configuration, you will repeat some of the steps you executed during installation. This will enable you to reconfigure the machine to the same state it was in before installing Solaris for ISPs. The steps are:

  1. Choosing software components to uninstall.

  2. Reviewing and resetting the Solaris services that the host configuration software configured during installation.

  3. Specifying an optional post-configuration command (or script) that the host configuration software will run towards the end of its batch uninstall process.

  4. Reviewing a summary of all the changes you have specified. At this point, you can use the Back button on the browser to access earlier screens and amend your choices.

  5. Executing the configuration scenario you have specified.

Beginning Host Configuration

  1. Start host configuration software. To start,

    1. Log into the computer where you want to install the software and give yourself root access.

      If you are installing remotely, enter:

      • % xhost +remotehostname
      • % rlogin remotehostname
      • % password
      • % 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 -

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

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

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

    3. Enter # ./hcstartup

      The script asks a few questions before bringing up the host configuration GUI.

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

        If your current working directory is the root of the media from which you are uninstalling, press Return. If it is not, enter the path to the media from which you are uninstalling.

      2. Enter port to use [8000]

        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. If port 8000 is available, press Return.

        You will see a series of messages:

        • Unwrapping archives for Host Configuration
        • Setting up media database
        • Starting web server
        • Ready to start hotjava

      3. Please choose one of the following options:

        Press Return to start HotJavaTM. This is the default option. Enter 2 to open the URL for host configuration in another browser. At this point, you can also abort the installation by entering 3.

        After a moment,

        • If you selected the default HotJava browser for host configuration, the browser appears and displays the splash screen.
        • If you selected the second option, to continue the configuration process you must open a browser and access the URL: http://hostname:8000/cgi-bin/splash where hostname is the host name of the machine where you are installing and 8000 is the default port number. If you specified a port other than the default for the host configuration software to use, enter that port number.

  2. Click on Begin in the host configuration welcome screen.

    The Component Configuration screen is displayed.

Choosing Components to Uninstall

  1. Select the component you want to uninstall from the list in the Component column and verify component installation status by referring to the status displayed in the Installed? column.

    Solaris for ISPs host configuration software will prevent you from uninstalling components that other installed components rely upon.

    Note -

    If the status displayed is yes, the component is currently installed on the machine. If the status displayed status is no, the component is currently not installed on the machine.

  2. Select Uninstall from the option menu, in the Action column, for each component.

    By default, No Action will be executed for the component.

  3. Click on Next.

    The Solaris Service Configuration screen is displayed.

Reconfiguring Solaris Services

This screen enables you to reconfigure Solaris services that you had enabled or disabled during installation of Solaris for ISPs.

  1. Select enable or disable, for the service you wish to reconfigure, from the option menu in the Desired State column.

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

    The Post-Configuration Command screen is displayed.

Confirming Scenario

  1. Click on Next in the Post Configuration screen.

    The Confirm Configuration screen is displayed.

    Note -

    You can specify some commands or script to be executed after uninstalling the specified component.

  2. Click on Execute (with reboot) to uninstall the specified component.

Determining that Uninstall 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 April 1, 1998, find the log file named config.1998-04-01.1845.

  3. Read the log file. For each software component selected for uninstall, you will see a section beginning with four greater-than signs (>>>>) and a message including the component identifier. Ensure that the section ends with the message: Component "Componentname" (ID=Componentid) uninstalled successfullywhere Componentname is the name of the component that has been uninstalled and Componentid is the package name of the component removed.