This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
en:navody:ssh:dmput [24.04.2013 17:17] 127.0.0.1 external edit |
— (current) | ||
---|---|---|---|
Line 1: | Line 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> − 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 "mmmm:nnnn" | ||
- | where "mmmm" specifies the first byte in the range | ||
- | and "nnnn" specifies the last byte in it. Each of | ||
- | "mmmm" and "nnnn" counts from the | ||
- | beginning of the file if unsigned, and backwards from the | ||
- | end if preceded by "-". The first byte in the file | ||
- | is byte "0", "BOF", or "bof", | ||
- | and the last one is byte "-0", "EOF", or | ||
- | "eof", so "bof:eof", | ||
- | "BOF:EOF", and "0:-0" all define a range | ||
- | covering the entire file.</p> | ||
- | <!-- INDENTATION --> | ||
- | <p>A <b>byterange</b> may also of the form | ||
- | "mmmm+llll" where "mmmm" is a byte | ||
- | position as above, and "llll" is the number of | ||
- | bytes in the range, starting at "mmmm". If | ||
- | "llll" starts with a minus sign, it specifies a | ||
- | range of "llll" bytes ending at | ||
- | "mmmm".</p> | ||
- | <!-- INDENTATION --> | ||
- | <p>A single number "llll" (without a colon or plus | ||
- | symbol) is also acceptable as a <b>byterange</b>, being | ||
- | interpreted as "EOF+llll" if "llll" | ||
- | starts with a "-", or "BOF+llll" if it | ||
- | doesn’t.</p> | ||
- | <!-- INDENTATION --> | ||
- | <p>Each number can be either a hexadecimal number of the | ||
- | form "0xnnnn", a based number of the form | ||
- | "base#nnnn", or a decimal number with an optional | ||
- | trailing scaling character. The decimal number may include a | ||
- | "." 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> | ||