Revision c0d88cf3 docs/quick-install-admin-guide.rst

b/docs/quick-install-admin-guide.rst
2093 2093

  
2094 2094
The USER_TOKEN appears on the user's `Profile` web page on the Astakos Web UI.
2095 2095

  
2096
You can see that the new configuration options have been applied correctly, either by checking the editable file ``~/.kamakirc`` or by running:
2096
You can see that the new configuration options have been applied correctly,
2097
either by checking the editable file ``~/.kamakirc`` or by running:
2097 2098

  
2098 2099
.. code-block:: console
2099 2100

  
2100 2101
   $ kamaki config list
2101 2102

  
2102
A quick test to check if kamaki is configured correctly is a user authentication based on the provided token:
2103
A quick test to check that kamaki is configured correctly, is to try to
2104
authenticate a user based on his/her token (in this case the user is you):
2103 2105

  
2104 2106
.. code-block:: console
2105 2107

  
2106 2108
  $ kamaki user authenticate
2107 2109

  
2108
The above operation should provide various user information, e.g. UUID (the unique user id) which might prove useful in some operations.
2110
The above operation provides various user information, e.g. UUID (the unique
2111
user id) which might prove useful in some operations.
2109 2112

  
2110 2113
Upload an Image file to Pithos+
2111 2114
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
......
2128 2131

  
2129 2132
   $ kamaki file create images
2130 2133

  
2131
To check if the container has been created, list all containers of your account:
2134
To check if the container has been created, list all containers of your
2135
account:
2132 2136

  
2133 2137
.. code-block:: console
2134 2138

  
......
2140 2144

  
2141 2145
   $ kamaki file upload /srv/images/debian_base-6.0-7-x86_64.diskdump images
2142 2146

  
2143
The first is the local path and the second is the remote container on Pithos+. Check if the file has been uploaded, by listing the container contents:
2147
The first is the local path and the second is the remote container on Pithos+.
2148
Check if the file has been uploaded, by listing the container contents:
2144 2149

  
2145 2150
.. code-block:: console
2146 2151

  
......
2151 2156
Register an existing Image file to Plankton
2152 2157
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2153 2158

  
2154
For the purposes of the following example, we assume that the user UUID is ``u53r-un1qu3-1d``.
2159
For the purposes of the following example, we assume that the user UUID is
2160
``u53r-un1qu3-1d``.
2155 2161

  
2156 2162
Once the Image file has been successfully uploaded on Pithos+ then we register
2157 2163
it to Plankton (so that it becomes visible to Cyclades), by running:
......
2159 2165
.. code-block:: console
2160 2166

  
2161 2167
   $ kamaki image register "Debian Base" \
2162
                  pithos://u53r-un1qu3-1d/images/debian_base-6.0-7-x86_64.diskdump \
2163
                  --public \
2164
                  --disk-format=diskdump \
2165
                  --property OSFAMILY=linux --property ROOT_PARTITION=1 \
2166
                  --property description="Debian Squeeze Base System" \
2167
                  --property size=451 --property kernel=2.6.32 --property GUI="No GUI" \
2168
                  --property sortorder=1 --property USERS=root --property OS=debian
2168
                           pithos://u53r-un1qu3-1d/images/debian_base-6.0-7-x86_64.diskdump \
2169
                           --public \
2170
                           --disk-format=diskdump \
2171
                           --property OSFAMILY=linux --property ROOT_PARTITION=1 \
2172
                           --property description="Debian Squeeze Base System" \
2173
                           --property size=451 --property kernel=2.6.32 --property GUI="No GUI" \
2174
                           --property sortorder=1 --property USERS=root --property OS=debian
2169 2175

  
2170 2176
This command registers the Pithos+ file
2171 2177
``pithos://u53r-un1qu3-1d/images/debian_base-6.0-7-x86_64.diskdump`` as an

Also available in: Unified diff