path: root/sbin/gvinum/gvinum.8
diff options
authorUlf Lilleengen <lulf@FreeBSD.org>2009-04-10 10:12:09 +0000
committerUlf Lilleengen <lulf@FreeBSD.org>2009-04-10 10:12:09 +0000
commit8d4311eacbb5868ed273d328c14d2e3d1ec1d921 (patch)
tree7878a6830d89856242ee9068d85f5f48fe849304 /sbin/gvinum/gvinum.8
parent11e0093f28feefb0f060c480439de0ade62b5305 (diff)
- Implement the grow command to make it easier for users to extend plexes
without having to understand all gvinum internals. - Document the grow command in the manpage and update examples to use the command where possible.
Notes: svn path=/head/; revision=190884
Diffstat (limited to 'sbin/gvinum/gvinum.8')
1 files changed, 9 insertions, 7 deletions
diff --git a/sbin/gvinum/gvinum.8 b/sbin/gvinum/gvinum.8
index d2b96162508f..9bf44ee0f663 100644
--- a/sbin/gvinum/gvinum.8
+++ b/sbin/gvinum/gvinum.8
@@ -79,6 +79,10 @@ flag is given.
.It Ic detach Oo Fl f Oc Op Ar plex | subdisk
Detach a plex or subdisk from the volume or plex to which it is
+.It Ic grow Ar plex device
+Grow a plex by creating a gvinum drive and subdisk on device and attach it to
+the plex.
+If required by the plex organization, it will be put into the growable state.
.It Ic help
Provides a synopsis of
@@ -333,16 +337,11 @@ Then, initiate the rebuild:
The plex will go up form degraded mode after the rebuild is finished.
The plex can still be used while the rebuild is in progress, although requests
might be delayed.
-For a more advanced usage and detailed explanation of gvinum, the
-handbook is recommended.
Given the configuration as in the previous example, growing a RAID-5 or STRIPED
-array is accomplished by adding a new subdisk to the plex with a
-.Ar description-file
-similar to this:
+array is accomplished by using the grow command:
-.Dl "drive newdrive device /dev/ad4"
-.Dl "sd drive newdrive plex myraid5vol.p0"
+.Dl "gvinum grow myraid5vol.p0 /dev/ad4"
If everything went ok, the plex state should now be set to growable.
You can then start the growing with the
@@ -355,6 +354,9 @@ As with rebuilding, you can watch the progress using the
.Ic list
+For a more advanced usage and detailed explanation of gvinum, the
+handbook is recommended.
.Xr geom 4 ,
.Xr geom 8