Revision f0497c25

b/docs/admin-guide.rst
642 642

  
643 643
.. code-block:: console
644 644

  
645
 $ kamaki image register "Debian Base" \
646
        pithos://u53r-un1qu3-1d/images/debian_base-6.0-7-x86_64.diskdump \
645
 $ kamaki image register --name="Debian Base" \
646
        --location=pithos://u53r-un1qu3-1d/images/debian_base-6.0-7-x86_64.diskdump \
647 647
        --public \
648 648
        --disk-format=diskdump \
649 649
        --property OSFAMILY=linux --property ROOT_PARTITION=1 \
......
1660 1660

  
1661 1661
.. code-block:: console
1662 1662

  
1663
   $ kamaki config set image.url https://cyclades.example.com/image
1664
   $ kamaki config set file.url https://pithos.example.com/v1
1665
   $ kamaki config set user.url https://accounts.example.com
1666
   $ kamaki config set token ...
1663
   $ kamaki config set cloud.default.url https://example.com/identity/v2.0
1664
   $ kamaki config set cloud.default.token ...
1667 1665

  
1668 1666
To test that everything works, try authenticating the current account with
1669 1667
kamaki:
......
1682 1680

  
1683 1681
.. code-block:: console
1684 1682

  
1685
   $ kamaki file list
1683
   $ kamaki file list /images
1686 1684

  
1687 1685
If the container ``images`` does not exist, create it:
1688 1686

  
1689 1687
.. code-block:: console
1690 1688

  
1691
  $ kamaki file create images
1689
  $ kamaki container create images
1692 1690

  
1693 1691
You are now ready to upload an image to container ``images``. You can upload it
1694 1692
with a Pithos client, or use kamaki directly:
1695 1693

  
1696 1694
.. code-block:: console
1697 1695

  
1698
   $ kamaki file upload ubuntu.iso images
1696
   $ kamaki file upload ubuntu.iso /images
1699 1697

  
1700 1698
You can use any Pithos client to verify that the image was uploaded correctly,
1701 1699
or you can list the contents of the container with kamaki:
1702 1700

  
1703 1701
.. code-block:: console
1704 1702

  
1705
  $ kamaki file list images
1703
  $ kamaki file list /images
1706 1704

  
1707 1705
The full Pithos URL for the previous example will be
1708 1706
``pithos://u53r-un1qu3-1d/images/ubuntu.iso`` where ``u53r-un1qu3-1d`` is the
......
1711 1709
Register Image
1712 1710
--------------
1713 1711

  
1714
To register an image you will need to use the full Pithos URL. To register as
1715
a public image the one from the previous example use:
1712
To register an image you will need to use the full or the relative Pithos URL.
1713
To register as a public image the one from the previous example use:
1716 1714

  
1717 1715
.. code-block:: console
1718 1716

  
1719
   $ kamaki image register Ubuntu pithos://u53r-un1qu3-1d/images/ubuntu.iso --public
1717
   $ kamaki image register --name=Ubuntu --location=/images/ubuntu.iso --public
1720 1718

  
1721 1719
The ``--public`` flag is important, if missing the registered image will not
1722 1720
be listed by ``kamaki image list``.
......
1726 1724

  
1727 1725
.. code-block:: console
1728 1726

  
1729
   $ kamaki image register Ubuntu pithos://u53r-un1qu3-1d/images/ubuntu.iso \
1727
   $ kamaki image register --name Ubuntu --location /images/ubuntu.iso \
1730 1728
            --public --disk-format diskdump --property kernel=3.1.2
1731 1729

  
1732 1730
To verify that the image was registered successfully use:
1733 1731

  
1734 1732
.. code-block:: console
1735 1733

  
1736
   $ kamaki image list --name-like=ubuntu
1734
   $ kamaki image list --name-like ubuntu
1737 1735

  
1738 1736

  
1739 1737
Miscellaneous
b/docs/quick-install-admin-guide.rst
2255 2255

  
2256 2256
.. code-block:: console
2257 2257

  
2258
   $ kamaki file create images
2258
   $ kamaki container create images
2259 2259

  
2260 2260
To check if the container has been created, list all containers of your
2261 2261
account:
2262 2262

  
2263 2263
.. code-block:: console
2264 2264

  
2265
  $ kamaki file list
2265
  $ kamaki file list /images
2266 2266

  
2267 2267
Then, we upload the Image file to that container:
2268 2268

  
2269 2269
.. code-block:: console
2270 2270

  
2271
   $ kamaki file upload /srv/images/debian_base-6.0-7-x86_64.diskdump images
2271
   $ kamaki file upload /srv/images/debian_base-6.0-7-x86_64.diskdump /images
2272 2272

  
2273 2273
The first is the local path and the second is the remote container on Pithos.
2274 2274
Check if the file has been uploaded, by listing the container contents:
2275 2275

  
2276 2276
.. code-block:: console
2277 2277

  
2278
  $ kamaki file list images
2278
  $ kamaki file list /images
2279 2279

  
2280 2280
Alternatively check if the new container and file appear on the Pithos Web UI.
2281 2281

  
......
2290 2290

  
2291 2291
.. code-block:: console
2292 2292

  
2293
   $ kamaki image register "Debian Base" \
2294
                           pithos://u53r-un1qu3-1d/images/debian_base-6.0-11-x86_64.diskdump \
2293
   $ kamaki image register --name "Debian Base" \
2294
                           --location /images/debian_base-6.0-11-x86_64.diskdump \
2295 2295
                           --public \
2296 2296
                           --disk-format=diskdump \
2297 2297
                           --property OSFAMILY=linux --property ROOT_PARTITION=1 \

Also available in: Unified diff