root / docs / upgrade / upgrade-0.16.rst @ fd050112
History | View | Annotate | Download (3.4 kB)
1 | fd050112 | Giorgos Korfiatis | Upgrade to Synnefo v0.16 |
---|---|---|---|
2 | fd050112 | Giorgos Korfiatis | ^^^^^^^^^^^^^^^^^^^^^^^^ |
3 | fd050112 | Giorgos Korfiatis | |
4 | fd050112 | Giorgos Korfiatis | |
5 | fd050112 | Giorgos Korfiatis | Upgrade Steps |
6 | fd050112 | Giorgos Korfiatis | ============= |
7 | fd050112 | Giorgos Korfiatis | |
8 | fd050112 | Giorgos Korfiatis | The upgrade to v0.16 consists in the following steps: |
9 | fd050112 | Giorgos Korfiatis | |
10 | fd050112 | Giorgos Korfiatis | 1. Bring down services and backup databases. |
11 | fd050112 | Giorgos Korfiatis | |
12 | fd050112 | Giorgos Korfiatis | 2. Upgrade packages, migrate the databases and configure settings. |
13 | fd050112 | Giorgos Korfiatis | |
14 | fd050112 | Giorgos Korfiatis | 3. __placeholder__ |
15 | fd050112 | Giorgos Korfiatis | |
16 | fd050112 | Giorgos Korfiatis | 4. Bring up all services. |
17 | fd050112 | Giorgos Korfiatis | |
18 | fd050112 | Giorgos Korfiatis | .. warning:: |
19 | fd050112 | Giorgos Korfiatis | |
20 | fd050112 | Giorgos Korfiatis | It is strongly suggested that you keep separate database backups |
21 | fd050112 | Giorgos Korfiatis | for each service after the completion of each step. |
22 | fd050112 | Giorgos Korfiatis | |
23 | fd050112 | Giorgos Korfiatis | 1. Bring web services down, backup databases |
24 | fd050112 | Giorgos Korfiatis | ============================================ |
25 | fd050112 | Giorgos Korfiatis | |
26 | fd050112 | Giorgos Korfiatis | 1. All web services must be brought down so that the database maintains a |
27 | fd050112 | Giorgos Korfiatis | predictable and consistent state during the migration process:: |
28 | fd050112 | Giorgos Korfiatis | |
29 | fd050112 | Giorgos Korfiatis | $ service gunicorn stop |
30 | fd050112 | Giorgos Korfiatis | $ service snf-dispatcher stop |
31 | fd050112 | Giorgos Korfiatis | $ service snf-ganeti-eventd stop |
32 | fd050112 | Giorgos Korfiatis | |
33 | fd050112 | Giorgos Korfiatis | 2. Backup databases for recovery to a pre-migration state. |
34 | fd050112 | Giorgos Korfiatis | |
35 | fd050112 | Giorgos Korfiatis | 3. Keep the database servers running during the migration process. |
36 | fd050112 | Giorgos Korfiatis | |
37 | fd050112 | Giorgos Korfiatis | |
38 | fd050112 | Giorgos Korfiatis | 2. Upgrade Synnefo and configure settings |
39 | fd050112 | Giorgos Korfiatis | ========================================= |
40 | fd050112 | Giorgos Korfiatis | |
41 | fd050112 | Giorgos Korfiatis | 2.1 Install the new versions of packages |
42 | fd050112 | Giorgos Korfiatis | ---------------------------------------- |
43 | fd050112 | Giorgos Korfiatis | |
44 | fd050112 | Giorgos Korfiatis | :: |
45 | fd050112 | Giorgos Korfiatis | |
46 | fd050112 | Giorgos Korfiatis | astakos.host$ apt-get install \ |
47 | fd050112 | Giorgos Korfiatis | python-objpool \ |
48 | fd050112 | Giorgos Korfiatis | snf-common \ |
49 | fd050112 | Giorgos Korfiatis | python-astakosclient \ |
50 | fd050112 | Giorgos Korfiatis | snf-django-lib \ |
51 | fd050112 | Giorgos Korfiatis | snf-webproject \ |
52 | fd050112 | Giorgos Korfiatis | snf-branding \ |
53 | fd050112 | Giorgos Korfiatis | snf-astakos-app |
54 | fd050112 | Giorgos Korfiatis | |
55 | fd050112 | Giorgos Korfiatis | cyclades.host$ apt-get install \ |
56 | fd050112 | Giorgos Korfiatis | python-objpool \ |
57 | fd050112 | Giorgos Korfiatis | snf-common \ |
58 | fd050112 | Giorgos Korfiatis | python-astakosclient \ |
59 | fd050112 | Giorgos Korfiatis | snf-django-lib \ |
60 | fd050112 | Giorgos Korfiatis | snf-webproject \ |
61 | fd050112 | Giorgos Korfiatis | snf-branding \ |
62 | fd050112 | Giorgos Korfiatis | snf-pithos-backend \ |
63 | fd050112 | Giorgos Korfiatis | snf-cyclades-app |
64 | fd050112 | Giorgos Korfiatis | |
65 | fd050112 | Giorgos Korfiatis | pithos.host$ apt-get install \ |
66 | fd050112 | Giorgos Korfiatis | python-objpool \ |
67 | fd050112 | Giorgos Korfiatis | snf-common \ |
68 | fd050112 | Giorgos Korfiatis | python-astakosclient \ |
69 | fd050112 | Giorgos Korfiatis | snf-django-lib \ |
70 | fd050112 | Giorgos Korfiatis | snf-webproject \ |
71 | fd050112 | Giorgos Korfiatis | snf-branding \ |
72 | fd050112 | Giorgos Korfiatis | snf-pithos-backend \ |
73 | fd050112 | Giorgos Korfiatis | snf-pithos-app \ |
74 | fd050112 | Giorgos Korfiatis | snf-pithos-webclient |
75 | fd050112 | Giorgos Korfiatis | |
76 | fd050112 | Giorgos Korfiatis | ganeti.node$ apt-get install \ |
77 | fd050112 | Giorgos Korfiatis | python-objpool \ |
78 | fd050112 | Giorgos Korfiatis | snf-common \ |
79 | fd050112 | Giorgos Korfiatis | snf-cyclades-gtools \ |
80 | fd050112 | Giorgos Korfiatis | snf-pithos-backend \ |
81 | fd050112 | Giorgos Korfiatis | snf-network |
82 | fd050112 | Giorgos Korfiatis | |
83 | fd050112 | Giorgos Korfiatis | .. note:: |
84 | fd050112 | Giorgos Korfiatis | |
85 | fd050112 | Giorgos Korfiatis | Make sure `snf-webproject' has the same version with snf-common |
86 | fd050112 | Giorgos Korfiatis | |
87 | fd050112 | Giorgos Korfiatis | .. note:: |
88 | fd050112 | Giorgos Korfiatis | |
89 | fd050112 | Giorgos Korfiatis | Installing the packages will cause services to start. Make sure you bring |
90 | fd050112 | Giorgos Korfiatis | them down again (at least ``gunicorn``, ``snf-dispatcher``) |
91 | fd050112 | Giorgos Korfiatis | |
92 | fd050112 | Giorgos Korfiatis | 2.2 Sync and migrate the database |
93 | fd050112 | Giorgos Korfiatis | --------------------------------- |
94 | fd050112 | Giorgos Korfiatis | |
95 | fd050112 | Giorgos Korfiatis | .. note:: |
96 | fd050112 | Giorgos Korfiatis | |
97 | fd050112 | Giorgos Korfiatis | If you are asked about stale content types during the migration process, |
98 | fd050112 | Giorgos Korfiatis | answer 'no' and let the migration finish. |
99 | fd050112 | Giorgos Korfiatis | |
100 | fd050112 | Giorgos Korfiatis | :: |
101 | fd050112 | Giorgos Korfiatis | |
102 | fd050112 | Giorgos Korfiatis | astakos-host$ snf-manage syncdb |
103 | fd050112 | Giorgos Korfiatis | astakos-host$ snf-manage migrate |
104 | fd050112 | Giorgos Korfiatis | |
105 | fd050112 | Giorgos Korfiatis | cyclades-host$ snf-manage syncdb |
106 | fd050112 | Giorgos Korfiatis | cyclades-host$ snf-manage migrate |
107 | fd050112 | Giorgos Korfiatis | |
108 | fd050112 | Giorgos Korfiatis | pithos-host$ pithos-migrate upgrade head |
109 | fd050112 | Giorgos Korfiatis | |
110 | fd050112 | Giorgos Korfiatis | |
111 | fd050112 | Giorgos Korfiatis | 3. __placeholder__ |
112 | fd050112 | Giorgos Korfiatis | ================== |
113 | fd050112 | Giorgos Korfiatis | |
114 | fd050112 | Giorgos Korfiatis | |
115 | fd050112 | Giorgos Korfiatis | 4. Bring all services up |
116 | fd050112 | Giorgos Korfiatis | ======================== |
117 | fd050112 | Giorgos Korfiatis | |
118 | fd050112 | Giorgos Korfiatis | After the upgrade is finished, we bring up all services: |
119 | fd050112 | Giorgos Korfiatis | |
120 | fd050112 | Giorgos Korfiatis | .. code-block:: console |
121 | fd050112 | Giorgos Korfiatis | |
122 | fd050112 | Giorgos Korfiatis | astakos.host # service gunicorn start |
123 | fd050112 | Giorgos Korfiatis | cyclades.host # service gunicorn start |
124 | fd050112 | Giorgos Korfiatis | pithos.host # service gunicorn start |
125 | fd050112 | Giorgos Korfiatis | |
126 | fd050112 | Giorgos Korfiatis | cyclades.host # service snf-dispatcher start |