Sun Cluster Data Service for Agfa IMPAX Guide for Solaris OS

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

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.

Table 1 Protection of Agfa IMPAX Components by Sun Cluster Data Services

Agfa IMPAXComponent 

Data Service 

Oracle database 

Sun Cluster HA for Oracle 

Agfa IMPAX 

Sun Cluster HA for Agfa IMPAX 

NFS file system 

Sun Cluster HA for NFS 

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.

Table 2 Tasks for Installing and Configuring Sun Cluster HA for Agfa IMPAX

Task 

Instructions 

Plan the Agfa IMPAX installation. 

Your Agfa documentation and a consultant from Agfa. 

Sun Cluster Data Services Planning and Administration Guide for Solaris OS

Planning the Sun Cluster HA for Agfa IMPAX Installation and Configuration

Install and configure Agfa IMPAX. 

A consultant from Agfa always installs the IMPAX software. 

Enable Agfa IMPAX to run in a cluster. 

How to Enable Agfa IMPAX to Run in a Cluster

Install the Sun Cluster HA for Agfa IMPAX packages, together with the HA for Oracle packages. 

Installing the Sun Cluster HA for Agfa IMPAX Packages

Register the Sun Cluster HA for Oracle data service and configure the cluster for the data service. 

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

Register the Sun Cluster HA for Agfa IMPAX data service and configure the cluster for the data service.  

Registering and Configuring Sun Cluster HA for Agfa IMPAX

Verify the Sun Cluster HA for Agfa IMPAX installation and configuration. 

Verifying the Sun Cluster HA for Agfa IMPAX Installation and Configuration

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.


Note –

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.


Caution – Caution –

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.


Caution – Caution –

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.

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.

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.

ProcedureHow to Enable Agfa IMPAX to Run in a Cluster

Steps
  1. Become superuser on one cluster node.

  2. Create a resource group for the IMPAX resource.


    # scrgadm -a -g 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.


    # scrgadm -a -L -g impax-rg -l 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.


    # scswitch -Z -g 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. Perform this procedure on each cluster node where you are installing the Sun Cluster HA for Agfa IMPAX packages. To complete this procedure, you need the Sun Java Enterprise System Accessory CD Volume 3.

If you are installing more than one data service simultaneously, perform the procedure in Installing the Software in Sun Cluster Software Installation Guide for Solaris OS.

Install the Sun Cluster HA for Agfa IMPAX packages by using one of the following installation tools:


Note –

The Web Start program is not available in releases earlier than Sun Cluster 3.1 Data Services 10/03.


ProcedureHow to Install the Sun Cluster HA for Agfa IMPAX Packages by Using the Web Start Program

You can run the Web Start program 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. For more information about the Web Start program, see the installer(1M) man page.

Steps
  1. On the cluster node where you are installing the Sun Cluster HA for Agfa IMPAX packages, become superuser.

  2. (Optional) If you intend to run the Web Start program with a GUI, ensure that your DISPLAY environment variable is set.

  3. Insert the Sun Java Enterprise System Accessory CD Volume 3 into the CD-ROM drive.

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

  4. Change to the Sun Cluster HA for Agfa IMPAX component directory of the CD-ROM.

    The Web Start program for the Sun Cluster HA for Agfa IMPAX data service resides in this directory.


    # cd /cdrom/cdrom0/components/SunCluster_HA_AGFA_IMPAX_3.1
    
  5. Start the Web Start program.


    # ./installer
    
  6. When you are prompted, select the type of installation.

    • To install only the C locale, select Typical.

    • To install other locales, select Custom.

  7. Follow the instructions on the screen to install the Sun Cluster HA for Agfa IMPAX packages on the node.

    After the installation is finished, the Web Start program provides an installation summary. This summary enables you to view logs that the Web Start program created during the installation. These logs are located in the /var/sadm/install/logs directory.

  8. Exit the Web Start program.

  9. Remove the Sun Java Enterprise System Accessory CD Volume 3 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 Registering and Configuring Sun Cluster HA for Agfa IMPAX.

ProcedureHow to Install the Sun Cluster HA for Agfa IMPAX Packages by Using the scinstall Utility

Perform this procedure on all of the cluster members that can master Sun Cluster HA for Agfa IMPAX.

Before You Begin

Ensure that you have the Sun Java Enterprise System Accessory CD Volume 3.

Steps
  1. Load the Sun Java Enterprise System Accessory CD Volume 3 into the CD-ROM drive.

  2. Run the scinstall utility with no options.

    This step starts the scinstall utility in interactive mode.

  3. Select the menu option, Add Support for New Data Service to This Cluster Node.

    The scinstall utility prompts you for additional information.

  4. Provide the path to the Sun Java Enterprise System Accessory CD Volume 3.

    The utility refers to the CD as the “data services cd.”

  5. Specify the data service to install.

    The scinstall utility lists the data service that you selected and asks you to confirm your choice.

  6. Exit the scinstall utility.

  7. Unload the CD from the drive.

Next Steps

Go to Registering and Configuring 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.


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


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.


# scrgadm -a -j oraserver-rs -t SUNW.oracle_server -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


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 How to Install the Sun Cluster HA for Agfa IMPAX Packages by Using the Web Start Program or How to Install the Sun Cluster HA for Agfa IMPAX Packages by Using the scinstall Utility.

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

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


    # scrgadm -a -t SUNW.gds
    
  3. Register the SUNW.HAStoragePlus resource type.


    # scrgadm -a -j ora-ds -t SUNW.HAStoragePlus -
    
    ora-ds

    The logical name for the Oracle database

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


    # scrgadm -a -j ora-ds -t SUNW.HAStoragePlus -g impax-rg \ 
    -x FileSystemMountPoints=/dbase, /cache1
    
  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.


    # scrgadm -a -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.

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

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