This manual serves as your starting point for using PRIMECLUSTER. It explains the workflow of the series of operations from installation to operation management of the PRIMECLUSTER system. Since the PRIMECLUSTER system comprises multiple features, there are several other manuals besides this one for each feature. However, by reading this manual first, you will be able to perform the series of operations because this manual refers readers to other manuals that contain feature-specific information that is necessary for the operations.
This manual also provides a functional overview of products that are supported by the PRIMECLUSTER system and describes operation procedures.
This manual only covers the basic operation of PRIMECLUSTER. For operations using different hardware and software configurations, see "Related Documentation."
The table below shows the operation flow from PRIMECLUSTER installation to the start of operation management and indicates the reference location in this manual for each operation.
PRIMECLUSTER system operation flow | Reference location in this manual |
|---|---|
1. Understanding the flow of PRIMECLUSTER system building and designing the PRIMECLUSTER system | Part 1 Planning |
2. Installing the PRIMECLUSTER system | Part 2 Installation |
3. Monitoring the operation status of the PRIMECLUSTER system | Part 3 Operations |
4. Changing the PRIMECLUSTER system configuration after system operation has been started | Part 4 System Configuration Modifications |
5. Maintaining the PRIMECLUSTER system | Part 5 Maintenance |
6. Installing products for the PRIMECLUSTER system | Part 6 PRIMECLUSTER Products |
For detailed procedural explanations, refer to the reference manuals that are indicated in the target location of each part.
Target Readers
This manual is intended for all users who use PRIMECLUSTER 4.3 and perform cluster system installation and operation management. It is also intended for programmers who develop applications that operate on PRIMECLUSTER.
Configuration of This Documentation
This manual consists of six parts, appendixes, and a glossary. The contents of each part are described below.
Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes the overall workflow from installation to operation of the PRIMECLUSTER system.
Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes operations for software installation, cluster building, and application building.
Audience: System administrators who manage system operations
Contents: This part describes operation methods for operations such as monitoring the PRIMECLUSTER system and investigating failure causes.
Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes necessary work items for additions, modifications, and deletions to the PRIMECLUSTER system configuration.
Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes the items related to the maintenance of the PRIMECLUSTER system.
Audience: Users who operate PRIMECLUSTER products on PRIMECLUSTER systems
Contents: This part describes the versions and levels of products that are supported by the PRIMECLUSTER system and provides a functional overview of those products.
Audience: Users who design PRIMECLUSTER systems
Contents: This appendix contains the PRIMECLUSTER System Design Worksheet.
Audience: All users who use PRIMECLUSTER systems
Contents: This appendix describes the online manual pages that are used by the individual features of the PRIMECLUSTER system.
Audience: All users who use PRIMECLUSTER systems
Contents: This appendix describes corrective actions for problems that may occur in the PRIMECLUSTER system. It also explains how to collect data when requesting a problem investigation.
Audience: All users who use PRIMECLUSTER-compatible resources
Contents: This appendix describes procedures for registering, changing, and deleting procedure resources when the cluster applications use procedure resources.
Audience: All users who use PRIMECLUSTER systems
Contents: This appendix descries Configuration Update Service for SA.
Audience: All users who use PRIMECLUSTER systems in a KVM environment
Contents: This appendix describes the installation procedures for using the PRIMECLUSTER system in a KVM environment.
Audience: All users who use PRIMECLUSTER systems in a VMware environment
Contents: This appendix describes the installation procedures for using the PRIMECLUSTER system in a VMware environment.
Audience: System administrators who build PRIMECLUSTER systems
Contents: This appendix provides explanations on scripts and daemons that are started by PRIMECLUSTER, and the port numbers being used.
Audience: All users who use PRIMECLUSTER systems
Contents: This appendix describes the procedure when using Firewall in the PRIMECLUSTER system.
Audience: All users who use PRIMECLUSTER 4.0A20, 4.1A20, 4.1A30, 4.2A00, 4.2A30, 4.3A00, 4.3A10, or 4.3A20
Contents: This appendix describes the changes made to the specifications of PRIMECLUSTER 4.3A30.
Audience: All users who use PRIMECLUSTER systems
Contents: This appendix describes the main changes of this manual.
Audience: All users who use PRIMECLUSTER systems
Contents: This section explains terms used to describe the PRIMECLUSTER system.
Related Documentation
Refer to the following manuals as necessary when setting up the cluster:
PRIMECLUSTER Concepts Guide
PRIMECLUSTER Cluster Foundation (CF) Configuration and Administration Guide
PRIMECLUSTER Reliant Monitor Services (RMS) with Wizard Tools Configuration and Administration Guide
PRIMECLUSTER Global Disk Services Configuration and Administration Guide
PRIMECLUSTER Global File Services Configuration and Administration Guide
PRIMECLUSTER Global Link Services Configuration and Administration Guide : Redundant Line Control Function
PRIMECLUSTER Web-Based Admin View Operation Guide
PRIMECLUSTER Messages
PRIMECLUSTER Wizard for Oracle Configuration and Administration Guide
Interstage Application Server Reference Manual - Command Edition
Interstage Application Server Operator's Guide
PRIMEQUEST 1000 Series User Interface Operating Instructions
PRIMEQUEST 1000 Series Message Reference
PRIMEQUEST 1000 Series Tool Reference
PRIMEQUEST 1000 Series Installation Manual
PRIMEQUEST 1000 Series Administration Manual
PRIMEQUEST 1000 Series ServerView Mission Critical Option User Manual
PRIMEQUEST 1000 SERIES HBA blockage function USER'S GUIDE
PRIMEQUEST 2000 Series Tool Reference
PRIMEQUEST 2000 Series Installation Manual
PRIMEQUEST 2000 Series ServerView Mission Critical Option User Manual
PRIMEQUEST 2000 Series HBA blockage function USER'S GUIDE
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 "CD" 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 CD-ROM 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".
Conventions
Command line examples that require system administrator (or root) rights 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 ($).
References to the Linux(R) operating system commands are followed by their manual page section numbers in parentheses - for example, cp(1)
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.
The following typefaces highlight specific elements in this manual.
Typeface | 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 that you must replace with an actual value. |
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:
root:x:0:0:root:/root:/bin/bash
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(1) command to display the contents of a file, enter the following command line:
$ cat file
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.
Red Hat Enterprise Linux is abbreviated as RHEL.
Red Hat Enterprise Linux AS is abbreviated as RHEL-AS.
Red Hat Enterprise Linux ES is abbreviated as RHEL-ES.
RHEL-AS and RHEL-ES are abbreviated as Linux(R).
VMware(R) ESX(R) is abbreviated as ESX.
VMware(R) ESXi(TM) is abbreviated as ESXi.
If you use ESXi, read "ESX" as "ESXi."
VMware vSphere(R) is abbreviated as VMware vSphere.
VMware vSphere(R) High Availability is abbreviated as VMware HA.
VMware vSphere(R) Fault Tolerance is abbreviated as VMware FT.
VMware vSphere(R) Distributed Resource Scheduler(TM) is abbreviated as VMware DRS.
VMware vSphere(R) vMotion(R) is abbreviated as VMware vMotion.
VMware vSphere(R) Storage vMotion(R) is abbreviated as VMware Storage vMotion.
VMware(R) vCenter(TM) Converter(TM) is abbreviated as VMware vCenter Converter.
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 registered trademark of Red Hat, Inc. in the U.S. and other countries.
Linux is a registered trademark of Linus Torvalds.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Microsoft, Windows, and Internet Explorer are registered trademarks of Microsoft Corporation in the United States and other countries.
CORBA, OMG, and ORB are registered trademarks of Object Management Group (OMG).
NetWorker is a registered trademark or trademark of EMC Corporation in the United States and other countries.
VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions.
PRIMECLUSTER is a registered trademark of Fujitsu Limited.
Other product names are product names, trademarks, or registered trademarks of these companies.
Requests
No part of this documentation may be reproduced or copied without permission of FUJITSU LIMITED.
The contents of this documentation may be revised without prior notice.
Date of publication and edition
February 2014, Eighth edition |
Copyright notice
All Rights Reserved, Copyright (C) FUJITSU LIMITED 2008-2016.
Revision | Location | Edition |
|---|---|---|
Added notes on the virtual machine function. | 2.2.1 Virtual Machine Function | 8.1 |
Added the series name to indicate PRIMEQUEST. | 2.2.1 Virtual Machine Function | |
Modified descriptions of the CF node name. | 5.1.1 Setting Up CF and CIP | |
Added explanation of how to create a shared disk configuration file in "Registering a shared disk". | 5.1.3.2 Registering Hardware Devices | |
Changed explanation of processing after setting up GLS. | 6.2.1 GLS Setup | |
Added the reference to set up Online/Offline scripts. | 6.6 Setting Up Online/Offline Scripts | |
Modified the display example of the hvw command. | 6.7.2.1 Creating Standby Cluster Applications | |
Added the note on "Configuration-Activate". | 6.7.4 Generate and Activate | |
Changed how to add a shared disk device. | 8.12.1.1 Adding a shared disk device | |
Changed the description of the operation environment for Configuration Update Service for SA. | E.2 Operation Environment | |
Changed notes on the cluster system in a VMware environment. | G.1 Cluster Systems in a VMware Environment | |
Changed descriptions of how to configure the /etc/hostid file to run I/O fencing properly. | G.2.1.1 Installation and Configuration of Related Software | |
Changed descriptions of how to set up the shutdown facility. | G.2.3.2 Setting Up the Shutdown Facility | |
Changed the description of the utilized port of S13SMAWsf. | H.2 Startup Script Lists | |
Changed descriptions of information on incompatibility. | Appendix J Changes in Each Version | |
Changed the supported hardware devices. | 1.7.2 Notes on PRIMERGY | 8.2 |
Added and changed the notes on Xen, KVM, and VMware environments. | 2.2.1 Virtual Machine Function | |
Added the description about the settings when performing immediate cluster failover if an I/O device where the system volume is allocated fails in the ext3 or the ext4 file system. | 3.1.3 Setting Up Disk Units | |
Added the remark to "Prerequisites for the IPMI shutdown agent settings." | 3.1.6.1 PRIMERGY | |
Added the description to the kdump settings. | 3.3 PRIMECLUSTER Installation | |
Deleted the note on displaying the Web-Based Admin View GUI screen. | 4.3.2 Preparing the Client Environment | |
Added the note on the initial setup of Web-Based Admin View. | 4.3.3 Initial Setup of Web-Based Admin View | |
Added the note on the calculation for the survival priority. | 5.1.2.2 Survival priority | |
Changed the description when displaying a message to a console and also how to start the console. | 5.2 Setting Up Fault Resource Identification and Operator Intervention Request | |
Added the note on setting up Cmdline resources. | 6.7.3.1 Setting Up Cmdline Resources | |
Changed the setting procedure and the note of an Fsystem resource. | 6.7.3.2 Setting Up Fsystem Resources | |
Changed the contents of setting file definition for the cluster. | 6.7.3.6 Setting Up Takeover Network Resources | |
Added the notes on exclusive relationships between cluster applications. | 6.7.7 Exclusive Relationships Between Cluster | |
Added "Environment Variables that can be referred to within the Check Scripts." | 6.11.2.2.2 Environment Variables that can be referred to within the Check Scripts | |
Added "File System on the Shared Disk Device." | 6.12.4 File System on the Shared Disk Device | |
Changed the description of notes on operation. | 7.5 Notes on Operation | |
Added and changed the tables and notes of cron processing. | 7.7 cron Processing | |
Changed the procedure for adding, deleting, and changing shared disk devices. | 8.12.1.1 Adding a shared disk device | |
Changed the worksheets. | A.8 Cluster Application Configuration Worksheets | |
Added the note on changing the registration information of a procedure resource. | D.2.3 Changing registration information of a procedure resource | |
Added and changed the node on the cluster system in a VMware environment. | G.1 Cluster Systems in a VMware Environment | |
Changed the setting contents for the installation of VMware vSphere. | G.2.1.1 Installation and Configuration of Related Software | |
Added the service names, to be supported to port numbers, to Remarks. | H.2 Startup Script Lists | |
Added S06clonltrc to /etc/rc3.d. | H.2 Startup Script Lists | |
Changed the description when changing the configuration of iptables described in Note. | Appendix I Using Firewall | |
Deleted the description about RSB. | 1.7.2 Notes on PRIMERGY | 8.3 |
Added the note to assign the iRMC user to the Administrator permission group when using the IPMI shutdown agent. | 1.7.2 Notes on PRIMERGY | |
Added the note when building the cluster system between guest OSes on multiple host OSes without using Host OS failover function. | 2.2.1 Virtual Machine Function | |
Added the note to the procedure when setting the kdump shutdown agent. | 3.1.6.1 PRIMERGY | |
Added the GDS modules to the settings of blacklist. | 3.3 PRIMECLUSTER Installation | |
Added the note about kdump_post in /etc/kdump.conf. | 3.3 PRIMECLUSTER Installation | |
Added the note when using a bonding device as the cluster interconnect. | 5.1.1 Setting Up CF and CIP | |
Changed the note about survival priority. | 5.1.2.2 Survival priority | |
Added the note when setting the kdump shutdown agent. | 5.1.2.3.4 kdump | |
Added the note when executing "sdtool -s" after starting the shutdown facility, and when starting the MMB asynchronous monitoring daemon for the first time. | 5.1.2.4.1 MMB | |
Added the note when using RMS. | Chapter 6 Building Cluster Applications | |
Changed the note about the environment variables used with the scripts. | 6.6 Setting Up Online/Offline Scripts | |
Added the note when creating the userApplication name. | 6.7.2 Setting Up userApplication | |
Added the information about the scripts that can be registered to userApplication. | 6.7.2.1 Creating Standby Cluster Applications | |
Added the note when "none" is set to StopCommands. | 6.7.3.1 Setting Up Cmdline Resources | |
Added the notes about the directory paths specified as mount points. | 6.7.3.2 Setting Up Fsystem Resources | |
Added the description about "Timeout of Check Script." | 6.11.2.2.4 Timeout of Check Script | |
Changed the note about the environment variables used with the scripts. | 6.11.3 Notes on Scripts | |
Added the note about the status icon of userApplication in maintenance mode. | 7.1.3.1 RMS Tree | |
Added the attribute to be used as a resource name to "Contents to be changed" of "When a cluster application that is performing standby operation is to be changed." | 8.1 Changing the Cluster Configuration | |
Added the procedure to change the settings of SF when SA_icmp is used. | 8.3 Changing a CIP Address | |
Added the note when all userApplications are deleted. | 8.7.3 Deleting a userApplication | |
Added the note when setting kernel parameters. | A.6.2 RMS Configuration | |
Added CheckCommandsTimeouts object. | A.10.1 Cmdline Resource Worksheet | |
Changed the procedure on how to change the startup priority of the state transition procedure. | D.2.2 Changing the Startup Priority of a State Transition Procedure | |
Changed the procedure on how to change the registration information of a procedure resource. | D.2.3 Changing registration information of a procedure resource | |
Changed the condition of the path policy for Native Multipathing (NMP). | G.1 Cluster Systems in a VMware Environment | |
Changed the description about the forcible stop by using the I/O fencing function. | G.1 Cluster Systems in a VMware Environment | |
Added the note about hot swap of the virtual machine software. | G.1 Cluster Systems in a VMware Environment | |
Changed the description about the settings of the virtual network when installing VMware vSphere. | G.2.1.1 Installation and Configuration of Related Software | |
Added the note when bundling the network specified to the interconnect by using NIC teaming of VMware. | G.2.1.1 Installation and Configuration of Related Software | |
Added and changed the description about the settings. | G.2.1.1 Installation and Configuration of Related Software | |
Added the note about PRIMECLUSTER operations. | G.4 Operations | |
Added the following scripts to /etc/rc3.d. | H.2 Startup Script Lists | |
Changed the utilized ports of S13SMAWsf. | H.2 Startup Script Lists | |
Changed the Communication target of utilized port for S99fjsvwvcnf. | H.2 Startup Script Lists | |
Changed the description of "Changes" of hvshut command. | Appendix J Changes in Each Version |
