Top
PRIMECLUSTER  Installation and Administration Guide 4.5
FUJITSU Software

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.5 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 Configuration Update Service for SA

Audience: All users who use PRIMECLUSTER systems
Contents: This appendix descries Configuration Update Service for SA.

Appendix F 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 G 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 H 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 I 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 J Startup Scripts and Startup Daemons, and Port Numbers in PRIMECLUSTER

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.

Appendix K 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 L Using Firewall

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

Appendix M Cloning the Cluster System Environment

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

Appendix N Changes in Each Version

Audience: All users who use PRIMECLUSTER 4.0A20, 4.1A20, 4.1A30, 4.2A00, 4.2A30, 4.3A00, 4.3A10, 4.3A20, 4.3A30, 4.3A40, 4.4A00, or 4.5A00.
Contents: This appendix describes the changes made to the specifications of PRIMECLUSTER 4.5A10.

Appendix O 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/2000 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 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.

Dell EMC, PowerPath, and NetWorker are registered trademarks or trademarks 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.

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

Requests

Date of publication and edition

December 2017, First edition
August 2018, Second edition
April 2019, 2.1 edition
May 2020, 2.2 edition
August 2020, 2.3 edition

Copyright notice

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

Revision History

Revision

Location

Edition

Changed the description of PRIMECLUSTER Lite Pack (LP).

2.1.1 Product Selection

2.1

Added the procedure when setting the operation mode of the Gds resources.

6.7.3.4 Setting Up Gds Resources

Added the note when PRIMECLUSTER Wizard for NAS is used.

6.7.5 Registering the Cluster Service of a PRIMECLUSTER-compatible product
10.1 Adding cluster applications
10.2.2 Deleting a userApplication
10.3 Changing the Cluster Configuration
10.4 Add Resources
10.5 Deleting a Resource
11.1.1 Changing the Operation Attributes (CUI)

Added the note when starting the system in RHEL6 environment, and changed the note when starting the system in RHEL7 environment.

7.5 Notes on Operation

Changed the procedure when changing the IP address of the public LAN.

9.2.1 Changing the IP Address of the Public LAN

Changed the procedure when changing the IP address of the administrative LAN.

9.2.2 Changing the IP Address of the Administrative LAN

Changed the description of the procedure when restoring the configuration information of GDS.

M.3.4 Restoring the GDS Configuration Information

Added the note when setting management servers of Web-Based Admin View.

4.3.3 Initial Setup of Web-Based Admin View

2.2

Added the note while executing the hvw command.

6.7.1 Starting RMS Wizard

Added the description about the definition of mount points.

6.7.3.2 Setting Up Fsystem Resources

Changed the description of notes when setting a cluster application.

6.10.2 Notes on Configuration

Added the description of timeout values of the Check script.

6.11.2.2.4 Timeout of Check Script

Added the note when creating the Fsystem resource.

6.12.1 Monitoring Fsystem

Added the note when displaying logs from Cluster Admin.

7.1.3.3 Switchlogs and application logs
7.3.4 Viewing Logs Created by the PRIMECLUSTER System

Changed the note when starting the maintenance mode.

7.2.2.6 Entering maintenance mode for Cluster Application

Added "See" for the method of changing the IP address of the administrative LAN used by Web-Based Admin View.

9.2.2 Changing the IP Address of the Administrative LAN

Changed the description when changing the host names in the takeover network resources.

M.3.7.2 When Using the Takeover Network

Added the note if CF is running.

1.7.1 Common Notes on PRIMERGY/PRIMEQUEST

2.3