root / snf-app / docs / src / admin_tools.rst @ d2df1ace
History | View | Annotate | Download (1.4 kB)
| 1 |
Administration Tools User's Guide |
|---|---|
| 2 |
================================= |
| 3 |
|
| 4 |
Registering an Image |
| 5 |
-------------------- |
| 6 |
|
| 7 |
To upload an image to Pithos and register it for use by Plankton, use the **image upload** command:: |
| 8 |
|
| 9 |
snf-admin image upload Ubuntu /tmp/ubuntu.iso --public |
| 10 |
|
| 11 |
You can additionally pass *disk_format*, *container_format* and other custom metadata:: |
| 12 |
|
| 13 |
snf-admin image upload Ubuntu /tmp/ubuntu.iso --public --disk-format diskdump --meta kernel=2.6.42 |
| 14 |
|
| 15 |
The images are uploaded to the *images* container of the *SYSTEM_IMAGES_OWNER* user (defined in settings). |
| 16 |
|
| 17 |
To register an image that is already stored in Pithos, use the **image register** command:: |
| 18 |
|
| 19 |
snf-admin image register Debian pithos://okeanos/images/debian.iso dump --public |
| 20 |
|
| 21 |
As with upload you can additionally pass custom metadata with ``--meta``. |
| 22 |
|
| 23 |
To verify the image use **image list**: |
| 24 |
|
| 25 |
snf-admin image list -l a58a3cce-c938-6ef4-6b1a-529bda1e9e03 |
| 26 |
|
| 27 |
|
| 28 |
Modifying an Image |
| 29 |
------------------ |
| 30 |
|
| 31 |
You can modify an already registered image use **image update**:: |
| 32 |
|
| 33 |
snf-admin image update a58a3cce-c938-6ef4-6b1a-529bda1e9e03 --disk-format diskdump --name Xubuntu |
| 34 |
|
| 35 |
To modify just the custom metadata use **image meta**:: |
| 36 |
|
| 37 |
snf-admin image meta a58a3cce-c938-6ef4-6b1a-529bda1e9e03 OS=Linux |
| 38 |
|
| 39 |
To verify all the metadata, use **image meta** with no arguments:: |
| 40 |
|
| 41 |
snf-admin image meta a58a3cce-c938-6ef4-6b1a-529bda1e9e03 |