Sun Cluster 2.2 Software Installation Guide

8.3.1 How to Install Netscape News

This procedure shows the user interaction with the ns-setup command. Only the sections that are specific to Sun Cluster HA for Netscape News are shown here. For the other sections, choose or change the default value as appropriate.

  1. Run the ns-setup command from the Netscape News install directory on the CD.

    Change directory to the Netscape News distribution location on the CD, and run the ns-setup command.

    phys-hahost1# cd /cdrom/news_server/solaris/news/install
    phys-hahost1# ./ns-setup
    

    Note -

    The Netscape directory on the CD might be different from that shown in the example. Check your Netscape documentation for the actual location.


    After the licensing agreement you see:

    Netscape Communications Corporation
     Netscape SuiteSpot Server Installation
     ---------------------------------------------------------------
    
     This program will extract the server files from the distribution
     media and install them into a directory you specify. This 
     directory is called the server root and will contain the server 
     programs, the Administration Server, and the server configuration 
     files.
    
     To accept the default shown in brackets, press return.
    
     Server root [/usr/netscape/suitespot]:
  2. Enter the logical host name for the Netscape News Server and the appropriate DNS domain name.

    A full name is of type hostname.domainname, such as hahost1.sun.com. You should not accept the default, and you can enter any directory name you might have created for the data service here as well.


    Note -

    You must use the logical host name rather than the physical host name here and everywhere else you are asked, for Sun Cluster HA for Netscape News to fail over correctly.


    For example:

    Machine's name [phys-hahost1]:hahost1

    Follow the screen instructions (in many cases you may want to accept the default choices) for the server installation.

  3. Enter Server Administrator ID and password when asked.

    Follow the guidelines for your system.


    Note -

    The default administration port is not the port that the data services will listen on, so it is an acceptable default. You will however, want to make note of the port number for future use.


    When you see the following, your installation is complete and ready for configuration:

    Your parameters are now entered into the Administration Server
     configuration files, and the Administration Server will be
     started.
    
     Writing configuration files ...
  4. Bring up the Netscape browser.

    Web browser [netscape]: 

    You should see the Netscape browser.

  5. Enter the URL of the logical host where the server is installed.

    For example:

    logicalhostname:admin_port_#
    

    Enter the proper user ID and password when prompted.

    You see the page with the logical host name you assigned and the Administration port number.

  6. Click Create New Netscape Collabra Server 3.5.

    This should be the second link from the bottom of the page. You should see another page load.

  7. Click OK from the bottom of the following page.

    You see the Success page with the name of the new server and associated port number.

  8. Run the hadsconfig command from the physical host:

    [phys-hahost1]: hadsconfig
    
  9. Enter the number for the nsnews menu item at the prompt.

    Your choices may vary depending on the services installed.

  10. Enter the number for the Create a new instance item at the prompt.

    You see something similar to the following:

    Name of the instance [?] :
     Logical host [?] :
     Base directory of product installation [?] :
     Server Port Number [?] :
     Time between probes (sec) [60]  [?] :
     Time out value for the probe (sec) 60]  [?] :
     Take over flag [y]  [?] :
  11. Enter the name for the instance.

  12. Enter your logical hostname.

  13. Enter the location to the logical host where the service is installed for the Base directory location.

    This is the location of the start and stop scripts. For example, /netscape-1/vol01/nsnews/hahost1. You may have created other directories between the logical host and service directories.

  14. Enter the server port number you want the server to listen on.

    For example 119 for News.

  15. Either accept or change the defaults by entering the appropriate information.

    You can change the defaults now if necessary. After you finish, a confirmation appears.

  16. Add this instance.

    You see instance added to workfile.

  17. Enter the menu item number to go to the Main Menu.

    You see Configuration has changed in workfile.

  18. Update the configuration from the workfile.

  19. Enter the appropriate information when you see the checking node status... message.

  20. Enter the Quit menu item number.

    You are returned to the root prompt of your physical host.

  21. Register and activate the service by using the hareg(1M) command.

    Run the hareg(1M) command on only one host.

    If the service is not yet registered, use the hareg(1M) command to register it. To register the service only on the logical host, include the -h option and logical host name:

    # hareg -s -r nsnews [-h logicalhost]

    If the cluster is running already, use the hareg(1M) command to activate the service:

    # hareg -y nsnews
    
  22. Confirm your News server operation by making a telnet connection to your logical host where the service is listening.

    For example:

    # telnet logicalhost 119
    

    After you have confirmed the server's operation, your installation is complete.