EVMS User Guide
   Next

EVMS User Guide

Christine Lorenz

IBM

Joy Goodreau

IBM

Kylie Smith

IBM

Copyright © 2004 IBM

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.

September 16, 2004

Table of Contents

Preface
1. What is EVMS?
1. Why choose EVMS?
2. The EVMS user interfaces
3. EVMS terminology
4. What makes EVMS so flexible?
5. Plug-in layer definitions
2. Using the EVMS interfaces
1. EVMS GUI
1.1. Using context sensitive and action menus
1.2. Saving changes
1.3. Refreshing changes
1.4. Using the GUI "+"
1.5. Using the accelerator keys
2. EVMS Ncurses interface
2.1. Navigating through EVMS Ncurses
2.2. Saving changes
3. EVMS Command Line Interpreter
3.1. Using the EVMS CLI
3.2. Notes on commands and command files
3. The EVMS log file and error data collection
1. About the EVMS log file
2. Log file logging levels
3. Specifying the logging levels
4. Viewing compatibility volumes after migrating
1. Using the EVMS GUI
2. Using Ncurses
3. Using the CLI
5. Obtaining interface display details
1. Using the EVMS GUI
2. Using Ncurses
3. Using the CLI
6. Adding and removing a segment manager
1. When to add a segment manager
2. Types of segment managers
2.1. DOS Segment Manager
2.2. GUID Partitioning Table (GPT) Segment Manager
2.3. S/390 Segment Manager
2.4. Cluster segment manager
2.5. BSD segment manager
2.6. MAC segment manager
2.7. BBR segment manager
3. Adding a segment manager to an existing disk
4. Adding a segment manager to a new disk
5. Example: add a segment manager
5.1. Using the EVMS GUI
5.2. Using Ncurses
5.3. Using the CLI
6. Removing a segment manager
7. Example: remove a segment manager
7.1. Using the EVMS GUI context sensitive menu
7.2. Using Ncurses
7.3. Using the CLI
7. Creating segments
1. When to create a segment
2. Example: create a segment
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
8. Creating a container
1. When to create a container
2. Example: create a container
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
9. Creating regions
1. When to create regions
2. Example: create a region
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
10. Creating drive links
1. What is drive linking?
2. How drive linking is implemented
3. Creating a drive link
4. Example: create a drive link
4.1. Using the EVMS GUI
4.2. Using Ncurses
4.3. Using the CLI
5. Expanding a drive link
6. Shrinking a drive link
7. Deleting a drive link
11. Creating snapshots
1. What is a snapshot?
2. Creating snapshot objects
3. Example: create a snapshot
3.1. Using the EVMS GUI
3.2. Using Ncurses
3.3. Using the CLI
4. Reinitializing a snapshot
4.1. Using the EVMS GUI or Ncurses
4.2. Using the CLI
5. Expanding a snapshot
5.1. Using the EVMS GUI or Ncurses
5.2. Using the CLI
6. Deleting a snapshot
7. Rolling back a snapshot
7.1. Using the EVMS GUI or Ncurses
7.2. Using the CLI
12. Creating volumes
1. When to create a volume
2. Example: create an EVMS native volume
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
3. Example: create a compatibility volume
3.1. Using the GUI
3.2. Using Ncurses
3.3. Using the CLI
13. FSIMs and file system operations
1. The FSIMs supported by EVMS
1.1. JFS
1.2. XFS
1.3. ReiserFS
1.4. Ext2/3
1.5. SWAPFS
1.6. OpenGFS
1.7. NTFS
2. Example: add a file system to a volume
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
3. Example: check a file system
3.1. Using the EVMS GUI
3.2. Using Ncurses
3.3. Using the CLI
14. Clustering operations
1. Rules and restrictions for creating cluster containers
2. Example: create a private cluster container
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
3. Example: create a shared cluster container
3.1. Using the EVMS GUI
3.2. Using Ncurses
3.3. Using the CLI
4. Example: convert a private container to a shared container
4.1. Using the EVMS GUI
4.2. Using Ncurses
4.3. Using the CLI
5. Example: convert a shared container to a private container
5.1. Using the EVMS GUI
5.2. Using Ncurses
5.3. Using the CLI
6. Example: deport a private or shared container
6.1. Using the EVMS GUI
6.2. Using Ncurses
6.3. Using the CLI
7. Deleting a cluster container
8. Failover and Failback of a private container on Linux-HA
9. Remote configuration management
9.1. Using the EVMS GUI
9.2. Using Ncurses
9.3. Using the CLI
10. Forcing a cluster container to be active
15. Converting volumes
1. When to convert volumes
2. Example: convert compatibility volumes to EVMS volumes
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
3. Example: convert EVMS volumes to compatibility volumes
3.1. Using the EVMS GUI
3.2. Using Ncurses
3.3. Using the CLI
16. Expanding and shrinking volumes
1. Why expand and shrink volumes?
2. Example: shrink a volume
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
3. Example: expand a volume
3.1. Using the EVMS GUI
3.2. Using Ncurses
3.3. Using the CLI
17. Adding features to an existing volume
1. Why add features to a volume?
2. Example: add drive linking to an existing volume
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
18. Selectively activating volumes and objects
1. Initial activation using /etc/evms.conf
2. Activating and deactivating volumes and objects
2.1. Activation
2.2. Deactivation
2.3. Activation and deactivation dependencies
19. Mounting and unmounting volumes from within EVMS
1. Mounting a volume
1.1. Using the EVMS GUI
1.2. Using Ncurses
1.3. Using the CLI
2. Unmounting a volume
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
3. The SWAPFS file system
3.1. Turning swap on
3.2. Turning swap off
20. Plug-in operations tasks
1. What are plug-in tasks?
2. Example: complete a plug-in operations task
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
21. Deleting objects
1. How to delete objects: delete and delete recursive
2. Example: perform a delete recursive operation
2.1. Using the EVMS GUI
2.2. Using Ncurses
2.3. Using the CLI
22. Replacing objects
1. What is object-replace?
2. Replacing a drive-link child object
2.1. Using the EVMS GUI or Ncurses
2.2. Using the CLI
23. Moving segment storage objects
1. What is segment moving?
2. Why move a segment?
3. Which segment manager plug-ins implement the move function?
4. Example: move a DOS segment
4.1. Using the EVMS GUI context sensitive menu
4.2. Using Ncurses
4.3. Using the CLI
A. The DOS plug-in
1. How the DOS plug-in is implemented
2. Assigning the DOS plug-in
3. Creating DOS partitions
4. Expanding DOS partitions
5. Shrinking DOS partitions
6. Deleting partitions
B. The MD region manager
1. Characteristics of Linux RAID levels
1.1. Linear mode
1.2. RAID-0
1.3. RAID-1
1.4. RAID-4/5
1.5. Multipath
2. Creating an MD region
2.1. RAID-0 options
2.2. RAID-1 options
2.3. RAID-4/5 options
3. Active and spare objects
3.1. Adding spare objects
3.2. Removing spare objects
3.3. Adding active objects to RAID-1
4. Faulty objects
4.1. Removing faulty objects
4.2. Fixing temporarily failed objects
4.3. Marking objects faulty
5. Resizing MD regions
5.1. Linear
5.2. RAID-0
5.3. RAID-1
5.4. RAID-4/5
6. Replacing objects
C. The LVM plug-in
1. How LVM is implemented
2. Container operations
2.1. Creating LVM containers
2.2. Adding objects to LVM containers
2.3. Removing objects from LVM containers
2.4. Expanding consumed objects in LVM containers
2.5. Shrinking consumed objects in LVM containers
2.6. Deleting LVM containers
2.7. Renaming LVM containers
3. Region operations
3.1. Creating LVM regions
3.2. Expanding LVM regions
3.3. Shrinking LVM regions
3.4. Deleting LVM regions
3.5. Moving LVM regions
3.6. Renaming LVM regions
D. The LVM2 plug-in
1. Container operations
1.1. Creating LVM2 containers
1.2. Adding objects to LVM2 containers
1.3. Removing objects from LVM2 containers
1.4. Expanding consumed objects in LVM2 containers
1.5. Shrinking consumed objects in LVM2 containers
1.6. Deleting LVM2 containers
1.7. Renaming LVM2 containers
2. Region operations
2.1. Creating LVM2 regions
2.2. Expanding LVM2 regions
2.3. Shrinking LVM2 regions
2.4. Deleting LVM2 regions
2.5. Renaming LVM2 regions
E. The CSM plug-in
1. Assigning the CSM plug-in
2. Unassigning the CSM plug-in
3. Deleting a CSM container
F. JFS file system interface module
1. Creating JFS file systems
2. Checking JFS file systems
3. Removing JFS file systems
4. Expanding JFS file systems
5. Shrinking JFS file systems
G. XFS file system interface module
1. Creating XFS file systems
2. Checking XFS file systems
3. Removing XFS file systems
4. Expanding XFS file systems
5. Shrinking XFS file systems
H. ReiserFS file system interface module
1. Creating ReiserFS file systems
2. Checking ReiserFS file systems
3. Removing ReiserFS file systems
4. Expanding ReiserFS file systems
5. Shrinking ReiserFS file systems
I. Ext-2/3 file system interface module
1. Creating Ext-2/3 file systems
2. Checking Ext-2/3 file systems
3. Removing Ext-2/3 file systems
4. Expanding and shrinking Ext-2/3 file systems
J. OpenGFS file system interface module
1. Creating OpenGFS file systems
2. Checking OpenGFS file systems
3. Removing OpenGFS file systems
4. Expanding and shrinking OpenGFS file systems
K. NTFS file system interface module
1. Creating NTFS file systems
2. Fixing NTFS file systems
3. Cloning NTFS file systems
4. Removing NTFS file systems
5. Expanding and shrinking NTFS file systems

List of Figures

4.1. GUI start-up window
4.2. Ncurses start-up window
4.3. CLI volume query results

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 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
   Next
   Preface