root / man / gnt-job.rst @ 6d3d13ab
History | View | Annotate | Download (3.4 kB)
1 | b3723c81 | Iustin Pop | gnt-job(8) Ganeti | Version @GANETI_VERSION@ |
---|---|---|---|
2 | b3723c81 | Iustin Pop | ============================================ |
3 | b3723c81 | Iustin Pop | |
4 | b3723c81 | Iustin Pop | Name |
5 | b3723c81 | Iustin Pop | ---- |
6 | b3723c81 | Iustin Pop | |
7 | b3723c81 | Iustin Pop | gnt-job - Job commands |
8 | b3723c81 | Iustin Pop | |
9 | b3723c81 | Iustin Pop | Synopsis |
10 | b3723c81 | Iustin Pop | -------- |
11 | b3723c81 | Iustin Pop | |
12 | b3723c81 | Iustin Pop | **gnt-job** {command} [arguments...] |
13 | b3723c81 | Iustin Pop | |
14 | b3723c81 | Iustin Pop | DESCRIPTION |
15 | b3723c81 | Iustin Pop | ----------- |
16 | b3723c81 | Iustin Pop | |
17 | b3723c81 | Iustin Pop | The **gnt-job** is used for examining and manipulating the job |
18 | b3723c81 | Iustin Pop | queue. |
19 | b3723c81 | Iustin Pop | |
20 | b3723c81 | Iustin Pop | COMMANDS |
21 | b3723c81 | Iustin Pop | -------- |
22 | b3723c81 | Iustin Pop | |
23 | b3723c81 | Iustin Pop | ARCHIVE |
24 | b3723c81 | Iustin Pop | ~~~~~~~ |
25 | b3723c81 | Iustin Pop | |
26 | b3723c81 | Iustin Pop | **archive** {id...} |
27 | b3723c81 | Iustin Pop | |
28 | b3723c81 | Iustin Pop | This command can be used to archive job by their IDs. Only jobs |
29 | b3723c81 | Iustin Pop | that have finished execution (i.e either *success*, *error* or |
30 | b3723c81 | Iustin Pop | *canceled* jobs). |
31 | b3723c81 | Iustin Pop | |
32 | b3723c81 | Iustin Pop | AUTOARCHIVE |
33 | b3723c81 | Iustin Pop | ~~~~~~~~~~~ |
34 | b3723c81 | Iustin Pop | |
35 | b3723c81 | Iustin Pop | **autoarchive** {*age* | ``all``} |
36 | b3723c81 | Iustin Pop | |
37 | b3723c81 | Iustin Pop | Archive jobs by their age. This command can archive jobs older than |
38 | b3723c81 | Iustin Pop | *age* seconds, or alternatively all finished jobs can be archived |
39 | b3723c81 | Iustin Pop | if the string all is passed. |
40 | b3723c81 | Iustin Pop | |
41 | b3723c81 | Iustin Pop | CANCEL |
42 | b3723c81 | Iustin Pop | ~~~~~~ |
43 | b3723c81 | Iustin Pop | |
44 | e1c701e7 | Michael Hanselmann | | **cancel** |
45 | e1c701e7 | Michael Hanselmann | | {[\--force] {\--pending | \--queued | \--waiting} | *job-id* ...} |
46 | b3723c81 | Iustin Pop | |
47 | e1c701e7 | Michael Hanselmann | Cancel the job(s) identified by the given *job id*. Only jobs that have |
48 | b3723c81 | Iustin Pop | not yet started to run can be canceled; that is, jobs in either the |
49 | e1c701e7 | Michael Hanselmann | *queued* or *waiting* state. To skip a confirmation, pass ``--force``. |
50 | e1c701e7 | Michael Hanselmann | ``--queued`` and ``waiting`` can be used to cancel all jobs in the |
51 | e1c701e7 | Michael Hanselmann | respective state, ``--pending`` includes both. |
52 | b3723c81 | Iustin Pop | |
53 | e9e07c9c | Michael Hanselmann | CHANGE-PRIORITY |
54 | e9e07c9c | Michael Hanselmann | ~~~~~~~~~~~~~~~ |
55 | e9e07c9c | Michael Hanselmann | |
56 | e9e07c9c | Michael Hanselmann | | **change-priority** --priority {low | normal | high} |
57 | e9e07c9c | Michael Hanselmann | | {[\--force] {\--pending | \--queued | \--waiting} | *job-id* ...} |
58 | e9e07c9c | Michael Hanselmann | |
59 | e9e07c9c | Michael Hanselmann | Changes the priority of one or multiple pending jobs. Jobs currently |
60 | e9e07c9c | Michael Hanselmann | running have only the priority of remaining opcodes changed. |
61 | e9e07c9c | Michael Hanselmann | ``--priority`` must be specified. ``--queued`` and ``waiting`` can be |
62 | e9e07c9c | Michael Hanselmann | used to re-prioritize all jobs in the respective state, ``--pending`` |
63 | e9e07c9c | Michael Hanselmann | includes both. To skip a confirmation, pass ``--force``. |
64 | e9e07c9c | Michael Hanselmann | |
65 | b3723c81 | Iustin Pop | INFO |
66 | b3723c81 | Iustin Pop | ~~~~ |
67 | b3723c81 | Iustin Pop | |
68 | b3723c81 | Iustin Pop | **info** {*id*...} |
69 | b3723c81 | Iustin Pop | |
70 | b3723c81 | Iustin Pop | Show detailed information about the given job id(s). If no job id |
71 | b3723c81 | Iustin Pop | is given, all jobs are examined (warning, this is a lot of |
72 | b3723c81 | Iustin Pop | information). |
73 | b3723c81 | Iustin Pop | |
74 | b3723c81 | Iustin Pop | LIST |
75 | b3723c81 | Iustin Pop | ~~~~ |
76 | b3723c81 | Iustin Pop | |
77 | 72ef8df8 | Michael Hanselmann | | **list** [\--no-headers] [\--separator=*SEPARATOR*] |
78 | 72ef8df8 | Michael Hanselmann | | [-o *[+]FIELD,...*] [\--filter] [job-id...] |
79 | b3723c81 | Iustin Pop | |
80 | b3723c81 | Iustin Pop | Lists the jobs and their status. By default, the job id, job |
81 | b3723c81 | Iustin Pop | status, and a small job description is listed, but additional |
82 | b3723c81 | Iustin Pop | parameters can be selected. |
83 | b3723c81 | Iustin Pop | |
84 | b3723c81 | Iustin Pop | The ``--no-headers`` option will skip the initial header line. The |
85 | b3723c81 | Iustin Pop | ``--separator`` option takes an argument which denotes what will be |
86 | b3723c81 | Iustin Pop | used between the output fields. Both these options are to help |
87 | b3723c81 | Iustin Pop | scripting. |
88 | b3723c81 | Iustin Pop | |
89 | b3723c81 | Iustin Pop | The ``-o`` option takes a comma-separated list of output fields. |
90 | b3723c81 | Iustin Pop | The available fields and their meaning are: |
91 | b3723c81 | Iustin Pop | |
92 | 3086220e | Michael Hanselmann | @QUERY_FIELDS_JOB@ |
93 | b3723c81 | Iustin Pop | |
94 | 3086220e | Michael Hanselmann | If the value of the option starts with the character ``+``, the new |
95 | 3086220e | Michael Hanselmann | fields will be added to the default list. This allows one to quickly |
96 | 3086220e | Michael Hanselmann | see the default list plus a few other fields, instead of retyping |
97 | 3086220e | Michael Hanselmann | the entire list of fields. |
98 | b3723c81 | Iustin Pop | |
99 | 43d51ef2 | Michael Hanselmann | To include archived jobs in the list the ``--archived`` option can be |
100 | 43d51ef2 | Michael Hanselmann | used. |
101 | 43d51ef2 | Michael Hanselmann | |
102 | 72ef8df8 | Michael Hanselmann | The following options can be used to show only specific jobs: |
103 | 72ef8df8 | Michael Hanselmann | |
104 | 72ef8df8 | Michael Hanselmann | ``--pending`` |
105 | 72ef8df8 | Michael Hanselmann | Show only jobs pending execution. |
106 | 72ef8df8 | Michael Hanselmann | ``--running`` |
107 | 72ef8df8 | Michael Hanselmann | Show jobs currently running only. |
108 | 72ef8df8 | Michael Hanselmann | ``--error`` |
109 | 72ef8df8 | Michael Hanselmann | Show failed jobs only. |
110 | 72ef8df8 | Michael Hanselmann | ``--finished`` |
111 | 72ef8df8 | Michael Hanselmann | Show finished jobs only. |
112 | 72ef8df8 | Michael Hanselmann | |
113 | 72ef8df8 | Michael Hanselmann | If exactly one argument is given and it appears to be a query filter |
114 | 354c4f62 | Michael Hanselmann | (see **ganeti**\(7)), the query result is filtered accordingly. For |
115 | 72ef8df8 | Michael Hanselmann | ambiguous cases (e.g. a single field name as a filter) the ``--filter`` |
116 | 72ef8df8 | Michael Hanselmann | (``-F``) option forces the argument to be treated as a filter. |
117 | 72ef8df8 | Michael Hanselmann | |
118 | b3723c81 | Iustin Pop | |
119 | 3086220e | Michael Hanselmann | LIST-FIELDS |
120 | 3086220e | Michael Hanselmann | ~~~~~~~~~~~ |
121 | b3723c81 | Iustin Pop | |
122 | 3086220e | Michael Hanselmann | **list-fields** [field...] |
123 | b3723c81 | Iustin Pop | |
124 | 3086220e | Michael Hanselmann | Lists available fields for jobs. |
125 | b3723c81 | Iustin Pop | |
126 | b3723c81 | Iustin Pop | |
127 | b3723c81 | Iustin Pop | WATCH |
128 | b3723c81 | Iustin Pop | ~~~~~ |
129 | b3723c81 | Iustin Pop | |
130 | b3723c81 | Iustin Pop | **watch** {id} |
131 | b3723c81 | Iustin Pop | |
132 | b3723c81 | Iustin Pop | This command follows the output of the job by the given *id* and |
133 | b3723c81 | Iustin Pop | prints it. |
134 | 9ff4f2c0 | Michael Hanselmann | |
135 | 9ff4f2c0 | Michael Hanselmann | .. vim: set textwidth=72 : |
136 | 9ff4f2c0 | Michael Hanselmann | .. Local Variables: |
137 | 9ff4f2c0 | Michael Hanselmann | .. mode: rst |
138 | 9ff4f2c0 | Michael Hanselmann | .. fill-column: 72 |
139 | 9ff4f2c0 | Michael Hanselmann | .. End: |