code.grnet.gr Git - kamaki/blob - README.Upgrade

   1 This document describes changes and steps to upgrade from kamaki 0.7.X to kamaki 0.8
   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 Note: if the above config options are not changed, users can still use file and user commands, due to backword support for old command options. Support for astakos and store configuration options will not continue in version 0.9
  17 - Do not require <cmd group>.cli (cli specification) field in configuration file, use it only to override default values.
  18 - Change the naming convention for cli specifications by loosing the _cli suffix:
  19     <cmd group>_cli --> <cmd group>
  20 - Seperate kamaki image commands based on whether they make requests to Plankton or Cyclades.
  21     Plankton image commands: kamaki image <action>
  22     Cyclades image commands: kamaki image compute <action>
  23 - Rename: kamaki image public --> kamaki image list
  24 - Change letter case for recursive download runtime argument:
  25     kamaki store download -r <container>:<path> [local destination]
  26     -->
  27     kamaki file download -R <container>:<path> [local destination]
  28
  29
  30 Suggested upgrade method:
  31 1. Backup the .kamakirc file (usually stored as ~/.kamakirc). E.g.:
  32     cp ~/.kamakirc ~/tmp/.kamakirc.bu
  33 2. Upgrade kamaki (refer to your installation method). E.g. if installed from pypi:
  34     pip install --upgrade kamaki
  35 3. Download the script bellow:
  36     For Linux, OS X, *nix, systems that run bash:
  37         https://code.grnet.gr/attachments/download/2493/kamaki0.7to0.8.sh
  38     For windows:
  39         https://code.grnet.gr/attachments/download/2497/kamaki0.7to0.8.bat
  40 and run it from command line. This script will modify the default .kamakirc file in order to comply with version 0.8