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

Následující verze
Předchozí verze
cs:navody:ssh:dmput [26.10.2012 02:57]
127.0.0.1 upraveno mimo DokuWiki
— (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>​