1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
<!DOCTYPE html>
<html lang='en'>
<head>
<title>
Upgrade to 0.10 - LEAP Platform Documentation
</title>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<meta charset='UTF-8'>
<base href="" />
<style>
body {
background: #444;
display: flex;
flex-direction: row;
padding: 10px;
margin: 0px;
}
#sidebar {
flex: 0 0 250px;
background: white;
margin-right: 10px;
padding: 20px;
}
#sidebar ul {
list-style-type: none;
padding-left: 0px;
margin: 0;
}
#sidebar li { padding: 4px }
#sidebar li a { text-decoration: none }
#sidebar li.active { background: #444 }
#sidebar li.active a { color: white }
#sidebar li.level1 { padding-left: 20px }
#sidebar li.level2 { padding-left: 40px }
#main {
flex: 1 1 auto;
background: white;
padding: 20px;
}
#title-box {
padding-bottom: 20px;
border-bottom: 5px solid #eee;
}
#title-box h1 {
margin-top: 0px;
}
pre {
padding: 10px;
background: #eef;
}
code {
background: #eef;
}
table {border-collapse: collapse}
table td {
border: 1px solid #ccc;
padding: 4px;
vertical-align: top;
}
</style>
</head>
<body>
<div id='sidebar'>
<ul>
<li class=''>
<a href='../../index.html'>Home</a>
</li>
<li class=' level0'>
<a class='' href='../guide.html'>Guide</a>
</li>
<li class=' level0'>
<a class='' href='../tutorials.html'>Tutorials</a>
</li>
<li class=' level0'>
<a class='' href='../services.html'>Services</a>
</li>
<li class='semi-active level0'>
<a class='' href='../upgrading.html'>Upgrading</a>
</li>
<li class='active level1'>
<a class='' href='upgrade-0-10.html'>Upgrade to 0.10</a>
</li>
<li class=' level1'>
<a class='' href='upgrade-0-9.html'>Upgrade to 0.9</a>
</li>
<li class=' level1'>
<a class='' href='upgrade-0-8.html'>Upgrade to 0.8</a>
</li>
<li class=' level0'>
<a class='' href='../troubleshooting.html'>Troubleshooting</a>
</li>
<li class=' level0'>
<a class='' href='../details.html'>Details</a>
</li>
</ul>
</div>
<div id='main'>
<div id='title-box'>
<h1>Upgrade to 0.10</h1>
<div id='summary'></div>
</div>
<div id='content-box'>
<h2><a name="upgrading-to-platform-010"></a>Upgrading to Platform 0.10</h2>
<p>If you have a node with the service ‘tor’ defined, you will need to change it to
be either ‘tor-relay’, or ‘tor-exit’. Look in your provider directory under the
nodes directory for any .json file that has a ‘services’ section with ‘tor’
defined, change that to the correct tor service you are wanting to deploy.</p>
<p>Make sure you have the correct version of leap_cli</p>
<pre><code>workstation$ sudo gem install leap_cli --version=1.9
</code></pre>
<p>If you are upgrading from a version previous to 0.9, please follow those upgrade
instructions before upgrading to 0.10.</p>
<p>Prepare your platform source by checking out the 0.10.x branch:</p>
<pre><code>workstation$ cd leap_platform
workstation$ git fetch
workstation$ git checkout 0.10.x
</code></pre>
<p>Then, deploy:</p>
<pre><code>workstation$ cd $PROVIDER_DIR
workstation$ leap deploy
workstation$ leap test
</code></pre>
<p>After deployment, if the leap test does not succeed, you should
investigate. Please see below for some post-deployment upgrade steps that you
may need to perform.</p>
<p>Starting with Soledad Server 0.9.0, the CouchDB database schema was changed to
improve speed of the server side storage backend. If you provided email, you
will need to run the migration script, otherwise it is unnecessary. Until you
migrate, soledad will refuse to start.</p>
<p>To run the migration script, do the following (replacing $PROVIDER_DIR,
$COUCHDB_NODE, $MX_NODE, and $SOLEDAD_NODE with your values):</p>
<p>First backup your couchdb databases, just to be safe. NOTE: This can take some
time and will place several hundred megabytes of data into
/var/backups/couchdb. The size and time depends on how many users there are on
your system. For example, 15k users took approximately 25 minutes and 308M of
space:
workstation$ leap ssh $COUCHDB_NODE
server# cd /srv/leap/couchdb/scripts
server# ./cleanup-user-dbs
server# time ./couchdb_dumpall.sh</p>
<p> Once that has finished, then its time to run the migration:</p>
<pre><code>workstation$ cd $PROVIDER_DIR
workstation$ leap run 'systemctl leap_mx stop' $MX_NODE
workstation$ leap run --stream '/usr/share/soledad-server/migration/0.9/migrate.py --log-file /var/log/leap/soledad_migration --verbose --do-migrate' $SOLEDAD_NODE
wait for it to finish (will print DONE)
rerun if interrupted
workstation$ leap deploy
workstation$ leap test
</code></pre>
<p>Known Issues:</p>
<p>If you have been deploying from our master branch (ie: unstable code), you might
end up with a broken sources line for apt. If you get the following:
WARNING: The following packages cannot be authenticated!
Then you should remove the files on your nodes inside
/var/lib/puppet/modules/apt/keys and deploy again. (#8862, #8876)</p>
<ul>
<li>When upgrading, sometimes systemd does not report the correct state of a
daemon. The daemon will be not running, but systemd thinks it is. The symptom
of this is that a deploy will succeed but <code>leap test</code> will fail. To fix, you
can run <code>systemctl stop DAEMON</code> and then <code>systemctl start DAEMON</code> on the
affected host (systemctl restart seems to work less reliably).</li>
</ul>
<p>Includes:</p>
<ul>
<li>leap_web: 0.9.2</li>
<li>nickserver: 0.10.0</li>
<li>leap-mx: 0.10.1</li>
<li>soledad-server: 0.10.5</li>
</ul>
<p>Commits: <a href="https://0xacab.org/groups/leap/milestones/platform-010?title=Platform+0.10">https://0xacab.org/groups/leap/milestones/platform-010?title=Platform+0.10</a></p>
<p>For details on about all the changes included in this release please consult the
<a href="https://0xacab.org/leap/platform/milestones/7">LEAP platform 0.10 milestone</a>.</p>
<p>Always a good idea to check if you have the latest version of leap_cli:</p>
<pre><code>workstation$ sudo gem install leap_cli --version=1.9
</code></pre>
<p>If you don’t want to install using ‘sudo’:</p>
<pre><code>workstation$ gem install --user-install leap_cli --version=1.9
workstation$ PATH="$PATH:$(ruby -e 'puts Gem.user_dir')/bin"
</code></pre>
</div>
</div>
</body>
</html>
|
