EVMS User Guide

Christine Lorenz


Joy Goodreau


Kylie Smith


Special Notices

The following terms are registered trademarks of International Business Machines corporation in the United States and/or other countries: AIX, OS/2, System/390. A full list of U.S. trademarks owned by IBM may be found at http://www.ibm.com/legal/copytrade.shtml.

Intel is a trademark or registered trademark of Intel Corporation in the United States, other countries, or both.

Windows is a trademark of Microsoft Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Other company, product, and service names may be trademarks or service marks of others.

This document is provided "AS IS," with no express or implied warranties. Use the information in this document at your own risk.

License Information

This document may be reproduced or distributed in any form without prior permission provided the copyright notice is retained on all copies. Modified versions of this document may be freely distributed provided that they are clearly identified as such, and this copyright is included intact.

Table of Contents
1. What is EVMS?
1.1. Why choose EVMS?
1.2. The EVMS user interfaces
1.3. EVMS terminology
1.4. What makes EVMS so flexible?
1.5. Plug-in layer definitions
2. Using the EVMS interfaces
2.1.1. Using context sensitive and action menus
2.1.2. Saving changes
2.1.3. Refreshing changes
2.1.4. Using the GUI "+"
2.1.5. Using the accelerator keys
2.2. EVMS Ncurses interface
2.2.1. Navigating through EVMS Ncurses
2.2.2. Saving changes
2.3. EVMS Command Line Interpreter
2.3.1. Using the EVMS CLI
2.3.2. Notes on commands and command files
3. The EVMS log file and error data collection
3.1. About the EVMS log file
3.2. Log file logging levels
3.3. Specifying the logging levels
4. Viewing compatibility volumes after migrating
4.1. Using the EVMS GUI
4.2. Using Ncurses
4.3. Using the CLI
5. Obtaining interface display details
5.1. Using the EVMS GUI
5.2. Using Ncurses
5.3. Using the CLI
6. Adding and removing a segment manager
6.1. When to add a segment manager
6.2. Types of segment managers
6.2.1. DOS Segment Manager
6.2.2. GUID Partitioning Table (GPT) Segment Manager
6.2.3. S/390 Segment Manager
6.2.4. Cluster segment manager
6.2.5. BSD segment manager
6.2.6. MAC segment manager
6.2.7. BBR segment manager
6.3. Adding a segment manager to an existing disk
6.4. Adding a segment manager to a new disk
6.5. Example: add a segment manager
6.5.1. Using the EVMS GUI
6.5.2. Using Ncurses
6.5.3. Using the CLI
6.6. Removing a segment manager
6.7. Example: remove a segment manager
6.7.1. Using the EVMS GUI context sensitive menu
6.7.2. Using Ncurses
6.7.3. Using the CLI
7. Creating segments
7.1. When to create a segment
7.2. Example: create a segment
7.2.1. Using the EVMS GUI
7.2.2. Using Ncurses
7.2.3. Using the CLI
8. Creating a container
8.1. When to create a container
8.2. Example: create a container
8.2.1. Using the EVMS GUI
8.2.2. Using Ncurses
8.2.3. Using the CLI
9. Creating regions
9.1. When to create regions
9.2. Example: create a region
9.2.1. Using the EVMS GUI
9.2.2. Using Ncurses
9.2.3. Using the CLI
10. Creating drive links
10.1. What is drive linking?
10.2. How drive linking is implemented
10.3. Creating a drive link
10.4. Example: create a drive link
10.4.1. Using the EVMS GUI
10.4.2. Using Ncurses
10.4.3. Using the CLI
10.5. Expanding a drive link
10.6. Shrinking a drive link
10.7. Deleting a drive link
11. Creating snapshots
11.1. What is a snapshot?
11.2. Creating snapshot objects
11.3. Example: create a snapshot
11.3.1. Using the EVMS GUI
11.3.2. Using Ncurses
11.3.3. Using the CLI
11.4. Reinitializing a snapshot
11.4.1. Using the EVMS GUI or Ncurses
11.4.2. Using the CLI
11.5. Expanding a snapshot
11.5.1. Using the EVMS GUI or Ncurses
11.5.2. Using the CLI
11.6. Deleting a snapshot
11.7. Rolling back a snapshot
11.7.1. Using the EVMS GUI or Ncurses
11.7.2. Using the CLI
12. Creating volumes
12.1. When to create a volume
12.2. Example: create an EVMS native volume
12.2.1. Using the EVMS GUI
12.2.2. Using Ncurses
12.2.3. Using the CLI
12.3. Example: create a compatibility volume
12.3.1. Using the GUI
12.3.2. Using Ncurses
12.3.3. Using the CLI
13. FSIMs and file system operations
13.1. The FSIMs supported by EVMS
13.1.1. JFS
13.1.2. XFS
13.1.3. ReiserFS
13.1.4. Ext2/3
13.1.5. SWAPFS
13.1.6. OpenGFS
13.1.7. NTFS
13.2. Example: add a file system to a volume
13.2.1. Using the EVMS GUI
13.2.2. Using Ncurses
13.2.3. Using the CLI
13.3. Example: check a file system
13.3.1. Using the EVMS GUI
13.3.2. Using Ncurses
13.3.3. Using the CLI
14. Clustering operations
14.1. Rules and restrictions for creating cluster containers
14.2. Example: create a private cluster container
14.2.1. Using the EVMS GUI
14.2.2. Using Ncurses
14.2.3. Using the CLI
14.3. Example: create a shared cluster container
14.3.1. Using the EVMS GUI
14.3.2. Using Ncurses
14.3.3. Using the CLI
14.4. Example: convert a private container to a shared container
14.4.1. Using the EVMS GUI
14.4.2. Using Ncurses
14.4.3. Using the CLI
14.5. Example: convert a shared container to a private container
14.5.1. Using the EVMS GUI
14.5.2. Using Ncurses
14.5.3. Using the CLI
14.6. Example: deport a private or shared container
14.6.1. Using the EVMS GUI
14.6.2. Using Ncurses
14.6.3. Using the CLI
14.7. Deleting a cluster container
14.8. Failover and Failback of a private container on Linux-HA
14.9. Remote configuration management
14.9.1. Using the EVMS GUI
14.9.2. Using Ncurses
14.9.3. Using the CLI
14.10. Forcing a cluster container to be active
15. Converting volumes
15.1. When to convert volumes
15.2. Example: convert compatibility volumes to EVMS volumes
15.2.1. Using the EVMS GUI
15.2.2. Using Ncurses
15.2.3. Using the CLI
15.3. Example: convert EVMS volumes to compatibility volumes
15.3.1. Using the EVMS GUI
15.3.2. Using Ncurses
15.3.3. Using the CLI
16. Expanding and shrinking volumes
16.1. Why expand and shrink volumes?
16.2. Example: shrink a volume
16.2.1. Using the EVMS GUI
16.2.2. Using Ncurses
16.2.3. Using the CLI
16.3. Example: expand a volume
16.3.1. Using the EVMS GUI
16.3.2. Using Ncurses
16.3.3. Using the CLI
17. Adding features to an existing volume
17.1. Why add features to a volume?
17.2. Example: add drive linking to an existing volume
17.2.1. Using the EVMS GUI
17.2.2. Using Ncurses
17.2.3. Using the CLI
18. Selectively activating volumes and objects
18.1. Initial activation using /etc/evms.conf
18.2. Activating and deactivating volumes and objects
18.2.1. Activation
18.2.2. Deactivation
18.2.3. Activation and deactivation dependencies
19. Mounting and unmounting volumes from within EVMS
19.1. Mounting a volume
19.1.1. Using the EVMS GUI
19.1.2. Using Ncurses
19.1.3. Using the CLI
19.2. Unmounting a volume
19.2.1. Using the EVMS GUI
19.2.2. Using Ncurses
19.2.3. Using the CLI
19.3. The SWAPFS file system
19.3.1. Turning swap on
19.3.2. Turning swap off
20. Plug-in operations tasks
20.1. What are plug-in tasks?
20.2. Example: complete a plug-in operations task
20.2.1. Using the EVMS GUI
20.2.2. Using Ncurses
20.2.3. Using the CLI
21. Deleting objects
21.1. How to delete objects: delete and delete recursive
21.2. Example: perform a delete recursive operation
21.2.1. Using the EVMS GUI
21.2.2. Using Ncurses
21.2.3. Using the CLI
22. Replacing objects
22.1. What is object-replace?
22.2. Replacing a drive-link child object
22.2.1. Using the EVMS GUI or Ncurses
22.2.2. Using the CLI
23. Moving segment storage objects
23.1. What is segment moving?
23.2. Why move a segment?
23.3. Which segment manager plug-ins implement the move function?
23.4. Example: move a DOS segment
23.4.1. Using the EVMS GUI context sensitive menu
23.4.2. Using Ncurses
23.4.3. Using the CLI
24. Backing up and restoring EVMS metadata
24.1. Backing up metadata
24.1.1. Using the EVMS GUI
24.1.2. Using Ncurses
24.1.3. Metadata backup configuration options in /etc/evms.conf
24.1.4. Using the evms_metadata_backup utility
24.2. Restoring metadata
24.2.1. Examples
24.3. Cautions
24.3.1. Metadata backups and restores are name based
24.3.2. Restoring metadata to objects that have changed size
24.3.3. Restoring metadata to build Multi-Disk (MD) RAID arrays
A. The DOS plug-in
A.1. How the DOS plug-in is implemented
A.2. Assigning the DOS plug-in
A.3. Creating DOS partitions
A.4. Expanding DOS partitions
A.5. Shrinking DOS partitions
A.6. Deleting partitions
B. The MD region manager
B.1. Characteristics of Linux RAID levels
B.1.1. Linear mode
B.1.2. RAID-0
B.1.3. RAID-1
B.1.4. RAID-4/5
B.1.5. Multipath
B.2. Creating an MD region
B.2.1. RAID-0 options
B.2.2. RAID-1 options
B.2.3. RAID-4/5 options
B.3. Active and spare objects
B.3.1. Adding spare objects
B.3.2. Removing spare objects
B.3.3. Adding active objects to RAID-1
B.4. Faulty objects
B.4.1. Removing faulty objects
B.4.2. Fixing temporarily failed objects
B.4.3. Marking objects faulty
B.5. Resizing MD regions
B.5.1. Linear
B.5.2. RAID-0
B.5.3. RAID-1
B.5.4. RAID-4/5
B.6. Replacing objects
C. The LVM plug-in
C.1. How LVM is implemented
C.2. Container operations
C.2.1. Creating LVM containers
C.2.2. Adding objects to LVM containers
C.2.3. Removing objects from LVM containers
C.2.4. Expanding consumed objects in LVM containers
C.2.5. Shrinking consumed objects in LVM containers
C.2.6. Deleting LVM containers
C.2.7. Renaming LVM containers
C.3. Region operations
C.3.1. Creating LVM regions
C.3.2. Expanding LVM regions
C.3.3. Shrinking LVM regions
C.3.4. Deleting LVM regions
C.3.5. Moving LVM regions
C.3.6. Renaming LVM regions
D. The LVM2 plug-in
D.1. Container operations
D.1.1. Creating LVM2 containers
D.1.2. Adding objects to LVM2 containers
D.1.3. Removing objects from LVM2 containers
D.1.4. Expanding consumed objects in LVM2 containers
D.1.5. Shrinking consumed objects in LVM2 containers
D.1.6. Deleting LVM2 containers
D.1.7. Renaming LVM2 containers
D.2. Region operations
D.2.1. Creating LVM2 regions
D.2.2. Expanding LVM2 regions
D.2.3. Shrinking LVM2 regions
D.2.4. Deleting LVM2 regions
D.2.5. Renaming LVM2 regions
D.2.6. Moving LVM2 regions
D.2.7. Splitting and merging LVM2 region mappings
E. The CSM plug-in
E.1. Assigning the CSM plug-in
E.2. Unassigning the CSM plug-in
E.3. Deleting a CSM container
F. JFS file system interface module
F.1. Creating JFS file systems
F.2. Checking JFS file systems
F.3. Removing JFS file systems
F.4. Expanding JFS file systems
F.5. Shrinking JFS file systems
G. XFS file system interface module
G.1. Creating XFS file systems
G.2. Checking XFS file systems
G.3. Removing XFS file systems
G.4. Expanding XFS file systems
G.5. Shrinking XFS file systems
H. ReiserFS file system interface module
H.1. Creating ReiserFS file systems
H.2. Checking ReiserFS file systems
H.3. Removing ReiserFS file systems
H.4. Expanding ReiserFS file systems
H.5. Shrinking ReiserFS file systems
I. Ext-2/3 file system interface module
I.1. Creating Ext-2/3 file systems
I.2. Checking Ext-2/3 file systems
I.3. Removing Ext-2/3 file systems
I.4. Expanding and shrinking Ext-2/3 file systems
J. OpenGFS file system interface module
J.1. Creating OpenGFS file systems
J.2. Checking OpenGFS file systems
J.3. Removing OpenGFS file systems
J.4. Expanding and shrinking OpenGFS file systems
K. NTFS file system interface module
K.1. Creating NTFS file systems
K.2. Fixing NTFS file systems
K.3. Cloning NTFS file systems
K.4. Removing NTFS file systems
K.5. Expanding and shrinking NTFS file systems
List of Tables
1. Organization of the EVMS User Guide
1-1. EVMS user interfaces
2-1. Accelerator keys in the Main Window
2-2. Accelerator keys in the views
2-3. Accelerator keys in the selection window
2-4. Accelerator keys in the configuration options window
2-5. Widget navigation keys in the configuration options window
3-1. EVMS logging levels
16-1. FSIM support for expand and shrink operations
List of Figures
4-1. GUI start-up window
4-2. Ncurses start-up window
4-3. CLI volume query results
List of Examples
6-1. Add the DOS Segment Manager
6-2. Remove the DOS Segment Manager
7-1. Create a 100MB segment
8-1. Create "Sample Container"
9-1. Create "Sample Region"
10-1. Create a drive link
11-1. Create a snapshot of a volume
12-1. Create an EVMS native volume
12-2. Create a compatibility volume
13-1. Add a JFS File System to a Volume
13-2. Check a JFS File System
14-1. Create a private cluster container
14-2. Create a shared cluster container
14-3. Convert a private container to shared
14-4. Convert a shared container to private
14-5. Deport a cluster container
15-1. Convert a compatibility volume
15-2. Convert an EVMS volume
16-1. Shrink a volume
16-2. Expand a volume
17-1. Add drive linking to an existing volume
20-1. Add a spare disk to a compatibility volume made from an MDRaid5 region
21-1. Destroy a volume and the region and container below it
copyright  ©  November 26 2022 sean dreilinger url: https://durak.org/sean/pubs/software/evms2/index.html