Top
PRIMECLUSTER  Installation and Administration Guide 4.7

Preface

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.

Flow from PRIMECLUSTER system installation to operation management

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

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.7 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 five parts, appendixes, and a glossary. The contents of each part are described below.

Part 1 Planning

Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes the overall workflow from installation to operation of the PRIMECLUSTER system.

Part 2 Installation

Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes operations for software installation, cluster building, and application building.

Part 3 Operations

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.

Part 4 System Configuration Modifications

Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes necessary work items for additions, modifications, and deletions to the PRIMECLUSTER system configuration.

Part 5 Maintenance

Audience: System administrators who build PRIMECLUSTER systems
Contents: This part describes the items related to the maintenance of the PRIMECLUSTER system.

Appendix A PRIMECLUSTER Products

Audience: Users who operate PRIMECLUSTER products on PRIMECLUSTER systems
Contents: This appendix describes the list of products supported by PRIMECLUSTER systems.

Appendix B Manual Pages

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.

Appendix C Troubleshooting

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.

Appendix D Registering, Changing, and Deleting State Transition Procedure Resources for PRIMECLUSTER Compatibility

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.

Appendix E Setting up Cmdline Resource to Control Guest OS from Cluster Application of Host OS in KVM Environment

Audience: All users who control the guest OS from the cluster application of host OS in a KVM environment

Contents: This appendix describes how to set up the Cmdline resource to control the guest OS from the cluster application of host OS in a KVM environment.

Appendix F Using the Migration Function in KVM Environment

Audience: All users who use the migration function in a KVM Environment
Contents: This appendix describes the procedure for using the migration function in a KVM Environment.

Appendix G Using PRIMECLUSTER in a VMware 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.

Appendix H Using PRIMECLUSTER in RHOSP Environment

Audience: All users who use PRIMECLUSTER systems in RHOSP environment
Contents: This appendix describes the installation procedure for using the PRIMECLUSTER systems in RHOSP environment.

Appendix I Systemd Service and Startup Daemons, and Port Numbers in PRIMECLUSTER

Audience: System administrators who build PRIMECLUSTER systems
Contents: This appendix provides explanations on systemd services and daemons that are started by PRIMECLUSTER, and the port numbers being used.

Appendix J Using Firewall

Audience: All users who use PRIMECLUSTER systems
Contents: This appendix describes the procedure when using Firewall in the PRIMECLUSTER system.

Appendix K Copying the Cluster System Environment

Audience: System administrators who copy PRIMECLUSTER systems
Contents: This appendix describes the procedures for copying the PRIMECLUSTER system.

Appendix L Resident Processes in PRIMECLUSTER and Monitoring Targets

Audience: All users who use PRIMECLUSTER systems
Contents: This appendix describes the resident processes in PRIMECLUSTER and the necessity of monitoring them.

Appendix M Changes in Each Version

Audience: All users who use PRIMECLUSTER 4.6A20 or earlier
Contents: This appendix describes the changes made to the specifications of PRIMECLUSTER 4.7A00.

Appendix N Release Information

Audience: All users who use PRIMECLUSTER systems
Contents: This appendix lists the main changes in this manual

Glossary

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:

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."

Conventions

Notation
Prompts

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 ($).

Manual page section numbers

References to the Linux(R) operating system commands are followed by their manual page section numbers in parentheses - for example, cp(1)

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

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

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
  • Red Hat Enterprise Linux is abbreviated as RHEL.

  • Red Hat Enterprise Linux AS is abbreviated as RHEL-AS.

  • RHEL and RHEL-AS are abbreviated as Linux(R).

  • Red Hat OpenStack Platform is abbreviated as RHOSP.

  • VMware(R) ESXi(TM) is abbreviated as ESXi.

  • VMware vSphere(R) is abbreviated as VMware vSphere.

  • VMware vSphere(R) High Availability is abbreviated as VMware vSphere HA.

  • VMware vSphere(R) Fault Tolerance is abbreviated as VMware vSphere FT.

  • VMware vSphere(R) Distributed Resource Scheduler(TM) is abbreviated as VMware vSphere DRS.

  • VMware vSphere(R) Distributed Power Management (TM) is abbreviated as VMware vSphere DPM.

  • VMware vSphere(R) vMotion(R) is abbreviated as VMware vSphere vMotion.

  • VMware vSAN(TM) is abbreviated as VMware vSAN.

  • VMware vSphere(R) Storage vMotion(R) is abbreviated as VMware vSphere Storage vMotion.

  • VMware(R) vCenter(TM) Converter(TM) is abbreviated as VMware vCenter Converter.

  • PRIMEQUEST 3000 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 and Red Hat Enterprise Linux are registered trademarks of Red Hat, Inc. in the U.S. and other countries.

Linux(R) is the registered trademark of Linus Torvalds in the U.S. and other countries.

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

Microsoft, Internet Explorer, and Windows are trademarks of the Microsoft group of companies.

Dell EMC, PowerPath, and NetWorker are trademarks of Dell Inc. or its subsidiaries.

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

Other product names are product names, trademarks, or registered trademarks of these companies.

Requests

Date of publication and edition

February 2023, First edition
July 2023, Second edition
June 2024, 2.1 edition

Copyright notice

Copyright Fujitsu Limited 2023-2024.

Revision History

Revision

Location

Edition

Deleted the description of VMware's cloning function.

K.1.1 Copying Method for the System
K.4.1 Creating the Physical/Virtual Machine/Cloud Environment

2.1

Added the reference location.

K.1.2 Copying Method for System Disk Mirroring (GDS)
K.1.3 Copying Method for Data Disk (GDS)

Moved the description for the network, OS, disk, takeover IP address, and other MW settings after copying the system image.

K.2 Overview of Copying Procedure for the Cluster System
K.4.2 Copying System Image
K.4.3 Copying Disk Data
K.5 Changing Cluster System Settings
K.5.4 Setting up an FJcloud-O environment
K.5.5 Setting up in Single-User Mode

Added the description for the case when GLS is used.

K.3.6 Preparing for the Cloud Environment

Changed the description.

K.5.2 Adding and Deleting the OS Status Notification and/or HBA Blockage Function

Added the description for the case when the I/O fencing function is used at the source but not at the destination.

K.5.3 Setting up a VMware environment

Added the following description to the process of changing the IP address of the virtual interface:
- Procedure for cloud environments
- Reference for changing the IP address of virtual interfaces

K.5.5 Setting up in Single-User Mode