1.4 Upgrading a Clustered Linux GroupWise System

1.4.1 Installing the GroupWise Software

As with any upgrade, you must upgrade the primary domain first.

  1. Stop all GroupWise agents that are running on the node that you want to upgrade first.

  2. Install the GroupWise Server component on the first node.

    Follow the instructions in Step 1 through Step 9 in Linux: Installing the GroupWise Server Software in the GroupWise Installation Guide.

    IMPORTANT:Do not start the GroupWise Admin console after installing the GroupWise software.

  3. Continue with Configuring the GroupWise Admin Service to Function in a Cluster.

1.4.2 Configuring the GroupWise Admin Service to Function in a Cluster

You must configure the GroupWise Admin Service to function in a cluster, so that it keeps track of which cluster resources are available to it at each point in time. Configuring the GroupWise Admin Service for clustering ensures that files associated with domains and post offices are created on cluster volumes, rather than on individual cluster nodes.

File

Standard Location

Clustered location

Domain SSL Certificate, MTA SSL Certificate, GWIA SSL Certificate

/opt/novell/groupwise/certificates
/groupwise/certificates

(a peer to the domain folder)

Post Office SSL Certificate, POA SSL Certificate

/opt/novell/groupwise/certificates
/groupwise/certificates

(a peer to the post office folder)

MTA Log Files

/var/log/novell/groupwise/
                        domain.mta
/groupwise/agents/logs

(a peer to the domain folder)

GWIA Log Files

/var/log/novell/groupwise/
                       gwia.domain
/groupwise/agents/logs

(a peer to the domain folder)

POA Log Files

/var/log/novell/groupwise/
                   post_office.poa
/groupwise/agents/logs

(a peer to the post office folder)

  1. Run the following command to enable the GroupWise Admin Service to run in a clustering environment:

    gwadminutil config -cluster enable

    You should receive the following response:

    Cluster: enabled
    Default Port: 9710
  2. Use the following command to restart the GroupWise Admin Service.

    rcgrpwise restart gwadminservice

    Your GroupWise system is now ready to function in a cluster.

  3. For convenience, configure the GroupWise Installation console to use an authentication mode of a user name and password, rather than the default token-based authentication mode:

    gwadminutil installcfg -m user -u user_name -p password
  4. Continue with Upgrading Domains and Post Offices.

1.4.3 Upgrading Domains and Post Offices

For background information about upgrading your GroupWise system, see GroupWise System Upgrade in the GroupWise Installation Guide.

  1. In a web browser, start the GroupWise Installation console:

    https://domain_server_secondary_ip_address:9710/gwadmin-console/install
  2. Provide the user name as password that you established in Step 3 in Configuring the GroupWise Admin Service to Function in a Cluster.

  3. In the GroupWise Installation console, click Upgrade an Existing Domain or Post Office GroupWise 18.

    The Installation console provides a list of agents on the current node. The list is built from the gwha.conf file.

  4. (Conditional) If there are any domains or post offices that are not currently online to this node, select them, and then click Remove to remove them from the list.

  5. For each domain and post office, verify that the IP address in the list is the secondary IP address of the cluster resource.

  6. For each domain and post office, verify that there are no port conflicts for the Admin port.

  7. (Conditional) If you need to change the IP address or Admin port for a domain or post office, click the name of the domain or post office, update the information, and then click OK.

  8. Click Next to continue with the upgrade.

  9. On the Credentials page:

    1. (Conditional) If the primary domain is being upgraded, specify the user name for the GroupWise Super Admin, and type the password twice for confirmation.

      or

      Specify the IP address, Admin port, and Admin credentials of the owning domain.

  10. Click Next to display the Summary page.

  11. Review the summary, and then click Finish.

  12. Continue with Finishing the GroupWise Software Upgrade.

1.4.4 Finishing the GroupWise Software Upgrade

To finish the GroupWise Software Upgrade, you need to repeat the same tasks above on each cluster node:

  1. On each cluster node, repeat the steps in the following sections:

  2. Continue with Providing New Load and Unload Scripts.

1.4.5 Providing New Load and Unload Scripts

After upgrade, you need to replace the existing “load” and “unload” scripts as shown in the example steps below:

  1. In iManager, replace the existing load script for each cluster resource with a new load script that is similar to the following example:

    #!/bin/bash
    ./opt/novell/ncs/lib/ncsfuncs
    exit_on_error nss /poolact=DOM
    exit_on_error ncpcon mount DOM=254
    exit_on_error add_secondary_ipaddress 151.155.136.248
    exit_on_error ncpcon bind --ncpservername=DOM --ipaddress=151.155.136.248
    exit_on_error novcifs --add '--vserver=".cn=DOM.ou=servers.o=novell.t=GW14-TREE."' --ip-addr=151.155.136.248
    # Start grpwise service
    systemctl start grpwise.service
    #create agent services
    exit_on_error /opt/novell/groupwise/admin/gwsc -i /media/nss/DOM/utah
    exit_on_error /opt/novell/groupwise/admin/gwsc -i /media/nss/DOM/utah/wpgate/gwia
    exit_on_error /opt/novell/groupwise/admin/gwsc -i /media/nss/DOM/provo/
    #start admin service listeners
    exit_on_error /opt/novell/groupwise/admin/gwadmin-ipc start utah cluster
    exit_on_error /opt/novell/groupwise/admin/gwadmin-ipc start provo.utah cluster
    #start GroupWise agents
    gwsc -start utah
    gwsc -start gwia.utah
    gwsc -start provo.utah

    This sample cluster load script performs the following actions:

    • Establishes what to do for certain error conditions.

    • Creates the GroupWise agent services (if they do not already exist).

    • Starts the GroupWise Admin Service listeners with clustering enabled for the MTA and POA.

    • Starts the POA, MTA, and GWIA (in that order if all are present)

  2. Replace the existing unload script for each cluster resource with a new unload script that is similar to the following example:

    #!/bin/bash
    . /opt/novell/ncs/lib/ncsfuncs
    
    # Stop admin service listeners
    ignore_error /opt/novell/groupwise/admin/gwadmin-ipc stop utah
    ignore_error /opt/novell/groupwise/admin/gwadmin-ipc stop provo.utah
    # Stop GroupWise agents
    gwsc -stop utah
    gwsc -stop gwia.utah
    gwsc -stop provo.utah
    #Remove agent service 
    gwsc -u /media/nss/DOM/utah
    gwsc -u /media/nss/DOM/utah/wpgate/gwia
    gwsc -u /media/nss/DOM/provo/
    ignore_error novcifs --remove '--vserver=".cn=DOM.ou=servers.o=novell.t=GW14-TREE."' --ip-addr=151.155.136.248
    ignore_error ncpcon unbind --ncpservername=DOM --ipaddress=151.155.136.248
    ignore_error del_secondary_ipaddress 151.155.136.248
    ignore_error nss /pooldeact=DOM
    exit 0

    This sample cluster unload script performs the following actions:

    • Stops the GroupWise Admin Service listeners for the MTA and POA

    • Stops the MTA, GWIA, and POA (in that order if all are present)

    • Lists error conditions that can be ignored

    NOTE:The pkill command used in earlier versions of the GroupWise unload script is no longer needed. In GroupWise 18, the grpwise script terminates GroupWise agent processes according to the wait setting specified in the gwha.conf file. The default is 60 seconds. If that amount of time is not sufficient to ensure a clean shutdown of the agents in your GroupWise system, increase the wait setting as needed.

  3. Continue with Testing the Upgraded Cluster.

1.4.6 Testing the Upgraded Cluster

Follow the instructions in Testing Your Clustered GroupWise System on Linux to verify that the GroupWise Administration Console keeps track of the cluster resources that are currently available to it.