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

   1 This document describes changes and steps to upgrade from kamaki 0.11 to
   2 kamaki 0.12
   3
   4 1. Update the kamaki configuration with these commands:
   5   $ kamaki config delete network_cli
   6   $ kamaki config delete ip_cli
   7
   8 2. Upgrade shell scripts to use the new syntax:
   9     positional arguments are removed, except if refering to the objects
  10     e.g., kamaki server info SERVER_ID
  11     but not kamaki server create NAME IMAGE FLAVOR
  12     Use mandatory non-positional arguments
  13     e.g., kamaki server create --name=NAME --image-id=IMAGE_ID --flavor-id=FLAVOR_ID
  14           kamaki image register --name=NAME --location=IMAGE_LOCATION
  15
  16 Config file
  17 -----------
  18
  19 Kamaki v0.9 will have a new config file with the following format:
  20
  21   [global]
  22   default_cloud = some_cloud
  23   ... more kamaki-related settings ...
  24
  25   [cloud "some_cloud"]
  26   url = https://some/cloud/single/authentication/url
  27   token = user_token==
  28
  29 For more information on the exact format of the kamaki global variables, see
  30 the respective documentation page:
  31 http://www.synnefo.org/docs/kamaki/latest/setup.html#available-options
  32
  33 How to convert the config file
  34 ------------------------------
  35
  36 To convert an old config file, backup the old one and then run:
  37
  38   kamaki -c <config file path> user authenticate
  39
  40 Kamaki will automatically inspect the file and suggest a list of convertions,
  41 namely renamings and discards. Take a look at the list of discarded values,
  42 write down the ones that might be usefull.
  43
  44 If you are sure about the changes, press 'y'.
  45
  46 Kamaki should raise an error, demanding an authentication URL and/or token.
  47
  48 First, you need to go to the clouds UI and find the authentication URL and
  49 token. Then you should think of a name for your cloud, e.g. "mycloud". Now,
  50 feed kamaki with this information:
  51
  52 kamaki -c <config file path> config set cloud.mycloud.url <URL>
  53 kamaki -c <config file path> config set cloud.mycloud.token <token>
  54
  55 Now the configuration file should be kamaki 0.9 ready.