cs:navody:ssh:dmput

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

cs:navody:ssh:dmput [26.10.2012 02:57] (aktuální)
Řádek 1: Řádek 1:
 +<​html>​
 +<​style>​ td {text-align:​left;​ } </​style>​
 +<h1 align=center>​DMPUT</​h1>​
 +<a href="#​NAME">​NAME</​a><​br>​
 +<a href="#​SYNOPSIS">​SYNOPSIS</​a><​br>​
 +<a href="#​IMPLEMENTATION">​IMPLEMENTATION</​a><​br>​
 +<a href="#​DESCRIPTION">​DESCRIPTION</​a><​br>​
 +<a href="#​NOTES">​NOTES</​a><​br>​
 +<a href="#​EXAMPLES">​EXAMPLES</​a><​br>​
 +<a href="#​FILES">​FILES</​a><​br>​
 +<a href="#​SEE ALSO">​SEE ALSO</​a><​br>​
 +
 +<hr>
 +<a name="​NAME"></​a>​
 +<​h2>​NAME</​h2>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p><​b>​dmput</​b>​ &minus; Migrates online files to offline
 +media</​p>​
 +</td>
 +</​table>​
 +<a name="​SYNOPSIS"></​a>​
 +<​h2>​SYNOPSIS</​h2>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p><​b>​dmput</​b>​ [<​b>​-h</​b>​] [<​b>​-n</​b>​] [<​b>​-r</​b>​
 +[<​b>​-F</​b>​ byterange-list]] [<​b>​-v</​b>​] [<​b>​-w</​b>​] [<​b>​-V
 +mspvglist</​b>​] [<​i>​list</​i>​]<​b><​br>​
 +dmput</​b>​ [<​b>​-h</​b>​] [<​b>​-n</​b>​] [<​b>​-r</​b>​ [<​b>​-K</​b>​
 +byterange-list]] [<​b>​-v</​b>​] [<​b>​-w</​b>​] [<​b>​-V
 +mspvglist</​b>​] [<​i>​list</​i>​]</​p>​
 +</td>
 +</​table>​
 +<a name="​IMPLEMENTATION"></​a>​
 +<​h2>​IMPLEMENTATION</​h2>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p>​SGI systems licensed for the Data Migration Facility
 +(DMF) and systems functioning as DMF clients.</​p>​
 +</td>
 +</​table>​
 +<a name="​DESCRIPTION"></​a>​
 +<​h2>​DESCRIPTION</​h2>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p>​The <​b>​dmput</​b>​ command migrates an online file to an
 +offline medium. You can use this command to migrate files
 +that you own; the system administrator can use this command
 +to migrate any files. You must be <​b>​root</​b>​ to migrate
 +files you do not own.</​p>​
 +<!-- INDENTATION -->
 +<​p>​The <​b>​dmput</​b>​ command accepts the following
 +options:</​p>​
 +</td>
 +</​table>​
 +<!-- TABS -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​4"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​17%">​
 +
 +<​p><​b>​Option</​b></​p>​
 +</td>
 +<td width="​4%"></​td>​
 +<td width="​66%">​
 +
 +<​p><​b>​Description</​b></​p>​
 +</td>
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​17%">​
 +
 +<​p><​b>​-h</​b></​p>​
 +</td>
 +<td width="​4%"></​td>​
 +<td width="​66%">​
 +
 +<​p>​Causes the <​i>​list</​i>​ to be treated as a list of Data
 +Management API (DMAPI) fhandles rather than file paths. The
 +fhandle is the DMF representation of the DMAPI name for the
 +file in the file system.</​p>​
 +</td>
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​17%">​
 +
 +<​p><​b>​-n</​b></​p>​
 +</td>
 +<td width="​4%"></​td>​
 +<td width="​66%">​
 +
 +<​p>​Directs the <​b>​dmput</​b>​ command to abort if the DMF
 +daemon is not responding or if the daemon stops responding
 +while the request is being processed. The default is to wait
 +until the request has finished processing.</​p>​
 +</td>
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​17%">​
 +
 +<​p><​b>​-r</​b></​p>​
 +</td>
 +<td width="​4%"></​td>​
 +<td width="​66%">​
 +
 +<​p>​Releases the disk data blocks associated with this file
 +after the offline copies are made. If this option is not
 +specified, the disk data blocks are not released until
 +automated space management determines a need for the disk
 +blocks.</​p>​
 +</td>
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​17%">​
 +
 +<​p><​b>​-v</​b></​p>​
 +</td>
 +<td width="​4%"></​td>​
 +<td width="​66%">​
 +
 +<​p>​Specifies verbose mode. This option is useful for
 +administrators when trying to determine the cause of
 +operational problems between DMF client commands and the
 +server host machine. This option might cause the command to
 +display more information regarding the cause of an error
 +than the command does without the option, if such
 +information is available. The option is not useful in cases
 +of normal client/​server operation.</​p>​
 +</td>
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​17%">​
 +
 +<​p><​b>​-w</​b></​p>​
 +</td>
 +<td width="​4%"></​td>​
 +<td width="​66%">​
 +
 +<​p>​Waits until all offline copies are completed before
 +terminating.</​p>​
 +</td>
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​17%">​
 +
 +<​p><​b>​-V mspvglist</​b></​p>​
 +</td>
 +<td width="​4%"></​td>​
 +<td width="​66%">​
 +
 +<​p>​Specifies a list of MSPs, VGs or Migrate Groups to which
 +the file should be migrated. The values in the list may be
 +comma-separated,​ with no white space. Alternatively,​ the
 +list may be enclosed in quotes, and the values may be
 +separated by white space. This option only affects the
 +initial migration of a file. If the <​b>​-V</​b>​ option is not
 +specified, the policies in the <​b>​dmf.conf</​b>​ file
 +determine the MSPs or VGs to which the file should be
 +migrated. If this option is specified, the <​b>​mspvglist</​b>​
 +is used, and the policies in the <​b>​dmf.conf</​b>​ file are
 +ignored, only when <​b>​dmput</​b>​ is issued by the root user
 +on the DMF server; otherwise the command behaves as if this
 +option had not been entered. If your site is using the
 +Customizable Policy feature, the default behavior may be
 +overridden. Please check with your administrator for any
 +behavior differences due to Customizable Policies.</​p>​
 +</td>
 +</​table>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p><​b>​-F byterange-list</​b></​p></​td>​
 +</​table>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​33%"></​td>​
 +<td width="​66%">​
 +<​p>​Specifies a list of byteranges to be made offline
 +(freed); the rest of the file is kept online. Requires
 +<​b>​-r</​b>​ and must not be used with <​b>​-K</​b>​.</​p>​
 +</td>
 +</​table>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p><​b>​-K byterange-list</​b></​p></​td>​
 +</​table>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​33%"></​td>​
 +<td width="​66%">​
 +<​p>​Specifies a list of byteranges to be kept online; the
 +rest of the file is made offline. Requires <​b>​-r</​b>​ and
 +must not be used with <​b>​-F</​b>​.</​p>​
 +</td>
 +</​table>​
 +<!-- TABS -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​4"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​5%">​
 +
 +<​p><​i>​list</​i></​p>​
 +</td>
 +<td width="​16%"></​td>​
 +<td width="​66%">​
 +
 +<​p>​Specifies a list of file paths or fhandles to process.
 +If you do not specify <​i>​list</​i>,​ <​b>​dmput</​b>​ processes
 +file paths or fhandles read from standard input.</​p>​
 +</td>
 +</​table>​
 +<a name="​NOTES"></​a>​
 +<​h2>​NOTES</​h2>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p>​The system administrator sets the migration medium used
 +in the DMF configuration file. The files that you migrate
 +must comply with the settings in the configuration file.</​p>​
 +<!-- INDENTATION -->
 +<​p>​Unless you specify the <​b>​-r</​b>​ option, the <​b>​dmput</​b>​
 +command does not automatically release the disk space
 +occupied by the file specified (by path or fhandle) in
 +<​i>​list</​i>​. Although it is possible that the disk space
 +will eventually be released if the file resides on a file
 +system that is managed by automated space management, it is
 +preferable to always specify the <​b>​-r</​b>​ option rather
 +than trying to determine whether and when the file space
 +will be released.</​p>​
 +<!-- INDENTATION -->
 +<p>A <​b>​byterange-list</​b>​ is one or more <​b>​byteranges</​b>​
 +separated by commas.</​p>​
 +<!-- INDENTATION -->
 +<p>A <​b>​byterange</​b>​ is of the form &​quot;​mmmm:​nnnn&​quot;​
 +where &​quot;​mmmm&​quot;​ specifies the first byte in the range
 +and &​quot;​nnnn&​quot;​ specifies the last byte in it. Each of
 +&​quot;​mmmm&​quot;​ and &​quot;​nnnn&​quot;​ counts from the
 +beginning of the file if unsigned, and backwards from the
 +end if preceded by &​quot;​-&​quot;​. The first byte in the file
 +is byte &​quot;​0&​quot;,​ &​quot;​BOF&​quot;,​ or &​quot;​bof&​quot;,​
 +and the last one is byte &​quot;​-0&​quot;,​ &​quot;​EOF&​quot;,​ or
 +&​quot;​eof&​quot;,​ so &​quot;​bof:​eof&​quot;,​
 +&​quot;​BOF:​EOF&​quot;,​ and &​quot;​0:​-0&​quot;​ all define a range
 +covering the entire file.</​p>​
 +<!-- INDENTATION -->
 +<p>A <​b>​byterange</​b>​ may also of the form
 +&​quot;​mmmm+llll&​quot;​ where &​quot;​mmmm&​quot;​ is a byte
 +position as above, and &​quot;​llll&​quot;​ is the number of
 +bytes in the range, starting at &​quot;​mmmm&​quot;​. If
 +&​quot;​llll&​quot;​ starts with a minus sign, it specifies a
 +range of &​quot;​llll&​quot;​ bytes ending at
 +&​quot;​mmmm&​quot;​.</​p>​
 +<!-- INDENTATION -->
 +<p>A single number &​quot;​llll&​quot;​ (without a colon or plus
 +symbol) is also acceptable as a <​b>​byterange</​b>,​ being
 +interpreted as &​quot;​EOF+llll&​quot;​ if &​quot;​llll&​quot;​
 +starts with a &​quot;​-&​quot;,​ or &​quot;​BOF+llll&​quot;​ if it
 +doesn&​rsquo;​t.</​p>​
 +<!-- INDENTATION -->
 +<​p>​Each number can be either a hexadecimal number of the
 +form &​quot;​0xnnnn&​quot;,​ a based number of the form
 +&​quot;​base#​nnnn&​quot;,​ or a decimal number with an optional
 +trailing scaling character. The decimal number may include a
 +&​quot;​.&​quot;​ and exponent. The trailing scaling character
 +may be <i>k, K, m, M, g, G, t, T, p,</​i>​ or <​i>​P,</​i>​ all of
 +which are powers of 1000, not 1024.</​p>​
 +<!-- INDENTATION -->
 +<​p>​Byteranges are rounded to disk block boundaries. DMF may
 +decide to join nearby ranges together if necessary, or
 +adjust them to match the size of the file.</​p>​
 +</td>
 +</​table>​
 +<a name="​EXAMPLES"></​a>​
 +<​h2>​EXAMPLES</​h2>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p>​The following example migrates the <​b>​report1</​b>​ and
 +<​b>​report2</​b>​ files. <​b>​dmput</​b>​ will release the disk
 +space occupied by <​b>​report1</​b>​ and <​b>​report2</​b>,​ and
 +will wait until all offline copies are completed before
 +terminating:</​p>​
 +<!-- INDENTATION -->
 +<​pre><​b> ​    dmput -r -w report1 report2
 +
 +</​b>​The following example finds all unmigrated files in a directory and
 +migrates them:
 +
 +<​b> ​   dmfind . -state REG | dmput
 +</​b>​Note that piping the pathnames directly into dmput is much more efficient
 +than the use of the <​b>​-exec</​b>​ option or the <​b>​xargs</​b>​ command.
 +<​b>​dmattr</​b>,​ <​b>​dmget</​b>​ and <​b>​dmtag</​b>​ also accept pathnames on their
 +standard input file.
 +
 +In the following example, if file <​b>​partialfile</​b>​ is 14000 bytes long,
 +then both of the following commands will migrate the file, keeping
 +the first 4000 bytes (rounded to a disk block boundary) online and
 +freeing the remainder.
 +
 +<​b> ​   dmput -r -K 0:4000 partialfile
 +     dmput -r -F -10000:-0 partialfile
 +
 +</​b></​pre>​
 +</td>
 +</​table>​
 +<a name="​FILES"></​a>​
 +<​h2>​FILES</​h2>​
 +<!-- TABS -->
 +
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​4"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​11%"></​td>​
 +<td width="​25%">​
 +
 +<​p><​b>/​etc/​dmf/​dmf.conf</​b></​p>​
 +</td>
 +<td width="​19%"></​td>​
 +<td width="​44%">​
 +
 +<​p>​DMF configuration file</​p>​
 +</td>
 +</​table>​
 +<a name="​SEE ALSO"></​a>​
 +<​h2>​SEE ALSO</​h2>​
 +<!-- INDENTATION -->
 +<table width="​100%"​ border=0 rules="​none"​ frame="​void"​
 +       ​cols="​2"​ cellspacing="​0"​ cellpadding="​0">​
 +<tr valign="​top"​ align="​left">​
 +<td width="​10%"></​td>​
 +<td width="​89%">​
 +<​p><​tt><​b>​dmget</​b></​tt>​(1) for information about recalling
 +previously migrated files</​p>​
 +</td>
 +</​table>​
 +<hr>
 +</​html>​
  
Poslední úprava: 26.10.2012 02:57