Netra™ High Availability Suite 3.0 1/08 Foundation Services NMA Programming GuideTable Of Contents Previous ChapterNext ChapterBook Index


C H A P T E R  8

Reliable NFS Statistics

This chapter describes the Reliable NFS statistics that can be accessed from the NMA.

This chapter contains the following sections:

Introducing Reliable NFS Statistics

The Reliable NFS statistics collected by the NMA provide a view on the current state of replication in the cluster, node by node, reliable link by reliable link. Reliable NFS statistics are available only on the master node and the vice-master node.

See File Sharing and Data Replication in the Netra High Availability Suite 3.0 1/08 Foundation Services Overview for more information.

Reliable NFS Using SNDR

Reliable NFS can be used with SNDR or shared-disk configurations. This section describes the statistics that are generated for an SNDR configuration.

Reliable NFS Master Statistics for SNDR

This section describes the Reliable NFS statistics collected by NMA running on the master node.

RnfsMasterReplicatedSliceMBean

The RnfsMasterReplicatedSliceMBean MBean models a Reliable NFS replicated slice. Each slice is composed of a primary partition and a secondary partition. One instance of this MBean is instantiated for each replicated slice mounted on either the master or the vice-master node.

Getting the Completed Recovery Percentage

To get the percentage of segments of the slice that has been resynchronized, invoke the getCompletedRecoveryPercentage method, which takes no parameters and returns a float. This information is meaningful if the primary slice of this MBean is mounted on the host running the agent. No statistics are provided for a distant primary MBean.

Getting the Percentage of Segments Requiring Recovery

To get the percentage of segments of the slice that require recovery, invoke the getNeededRecoveryPercentage method, which takes no parameters and returns a float that indicates the percentage of segments that require recovery. This information is meaningful if the primary slice of this MBean is mounted on the host running the agent. No statistics are provided for distant primary MBean.

Reliable NFS Peer Node Statistics for SNDR

This section describes the Reliable NFS statistics collected by NMA running on each peer node.

RnfsStatisticsMBean

The RnfsStatisticsMBean MBean provides global Reliable NFS statistics. One instance of this MBean is instantiated on each master eligible node in the cluster. This MBean only provides statistics about Reliable NFS on the node on which it is running.

Getting the Primary Slice

To return the primary dual copy slice file name and slice name, invoke the getPrimarySlice method, which takes no parameters and returns a Slice.

Getting the Secondary Slice

To return the secondary dual copy slice file name and slice name, invoke the getSecondarySlice method, which takes no parameters and returns a Slice.

RnfsMasterStatisticsMBean

The RnfsMasterStatisticsMBean MBean provides Reliable NFS statistics on the master node.

Getting the Names of All Primary Files on the Local Host

To get an array of the names of the primary slices mounted on the local host, invoke the getPrimaryFiles method, which takes no parameters and returns a String[].

Getting the Names of All Secondary Files on the Local Host

To return an array of the names of the secondary slices mounted on the local host, invoke the getSecondaryFiles method, which takes no parameters and returns a String[].

RnfsReplicatedSliceMBean

The RnfsReplicatedSliceMBean MBean models a Reliable NFS slice. One instance of this MBean is instantiated for each replicated slice mounted on each MEN.

Getting the Completed Recovery Percentage

To get the percentage of segments of the partition that has been resynchronized, invoke the getCompletedRecoveryPercentage method, which takes no parameters and returns a float. This information is meaningful if the primary slice of this MBean is mounted on the host running the agent. No statistics are provided for a distant primary MBean.

Getting the Dual Copy Status

To get the current status of the dual copy as a DualCopyStatusEnum value, invoke the getDualCopyStatus method, which takes no parameters and returns a DualCopyStatusEnum. This information is meaningful if the primary slice of this MBean is mounted on the host running the agent. No statistics are provided for a distant primary MBean.

Getting the Link Status

To find out if replication is enabled, disabled, or in progress, invoke the getLinkStatus method, which takes no parameters and returns a LinkStatusEnum.

Getting the Percentage of Segments Requiring Recovery

To indicate the percentage of segments of the partition that require recovery, invoke the getNeededRecoveryPercentage method, which takes no parameters and returns a float. This information is meaningful if the primary slice of this MBean is mounted on the host running the agent. No statistics are provided for a distant primary MBean.

Getting the Primary Slice

To return the primary dual copy slice file name and slice name, invoke the getPrimarySlice method, which takes no parameters and returns a Slice.

Getting the Secondary Slice

To return the secondary dual copy slice file name and slice name, invoke the getSecondarySlice method, which takes no parameters and returns a Slice.

Getting the Names of All Primary Files on the Local Host

To get an array of the names of the primary slices mounted on the local host, invoke the getPrimaryFiles method, which takes no parameters and returns a String[].

Getting the Names of All Secondary Files on the Local Host

To return an array of the names of the secondary slices mounted on the local host, invoke the getSecondaryFiles method, which takes no parameters and returns a String[].

Reliable NFS Using Shared Disk Configuration

Reliable NFS can be used with SNDR or shared-disk configurations. This section describes the statistics that are generated for a shared-disk configuration.

Reliable NFS Master Statistics for Shared Disk

This section describes the Reliable NFS statistics collected by the NMA running on shared disk configuration.

SDMasterStatisticsMBean

The SDMasterStatisticsMBean MBean for shared disk models the Reliable NFS statistics.

Displaying the Shared Disk Device Name and ID

To display the device name and the device ID for the shared disk on the master node, invoke the getDevices method. The getDevices method takes no parameters and returns a String[].

Displaying the List of Drives Managed by the Shared Disk

To display the list of drives that are managed by the shared disk, invoke the getDrives method. The getDrives method takes no parameters and returns a String[].

Getting Disk Fencing Information

To display the list of disks taking part in the fencing provided by Reliable NFS (RNFS), invoke the getFencingDisks method. This list is pulled directly from the nhfs.conf file.

Displaying the Disk Fencing Type

To display the type of disk fencing used to guarantee data integrity for the shared disk, invoke the getFencingType method. Properties are NONE, SCSI2, and SCSI3. The default is NONE. For more information about this method, refer to the nhfs.conf4 man page.

Displaying the List of Hosts That Access the Shared Disk

To display the names of the hosts that access the shared disk device, invoke the getHosts method. The getHosts method takes no parameters and returns a String[].

Displaying the Details of the Shared Devices Configuration

To display information about the configuration of the shared devices, invoke the getMetadevicesConfig method. The getMetadevicesConfig method takes no parameters and returns a String[].

Displaying the Mirror and Submirror Information

To display the names of the mirrors, their submirrors, and the status of the submirrors, invoke the getMirrors method. The getMirrors method takes no parameters and returns a String[].

Displaying the Name of the Host that Owns the Shared Disk

To display the name of the host that is identified as the owner of the shared disk, invoke the getOwner method. The getOwner method takes no parameters and returns a String[].

Displaying the Disk Partitions Managed by RNFS

To display the disk partitions that must be managed by Reliable NFS, invoke the getRNFSSlices method. Properties are metadevice and mountflag. There is no default value for this property. For more information about this method, refer to the nhfs.conf4 man page.

Displaying the Name of the Set of Disks Managed by the Shared Disk

To display the name of the set of disks that are managed by shared disk and used by the Netra HA Suite software, invoke the getSetName method. The getSetName method takes no parameters and returns a String[].

Displaying the Numeric Identifier of the Disks Managed by the Shared Disk

To display the number assigned to the set of disks that are managed by shared disk and used by the Netra HA Suite software, invoke the getSetNumber method. The getSetNumber method takes no parameters and returns a String[].



Netra™ High Availability Suite 3.0 1/08 Foundation Services NMA Programming Guide819-5239-13Table Of Contents Previous ChapterNext ChapterBook Index


Copyright © 2008, Sun Microsystems, Inc. All rights reserved.