root / docs / man / kamaki.rst @ 82cc4b8f
History | View | Annotate | Download (7.3 kB)
1 | 5f9bb293 | Kostas Papadimitriou | :orphan: |
---|---|---|---|
2 | 5f9bb293 | Kostas Papadimitriou | |
3 | 5f9bb293 | Kostas Papadimitriou | kamaki tool manual page |
4 | 5f9bb293 | Kostas Papadimitriou | ======================= |
5 | 5f9bb293 | Kostas Papadimitriou | |
6 | 5f9bb293 | Kostas Papadimitriou | Synopsis |
7 | 5f9bb293 | Kostas Papadimitriou | -------- |
8 | 5f9bb293 | Kostas Papadimitriou | |
9 | cf49aa14 | Stavros Sachtouris | **kamaki** [*group*] [*command*] [...] [*options*] |
10 | 5f9bb293 | Kostas Papadimitriou | |
11 | 5f9bb293 | Kostas Papadimitriou | |
12 | 5f9bb293 | Kostas Papadimitriou | Description |
13 | 5f9bb293 | Kostas Papadimitriou | ----------- |
14 | 5f9bb293 | Kostas Papadimitriou | |
15 | 5f9bb293 | Kostas Papadimitriou | :program:`kamaki` is a simple, yet intuitive, command-line tool for managing |
16 | cf49aa14 | Stavros Sachtouris | clouds. It can be used in three forms: as an interactive shell, as a command line tool or as a clients API for other applications. |
17 | 5f9bb293 | Kostas Papadimitriou | |
18 | cf49aa14 | Stavros Sachtouris | To run kamaki as an interactive shell, type |
19 | cf49aa14 | Stavros Sachtouris | |
20 | cf49aa14 | Stavros Sachtouris | kamaki |
21 | cf49aa14 | Stavros Sachtouris | |
22 | cf49aa14 | Stavros Sachtouris | To run kamaki as tool type |
23 | cf49aa14 | Stavros Sachtouris | |
24 | cf49aa14 | Stavros Sachtouris | kamaki <group> <command> [...] [options] |
25 | cf49aa14 | Stavros Sachtouris | |
26 | cf49aa14 | Stavros Sachtouris | The kamaki clients API can be imported in python applications as kamaki.clients |
27 | cf49aa14 | Stavros Sachtouris | |
28 | cf49aa14 | Stavros Sachtouris | |
29 | cf49aa14 | Stavros Sachtouris | List of available command groups: |
30 | 5f9bb293 | Kostas Papadimitriou | |
31 | 5f9bb293 | Kostas Papadimitriou | config |
32 | 5f9bb293 | Kostas Papadimitriou | |
33 | 5f9bb293 | Kostas Papadimitriou | Edit configuration options. Config options are stored in ~/.kamakirc file. |
34 | 5f9bb293 | Kostas Papadimitriou | |
35 | cf49aa14 | Stavros Sachtouris | history |
36 | cf49aa14 | Stavros Sachtouris | |
37 | cf49aa14 | Stavros Sachtouris | Access kamaki user history, which is stored in ~/.kamaki.history file. |
38 | cf49aa14 | Stavros Sachtouris | |
39 | 0ea31480 | Stavros Sachtouris | user |
40 | e9e547ed | Stavros Sachtouris | |
41 | 0ea31480 | Stavros Sachtouris | Get information from Astakos API |
42 | e9e547ed | Stavros Sachtouris | |
43 | 5f9bb293 | Kostas Papadimitriou | server |
44 | 5f9bb293 | Kostas Papadimitriou | |
45 | 5f9bb293 | Kostas Papadimitriou | Manage compute API virtual machines. |
46 | 5f9bb293 | Kostas Papadimitriou | |
47 | 5f9bb293 | Kostas Papadimitriou | flavor |
48 | 5f9bb293 | Kostas Papadimitriou | |
49 | 5f9bb293 | Kostas Papadimitriou | Manage compute API flavors. |
50 | 5f9bb293 | Kostas Papadimitriou | |
51 | 5f9bb293 | Kostas Papadimitriou | network |
52 | 5f9bb293 | Kostas Papadimitriou | |
53 | 5f9bb293 | Kostas Papadimitriou | Manage compute API networks. |
54 | 5f9bb293 | Kostas Papadimitriou | |
55 | cf49aa14 | Stavros Sachtouris | image |
56 | 5f9bb293 | Kostas Papadimitriou | |
57 | 573be34f | Stavros Sachtouris | Manage images on Plankton (and Compute). |
58 | 5f9bb293 | Kostas Papadimitriou | |
59 | 0ea31480 | Stavros Sachtouris | file |
60 | 5f9bb293 | Kostas Papadimitriou | |
61 | 0ea31480 | Stavros Sachtouris | Manage Pithos+ API. |
62 | 5f9bb293 | Kostas Papadimitriou | |
63 | 5f9bb293 | Kostas Papadimitriou | |
64 | f5d9bc54 | Stavros Sachtouris | Hidden command groups |
65 | f5d9bc54 | Stavros Sachtouris | --------------------- |
66 | f5d9bc54 | Stavros Sachtouris | |
67 | 5b879b16 | Stavros Sachtouris | livetest |
68 | f5d9bc54 | Stavros Sachtouris | |
69 | 5b879b16 | Stavros Sachtouris | LIve tests that check kamaki against running services. To enable: |
70 | 0ea31480 | Stavros Sachtouris | kamaki config set livetest.cli livetest |
71 | f5d9bc54 | Stavros Sachtouris | |
72 | f5d9bc54 | Stavros Sachtouris | |
73 | 5f9bb293 | Kostas Papadimitriou | Options |
74 | 5f9bb293 | Kostas Papadimitriou | ------- |
75 | 5f9bb293 | Kostas Papadimitriou | |
76 | 4067cdaf | Stavros Sachtouris | .. code-block:: console |
77 | 4067cdaf | Stavros Sachtouris | |
78 | 4067cdaf | Stavros Sachtouris | --help, -h Show help message and exit. |
79 | 4067cdaf | Stavros Sachtouris | -v Use verbose output. |
80 | 4067cdaf | Stavros Sachtouris | -d Use debug output. |
81 | 4067cdaf | Stavros Sachtouris | -o KEY=VAL Override a config value (can be used multiple times) |
82 | 5f9bb293 | Kostas Papadimitriou | |
83 | 5f9bb293 | Kostas Papadimitriou | |
84 | 5f9bb293 | Kostas Papadimitriou | Commands |
85 | 5f9bb293 | Kostas Papadimitriou | -------- |
86 | 5f9bb293 | Kostas Papadimitriou | |
87 | 5f9bb293 | Kostas Papadimitriou | config commands |
88 | 5f9bb293 | Kostas Papadimitriou | *************** |
89 | 5f9bb293 | Kostas Papadimitriou | |
90 | 5f9bb293 | Kostas Papadimitriou | * list list configuration options |
91 | 5f9bb293 | Kostas Papadimitriou | * get get a configuration option |
92 | 5f9bb293 | Kostas Papadimitriou | * set set a configuration option |
93 | 5f9bb293 | Kostas Papadimitriou | * del delete a configuration option |
94 | 5f9bb293 | Kostas Papadimitriou | |
95 | 5f9bb293 | Kostas Papadimitriou | |
96 | cf49aa14 | Stavros Sachtouris | history commands |
97 | cf49aa14 | Stavros Sachtouris | **************** |
98 | cf49aa14 | Stavros Sachtouris | |
99 | 329753ae | Stavros Sachtouris | Command user history, as stored in ~/.kamaki.history |
100 | cf49aa14 | Stavros Sachtouris | |
101 | f5d9bc54 | Stavros Sachtouris | * show show intersession history |
102 | cf49aa14 | Stavros Sachtouris | * clean clean up history |
103 | f5d9bc54 | Stavros Sachtouris | * run run/show previously executed command(s) |
104 | cf49aa14 | Stavros Sachtouris | |
105 | 5f9bb293 | Kostas Papadimitriou | |
106 | 0ea31480 | Stavros Sachtouris | user commands |
107 | 0ea31480 | Stavros Sachtouris | ************* |
108 | e9e547ed | Stavros Sachtouris | |
109 | e9e547ed | Stavros Sachtouris | * authenticate Authenticate a user, show user information |
110 | e9e547ed | Stavros Sachtouris | |
111 | e9e547ed | Stavros Sachtouris | |
112 | 5f9bb293 | Kostas Papadimitriou | server commands |
113 | 5f9bb293 | Kostas Papadimitriou | *************** |
114 | 5f9bb293 | Kostas Papadimitriou | |
115 | f5d9bc54 | Stavros Sachtouris | * addr List the addresses of all network interfaces on a server (VM) |
116 | f5d9bc54 | Stavros Sachtouris | * console Get a VNC console to access an existing server (VM) |
117 | f5d9bc54 | Stavros Sachtouris | * create Create a server (aka Virtual Machine) |
118 | f5d9bc54 | Stavros Sachtouris | * delete Delete a server (VM) |
119 | cd295a1d | Stavros Sachtouris | * firewall Set the server (VM) firewall profile for public networks |
120 | cd295a1d | Stavros Sachtouris | * set Set the firewall profile |
121 | cd295a1d | Stavros Sachtouris | * get Get the firewall profile |
122 | 8be50626 | Stavros Sachtouris | * ip Manage floating IPs for the servers |
123 | 8be50626 | Stavros Sachtouris | * attach Attach a floating ip to a server with server_id |
124 | 8be50626 | Stavros Sachtouris | * info A floating IPs' details |
125 | 8be50626 | Stavros Sachtouris | * detach Detach floating ip from server |
126 | 8be50626 | Stavros Sachtouris | * list List all floating ips |
127 | 8be50626 | Stavros Sachtouris | * create Create a new floating IP |
128 | 8be50626 | Stavros Sachtouris | * delete Delete a floating ip |
129 | 8be50626 | Stavros Sachtouris | * pools List all floating pools of floating ips |
130 | f5d9bc54 | Stavros Sachtouris | * info Detailed information on a Virtual Machine |
131 | f5d9bc54 | Stavros Sachtouris | * list List Virtual Machines accessible by user |
132 | cd295a1d | Stavros Sachtouris | * metadata Manage a server metadata |
133 | cd295a1d | Stavros Sachtouris | * list List server metadata |
134 | cd295a1d | Stavros Sachtouris | * set Add or update server metadata |
135 | cd295a1d | Stavros Sachtouris | * delete Delete a piece of server metadata |
136 | f5d9bc54 | Stavros Sachtouris | * reboot Reboot a server (VM) |
137 | f5d9bc54 | Stavros Sachtouris | * rename Set/update a server (VM) name |
138 | f5d9bc54 | Stavros Sachtouris | * shutdown Shutdown an active server (VM) |
139 | f5d9bc54 | Stavros Sachtouris | * start Start an existing server (VM) |
140 | f5d9bc54 | Stavros Sachtouris | * stats Get server (VM) statistics |
141 | fc7c3c4c | Stavros Sachtouris | * resize Set a different flavor for an existing server |
142 | f5d9bc54 | Stavros Sachtouris | * wait Wait for server to finish [BUILD, STOPPED, REBOOT, ACTIVE] |
143 | 5f9bb293 | Kostas Papadimitriou | |
144 | 5f9bb293 | Kostas Papadimitriou | |
145 | 5f9bb293 | Kostas Papadimitriou | flavor commands |
146 | 5f9bb293 | Kostas Papadimitriou | *************** |
147 | 5f9bb293 | Kostas Papadimitriou | |
148 | 5f9bb293 | Kostas Papadimitriou | * list list flavors |
149 | 5f9bb293 | Kostas Papadimitriou | * info get flavor details |
150 | 5f9bb293 | Kostas Papadimitriou | |
151 | 5f9bb293 | Kostas Papadimitriou | |
152 | 573be34f | Stavros Sachtouris | image commands |
153 | 573be34f | Stavros Sachtouris | ************** |
154 | 5f9bb293 | Kostas Papadimitriou | |
155 | 395fbf9e | Stavros Sachtouris | * list List images accessible by user |
156 | 82cc4b8f | Stavros Sachtouris | * info Get image metadata |
157 | 404eb288 | Stavros Sachtouris | * meta Manage image metadata |
158 | 404eb288 | Stavros Sachtouris | * set Add / update metadata and properties for an image |
159 | 404eb288 | Stavros Sachtouris | * delete Remove/empty image metadata and/or custom properties |
160 | 395fbf9e | Stavros Sachtouris | * register (Re)Register an image |
161 | 395fbf9e | Stavros Sachtouris | * unregister Unregister an image (does not delete the image file) |
162 | 395fbf9e | Stavros Sachtouris | * shared List shared images |
163 | 395fbf9e | Stavros Sachtouris | * compute Compute Image API commands |
164 | 395fbf9e | Stavros Sachtouris | * list List images |
165 | 395fbf9e | Stavros Sachtouris | * delete Delete image |
166 | 395fbf9e | Stavros Sachtouris | * info Get image details |
167 | 395fbf9e | Stavros Sachtouris | * properties Manage properties related to OS installation in an image |
168 | 395fbf9e | Stavros Sachtouris | * delete Delete a property from an image |
169 | 395fbf9e | Stavros Sachtouris | * get Get an image property |
170 | 395fbf9e | Stavros Sachtouris | * list List all image properties |
171 | 395fbf9e | Stavros Sachtouris | * set Add / update a set of properties for an image |
172 | 395fbf9e | Stavros Sachtouris | * members Manage members (users who can modify an image) |
173 | 395fbf9e | Stavros Sachtouris | * add Add a member to an image |
174 | 395fbf9e | Stavros Sachtouris | * delete Remove a member from an image |
175 | 395fbf9e | Stavros Sachtouris | * list List members of an image |
176 | 395fbf9e | Stavros Sachtouris | * set Set the members of an image |
177 | f5d9bc54 | Stavros Sachtouris | |
178 | 5f9bb293 | Kostas Papadimitriou | |
179 | 5f9bb293 | Kostas Papadimitriou | network commands |
180 | 5f9bb293 | Kostas Papadimitriou | **************** |
181 | 5f9bb293 | Kostas Papadimitriou | |
182 | f5d9bc54 | Stavros Sachtouris | * connect Connect a server to a network |
183 | f5d9bc54 | Stavros Sachtouris | * create Create an (unconnected) network |
184 | f5d9bc54 | Stavros Sachtouris | * delete Delete a network |
185 | f5d9bc54 | Stavros Sachtouris | * disconnect Disconnect a nic that connects a server to a network |
186 | f5d9bc54 | Stavros Sachtouris | * info Detailed information on a network |
187 | f5d9bc54 | Stavros Sachtouris | * list List networks |
188 | f5d9bc54 | Stavros Sachtouris | * rename Set the name of a network |
189 | 5f9bb293 | Kostas Papadimitriou | |
190 | 5f9bb293 | Kostas Papadimitriou | |
191 | 0ea31480 | Stavros Sachtouris | file commands |
192 | 5f9bb293 | Kostas Papadimitriou | ************** |
193 | 5f9bb293 | Kostas Papadimitriou | |
194 | fa382f9e | Stavros Sachtouris | * append Append local file to remote file |
195 | 395fbf9e | Stavros Sachtouris | * cat Print a file to console |
196 | 395fbf9e | Stavros Sachtouris | * copy Copy an object |
197 | 395fbf9e | Stavros Sachtouris | * containerlimit Container size limit commands |
198 | 395fbf9e | Stavros Sachtouris | * set Set container data limit |
199 | 395fbf9e | Stavros Sachtouris | * get Get container data limit |
200 | 395fbf9e | Stavros Sachtouris | * create Create a container |
201 | 395fbf9e | Stavros Sachtouris | * delete Delete a container [or an object] |
202 | 395fbf9e | Stavros Sachtouris | * download Download a file or directory |
203 | 395fbf9e | Stavros Sachtouris | * group Manage access groups and group members |
204 | 395fbf9e | Stavros Sachtouris | * delete Delete a user group |
205 | 545c6c29 | Stavros Sachtouris | * list List groups and group members |
206 | 395fbf9e | Stavros Sachtouris | * set Set a user group |
207 | 395fbf9e | Stavros Sachtouris | * hashmap Get the hashmap of an object |
208 | 395fbf9e | Stavros Sachtouris | * info Get information for account [, container [or object]] |
209 | 395fbf9e | Stavros Sachtouris | * list List containers, object trees or objects in a directory |
210 | 395fbf9e | Stavros Sachtouris | * manifest Create a remote file with uploaded parts by manifestation |
211 | 395fbf9e | Stavros Sachtouris | * metadata Metadata are attached on objects (key:value pairs) |
212 | 395fbf9e | Stavros Sachtouris | * delete Delete metadata with given key |
213 | 395fbf9e | Stavros Sachtouris | * get Get metadatum |
214 | 395fbf9e | Stavros Sachtouris | * set Set a piece of metadata |
215 | 395fbf9e | Stavros Sachtouris | * mkdir Create a directory |
216 | 395fbf9e | Stavros Sachtouris | * move Copy an object |
217 | 395fbf9e | Stavros Sachtouris | * overwrite Overwrite part (from start to end) of a remote file |
218 | 395fbf9e | Stavros Sachtouris | * permissions Manage user and group accessibility for objects |
219 | 395fbf9e | Stavros Sachtouris | * delete Delete all permissions set on object |
220 | 395fbf9e | Stavros Sachtouris | * get Get read and write permissions of an object |
221 | 395fbf9e | Stavros Sachtouris | * set Set permissions for an object |
222 | 395fbf9e | Stavros Sachtouris | * publish Publish an object |
223 | 395fbf9e | Stavros Sachtouris | * purge Purge a container |
224 | 395fbf9e | Stavros Sachtouris | * quota Get quota for account |
225 | 395fbf9e | Stavros Sachtouris | * sharers List the accounts that share objects with default account |
226 | 395fbf9e | Stavros Sachtouris | * touch Create an empty object (file) |
227 | 395fbf9e | Stavros Sachtouris | * truncate Truncate remote file up to a size |
228 | 395fbf9e | Stavros Sachtouris | * unpublish Unpublish an object |
229 | 395fbf9e | Stavros Sachtouris | * upload Upload a file or directory |
230 | 395fbf9e | Stavros Sachtouris | * versioning Manage the versioning scheme of current pithos user account |
231 | 395fbf9e | Stavros Sachtouris | * get Get versioning for account or container |
232 | 395fbf9e | Stavros Sachtouris | * set Set versioning mode (auto, none) for account or container |
233 | 395fbf9e | Stavros Sachtouris | * versions Get the version list of an object |
234 | f5d9bc54 | Stavros Sachtouris | |
235 | f5d9bc54 | Stavros Sachtouris | |
236 | f5d9bc54 | Stavros Sachtouris | test commands (hidden) |
237 | f5d9bc54 | Stavros Sachtouris | ********************** |
238 | f5d9bc54 | Stavros Sachtouris | |
239 | f5d9bc54 | Stavros Sachtouris | * all test all clients |
240 | 0ea31480 | Stavros Sachtouris | * args test how arguments are treated by kamaki |
241 | f5d9bc54 | Stavros Sachtouris | * astakos test Astakos client |
242 | f5d9bc54 | Stavros Sachtouris | * cyclades test Cyclades client |
243 | f5d9bc54 | Stavros Sachtouris | * error Create an error message with optional message |
244 | f5d9bc54 | Stavros Sachtouris | * image test Image client |
245 | f5d9bc54 | Stavros Sachtouris | * pithos test Pithos client |
246 | f5d9bc54 | Stavros Sachtouris | * prints user-test print methods for lists and dicts |
247 | 5f9bb293 | Kostas Papadimitriou | |
248 | 5f9bb293 | Kostas Papadimitriou | |
249 | 5f9bb293 | Kostas Papadimitriou | Author |
250 | 5f9bb293 | Kostas Papadimitriou | ------ |
251 | 5f9bb293 | Kostas Papadimitriou | |
252 | 76e7661e | Stavros Sachtouris | Synnefo development team <synnefo-devel@googlegroups.com>. |