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