Revision 68358dbe docs/upgrade/upgrade-0.14.rst

b/docs/upgrade/upgrade-0.14.rst
9 9

  
10 10
3. Register services to astakos and perform a quota-related data migration.
11 11

  
12
4. Bring up all services.
13

  
12 14
.. warning::
13 15

  
14 16
    It is strongly suggested that you keep separate database backups
......
22 24

  
23 25
    $ service gunicorn stop
24 26
    $ service snf-dispatcher stop
25
    etc.
27
    $ service snf-ganeti-eventd stop
26 28

  
27 29
2. Backup databases for recovery to a pre-migration state.
28 30

  
......
75 77

  
76 78
.. note::
77 79

  
80
   Make sure `snf-webproject' has the same version with snf-common
81

  
82
.. note::
83

  
78 84
    Installing the packages will cause services to start. Make sure you bring
79 85
    them down again (at least ``gunicorn``, ``snf-dispatcher``)
80 86

  
81

  
82 87
2.2 Sync and migrate the database
83 88
---------------------------------
84 89

  
......
141 146

  
142 147
The latter is the URL that appears in the Cloudbar and leads to the
143 148
component UI. If you want to follow the default setup, set
144
the UI URL to ``<base_url>/ui/`` where ``base_url`` the component's base
149
the UI URL to ``<base_url>/ui/`` where ``base_url`` is the component's base
145 150
URL as explained before. (You can later change the UI URL with
146
``snf-manage component-modify <component_name> --url new_ui_url``)::
151
``snf-manage component-modify <component_name> --url new_ui_url``).
152

  
153
For example, for Astakos, if
154
``BASE_URL = https://accounts.example.synnefo.org/astakos``,
155
then ``UI_URL = https://accounts.example.synnefo.org/astakos/ui``)::
147 156

  
148 157
    astakos-host$ snf-component-register
149 158

  
150
(proceed to the next step without running ``snf-manage resource-modify``
151
suggested at the end of this command)
159
(ATTENTION: make sure to go to the next step *WITHOUT* running
160
``snf-manage resource-modify``, suggested at the end of this command)
152 161

  
153 162
.. note::
154 163

  
......
168 177
       # copy the file to astakos-host
169 178
       astakos-host$ snf-manage service-import --json pithos.json
170 179

  
171
The limit on pending project applications is since 0.14 handled as an
172
Astakos resource, rather than a custom setting. Command::
180
The limit on the pending project applications is since 0.14 handled as an
181
Astakos resource, rather than a custom setting. So, as a last step we need
182
to run::
173 183

  
174 184
    astakos-host$ astakos-migrate-0.14
175 185

  
176
will prompt you to set this limit (replacing setting
177
ASTAKOS_PENDING_APPLICATION_LIMIT) and then automatically migrate the
186
This will prompt you to set this limit (replacing setting
187
``ASTAKOS_PENDING_APPLICATION_LIMIT``) and then automatically migrate the
178 188
user-specific base quota for the new resource ``astakos.pending_app`` using
179 189
the deprecated user setting.
190

  
191
You are now done migrating from Synnefo v0.13 to v0.14. Please test your
192
installation to make sure everything works as expected.
193

  
194

  
195
4. Bring all services up
196
========================
197

  
198
After the upgrade is finished, we bring up all services:
199

  
200
.. code-block:: console
201

  
202
    astakos.host  # service gunicorn start
203
    cyclades.host # service gunicorn start
204
    pithos.host   # service gunicorn start
205

  
206
    cyclades.host # service snf-dispatcher start

Also available in: Unified diff