test

Solaris ISP Server 2.0 Installation Guide

Installing From the Browser

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 ISP Server host configuration software at least once for each computer that will host the Solaris ISP Server software. The host configuration software enables:

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

  2. Selecting specific system hardening steps and reviewing the Solaris services that the host configuration software will enable or disable (and possibly customizing these settings).

  3. Specifying an optional postconfiguration 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.

To Start the Host Configuration GUI

  1. Enter # ./hcstartup

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

    Note -

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

  2. Enter path to the 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.

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

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

No components found to be upgraded.

Setting up media database ... done.

Starting web server ... done.

Ready to start hotjava
URL = "http://hostname:8000/cgi-bin/splash"
DISPLAY = "hostname:0.0"

  5. 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 host configuration splash screen.

    If you opted to continue the configuration process in another browser, 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.

See "To Install the Components".

To Install the Components

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 the installation.

  1. Click Begin.

    The Component Configuration screen is displayed. For each component listed here, see "Introducing Solaris ISP Server" 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 on this host:

    1. Verify installation status in the Installed? column.

      If the status displayed is no, the component is not currently 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 without first uninstalling it.

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

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

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

      Note -

      To customize installation of the component, you must select for installation all the other components it depends upon. See Chapter 3, Installation Requirements.

    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 and must not accept the default customizations without reviewing.

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

      Note -

      See online help to specify installation parameters. Once completed, review the screen and ensure that appropriate installation parameters 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 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 online help for the host configuration software and in "Closing Potential Security Holes".

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

    The Post-Configuration Command screen is displayed.

See "To Specify a Post-Configuration Command".

To Specify a 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 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 sequence of commands separated by a semicolon. If you have no postconfiguration needs, click Next.

  1. (Optional) 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 Install Scenario".

To Confirm and Save the Install 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. (Optional) If you wish to save this installation and configuration scenario for use in the future,

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

      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.

      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 Installation was Successful":