This chapter explains how to install and configure Sun Cluster HA for Agfa IMPAX. This chapter contains the following procedures:
How to Install the Sun Cluster HA for Agfa IMPAX Packages by Using the Web Start Program
How to Install the Sun Cluster HA for Agfa IMPAX Packages by Using the scinstall Utility
How to Register and Configure Sun Cluster HA for Agfa IMPAX as a Failover Data Service
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–1 Protection of Agfa IMPAX Components by Sun Cluster Data Services
Agfa IMPAX Component |
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 |
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 1–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. | |
Install the Sun Cluster HA for Agfa IMPAX packages, together with the HA for Oracle 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. | |
Verify the Sun Cluster HA for Agfa IMPAX installation and configuration. |
Verifying 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.
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.
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.
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.
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.
Sun Cluster HA for Agfa IMPAX requires 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.
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 3.1 Data Service Planning and Administration Guide.
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 3.1 Data Service Planning and Administration Guide for the advantages and disadvantages of using the local file system instead of the cluster file system.
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.
Become superuser on one cluster node.
Create a resource group for the IMPAX resource.
# scrgadm -a -g impax-rg |
The name of the resource group you are adding
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.
If necessary, add an entry to /etc/hosts for each node on which Agfa IMPAX can run.
# Echo "address host" >>/etc/hosts |
The IP address of the node
The host name, which is the name of the IMPAX service
Add a logical host name resource to the resource group that you created in Step 2.
# scrgadm -a -L -g impax-rg -l hostname |
The resource group
A logical host name. use the IMPAX service name.
Bring online the resource group that you created in Step 2.
# scswitch -Z -g impax-rg |
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:
The Web Start program
The scinstall utility
The Web Start program is not available in releases earlier than Sun Cluster 3.1 Data Services 10/03.
Perform this procedure on each node that hosts the Agfa IMPAX service.
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.
On the cluster node where you are installing the Sun Cluster HA for Agfa IMPAX packages, become superuser.
(Optional) If you intend to run the Web Start program with a GUI, ensure
that your DISPLAY
environment
variable is set.
Insert the Sun Java Enterprise System Accessory CD Volume 3 in the CD-ROM drive.
If the Volume Management daemon vold(1M) is running and is configured to manage CD-ROM devices, it automatically mounts the CD-ROM on the /cdrom/cdrom0 directory.
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 |
Start the Web Start program.
# ./installer |
When you are prompted, select the type of installation.
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.
Exit the Web Start program.
Remove the Sun Java Enterprise System Accessory CD Volume 3 from the CD-ROM drive.
Go to Registering and Configuring Sun Cluster HA for Agfa IMPAX.
Perform this procedure on each node that hosts the Agfa IMPAX service.
Insert the Sun Java Enterprise System Accessory CD Volume 3 in the CD-ROM drive.
Run the scinstall utility with no options.
This step starts the scinstall utility in interactive mode.
Select the menu option, Add Support for New Data Service to This Cluster Node.
The scinstall utility prompts you for additional information.
Provide the path to the Sun Java Enterprise System Accessory CD Volume 3.
The utility refers to the CD as the “data services cd.”
Specify the data service to install.
The scinstall utility lists the data service that you selected and asks you to confirm your choice.
Exit the scinstall utility.
Remove the CD from the drive.
Go to Registering and Configuring 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.
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 |
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 |
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;
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.
Add an impaxscripts resource.
This resource allows Sun Cluster to perform certain tasks before Oracle starts and to clean up afterward if necessary.
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= |
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" |
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.
Register the SUNW.gds resource type.
# scrgadm -a -t SUNW.gds |
Register the SUNW.HAStoragePlus resource type.
# scrgadm -a -j ora-ds -t SUNW.HAStoragePlus - |
The logical name for the Oracle database
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 |
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 |
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
Register the resource in the cluster framework by using the impax_register utility.
# /opt/SUNWscpax/impaxapp/util/impax_register |
Use the service tools to verify that an Agfa IMPAX instance is available on the logical IP address.
Switch the IMPAX resource to another node to verify that the stop and start methods work.
Disable the IMPAX resource, then try to start the application manually.
This step ensures that no cluster-related interaction fails.
Disable all resources except the logical host name resource and data service resource.
Manually start the Agfa IMPAX application.