Planning the Sun Cluster HA for Alliance Gateway Installation and Configuration

This section contains the information that you need to plan your Sun Cluster HA for Alliance Gateway installation and configuration.

Before you begin, consult your Alliance Gateway documentation for configuration restrictions and requirements that are not imposed by Sun Cluster software. For information about restrictions that the Sun Cluster software imposes, see the Sun Cluster documentation.

Configuration Restrictions

The configuration restrictions in this section apply only to Sun Cluster HA for Alliance Gateway.

If your data service configuration does not conform to these restrictions, the data service configuration might not be supported.

For restrictions that apply to all data services, see Sun Cluster 3.2 11/09 Release Notes for Solaris OS.

• Sun Cluster HA for Alliance Gateway supports Alliance Gateway version 5.0, 6.0, 6.1 and 6.3.

• You can install the SWIFTNet Link and the Alliance Gateway software only on a failover file system. If WebSphere^TM MQ client software is needed for the operation of Alliance Gateway, install WebSphere MQ client software on the local file system in the same path on each cluster node or zone that can master the resource group. The default path is /opt/mqm.

• You cannot configure Sun Cluster HA for Alliance Gateway as a scalable data service.

The Sun Cluster HA for Alliance Gateway can be configured to run in a whole root or sparse root non-global zone for Sun Cluster HA for Alliance Gateway version 6.0, 6.1 or 6.3 if required.

Configuration Requirements

The configuration requirements in this section apply only to Sun Cluster HA for Alliance Gateway.

If your data service configuration does not satisfy these requirements, the data service configuration might not be supported.

For requirements that apply to all data services, see Configuration Guidelines for Sun Cluster Data Services in Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

• You must configure Sun Cluster HA for Alliance Gateway as a failover data service.

• Create the following groups with the same group ID on all cluster nodes or zones that can master the resource group: sagsnlg, swnetg.

  # groupadd -g groupid1 swnetg

  # groupadd -g groupid2 sagsnlg

• Create the following user with the same user ID on all cluster nodes or zones that can master the resource group: swnet.

  # useradd -u userid -g swnetg -d /home/swnet -s /usr/bin/ksh swnet

• On Solaris 10 – Create a Solaris project called swift on all cluster nodes or zones that can master the resource group.

  # projadd -U swnet swift

  # projmod -s -K 'project.max-sem-ids=(privileged,1080,deny)' swift

  # projmod -s -K 'project.max-sem-nsems=(privileged,512,deny)' swift

  # projmod -s -K 'project.max-shm-memory=(privileged,4294967295,deny)' swift

  # projmod -s -K 'project.max-shm-ids=(privileged,1200,deny)' swift

  # projmod -s -K 'process.max-msg-qbytes=(privileged,10485760,deny)' swift

  # projmod -s -K 'process.max-msg-messages=(privileged,8192,deny)' swift

  The previous values are examples only. For more accurate values refer to the SWIFTNet Link and Alliance Gateway latest documentation release notes.

• On Solaris 10 — Assign project swift as default project for swnet user by editing the /etc/user_attr file and adding the following line at the end of the file on all cluster nodes or zones that can master the resource group:

  swnet::::project=swift

• On earlier versions of Solaris 10, refer to the SWIFTNet Link and Alliance Gateway latest documentation release notes for the required setup in the /etc/system directory on all cluster nodes.

Configuration Considerations

The configuration considerations in the subsections that follow affect the installation and configuration of Sun Cluster HA for Alliance Gateway.

Resource Dependencies

Configure Sun Cluster HA for Alliance Gateway to protect a Sun Cluster instance and its respective components. The following table outlines these components and their dependencies.

Configuration Files and Registration Script

The Sun Cluster component has a configuration file and a registration script.

The /opt/SUNWscsag/etc/settings configuration file is obsolete and is no longer necessary for new data service registrations. All necessary variables are included in the /opt/SUNWscsag/util/sag_config configuration file. Resources that were registered prior to this change will still use the /opt/SUNWscsag/etc/settings configuration file.

Configuration Planning Questions

Use the questions in this section to plan the installation and configuration of Sun Cluster HA for Alliance Gateway. Write the answers to these questions in the space that is provided on the data service worksheets in Configuration Worksheets in Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

• Do you have a SWIFTNet connection and an Internet connection? The installation requires a secure server from SWIFT.

• Do you have your Alliance Gateway license key? If not, retrieve this information.

• Do you have your Alliance Gateway installation documentation? If not, refer the documentation available in the Alliance Gateway CD-ROM.

• Before you run Sun Cluster HA for Alliance Gateway as a failover data service, answer the following questions:

  • Which resource groups will you use for the Alliance Gateway application resource and the logical host name resource?

  • What is the logical hostname for the Alliance Gateway resource? Clients access the data service through this logical hostname.

• Where will the system configuration files reside?

  See Configuration Guidelines for Sun Cluster Data Services in Sun Cluster Data Services Planning and Administration Guide for Solaris OS for the advantages and disadvantages of using the local file system instead of the cluster file system.