-This document describes changes and steps to upgrade from kamaki 0.7.X to kamaki 0.8
-
-This document refers to users who:
-- use the kamaki command line
-- load configuration options with the kamaki.cli.config
-
-Notable changes:
-- Make progress (>= 1.1) module a requirement (was a suggestion)
-- Rename some command groups:
- store --> file
- astakos --> user
-- Rename some mandatory configuration options:
- astakos.url --> user.url,
- store.url --> file.url
-- Do not require <cmd group>.cli (cli specification) field in configuration file, use it only to override default values.
-- Change the naming convention for cli specifications by loosing the _cli suffix:
- <cmd group>_cli --> <cmd group>
-- Seperate kamaki image commands based on whether they make requests to Plankton or Cyclades.
- Plankton image commands: kamaki image <action>
- Cyclades image commands: kamaki image compute <action>
-- Rename: kamaki image public --> kamaki image list
-- Change letter case for recursive download runtime argument:
- kamaki store download -r <container>:<path> [local destination]
- -->
- kamaki file download -R <container>:<path> [local destination]
-
-
-Suggested upgrade method:
-1. Backup the .kamakirc file (usually stored as ~/.kamakirc). E.g.:
- cp ~/.kamakirc ~/tmp/.kamakirc.bu
-2. Upgrade kamaki (refer to your installation method). E.g. if installed from pypi:
- pip install --upgrade kamaki
-3. Download the script bellow:
- For Linux, OS X, *nix, systems that run bash:
- https://code.grnet.gr/attachments/download/2493/kamaki0.7to0.8.sh
- For windows:
- https://code.grnet.gr/attachments/download/2497/kamaki0.7to0.8.bat
-and run it from command line. This script will modify the default .kamakirc file in order to comply with version 0.8
+This document describes changes and steps to upgrade from kamaki 0.11 to
+kamaki 0.12
+
+1. Update the kamaki configuration with these commands:
+ $ kamaki config delete network_cli
+ $ kamaki config delete ip_cli
+
+2. Upgrade shell scripts to use the new syntax:
+ positional arguments are removed, except if refering to the objects
+ e.g., kamaki server info SERVER_ID
+ but not kamaki server create NAME IMAGE FLAVOR
+ Use mandatory non-positional arguments
+ e.g., kamaki server create --name=NAME --image-id=IMAGE_ID --flavor-id=FLAVOR_ID
+ kamaki image register --name=NAME --location=IMAGE_LOCATION
+
+Config file
+-----------
+
+Kamaki v0.9 will have a new config file with the following format:
+
+ [global]
+ default_cloud = some_cloud
+ ... more kamaki-related settings ...
+
+ [cloud "some_cloud"]
+ url = https://some/cloud/single/authentication/url
+ token = user_token==
+
+For more information on the exact format of the kamaki global variables, see
+the respective documentation page:
+http://www.synnefo.org/docs/kamaki/latest/setup.html#available-options
+
+How to convert the config file
+------------------------------
+
+To convert an old config file, backup the old one and then run:
+
+ kamaki -c <config file path> user authenticate
+
+Kamaki will automatically inspect the file and suggest a list of convertions,
+namely renamings and discards. Take a look at the list of discarded values,
+write down the ones that might be usefull.
+
+If you are sure about the changes, press 'y'.
+
+Kamaki should raise an error, demanding an authentication URL and/or token.
+
+First, you need to go to the clouds UI and find the authentication URL and
+token. Then you should think of a name for your cloud, e.g. "mycloud". Now,
+feed kamaki with this information:
+
+kamaki -c <config file path> config set cloud.mycloud.url <URL>
+kamaki -c <config file path> config set cloud.mycloud.token <token>
+
+Now the configuration file should be kamaki 0.9 ready.