EVMS User Guide

Joy Goodreau

IBM

Kylie Smith

IBM

Christine Lorenz

IBM

Copyright © 2003 IBM

March 31, 2003

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. Downloading and installing EVMS

2.1. Preparing your system
2.2. Downloading EVMS
2.3. Patching the kernel
2.4. Configuring the kernel
2.5. Building and installing the new kernel
2.6. Installing the cluster manager
2.7. Installing the Engine
2.8. Activating EVMS volumes
2.9. The root filesystem on an EVMS volume
2.10. Setting up clustered EVMS

3. Using the EVMS interfaces

3.1. EVMS GUI
3.2. EVMS Ncurses interface
3.3. EVMS Command Line Interpreter

4. The EVMS log file and error data collection

4.1. About the EVMS log file
4.2. Log file logging levels
4.3. Specifying the logging levels

5. Viewing compatibility volumes after migrating

5.1. Using the EVMS GUI
5.2. Using Ncurses
5.3. Using the CLI

6. Obtaining interface display details

6.1. Using the EVMS GUI
6.2. Using Ncurses
6.3. Using the CLI

7. Assigning a segment manager

7.1. When to assign a segment manager
7.2. Types of segment managers
7.3. Assigning a segment manager to an existing disk
7.4. Assigning a segment manager to a new disk
7.5. Example: assign a segment manager

8. Creating segments

8.1. When to create a segment
8.2. Example: create a segment

9. Creating a container

9.1. When to create a container
9.2. Example: create a container

10. Creating regions

10.1. When to create regions
10.2. Example: create a region

11. Creating drive links

11.1. What is drive linking?
11.2. How drive linking is implemented
11.3. Creating a drive link
11.4. Example: create a drive link
11.5. Expanding a drive link
11.6. Shrinking a drive link
11.7. Deleting a drive link

12. Creating snapshots

12.1. What is a snapshot?
12.2. Creating and activating snapshot objects
12.3. Example: create a snapshot
12.4. Reinitializing a snapshot
12.5. Deleting a snapshot
12.6. Rolling back a snapshot

13. Creating volumes

13.1. When to create a volume
13.2. Example: create an EVMS native volume
13.3. Example: create a compatibility volume

14. FSIMs and file system operations

14.1. The FSIMs supported by EVMS
14.2. Example: add a file system to a volume
14.3. Example: check a file system

15. Clustering operations

15.1. Rules and restrictions for creating cluster containers
15.2. Example: create a private cluster container
15.3. Example: create a shared cluster container
15.4. Example: convert a private container to a shared container
15.5. Example: convert a shared container to a private container
15.6. Example: deport a private or shared container
15.7. Deleting a cluster container
15.8. Failover and Failback of a private container on Linux-HA
15.9. Remote configuration management
15.10. Forcing a cluster container to be imported

16. Converting volumes

16.1. When to convert volumes
16.2. Example: convert compatibility volumes to EVMS volumes
16.3. Example: convert EVMS volumes to compatibility volumes

17. Expanding and shrinking volumes

17.1. Why expand and shrink volumes?
17.2. Example: shrink a volume
17.3. Example: expand a volume

18. Adding features to an existing volume

18.1. Why add features to a volume?
18.2. Example: add drive linking to an existing volume

19. Plug-in operations tasks

19.1. What are plug-in tasks?
19.2. Example: complete a plug-in operations task

20. Destroying EVMS objects

20.1. How to delete objects: delete and delete recursive
20.2. Example: perform a delete recursive operation

A. Building an init-ramdisk to use with EVMS

A.1. Build and install EVMS
A.2. Kernel support for initrd
A.3. Build the initrd image
A.4. Set up the boot loader
A.5. Update the file system configuration
A.6. Reboot the system

B. The DOS link plug-in

B.1. How the DOS plug-in is implemented
B.2. Assigning the DOS plug-in
B.3. Creating DOS partitions
B.4. Expanding DOS partitions
B.5. Shrinking DOS partitions
B.6. Deleting partitions

C. The MD region manager

C.1. Creating an MD region
C.2. Adding and removing a spare object (RAID-1 and RAID-4/5)
C.3. Removing an active object (RAID-1 only)
C.4. Removing a faulty object (RAID-1 and RAID-4/5)
C.5. Marking an object faulty (RAID-4/5 only)
C.6. Replacing an object
C.7. Characteristics of Linux RAID levels

D. The LVM plug-in

D.1. How LVM is implemented
D.2. Container operations
D.3. Region operations

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

List of Tables
1. Organization of the EVMS User Guide
1-1. EVMS user interfaces
3-1. Accelerator keys in the Main Window
3-2. Accelerator keys in the views
3-3. Accelerator keys in the selection window
3-4. Accelerator keys in the configuration options window
3-5. Widget navigation keys in the configuration options window
4-1. EVMS logging levels
17-1. FSIM support for expand and shrink operations

List of Figures
2-1. xconfig Window
2-2. Multi-device Support (RAID and LVM) Window
5-1. GUI start-up window
5-2. Ncurses start-up window
5-3. CLI volume query results

List of Examples
7-1. Assign the DOS Segment Manager
8-1. Create a 100MB segment
9-1. Create "Sample Container"
10-1. Create "Sample Region"
11-1. Create a drive link
12-1. Create a snapshot of a volume
13-1. Create an EVMS native volume
13-2. Create a compatibility volume
14-1. Add a JFS File System to a Volume
14-2. Check a JFS File System
15-1. Create a private cluster container
15-2. Create a shared cluster container
15-3. Convert a private container to shared
15-4. Convert a shared container to private
15-5. Deport a cluster container
16-1. Convert a compatibility volume
16-2. Convert an EVMS volume
17-1. Shrink a volume
17-2. Expand a volume
18-1. Add drive linking to an existing volume
19-1. Add a spare disk to a compatibility volume made from an MDRaid5 region
20-1. Destroy a volume and the region and container below it

		Next
		Preface