Installing and Configuring Sun Cluster HA for Agfa IMPAX

This chapter explains how to install and configure Sun Cluster HA for Agfa IMPAX.

This chapter contains the following sections.

• Sun Cluster HA for Agfa IMPAX Overview

• Overview of Installing and Configuring Sun Cluster HA for Agfa IMPAX

• Planning the Sun Cluster HA for Agfa IMPAX Installation and Configuration

• Enabling Agfa IMPAX to Run in a Cluster

• Installing the Sun Cluster HA for Agfa IMPAX Packages

• Configuring Sun Cluster HA for Oracle to Support Sun Cluster HA for Agfa IMPAX

• Registering and Configuring Sun Cluster HA for Agfa IMPAX

• Verifying the Sun Cluster HA for Agfa IMPAX Installation and Configuration

Sun Cluster HA for Agfa IMPAX Overview

To eliminate single points of failure in an IMPAX system, Sun Cluster HA for Agfa IMPAX provides automatic failover for the IMPAX application. Sun Cluster HA for Agfa IMPAX is a failover data service.

For conceptual information about failover data services, see the Sun Cluster Concepts Guide for Solaris OS.

Sun Cluster HA for Agfa IMPAX requires an Oracle database made available by Sun Cluster HA for Oracle. Sun Cluster HA for Agfa IMPAX provides fault monitoring for the database only. Configure the database resource so that it does not attempt a local restart of the database.

Each component of the Agfa IMPAX service has a data service that protects the component when the component is configured in Sun Cluster. See the following table.

Overview of Installing and Configuring Sun Cluster HA for Agfa IMPAX

The following table summarizes the tasks for installing and configuring Sun Cluster HA for Agfa IMPAX and provides cross-references to detailed instructions for performing these tasks. Perform the tasks in the order that they are listed in the table.

Planning the Sun Cluster HA for Agfa IMPAX Installation and Configuration

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

Before you begin, refer to your Agfa IMPAX documentation and consult your Agfa consultant for configuration restrictions and requirements that are not imposed by Sun Cluster software.

Configuration Restrictions

The configuration restrictions in this section apply only to Sun Cluster HA for Agfa IMPAX.

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 the Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Connections between the database and Agfa IMPAX are not resilient. To ensure integrity, do not configure Oracle for a local failover. Instead, use Sun Cluster's capacity to fail over to another cluster node.

For performance reasons, install the database files on a highly available local file system. Do not install database files on the cluster file system. The resulting degraded performance could affect the functionality of not only the IMPAX application, but also of the connected modalities and viewing stations.

Configuration Requirements

The configuration requirements in this section apply only to Sun Cluster HA for Agfa IMPAX.

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.

Installation Requirements

Agfa IMPAX must be installed according to the installation notes that are supplied by Agfa for your specific version of Agfa IMPAX. A consultant from Agfa always installs the Agfa IMPAX software. This is a requirement for the cluster to be supported by Agfa and by Sun.

Dependency on Sun Cluster HA for Oracle

Sun Cluster HA for Agfa IMPAX depends on the Sun Cluster HA for Oracle data service and uses an HAStoragePlus resource to synchronize startup of this database resource. When your Agfa engineer installs the Agfa IMPAX software, the engineer also installs the Oracle software. Configuring Sun Cluster HA for Oracle to Support Sun Cluster HA for Agfa IMPAX contains details about the requirements for configuring Sun Cluster HA for Oracle.

Additional Libraries

Sun Cluster HA for Agfa IMPAXrequires the libraries that are provided in the /opt/SUNWscpax/impaxapp/util/ directory. These libraries enable the IMPAX application to be used in a cluster. Additionally, some scripts must be replaced in the installation. The Agfa documentation contains the details about these scripts.

In suncluster 3.2 this is changed, there is a similar library included in the suncluster distribution, which has a better coverage of the functionalities needed to catch the hostname and translate it into the logical hostname needed to operate in suncluster.

Configuration Planning Questions

Use the questions in this section to plan the installation and configuration of Sun Cluster HA for Agfa IMPAX. 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.

• Which resource groups will you use for the Sun Cluster HA for Agfa IMPAX application resource and the logical hostname resource?

• What is the logical hostname for the Sun Cluster HA for Agfa IMPAX 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.

Enabling Agfa IMPAX to Run in a Cluster

Before you begin, contact your Agfa consultant to install the Agfa IMPAX application. Your consultant installs and configures Oracle at the same time as installing the IMPAX software.

How to Enable Agfa IMPAX to Run in a Cluster

1. Become superuser on one cluster node.

2. Create a resource group for the IMPAX resource.

   # clresourcegroup create impax-rg

   impax-rg

   The name of the resource group you are adding

   ---

   Note –

   You add the Oracle resources to this group. See Configuring Sun Cluster HA for Oracle to Support Sun Cluster HA for Agfa IMPAX for more information.

   ---

3. If necessary, add an entry to /etc/hosts for each node on which Agfa IMPAX can run.

   # Echo "address host" >>/etc/hosts

   address

   The IP address of the node

   host

   The host name, which is the name of the IMPAX service

4. Add a logical host name resource to the resource group that you created in Step 2.

   # clreslogicalhostname create -g impax-rg -h hostname

   impax-rg

   The resource group

   hostname

   A logical host name. use the IMPAX service name.

5. Bring online the resource group that you created in Step 2.

   # clresourcegroup online impax-rg

Installing the Sun Cluster HA for Agfa IMPAX Packages

If you did not install the Sun Cluster HA for Agfa IMPAX packages during your initial Sun Cluster installation, perform this procedure to install the packages. To install the packages, use the Sun Java Enterprise System Common Installer.

How to Install the Sun Cluster HA for Agfa IMPAX Packages

Perform this procedure on each cluster node where you are installing the Sun Cluster HA for Agfa IMPAX packages.

You can run the Sun Java Enterprise System Common Installer with a command-line interface (CLI) or with a graphical user interface (GUI). The content and sequence of instructions in the CLI and the GUI are similar.

Before You Begin

Ensure that you have the Sun Java^TM Availability Suite CD-ROM.

If you intend to run the Sun Java Enterprise System Common Installer with a GUI, ensure that your DISPLAY environment variable is set.

1. On the cluster node where you are installing the data service packages, become superuser.

2. Load the Sun Java Availability Suite CD-ROM into the CD-ROM drive.

   If the Volume Management daemon vold(1M) is running and configured to manage CD-ROM devices, the daemon automatically mounts the CD-ROM on the /cdrom directory.

3. Change to the Sun Java Enterprise System Common Installer directory of the CD-ROM.

   • If you are installing the data service packages on the SPARC® platform, type the following command:

     # cd /cdrom/cdrom0/Solaris_sparc

   • If you are installing the data service packages on the x86 platform, type the following command:

     # cd /cdrom/cdrom0/Solaris_x86

4. Start the Sun Java Enterprise System Common Installer.

   # ./installer

5. When you are prompted, accept the license agreement.

   If any Sun Java Enterprise System components are installed, you are prompted to select whether to upgrade the components or install new software.

6. From the list of Sun Cluster agents under Availability Services, select the data service for Agfa IMPAX.

7. If you require support for languages other than English, select the option to install multilingual packages.

   English language support is always installed.

8. When prompted whether to configure the data service now or later, choose Configure Later.

   Choose Configure Later to perform the configuration after the installation.

9. Follow the instructions on the screen to install the data service packages on the node.

   The Sun Java Enterprise System Common Installer displays the status of the installation. When the installation is complete, the wizard displays an installation summary and the installation logs.

10. (GUI only) If you do not want to register the product and receive product updates, deselect the Product Registration option.

    The Product Registration option is not available with the CLI. If you are running the Sun Java Enterprise System Common Installer with the CLI, omit this step

11. Exit the Sun Java Enterprise System Common Installer.

12. Unload the Sun Java Availability Suite CD-ROM from the CD-ROM drive.

    1. To ensure that the CD-ROM is not being used, change to a directory that does not reside on the CD-ROM.

    2. Eject the CD-ROM.

       # eject cdrom

Next Steps

Go to Configuring Sun Cluster HA for Oracle to Support Sun Cluster HA for Agfa IMPAX.

Configuring Sun Cluster HA for Oracle to Support Sun Cluster HA for Agfa IMPAX

Sun Cluster HA for Agfa IMPAX depends on a highly available Oracle database. When configuring Sun Cluster HA for Oracle to support Agfa IMPAX, add the Oracle server resource and the Oracle listener resource to the same resource group that you created for the IMPAX service. For details about how to install, configure, and register resources for Sun Cluster HA for Oracle, refer to Sun Cluster Data Service for Oracle Guide for Solaris OS.

In addition to registering the resources, add the oramon user to Oracle and allow it to probe the database.

Example 1 Registering Sun Cluster HA for Oracle Resources

The following example assumes that you created a resource group called impax-rg for the IMPAX data service.

# clresource create -g impax-rg -t SUNW.oracle_listener\ 
-x ORACLE_HOME=/global/export/oracle -x LISTENER_NAME=LISTNRname oralnsr-rs  

Example 2 Adding an Oracle Server Resource to the IMPAX Resource Group

The following example assumes that you created a resource group called impax-rg for the IMPAX data service.

# clresource create -g impax-rg -t SUNW.oracle_server  \ 
-x CONNECT_STRING=oramon/monitor -x ORACLE_SID=oraSID \ 
-x ORACLE_HOME=/global/export/oracle \ 
-x ALERT_LOG_FILE=/global/export/oracle/admin/oraSID/bdump/alert_oraSID.log oraserver-rs

Example 3 Configuring the oramon User

The following example illustrates the necessary oramon configuration.

su - mvf
	sqlplus "/ as sysdba"
grant connect, resource to oramon identified by "monitor";
alter user oramon default tablespace system quota 1m on system;
grant select on v_$sysstat to oramon;
grant create session to oramon;
grant create table to oramon;
exit;

Registering and Configuring Sun Cluster HA for Agfa IMPAX

To enable Sun Cluster HA for Agfa IMPAX to make Agfa IMPAX highly available, configure the Sun Cluster HA for Agfa IMPAX data service as a failover data service.

Before you perform this procedure, ensure that the Sun Cluster HA for Agfa IMPAX data service packages are installed. Perform all the steps in Installing the Sun Cluster HA for Agfa IMPAX Packages.

How to Register and Configure Sun Cluster HA for Agfa IMPAX as a Failover Data Service

1. Add an impaxscripts resource.

   This resource allows Sun Cluster to perform certain tasks before Oracle starts and to clean up afterward if necessary.

   1. Edit the registration configuration file /opt/SUNWscpax/impaxscripts/util/impaxscripts_config and change the resource and resource group names according to your configuration.

      The following shows the contents of the impaxscripts_config file. If they are appropriate to your configuration, you can use the default values for RS and RG.

      # These parameters can be customized in (key=value) form # # RS - name of the resource for the application # RG - name of the resource group containing RS # PORT - name of the port number # LH - name of the LogicalHostname SC resource # HAS_RS - name of the HAStoragePlus SC resource # RS=impaxscripts-rs RG=impax-rg PORT= LH= HAS_RS=

   2. Verify that the /opt/SUNWscpax/impaxscripts/etc/config configuration file contains the correct variable settings.

      These variables are provided by the Agfa IMPAX installation. They should read as follows:

      USERID=mvf # default userid for impax installations CLEANKILL="/usr/mvf/bin/sun_cluster_impax_kill" ORACLEPRE="/usr/mvf/bin/sun_cluster_oracle_prestart"

   3. Create the resource and register it in the cluster by gaining root access and using the impaxscripts_register utility.

      # /opt/SUNWscpax/impaxscripts/util/impaxscripts_register

      If this utility fails, return to Step b and verify that the configuration file is correct.

2. Register the SUNW.gds resource type.

   # clresourcetype register SUNW.gds

3. Register the SUNW.HAStoragePlus resource type.

   # clresourcetype register SUNW.HAStoragePlus

4. Create an HAStoragePlus resource for the file system on which the database files reside.

   # clresource create -g impax-rg -t SUNW.HAStoragePlus \ -x FileSystemMountPoints=/dbase, /cache1 ora-ds

5. To optimize the data path, manage the global file system in the same manner as you manage the disk groups.

   This approach makes the system local to the base services, although the files are available on both nodes.

   # clresource create -g impax-rg -t SUNW.HAStoragPlus -x FileSystemMountPoints=/global/export

6. Edit the /opt/SUNWscpax/impaxapp/util/impax_config file to match the following:

   • your configuration

   • the name of your resource group, as specified in Step 1.

   • your dependencies

7. Register the resource in the cluster framework by using the impax_register utility.

   # /opt/SUNWscpax/impaxapp/util/impax_register

Verifying the Sun Cluster HA for Agfa IMPAX Installation and Configuration

Use the service tools to verify that an Agfa IMPAX instance is available on the logical IP address.

How to Verify the Sun Cluster HA for Agfa IMPAX Installation and Configuration as a Failover Data Service

1. Switch the IMPAX resource to another node to verify that the stop and start methods work.

2. Disable the IMPAX resource, then try to start the application manually.

   This step ensures that no cluster-related interaction fails.

3. Disable all resources except the logical host name resource and data service resource.

4. Manually start the Agfa IMPAX application.