RSM Phase II: RSMRDT Driver Installation

This page describes the prerequisites and procedures for installation of the Remote Shared Memory Reliable Datagram Transport (RSMRDT) driver.

Note The RSMRDT driver should not be installed until RSM with 9iRAC is supported. Contact your Sun service provider for configuration support information.

This page includes the following sections:

• Overview of the RSMRDT Driver
• Restrictions
• How to Install the SUNWscrdt Package
• How to Uninstall the SUNWscrdt Package
• How to Unload the RSMRDT Driver Manually

Top

Overview of the RSMRDT Driver

Remote Shared Memory (RSM) is an interface on top of a memory-based interconnect. RSM provides highly reliable remote memory operations and synchronous detection of communication failure through barrier calls. RSMRDT consists of a driver that is built on top of RSMAPI and a library that exports the RSMRDT-API interface. RSMRDT is dependent on Sun Cluster software and RSM. The primary goal of the driver is to provide enhanced Oracle™ Parallel Server (OPS) performance. A secondary goal is to enhance load-balancing and high-availability (HA) functions by providing them directly inside the driver, making them available to the clients transparently.

Top

Installing the RSMRDT Driver

The RSMRDT driver and library are installed with the SUNWscrdt package. You must successfully install Sun Cluster software, the RSM package, SUNWrsmo, and SUNWrsmx before beginning RSMRDT installation.

Top

Restrictions

Use of the RSMRDT Driver is restricted to customers running an Oracle9i release 2 SCI configuration with RSM enabled. Refer to Oracle9i release 2 user documentation for detailed installation and configuration instructions. The SUNWscrdt package (RSMRDT driver package) depends on the following packages:

• SUNWrsmo RSMPI Operations Registration Module
• SUNWrsmox RSMPI Operations Registration Module (64-bit)

The SUNWscrdt package also has a functional dependency on the following RSM packages:

• SUNWrsm Remote Shared Memory
• SUNWrsmx Remote Shared Memory (64-bit)

How to Install the SUNWscrdt Package

1. Verify that SUNWrsmo and SUNWrsmx are installed before completing this procedure.
2. Become superuser on the node to which you want to install the SUNWscrdt package.

   Note You must repeat this procedure for each node in the cluster.

3. Install the SUNWscrdt package.

   # pkgadd -d pathname SUNWscrdt

   pathname

   Specifies the path name of the directory that contains SUNWscrdt

How to Uninstall the SUNWscrdt Package

1. Verify that no applications are using the RSMRDT driver before performing this procedure.
2. Become superuser on the node to which you want to uninstall the SUNWscrdt package.

   Note You must repeat this procedure for each node in the cluster.

3. Uninstall the SUNWscrdt package.

   # pkgrm SUNWscrdt

How to Unload the RSMRDT Driver Manually

If the driver remains loaded in memory after completing How to Uninstall the SUNWscrdt Package, perform the following procedure to unload the driver manually.

1. Start the adb tool.

   # adb -kw

2. Set the kernel variable clifrsmrdt_modunload_ok to 1.

   physmem ####
   clifrsmrdt_modunload_ok/W 1

3. Exit adb by pressing Control-D.
4. Find the clif_rsmrdt and rsmrdt module IDs.

   # modinfo | grep rdt

5. Unload the clif_rsmrdt module.

   # modunload -i clif_rsmrdt_id

   Note You must unload the clif_rsmrdt module before unloading rsmrdt. If modunload fails, applications are probably still using the driver. Terminate the applications before running modunload again.

   clif_rsmrdt_id

   Specifies the numeric ID for the module being unloaded.

6. Unload the rsmrdt module.

   # modunload -i rsmrdt_id

   rsmrdt_id

   Specifies the numeric ID for the module being unloaded.

7. Verify that the module was unloaded successfully.

   # modinfo | grep rdt

Example: Unloading the RSMRDT Driver

The following example shows the console output after the RSMRDT driver is manually unloaded.