Top
PRIMECLUSTER  Cluster Foundation Configuration and Administration Guide 4.3
FUJITSU Software

Preface

The Cluster Foundation (CF) provides a comprehensive base of services that user applications and other PRIMECLUSTER services need to administrate and communicate in a cluster.

Target Readers

This manual is intended for all users who use PRIMECLUSTER 4.3 and perform cluster system installation and operation management.

Configuration of This Documentation

This manual is organized as follows:

Chapter

Description

Chapter 1 Cluster Foundation

Describes the administration and configuration of the Cluster Foundation.

Chapter 2 CF Registry and Integrity Monitor

Discusses purpose and physical characteristics of the CF synchronized registry, and it discusses the purpose and implementation of the Cluster Integrity Monitor (CIM).

Chapter 3 Cluster resource management

Discusses the database which is a synchronized clusterwide database holding information specific to several PRIMECLUSTER products.

Chapter 4 GUI administration

Describes the administration features in the CF portion of the Cluster Admin graphical user interface (GUI).

Chapter 5 LEFTCLUSTER state

Discusses the LEFTCLUSTER state, relation between LEFTCLUSTER state and other states. How LEFTCLUSTER state is caused in various ways is also described.

Chapter 6 CF topology table

Discusses the layout and the use of the CF topology table.

Chapter 7 Shutdown Facility (SF)

Describes the components and advantages of PRIMECLUSTER SF and provides administration information.

Chapter 8 Diagnostics and troubleshooting

Provides help for troubleshooting and problem resolution for PRIMECLUSTER Cluster Foundation.

Chapter 9 Manual pages

Lists the manual pages for PRIMECLUSTER.

Appendix A Release information

Describes primary changes in this manual.

Related Documentation

The documents listed below provide details about PRIMECLUSTER products.

Note

The PRIMECLUSTER documentation includes the following documentation in addition to those listed above:

  • PRIMECLUSTER Software Release Guide and Installation Guide

    This Software Release Guide and Installation Guide are provided with each PRIMECLUSTER product package.

    The data is stored on "DVD" of each package. For details on the file names, see the documentation.

Manual Series

Manual Printing

If you want to print a manual, use the PDF file found on the DVD for the PRIMECLUSTER product. The correspondences between the PDF file names and manuals are described in the Software Release Guide for PRIMECLUSTER that comes with the product.

Adobe Reader is required to read and print this PDF file. To get Adobe Reader, see Adobe Systems Incorporated's website.

Online Manuals

To allow users to view the online manuals, use the Cluster management server to register each user name to one of the user groups (wvroot, clroot, cladmin, or clmon).

For information on user group registration procedures and user group definitions, see "4.3.1 Assigning Users to Manage the Cluster" in "PRIMECLUSTER Installation and Administration Guide."

Conventions

Notation
Prompts

Command line examples that require system administrator (or root) privileges to execute are preceded by the system administrator prompt, the hash sign (#). Entries that do not require system administrator rights are preceded by a dollar sign ($).

In some examples, the notation node# indicates a root prompt on the specified node. For example, a command preceded by fuji3# would mean that the command was run as user root on the node named fuji3.

The keyboard

Keystrokes that represent nonprintable characters are displayed as key icons such as [Enter] or [F1]. For example, [Enter] means press the key labeled Enter; [Ctrl-b] means hold down the key labeled Ctrl or Control and then press the [B] key.

Typefaces

The following typefaces highlight specific elements in this manual.

Typeface / Symbol

Usage

Constant Width

Computer output and program listings; commands, file names, manual page names and other literal programming elements in the main body of text.

Italic

Variables in a command line that you must replace with an actual value. May be enclosed in angle brackets to emphasize the difference from adjacent text; for example, <nodename>RMS; unless directed otherwise, you should not enter the angle brackets.

The name of an item in a character-based or graphical user interface.

This may refer to a menu item, a radio button, a checkbox, a text input box, a panel, or a window title.

Bold

Items in a command line that you must type exactly as shown.

Example 1

Several entries from an /etc/passwd file are shown below:

sysadm:x:0:0:System Admin.:/usr/admin:/usr/sbin/sysadm
setup:x:0:0:System Setup:/usr/admin:/usr/sbin/setup
daemon:x:1:1:0000-Admin(0000):/:
bin:x:1:1:bin:/bin:/bin/bash
daemon:x:2:2:daemon:/sbin:/bin/bash
lp:x:4:7:lp daemon:/var/spool/lpd:/bin/bash

Example 2

To use the cat command to display the contents of a file, enter the following command line:

$ cat file
Command syntax

The command syntax observes the following conventions.

Symbol

Name

Meaning

[ ]

Brackets

Enclose an optional item.

{ }

Braces

Enclose two or more items of which only one is used. The items are separated from each other by a vertical bar (|).

|

Vertical bar

When enclosed in braces, it separates items of which only one is used. When not enclosed in braces, it is a literal element indicating that the output of one program is piped to the input of another.

( )

Parentheses

Enclose items that must be grouped together when repeated.

...

Ellipsis

Signifies an item that may be repeated. If a group of items can be repeated, the group is enclosed in parentheses.

Notation symbols

Material of particular interest is preceded by the following symbols in this manual:

Point

Contains important information about the subject at hand.

Note

Describes an item to be noted.

Example

Describes operation using an example.

Information

Describes reference information.

See

Provides the names of manuals to be referenced.

Abbreviations

Oracle Solaris might be described as Solaris, Solaris Operating System, or Solaris OS.

PRIMEQUEST 2000/1000 Series are abbreviated as PRIMEQUEST.

Export Controls

Exportation/release of this document may require necessary procedures in accordance with the regulations of your resident country and/or US export control laws.

Trademarks

Red Hat is a trademark of Red Hat, Inc. in the United States and other countries.

Linux is a trademark or registered trademark of Mr. Linus Torvalds in the United States and other countries.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions.

All other hardware and software names used are trademarks of their respective companies.

Requests

Date of publication and edition

September 2015, Seventh edition
August 2016, 7.1 edition
January 2018, 7.2 edition
May 2020, 7.3 edition

Copyright notice

All Rights Reserved, Copyright (C) FUJITSU LIMITED 2008-2020.

Revision History

Revision

Location

Edition

Added the description for the configuration of sharing NIC with administrative LAN and cluster interconnect in the VMware environment.

1.1 CF, CIP, and CIM configuration

7.1

Added the corrective action in case of failure with rcqconfig command.

1.1.7 Example of CF configuration by CLI

Edited the description for Shutdown Daemon (SD).

7.1 Overview

Added "Checking SA status."

7.5.2 Checking SA status

Changed the description of the start CF services status window.

4.6.1 Starting CF

7.2

Changed the description when stopping the CF service.

4.6.2 Stopping CF

Added the note when displaying logs from Cluster Admin.

4.8 Using PRIMECLUSTER log viewer

7.3