/usr/share/doc/rt4-doc-html/rt-importer.html is in rt4-doc-html 4.2.12-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 | <ul id="index">
<li><a href="#NAME">NAME</a></li>
<li><a href="#SYNOPSIS">SYNOPSIS</a>
<ul>
<li><a href="#OPTIONS">OPTIONS</a></li>
</ul>
</li>
<li><a href="#CLONED-DATA">CLONED DATA</a></li>
</ul>
<h1 id="NAME"><a href="#___top">NAME</a></h1>
<p>rt-importer - Import a serialized RT database on top of the current one</p>
<h1 id="SYNOPSIS"><a href="#___top">SYNOPSIS</a></h1>
<pre><code> rt-importer path/to/export/directory</code></pre>
<p>This script is used to import the contents of a dump created by <code>rt-serializer</code>. It will create all of the objects in the dump in the current database; this may include users, queues, and tickets.</p>
<p>It is possible to stop the import process with ^C; it can be later resumed by re-running the importer.</p>
<h2 id="OPTIONS"><a href="#___top">OPTIONS</a></h2>
<dl>
<dt id="list"><b>--list</b></dt>
<dd>
<p>Print a summary of the data contained in the dump.</p>
</dd>
<dt id="originalid-cfname"><b>--originalid</b> <i>cfname</i></dt>
<dd>
<p>Places the original ticket organization and ID into a global custom field with the given name. If no global ticket custom field with that name is found in the current database, it will create one.</p>
</dd>
<dt id="ask"><b>--ask</b></dt>
<dd>
<p>Prompt for action when an error occurs inserting a record into the database. This can often happen when importing data from very old RTs where some attachments (usually spam) contain invalid UTF-8.</p>
<p>The importer will pause and ask if you want to ignore the error and continue on or abort (potentially to restart later). Ignoring errors will result in missing records in the database, which may cause database integrity problems later. If you ignored any errors, you should run <code>rt-validator</code> after import.</p>
</dd>
<dt id="ignore-errors"><b>--ignore-errors</b></dt>
<dd>
<p>Ignore all record creation errors and continue on when importing. This is equivalent to running with <code>--ask</code> and manually typing "ignore" at every prompt. You should always run <code>rt-validator</code> after importing with errors ignored.</p>
<p><b>This option can be dangerous and leave you with a broken RT!</b></p>
</dd>
<dt id="dump-class-class"><b>--dump</b> <i>class</i>[,<i>class</i>]</dt>
<dd>
<p>Prints <a href="http://metacpan.org/module/Data::Dumper">Data::Dumper</a> representations of the objects of type <i>class</i> in the serialized data. This is mostly useful for debugging.</p>
<p>Works only in conjunction with <code>--list</code>.</p>
</dd>
</dl>
<h1 id="CLONED-DATA"><a href="#___top">CLONED DATA</a></h1>
<p>Some dumps may have been taken as complete clones of the RT system, which are only suitable for inserting into a schema with no data in it. You can setup the required database state for the receiving RT instance by running:</p>
<pre><code> /usr/sbin/rt-setup-database --action create,schema,acl --prompt-for-dba-password</code></pre>
<p>The normal <code>make initdb</code> step will <b>not</b> work because it also inserts core system data.</p>
<a href="./">← Back to index</a>
|