Revision c3396aeb README.Upgrade

b/README.Upgrade
1
This document describes changes and steps to upgrade from kamaki 0.7.X to kamaki 0.8
1
This document describes changes and steps to upgrade from kamaki 0.8.X to kamaki 0.9
2 2

  
3
This document refers to users who:
4
- use the kamaki command line
5
- load configuration options with the kamaki.cli.config
6

  
7
Notable changes:
8
- Make progress (>= 1.1) module a requirement (was a suggestion)
9
- log http requests to ~/.kamaki.log
10
- Rename some command groups:
11
    store --> file
12
    astakos --> user
13
- Rename some mandatory configuration options:
14
    astakos.url --> user.url,
15
    store.url --> file.url
16
- Do not require <cmd group>.cli (cli specification) field in configuration file, use it only to override default values.
17
- Change the naming convention for cli specifications by loosing the _cli suffix:
18
    <cmd group>_cli --> <cmd group>
19
- Seperate kamaki image commands based on whether they make requests to Plankton or Cyclades.
20
    Plankton image commands: kamaki image <action>
21
    Cyclades image commands: kamaki image compute <action>
22
- Rename: kamaki image public --> kamaki image list
23
- Change letter case for recursive download runtime argument:
24
    kamaki store download -r <container>:<path> [local destination]
25
    -->
26
    kamaki file download -R <container>:<path> [local destination]
27

  
28

  
29
Suggested upgrade method:
30
1. Backup the .kamakirc file (usually stored as ~/.kamakirc). E.g.:
31
    cp ~/.kamakirc ~/tmp/.kamakirc.bu
32
2. Upgrade kamaki (refer to your installation method). E.g. if installed from pypi:
33
    pip install --upgrade kamaki
34
3. Download the script bellow:
35
    For Linux, OS X, *nix, systems that run bash:
36
        https://code.grnet.gr/attachments/download/2493/kamaki0.7to0.8.sh
37
    For windows:
38
        https://code.grnet.gr/attachments/download/2497/kamaki0.7to0.8.bat
39
and run it from command line. This script will modify the default .kamakirc file in order to comply with version 0.8

Also available in: Unified diff