old-www/LDP/EVMSUG/html/pluginexample.html

528 lines
6.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML
><HEAD
><TITLE
>Example: complete a plug-in operations task</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="EVMS User Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="Plug-in operations tasks"
HREF="plugintasks.html"><LINK
REL="PREVIOUS"
TITLE="What are plug-in tasks?"
HREF="aboutplugintasks.html"><LINK
REL="NEXT"
TITLE="Deleting objects"
HREF="deleterecurs.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>EVMS User Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="aboutplugintasks.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 20. Plug-in operations tasks</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="deleterecurs.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="pluginexample"
></A
>20.2. Example: complete a plug-in operations task</H1
><P
> This section shows how to complete a plug-in operations task with the EVMS GUI, Ncurses, and CLI interfaces.</P
><A
NAME="AEN4011"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><DIV
CLASS="example"
><A
NAME="AEN4012"
></A
><P
><B
>Example 20-1. Add a spare disk to a compatibility volume made from an MDRaid5 region</B
></P
><P
>This example adds disk <TT
CLASS="filename"
>sde</TT
> as a spare disk onto volume <TT
CLASS="filename"
>/dev/evms/md/md0</TT
>, which is a compatibility volume that was created from an MDRaid5 region.</P
></DIV
></BLOCKQUOTE
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="plugingui"
></A
>20.2.1. Using the EVMS GUI</H2
><P
>Follow these steps to add <TT
CLASS="filename"
>sde</TT
> to <TT
CLASS="filename"
>/dev/evms/md/md0</TT
> with the EVMS GUI:
<P
></P
><OL
TYPE="1"
><LI
><P
>Select <SPAN
CLASS="guimenu"
>Other</SPAN
>-&gt;<SPAN
CLASS="guimenuitem"
>Storage Object Tasks...</SPAN
>
</P
></LI
><LI
><P
>Select <SPAN
CLASS="guimenu"
>md/md0</SPAN
>.
</P
></LI
><LI
><P
>Click <SPAN
CLASS="guibutton"
>Next</SPAN
>.
</P
></LI
><LI
><P
>Select <SPAN
CLASS="guimenu"
>Add spare object</SPAN
>.
</P
></LI
><LI
><P
>Click <SPAN
CLASS="guibutton"
>Next</SPAN
>.
</P
></LI
><LI
><P
>Select <SPAN
CLASS="guimenu"
>sde</SPAN
>.</P
></LI
><LI
><P
>Click <SPAN
CLASS="guibutton"
>Add</SPAN
>.
</P
></LI
><LI
><P
>The operation is completed when you save.</P
></LI
></OL
>
</P
><P
>Alternatively, you could use context-sensitive menus to
complete the task, as follows:
<P
></P
><OL
TYPE="1"
><LI
><P
>View the region <TT
CLASS="filename"
>md/md0</TT
>. You can view the region either
by clicking on the small plus sign beside the volume name
(<TT
CLASS="filename"
>/dev/evms/md/md0</TT
>) on the <SPAN
CLASS="guimenu"
>volumes tab</SPAN
>,
or by selecting the <SPAN
CLASS="guimenu"
>regions tab</SPAN
>.</P
></LI
><LI
><P
>Right click the region (<TT
CLASS="filename"
>md/md0</TT
>). A list of acceptable
Actions and Navigational shortcuts displays. The last items on the
list are the tasks that are acceptable at this time.</P
></LI
><LI
><P
>Point to <SPAN
CLASS="guimenu"
>Add spare object</SPAN
> and
left click.</P
></LI
><LI
><P
>Select <SPAN
CLASS="guimenu"
>sde</SPAN
>.</P
></LI
><LI
><P
>Click <SPAN
CLASS="guibutton"
>Add</SPAN
>.</P
></LI
></OL
></P
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="plugintasksncurses"
></A
>20.2.2. Using Ncurses</H2
><P
>Follow these steps to add <TT
CLASS="filename"
>sde</TT
> to <TT
CLASS="filename"
>/dev/evms/md/md0</TT
> with Ncurses:
<P
></P
><OL
TYPE="1"
><LI
><P
>Select <SPAN
CLASS="guimenu"
>Other</SPAN
>-&gt;<SPAN
CLASS="guimenuitem"
>Storage Object Tasks</SPAN
>
</P
></LI
><LI
><P
>Select
<SPAN
CLASS="guimenuitem"
>md/md0</SPAN
>.
</P
></LI
><LI
><P
>Activate <SPAN
CLASS="guibutton"
>Next</SPAN
>.
</P
></LI
><LI
><P
>Select
<SPAN
CLASS="guimenuitem"
>Add spare object</SPAN
>.
</P
></LI
><LI
><P
>Activate <SPAN
CLASS="guibutton"
>Next</SPAN
>.
</P
></LI
><LI
><P
>Select
<SPAN
CLASS="guimenuitem"
>sde</SPAN
>.
</P
></LI
><LI
><P
>Activate <SPAN
CLASS="guibutton"
>Add</SPAN
>.
</P
></LI
></OL
>
</P
><P
>Alternatively, you can use the context sensitive menu to complete the task:</P
><P
></P
><OL
TYPE="1"
><LI
><P
>From the Regions view, press <B
CLASS="keycap"
>Enter</B
> on <SPAN
CLASS="guimenuitem"
>md/md0</SPAN
>.</P
></LI
><LI
><P
>Activate the <SPAN
CLASS="guimenuitem"
>Add spare object</SPAN
> menu item.</P
></LI
><LI
><P
>Select <SPAN
CLASS="guimenuitem"
>sde</SPAN
>.</P
></LI
><LI
><P
>Activate <SPAN
CLASS="guibutton"
>Add</SPAN
>.</P
></LI
></OL
></DIV
><DIV
CLASS="sect2"
><H2
CLASS="sect2"
><A
NAME="plugincli"
></A
>20.2.3. Using the CLI</H2
><P
>With the EVMS CLI, all plug-in tasks must be
accomplished with the <B
CLASS="command"
>task</B
> command. Follow these steps
to add <TT
CLASS="filename"
>sde</TT
> to <TT
CLASS="filename"
>/dev/evms/md/md0</TT
>
with the CLI:
<P
></P
><OL
TYPE="1"
><LI
><P
>The following query command with the list
options filter to determines
the acceptable tasks for a particular object and the name-value
pairs it supports. The command returns information about which
plug-in tasks are available at the current time and provides
the information necessary for you to complete the command.
</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="programlisting"
>query: objects, object=md/md0, list options</PRE
></FONT
></TD
></TR
></TABLE
></LI
><LI
><P
>The command takes the name of the task
(returned from the previous query), the object to operate on
(in this case, md/md0), any required options (none in this case)
and, if necessary, another object to be manipulated
(in our example, <TT
CLASS="filename"
>sde</TT
>, which is the spare disk
we want to add):
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="programlisting"
>task: addspare, md/md0, sde</PRE
></FONT
></TD
></TR
></TABLE
>
The command is completed upon saving.</P
></LI
></OL
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="aboutplugintasks.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="deleterecurs.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>What are plug-in tasks?</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="plugintasks.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Deleting objects</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>