root / pykota / trunk / docs / pkturnkey.sgml @ 2948

Revision 2560, 3.4 kB (checked in by jerome, 19 years ago)

Typo

  • Property svn:keywords set to Author Date Id Revision
Line 
1<!-- $Id$ -->
2
3<chapter>
4  <title>Initialize your database with pkturnkey</title>
5  <para>Last modified on $Date$</para>
6 
7  <para>
8    The ultimate goal of the <command>pkturnkey</command> command line tool is
9    to transform <application>PyKota</application> into a turn-key solution.
10  </para> 
11 
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 
68  <sect1>
69    <title>Reference</title>
70    <para>
71      <cmdsynopsis>
72        <command>pkturnkey</command>
73        <group choice="opt"><arg>-v</arg><arg>--version</arg></group>
74        <group choice="opt"><arg>-h</arg><arg>--help</arg></group>
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> 
94      </cmdsynopsis>
95    </para>
96  </sect1>
97</chapter>
98
Note: See TracBrowser for help on using the browser.