Revision c0d88cf3 docs/admin-guide.rst

b/docs/admin-guide.rst
847 847
   $ kamaki config set user.url https://accounts.example.com
848 848
   $ kamaki config set token ...
849 849

  
850
To test that everything works, try authenticating the current account with kamaki:
850
To test that everything works, try authenticating the current account with
851
kamaki:
851 852

  
852 853
.. code-block:: console
853 854

  
854 855
  $ kamaki user authenticate
855 856

  
856
This will output some user information. For example, *uuid* (unique user id) is quite useful.
857
This will output user information.
857 858

  
858 859
Upload Image
859 860
------------
860 861

  
861
By convention, images are stored in a container called ``images``. Check if the container exists, by listing all containers in your account:
862
By convention, images are stored in a container called ``images``. Check if the
863
container exists, by listing all containers in your account:
862 864

  
863 865
.. code-block:: console
864 866

  
......
870 872

  
871 873
  $ kamaki file create images
872 874

  
873
You are now ready to upload an image to container ``images``. You can upload it with a Pithos+ client, or use kamaki directly:
875
You are now ready to upload an image to container ``images``. You can upload it
876
with a Pithos+ client, or use kamaki directly:
874 877

  
875 878
.. code-block:: console
876 879

  
877 880
   $ kamaki file upload ubuntu.iso images
878 881

  
879
You can use any Pithos+ client to verify that the image was uploaded correctly, or you can list the contents of the container with kamaki:
882
You can use any Pithos+ client to verify that the image was uploaded correctly,
883
or you can list the contents of the container with kamaki:
880 884

  
881 885
.. code-block:: console
882 886

  
883 887
  $ kamaki file list images
884 888

  
885 889
The full Pithos URL for the previous example will be
886
``pithos://u53r-un1qu3-1d/images/ubuntu.iso``
887
where ``u53r-un1qu3-1d`` is the unique user id (uuid).
888

  
890
``pithos://u53r-un1qu3-1d/images/ubuntu.iso`` where ``u53r-un1qu3-1d`` is the
891
unique user id (uuid).
889 892

  
890 893
Register Image
891 894
--------------

Also available in: Unified diff