[2551] | 1 | <!-- $Id$ --> |
---|
[2541] | 2 | |
---|
| 3 | <chapter> |
---|
| 4 | <title>Initialize your database with pkturnkey</title> |
---|
| 5 | <para>Last modified on $Date$</para> |
---|
| 6 | |
---|
| 7 | <para> |
---|
[2557] | 8 | The ultimate goal of the <command>pkturnkey</command> command line tool is |
---|
| 9 | to transform <application>PyKota</application> into a turn-key solution. |
---|
[2541] | 10 | </para> |
---|
| 11 | |
---|
[2557] | 12 | <para> |
---|
| 13 | For now its functionnalities are fairly limited, but it can : |
---|
| 14 | <itemizedlist> |
---|
| 15 | <listitem> |
---|
| 16 | <para> |
---|
| 17 | Import existing print queues into <application>PyKota</application>'s database. |
---|
| 18 | </para> |
---|
| 19 | </listitem> |
---|
| 20 | <listitem> |
---|
| 21 | <para> |
---|
| 22 | Import existing users into <application>PyKota</application>'s database. |
---|
| 23 | </para> |
---|
| 24 | </listitem> |
---|
| 25 | <listitem> |
---|
| 26 | <para> |
---|
| 27 | Import existing users groups into <application>PyKota</application>'s database. |
---|
| 28 | </para> |
---|
| 29 | </listitem> |
---|
| 30 | <listitem> |
---|
| 31 | <para> |
---|
| 32 | Tell you which accounting method is the best for your printers. |
---|
| 33 | </para> |
---|
| 34 | </listitem> |
---|
| 35 | </itemizedlist> |
---|
| 36 | </para> |
---|
| 37 | |
---|
| 38 | <para> |
---|
| 39 | In the future, it is possible that this command will entirely generate configuration |
---|
| 40 | files for you, and do a bunch of other things to ease the installation and |
---|
| 41 | configuration of <application>PyKota</application> |
---|
| 42 | </para> |
---|
| 43 | |
---|
| 44 | <para> |
---|
| 45 | One very important thing to remember is that, by default, <command>pkturnkey</command> |
---|
| 46 | doesn't modify anything, unless you tell it to really do so by using its |
---|
| 47 | <literal>--force</literal> (or <literal>-f</literal>) command line switch. |
---|
| 48 | This lets you familiarize with what would happen before doing it for real, |
---|
| 49 | especially because <command>pkturnkey</command> displays the other commands |
---|
| 50 | it would launch. |
---|
| 51 | </para> |
---|
| 52 | |
---|
| 53 | <para> |
---|
| 54 | You can restrict the datas you want to import into the database by using the |
---|
| 55 | appropriate command line switches, or by passing printers' names as non-option |
---|
| 56 | arguments at the end of the command line. |
---|
| 57 | </para> |
---|
| 58 | |
---|
| 59 | <para> |
---|
| 60 | The following example will import all existing print queues, as well as all |
---|
| 61 | users whose uid is comprised between 1000 and 50000 and all groups whose |
---|
| 62 | gid is comprised between 5000 and 6000 : |
---|
| 63 | <screen> |
---|
| 64 | $ pkturnkey --force --uidmin 1000 --dousers --uidmax 50000 --dogroups --gidmin 5000 --gidmax 6000 |
---|
| 65 | </screen> |
---|
| 66 | </para> |
---|
| 67 | |
---|
[2541] | 68 | <sect1> |
---|
| 69 | <title>Reference</title> |
---|
| 70 | <para> |
---|
| 71 | <cmdsynopsis> |
---|
| 72 | <command>pkmail</command> |
---|
| 73 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
---|
| 74 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
---|
[2557] | 75 | <group choice="opt"><arg>-f</arg><arg>--force</arg></group> |
---|
| 76 | <group choice="opt"><arg>-d</arg><arg>--dousers</arg></group> |
---|
| 77 | <group choice="opt"><arg>-D</arg><arg>--dogroups</arg></group> |
---|
| 78 | <group choice="opt"> |
---|
| 79 | <arg>-u <replaceable>uid</replaceable></arg> |
---|
| 80 | <arg>--uidmin <replaceable>uid</replaceable></arg> |
---|
| 81 | </group> |
---|
| 82 | <group choice="opt"> |
---|
| 83 | <arg>-U <replaceable>uid</replaceable></arg> |
---|
| 84 | <arg>--uidmax <replaceable>uid</replaceable></arg> |
---|
| 85 | </group> |
---|
| 86 | <group choice="opt"> |
---|
| 87 | <arg>-g <replaceable>gid</replaceable></arg> |
---|
| 88 | <arg>--gidmin <replaceable>gid</replaceable></arg> |
---|
| 89 | </group> |
---|
| 90 | <group choice="opt"> |
---|
| 91 | <arg>-G <replaceable>gid</replaceable></arg> |
---|
| 92 | <arg>--gidmax <replaceable>gid</replaceable></arg> |
---|
| 93 | </group> |
---|
[2541] | 94 | </cmdsynopsis> |
---|
| 95 | </para> |
---|
| 96 | </sect1> |
---|
| 97 | </chapter> |
---|
| 98 | |
---|