C H A P T E R  1

Using the Troubleshooting Guide

For information about when and how to use this book, and for pointers to other books in the Netra™ High Availability (HA) Suite Foundation Services documentation set, see the following sections:


When to Use This Book

This book provides a defined approach to solving problems that can occur when you are installing, starting up, or using the Netra HA Suite. This book does not explain how to install or maintain your cluster. Nor does this book explain the tools, configuration files, and APIs provided by the Netra HA Suite. These subjects are covered in other books in the documentation set.

The following table lists some common questions and answers about the Netra HA Suite.


TABLE 1-1   Common Questions 
Question For Information, see
What is the Netra HA Suite? Netra High Availability Suite 3.0 1/08 Foundation Services Overview
What's new in this release? Netra High Availability Suite 3.0 1/08 Release Notes
What tools and configuration files are available? Netra High Availability Suite 3.0 1/08 Foundation Services Reference Manual for the man pages that can be accessed by using the man1 command
How can the Netra HA Suite be evaluated easily? Netra High Availability Suite 3.0 1/08 Foundation Services Getting Started Guide
How is the hardware configured? Netra High Availability Suite 3.0 1/08 Foundation Services Getting Started Guide
Which installation method should you use? Netra High Availability Suite 3.0 1/08 Foundation Services Overview
How is the Netra HA Suite installed? Netra High Availability Suite Foundation Services 3.0 Automated Installation Guide and Netra High Availability Suite 3.0 1/08 Foundation Services Manual Installation Guide for the Solaris OS
How is a cluster maintained, and how is hardware added or replaced? Netra High Availability Suite 3.0 1/08 Foundation Services Cluster Administration Guide
How are applications that use the Netra HA Suite developed? Netra High Availability Suite 3.0 1/08 Foundation Services CMM Programming Guide, the Netra High Availability Suite 3.0 1/08 Foundation Services SA Forum Programming Guide, or the Netra High Availability Suite 3.0 1/08 Foundation Services NMA Programming Guide
What does a term or a name mean? Netra High Availability Suite 3.0 1/08 Foundation Services Glossary


How to Use This Book

The subsequent chapters in this book provide detailed information about how to solve specific installation, startup, or runtime problems. Each chapter covers a different problem area. The following table shows where to find troubleshooting information for a particular troubleshooting area.


TABLE 1-2   Where to Find Troubleshooting Information 
Problem Area For Information, see
Installation and startup Chapter 3 through Chapter 5
Installation of the Solaris Operating System and the Netra HA Suite Chapter 2
Startup of master-eligible nodes Chapter 3
Startup of diskless nodes or dataless nodes Chapter 4
Run time Chapter 6 through Chapter 8
Failover and switchover during run time Chapter 5
Node reboot during run time Chapter 6
Addition of nodes to your cluster during run time Chapter 7
Collection of statistics about your cluster Chapter 8
Error messages in the system log files Appendix A

Appendix A lists the error messages that are generated by the Netra HA Suite. The appendix also provides a brief summary of the possible cause of error. The error messages are grouped as follows: those produced during installation, those produced during run time, and those produced when using the command-line interface. If you receive an error message, use Appendix A to find the cause and a possible resolution.

If you cannot resolve a problem that you encounter while installing or using the Netra HA Suite, contact your customer support center.


Using Administration Tools and Configuration Files to Troubleshoot

The Netra HA Suite provides a suite of tools and configuration files for maintaining and debugging your cluster environment. Because the Netra HA Suite runs on the Solaris Operating System, the Solaris tools and configuration files are also useful.

When your cluster produces an error, use the tools to determine the cause of the problem. For information about these tools, see the Netra High Availability Suite 3.0 1/08 Foundation Services Cluster Administration Guide.

For information about the individual tools, see their man pages in section 1M of the Netra High Availability Suite 3.0 1/08 Foundation Services Reference Manual. Similarly, for information about the individual configuration files, see their man pages in section 4 of the Netra High Availability Suite 3.0 1/08 Foundation Services Reference Manual.