Top
PRIMECLUSTERGlobal Disk Services Configuration and AdministrationGuide 4.3
FUJITSU Software

Preface

This manual describes the function, setting up, and managing of the following software:

Software (Feature)

Abbreviation

Description

Global Disk Services

GDS

Volume management software provided by PRIMECLUSTER.

Global Disk Services Snapshot

GDS Snapshot

Optional software of GDS provided by PRIMECLUSTER GDS Snapshot.


Purpose

This manual aims to help users understand GDS and GDS Snapshot, including environment configuration, operation and maintenance.


Target Reader

This manual is devoted to all users who will operate and manage GDS and GDS Snapshot and programmers who will create applications running in GDS environments.


Organization

This manual consists as follows:

"YES" in the Operator or Administrator column indicates who would benefit from reading that portion.

Headers

Contents

Operator

Administrator

Chapter 1
Functions

Explains the features of GDS and GDS Snapshot.

YES

YES

Chapter 2
Objects

Explains the objects used by GDS and GDS Snapshot.

YES

YES

Chapter 3
Starting and Exiting GDS Management View

Explains how to start and exit GDS Management and the required browser environment.

YES

YES

Chapter 4
Management View Screen Elements

Explains the contents of Management View.

YES

YES

Chapter 5
Operation

Explains the details about GDS operation such as operation flow, settings, maintenance and management.

YES

YES

Chapter 6
Backing Up and Restoring

Explains how to back up and restore data on disks managed by GDS.

YES

YES

Chapter 7
How to Set and Cancel System Disk Mirroring Using Commands

Explains how to set and cancel a system disk using commands.

-

YES

Appendix A
General Notes

Explains guidelines, general precautions, and configuration tips necessary for using GDS.

-

YES

Appendix B
Log Viewing with Web-Based Admin View

For details, see the supplementary "Web-Based Admin View Operation Guide."

-

YES

Appendix C
Web-Based Admin View Operating Environment Setting

For details, see the supplementary "Web-Based Admin View Operation Guide."

YES

YES

Appendix D
Command Reference

Explains the commands available in GDS and GDS Snapshot.

-

YES

Appendix E
GDS Messages

Explains the contents, possible causes, and resolutions for GDS messages that appear when setting or operating GDS and GDS Snapshot.

YES

YES

Appendix F
Troubleshooting

Explains resolutions for abnormality of objects and physical disks managed by GDS.

-

YES

Appendix G
Frequently Asked Questions (FAQ)

Lists frequently asked questions regarding GDS and GDS Snapshot.

YES

YES

Appendix H
Server and Storage Migration

Explains how to migrate servers and storage to new units on the system where GDS is used.

YES

YES

Appendix I
Disaster Recovery

Explains how to configure and operate the disaster recovery system where GDS is used.

YES

YES

Appendix J
Cloning

Explains how to clone the existing system on which GDS is installed and set to create another system.

YES

YES

Appendix K
Startup Scripts and Startup Daemons in GDS

Explains the GDS startup script and startup daemon.

-

YES

Appendix L
SMF Services and Port Numbers in GDS

Explains the SMF service and startup daemon and the port number used in GDS.

-

YES

Appendix M
Release Information

Explains new features, manual update details, and changes in specifications of GDS and GDS Snapshot, depending on the versions.

YES

YES

Glossary

Explains GDS and GDS Snapshot terminology. Please refer to it as necessary.

YES

YES

GDS: Global Disk Services
GDS Snapshot: Global Disk Services Snapshot


Related documentation

Please refer to the following documents according to need.

Manual Printing

Use the PDF file to print this manual.

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


Symbol

The following conventions are used in this manual:

Section numbers for
Solaris 11.3 or earlier

Section numbers for
Solaris 11.4 or later

Contents

1M

8

System Maintenance/Administration Commands

4

5

File Formats

5

7

Others

7

4

Device Special Files

Point

Main points are explained.

Note

Items that require attention are explained.

Information

Useful information is given.

See

Manual names and sections of this manual you should refer to are given.


Abbreviated name

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

Microsoft and Windows are registered trademarks of Microsoft Corporation, in the United States and other countries.

All other trademarks are property of their respective owners.

Window images are used according to the guidelines given by Microsoft Corporation.

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

Dell EMC, EMC, PowerPath, SAN Manager, SRDF, Symmetrix and TimeFinder are trademarks or registered trademarks of EMC Corporation.

Other product names that appear in this manual are product names, trademarks, or registered trademarks of respective companies.


Notice

Date of publication and edition

June 2015, Fourth edition
July 2015, 4.1 edition
December 2015, 4.2 edition
April 2017, 4.3 edition
April 2019, 4.4 edition


All Rights Reserved, Copyright (C) FUJITSU LIMITED 2012-2019.

Revision History

Revision

Location

Edition

SAS3.0(12Gbps SAS) is supported.

5.3.4 Disk Swap
6.1.2 Restoring
7.1 System Disk Mirroring in a ZFS Boot Environment (GDS Mirroring)
7.2 System Disk Mirroring in a ZFS Boot Environment (ZFS Mirroring)
A.2.17 Swapping Disks (SAS)
E.4.1 Error Messages (60000-60499)
F.1.5 System Disk Abnormality

4.1

Changed the descriptions of the error message "device is MPxIO disabled".

A.2.1 Physical Disk Driver

Changed the descriptions of Note.

F.3.1 sdxsystem - Enforced Cancellation of System Disk Mirroring

Added the description to the note "In PRIMECLUSTER systems."

5.1 Operation Outline

4.2

Added the description regarding the procedure to change the class name of the class registered in the cluster application.

5.4.1 Class Configuration

Added the necessary procedure when the file system is created on the volume.

5.5.2 Removing a Volume

Added the note "Permission of the /etc/vfstab file and the /etc/system file."

6.3.6 Backing Up

Removed an unnecessary step of restarting the system.

6.6.3 Restoring from Backup Disks

Added the note to "How to swap the system disk which is mirrored by ZFS mirroring."

A.2.9 System Disk Mirroring in a ZFS Boot Environment

Added the descriptions of the procedure when upgrading Dell EMC PowerPath.

A.2.26 Upgrading Procedure for Dell EMC PowerPath

Added the descriptions to "Explanation" and "Resolution" of the internal error message 26000.

E.2.4 Internal Error Messages (26000)

Changed the section title.

F.1.8 Errors in Dell EMC Storage Units

Added the descriptions of the procedure when restoring the file system on the volume.

F.1.10 File System Related Errors

Changed the procedure to delete the configuration information of the local class.

J.5 Setting up Copy Destination System

Added the note "High-capacity EFI label disk."

5.2 Settings
D.2 sdxdisk - Disk operations

4.3

Changed the command to delete resources.

5.2.3.1 Class Configuration
5.2.3.2 Cluster System Class Configuration
A.2.18 Swapping Disks (SAS)
H.2.1 Using the GDS Snapshot Online Disk Migration
H.2.2 Using the Copy Function of Storage Units and the sdxconfig Command

Added the reference "Disk size."

5.2.3.4 Volume Configuration

Added the note "Initialization of mirror disk."

6.1.2 Restoring

Deleted the description of PRIMEPOWER. "

6.1.2 Restoring
A.2.9 System Disk Mirroring
F.1.5 System Disk Abnormality

Changed the procedure on how to check the physical slice name.

6.2.1 Backing Up
6.2.2 Restoring (When the System Can Be Booted)
6.2.3 Restoring (When the System Cannot Be Booted)

Added a procedure for cluster system.

6.6.3 Restoring from Backup Disks

Added a procedure to attach label to the disk to be restored.

6.6.3 Restoring from Backup Disks

Added "A.2.6 Group Size."

A.2.6 Group Size

Added a description of root class to "Size of a private slice."

A.2.7 Disk Size

Added "Registration/deletion of high-capacity EFI label disk."

A.2.7 Disk Size

Deleted the description of Solaris 32 bit.

A.2.11 Keep Disk

Changed the procedure for specifying device name of the new disk.

A.2.18 Swapping Disks (SAS)

Added "A.2.25 Excluded Device List."

A.2.25 Excluded Device List

Added the explanation of Excluded Device List in GDS.

A.2.26 To Use Dell EMC Storage Units

Added a note when performing live migration.

A.2.39 Usage in Oracle VM Environment

Added a note when using GDS on both service domain and guest domain.

A.2.39 Usage in Oracle VM Environment

Added a note about hot spare function.

A.2.39 Usage in Oracle VM Environment

Added a description "How to use GDS in kernel zones."

A.2.40 Usage in Solaris Kernel Zones Environment

Added a description when installing GDS a message is output.

E.3.1 Halt Messages (40000-40099)

Added a description when installing GDS an internal error message is output.

E.3.5 Internal Error Messages (48000)

Changed the description of "Resolution" in "(4) System cannot be booted (Failure in all boot disk devices)." on how to check physical disk name.

F.1.5 System Disk Abnormality

Changed the procedure on how to start the cluster application indicated in "Resolution" of "(5) The disk space of a file system on a shared disk is "Full" (100%)."

F.1.9 Cluster System Related Error

Added a procedure to attach disk label to the storage of migration destination.

H.2.2 Using the Copy Function of Storage Units and the sdxconfig Command

Added descriptions to startup scripts and startup daemons in GDS.

Appendix K Startup Scripts and Startup Daemons in GDS

Added descriptions to SMF services and port number in GDS.

Appendix L SMF Services and Port Numbers in GDS

Changed the descriptions of host name.

3.2.1 Starting Web-Based Admin View Operation Menu

4.4

Changed the Note "When the Web-Based Admin View does not start."

3.2.1 Starting Web-Based Admin View Operation Menu

Added the Note "Confirmation before system disk settings."

5.2.1 System Disk Settings

Added the Note "Confirmation after completion of system disk settings."

5.2.1 System Disk Settings

Added the Note "Swapping the system disk which is mirrored by ZFS mirroring."

5.3.4 Disk Swap

Added the preconditions for volume name change to the Note "Preconditions for Changing Volume Attributes."

5.4.3 Volume Configuration

Changed the Note "Changes in Special File Path Name by Changing Volume Name."

5.4.3 Volume Configuration

Added the descriptions of settings necessary for backing up and before/after restoring systems using the shared class or local class.

6.1 Necessary Operations for Backing Up/Restoring System Disk

Added the procedures necessary when using the shared class or local class.

6.2.1 Backing Up
6.2.2 Restoring
6.3.1 Backing Up
6.3.2 Restoring (When the System Can Be Booted)
6.3.3 Restoring (When the System Cannot Be Booted)

Added the procedure for Solaris 11.4 or later.

6.2.2 Restoring
7.1.2.2 Procedure for System Disk Mirroring Cancellation (ZFS Boot Environment: GDS Mirroring)
7.2.1.2 Procedure for System Disk Mirroring Settings (ZFS Boot Environment: ZFS Mirroring)
7.2.2.2 Procedure for System Disk Mirroring Cancellation (ZFS Boot Environment: ZFS Mirroring)

Added the procedures necessary for the cluster system.

6.9.2 Restoring

Added the Note "SAN Boot Environment for Solaris 11.4 or Later."

Chapter 7 How to Set and Cancel System Disk Mirroring Using Commands

Added the Note "Confirmation and information collection before/after the system disk mirroring settings."

7.3 System Disk Mirroring in a UFS Boot Environment

Changed the note for MPxIO.

A.2.1 Physical Disk Driver

Added the note for the SAN boot environment (FC connection) for Solaris 11.4 or later to the Note.

A.2.1 Physical Disk Driver

Changed the procedures to also apply to upgrading the ETERNUS Multipath Driver.

A.2.28 Upgrading Procedure for Multipath Software

Added "Capacity Expansion of Disk Registered in the Class."

A.2.30 Online Volume Expansion

Added the descriptions that specifying the -N option is required for the zpool import command execution to "If using ZFS with a local class."

A.2.42 If using ZFS

Added the section numbers in the manual page to the command list.

Appendix D Command Reference

Added the Note "When seeing the manual page of the commands for this product by using the man(1) command."

Appendix D Command Reference

Changed the descriptions of scope sub options.

D.2 sdxdisk - Disk operations
D.7 sdxattr - Set objects attributes

Added the notes of multiple and consecutive executions to "DESCRIPTION."

D.6 sdxinfo - Display object configuration and status information

Added the descriptions of cluster system to the descriptions of PRIMARY OPTIONS -S.

D.12 sdxparam - Configuration parameter operations

Changed the descriptions of configuration parameter copy_delay.

D.12 sdxparam - Configuration parameter operations

Changed the procedure for the error message 60126.

E.4.1 Error Messages (60000-60499)

Changed the descriptions of the error message 60368.

E.4.1 Error Messages (60000-60499)

Changed the explanation and resolution for the warning message 5123.

E.5.2 Warning Messages (5000,5100-5199)

Changed the resolution when the cause of disk failure is "(1) Disk is in DISABLE status."

F.1.2 Disk Status Abnormality

Added the procedure for the case in which MPxIO is

disabled to the system disk when the system is started from the CD-ROM device in "(4) System cannot be booted (Failure in all boot disk devices)."

F.1.5 System Disk Abnormality

Added the procedure for Solaris 11.4 or later to the [Restoring] for "(4) System cannot be booted (Failure in all boot disk devices)."

F.1.5 System Disk Abnormality

Added the procedure for Solaris 11.4 or later to the "Resolution" for "(7) System cannot be booted in a ZFS Boot Environment (Abnormality of root class private slice)."

F.1.5 System Disk Abnormality

Changed the description of sdxsnap.sh.

F.2 Collecting Investigation Material
F.2.2 Collecting Investigation Material with sdxsnap.sh Script

Changed the procedures.

I.1 Building a Disaster Recovery System

I.3 Switching to a Disaster Recovery System

I.4 Restoration to the Operation System from a Disaster Recovery System

Added the descriptions to the procedure of "Data Synchronization of Operation System and Disaster Recovery System."

I.2 Data Synchronization of Operation System and Disaster Recovery System

Added the note "Unified Archives."

J.4 Copying Disk Data

GDS: Global Disk Services
GDS Snapshot: Global Disk Services Snapshot