ecommun / owncloud_ynh

Blame view

sources/core/doc/admin/maintenance/update.html 19.3 KB
edit raw normal view history
d1bafeea1   Kload   [fix] Upgrade to ... 
1
2
3
4
5
6
7
8
9
 
  
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  
  
  <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6d9380f96   Cédric Dupont   Update sources OC... 
10
 
      <title>Updating ownCloud &mdash; ownCloud Administrators Manual 7.0 documentation</title>
d1bafeea1   Kload   [fix] Upgrade to ... 
11
12
13
14
15
16
17
18
19
 
      
      <link rel="stylesheet" href="../_static/style.css" type="text/css" />
      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
      <link rel="stylesheet" href="../_static/style.css" type="text/css" />
      <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
      
      <script type="text/javascript">
        var DOCUMENTATION_OPTIONS = {
          URL_ROOT:    '../',
6d9380f96   Cédric Dupont   Update sources OC... 
20
 
          VERSION:     '7.0',
d1bafeea1   Kload   [fix] Upgrade to ... 
21
22
23
24
25
26
27
28
29
 
          COLLAPSE_INDEX: false,
          FILE_SUFFIX: '.html',
          HAS_SOURCE:  true
        };
      </script>
      <script type="text/javascript" src="../_static/jquery.js"></script>
      <script type="text/javascript" src="../_static/underscore.js"></script>
      <script type="text/javascript" src="../_static/doctools.js"></script>
      <script type="text/javascript" src="../_static/bootstrap.js"></script>
6d9380f96   Cédric Dupont   Update sources OC... 
30
 
      <link rel="top" title="ownCloud Administrators Manual 7.0 documentation" href="../index.html" />
d1bafeea1   Kload   [fix] Upgrade to ... 
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
 
      <link rel="up" title="Maintenance" href="index.html" />
      <link rel="next" title="Restoring ownCloud" href="restore.html" />
      <link rel="prev" title="Backing up ownCloud" href="backup.html" />
  <script type="text/javascript">
  (function () {
    /**
     * Patch TOC list.
     *
     * Will mutate the underlying span to have a correct ul for nav.
     *
     * @param $span: Span containing nested UL's to mutate.
     * @param minLevel: Starting level for nested lists. (1: global, 2: local).
     */
    var patchToc = function ($ul, minLevel) {
      var findA;
  
      // Find all a "internal" tags, traversing recursively.
      findA = function ($elem, level) {
        var level = level || 0,
          $items = $elem.find("> li > a.internal, > ul, > li > ul");
  
        // Iterate everything in order.
        $items.each(function (index, item) {
          var $item = $(item),
            tag = item.tagName.toLowerCase(),
            pad = 15 + ((level - minLevel) * 10);
  
          if (tag === 'a' && level >= minLevel) {
            // Add to existing padding.
            $item.css('padding-left', pad + "px");
            console.log(level, $item, 'padding-left', pad + "px");
          } else if (tag === 'ul') {
            // Recurse.
            findA($item, level + 1);
          }
        });
      };
  
      console.log("HERE");
      findA($ul);
    };
  
    $(document).ready(function () {
      // Add styling, structure to TOC's.
      $(".dropdown-menu").each(function () {
        $(this).find("ul").each(function (index, item){
          var $item = $(item);
          $item.addClass('unstyled');
        });
        $(this).find("li").each(function () {
          $(this).parent().append(this);
        });
      });
  
      // Patch in level.
      patchToc($("ul.globaltoc"), 2);
      patchToc($("ul.localtoc"), 2);
  
      // Enable dropdown.
      $('.dropdown-toggle').dropdown();
    });
  }());
  </script>
  
    </head>
    <body>
    
  
  <div class="container">
    <div class="content">
      <div class="page-header">
        <h1><a href="../contents.html">ownCloud Administrators Manual</a></h1>
  
      </div>
      
  			<div class="row">
  				<div class="span3">
  					<div class="sidebar">
  						<div class="well">
  							<div class="menu-support-container">
  								<ul id="menu-support" class="menu">
  									<ul>
  										<li><a href="../contents.html">Overview</a></li>
  									</ul>
                    <ul>
6d9380f96   Cédric Dupont   Update sources OC... 
116
 
  <li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
117
118
119
120
 
  </ul>
  <ul class="current">
  <li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation</a></li>
  <li class="toctree-l1"><a class="reference internal" href="../configuration/index.html">Configuration</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
121
 
  <li class="toctree-l1 current"><a class="reference internal" href="index.html">Maintenance</a><ul class="current">
6d9380f96   Cédric Dupont   Update sources OC... 
122
 
  <li class="toctree-l2"><a class="reference internal" href="enable_maintenance.html">Maintenance Mode Configuration</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
123
124
 
  <li class="toctree-l2"><a class="reference internal" href="backup.html">Backing up ownCloud</a></li>
  <li class="toctree-l2 current"><a class="current reference internal" href="">Updating ownCloud</a><ul>
6d9380f96   Cédric Dupont   Update sources OC... 
125
126
 
  <li class="toctree-l3"><a class="reference internal" href="#verifying-the-updater-app-is-enabled">Verifying the Updater App is Enabled</a></li>
  <li class="toctree-l3"><a class="reference internal" href="#enabling-the-updater-app">Enabling the Updater App</a></li>
d1bafeea1   Kload   [fix] Upgrade to ... 
127
128
129
130
131
132
 
  </ul>
  </li>
  <li class="toctree-l2"><a class="reference internal" href="restore.html">Restoring ownCloud</a></li>
  <li class="toctree-l2"><a class="reference internal" href="migrating.html">Migrating ownCloud Installations</a></li>
  </ul>
  </li>
d1bafeea1   Kload   [fix] Upgrade to ... 
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
 
  <li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues</a></li>
  </ul>
  
  								</ul>
  							</div>
  						</div>
  					</div>
  				</div>
          
  
  				<div class="span9">
  					<div class="page-content">
  						
    <div class="section" id="updating-owncloud">
  <h1>Updating ownCloud<a class="headerlink" href="#updating-owncloud" title="Permalink to this headline">¶</a></h1>
6d9380f96   Cédric Dupont   Update sources OC... 
148
149
 
  <p id="id1">The Updater app provides a more automated method of updating ownCloud.  To use the Updater app, it must be enabled in your ownCloud instance.  The Updater is enabled in your ownCloud instance by default when you install.</p>
  <p>To update ownCloud:</p>
d1bafeea1   Kload   [fix] Upgrade to ... 
150
151
 
  <div class="admonition note">
  <p class="first admonition-title">Note</p>
6d9380f96   Cédric Dupont   Update sources OC... 
152
153
 
  <p class="last">To update ownCloud, the Updater app must be enabled in your ownCloud instance. The Updater app is enabled in your ownCloud instance by default when you install.  However, to verify that it is enabled, or to enable the Updater app, see <a class="reference internal" href="#id2">Enabling the Updater App</a>.</p>
  </div>
d1bafeea1   Kload   [fix] Upgrade to ... 
154
 
  <ol class="arabic simple">
6d9380f96   Cédric Dupont   Update sources OC... 
155
 
  <li>Make a backup of the ownCloud folder and the database. See <a class="reference internal" href="backup.html"><em>Backing up ownCloud</em></a> for details.</li>
d1bafeea1   Kload   [fix] Upgrade to ... 
156
 
  <li>Navigate to the &#8216;Admin&#8217; page.</li>
6d9380f96   Cédric Dupont   Update sources OC... 
157
158
 
  <li>Click the &#8216;Update&#8217; tab.</li>
  <li>Refresh the page using Ctrl+F5.</li>
d1bafeea1   Kload   [fix] Upgrade to ... 
159
160
161
 
  </ol>
  <p>If this procedure doesn&#8217;t work (for example, ownCloud 5.0.10 doesn&#8217;t show new any new version) you could try to perform
  a full upgrade to update to the latest point release (see below).</p>
6d9380f96   Cédric Dupont   Update sources OC... 
162
163
164
165
166
167
168
169
 
  <div class="section" id="verifying-the-updater-app-is-enabled">
  <h2>Verifying the Updater App is Enabled<a class="headerlink" href="#verifying-the-updater-app-is-enabled" title="Permalink to this headline">¶</a></h2>
  <p>However, to verify that the Updater is enabled in your ownCloud instance:</p>
  <ol class="arabic simple">
  <li>Select the &#8220;Admin&#8221; option from the &#8220;Personal Settings&#8221; dropdown menu.</li>
  </ol>
  <div class="figure">
  <img alt="../_images/oc_personal_settings_dropdown_admin.png" src="../_images/oc_personal_settings_dropdown_admin.png" />
d1bafeea1   Kload   [fix] Upgrade to ... 
170
 
  </div>
6d9380f96   Cédric Dupont   Update sources OC... 
171
172
173
 
  <ol class="arabic simple" start="2">
  <li>Scroll down the resulting web page.  If the Updater app appears in this window, the app is enabled.  If not, then you must enable it.  See <a class="reference internal" href="#id2">Enabling the Updater App</a>.</li>
  </ol>
d1bafeea1   Kload   [fix] Upgrade to ... 
174
 
  </div>
6d9380f96   Cédric Dupont   Update sources OC... 
175
176
177
178
179
180
181
182
183
184
 
  <div class="section" id="enabling-the-updater-app">
  <h2>Enabling the Updater App<a class="headerlink" href="#enabling-the-updater-app" title="Permalink to this headline">¶</a></h2>
  <p id="id2">The Updater app is enabled in your ownCloud instance by default when you install.  However, it is possible that it was disabled at some point.   To enable the Updater app:</p>
  <ol class="arabic simple">
  <li>Click the &#8220;+ App&#8221; function in the Apps Selection Menu.</li>
  </ol>
  <blockquote>
  <div><p>The &#8220;Select an App&#8221; window opens.</p>
  <div class="figure">
  <img alt="../_images/oc_select_an_app_window.png" src="../_images/oc_select_an_app_window.png" />
d1bafeea1   Kload   [fix] Upgrade to ... 
185
 
  </div>
6d9380f96   Cédric Dupont   Update sources OC... 
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
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
 
  <p><strong>Select an App window</strong></p>
  </div></blockquote>
  <ol class="arabic simple" start="2">
  <li>Scroll down the list of apps on the left side of the web page and select the Update app.</li>
  </ol>
  <blockquote>
  <div><div class="figure">
  <img alt="../_images/oc_updater_select.png" src="../_images/oc_updater_select.png" />
  </div>
  <p><strong>Selecting the Updater app</strong></p>
  </div></blockquote>
  <ol class="arabic simple" start="3">
  <li>In the App View window, click &#8220;Enable.&#8221;</li>
  </ol>
  <blockquote>
  <div><div class="figure">
  <img alt="../_images/oc_updater_enable.png" src="../_images/oc_updater_enable.png" />
  </div>
  <p><strong>Enabling the Updater app</strong></p>
  <p>ownCloud enables the Updater app.</p>
  </div></blockquote>
  <div class="section" id="upgrading-the-owncloud-server">
  <h3>Upgrading the ownCloud Server<a class="headerlink" href="#upgrading-the-owncloud-server" title="Permalink to this headline">¶</a></h3>
  <p>The process for upgrading the ownCloud Server is fairly straightforward but requires planning and proper file and folder management.</p>
  <p>To upgrade your ownCloud Server:</p>
  <ol class="arabic simple">
  <li>Ensure that you are running the latest point release of your current major ownCloud version (for example, point release 5.0.14a in the version 5.0 series). To update to the latest point release see &#8216;Updating ownCloud&#8217;_.</li>
  <li>Deactivate all third party applications.</li>
  </ol>
  <blockquote>
  <div><div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">Not all third party applications are supported on all ownCloud Server versions.  Make sure to check version compatibility prior to upgrading your ownCloud server.</p>
  </div>
  </div></blockquote>
  <ol class="arabic simple" start="3">
  <li>Back up your existing ownCloud Server database.  You can find these procedures in <a class="reference internal" href="backup.html"><em>Backing up ownCloud</em></a>.</li>
  <li>Download the latest ownCloud Server version to your working directory.</li>
  </ol>
  <blockquote>
  <div><p>For Linux operating systems, use the following command:</p>
  <p><tt class="docutils literal"><span class="pre">wget</span> <span class="pre">http://download.owncloud.org/community/owncloud-latest.tar.bz2</span></tt></p>
  <p>For Windows operating systems:</p>
  <p>See the installation instruction in <a class="reference internal" href="../installation/installation_windows.html"><em>Windows 7 and Windows Server 2008</em></a>.</p>
  </div></blockquote>
  <ol class="arabic simple" start="5">
  <li>Stop your web server.</li>
  </ol>
  <blockquote>
  <div><p>Depending on your environment, you will be running either an Apache server or a Windows IIS server.  In addition, when running your server in a Linux environment, the necessary commands for stopping the Apache server might differ from one Linux operating system to another.</p>
  <p>To stop an Apache server, refer to the following table for specific commands to use in different Linux operating systems:</p>
  <table border="1" class="docutils">
  <colgroup>
  <col width="28%" />
  <col width="72%" />
  </colgroup>
  <thead valign="bottom">
  <tr class="row-odd"><th class="head">Operating System</th>
  <th class="head">Command (as root)</th>
  </tr>
  </thead>
  <tbody valign="top">
  <tr class="row-even"><td>CentOS (Redhat)</td>
  <td><tt class="docutils literal"><span class="pre">apachectl</span> <span class="pre">stop</span></tt></td>
  </tr>
  <tr class="row-odd"><td>Debian
  or
  Ubuntu</td>
  <td><tt class="docutils literal"><span class="pre">/etc/init.d/apache2</span> <span class="pre">stop</span></tt></td>
  </tr>
  <tr class="row-even"><td>openSUSE
  or
  SUSE (SLE)</td>
  <td><tt class="docutils literal"><span class="pre">/usr/sbin/rcapache2</span> <span class="pre">stop</span></tt></td>
  </tr>
  </tbody>
  </table>
  <p>To stop the Windows IIS web server, you can use either the user interface (UI) or command line method as follows:</p>
  <table border="1" class="docutils">
  <colgroup>
  <col width="23%" />
  <col width="77%" />
  </colgroup>
  <thead valign="bottom">
  <tr class="row-odd"><th class="head">Method</th>
  <th class="head">Procedure</th>
  </tr>
  </thead>
  <tbody valign="top">
  <tr class="row-even"><td>User Interface (UI)</td>
  <td><ol class="first last arabic simple">
  <li>Open IIS Manager and navigate to the Web server node in the tree.</li>
  <li>In the <strong>Actions</strong> pane, click <strong>Stop</strong>.</li>
  </ol>
  </td>
  </tr>
  <tr class="row-odd"><td>Command Line</td>
  <td><ol class="first last arabic simple">
  <li>Open a command line window as administrator.</li>
  <li>At the command prompt, type <strong>net stop WAS</strong> and press <strong>ENTER</strong>.</li>
  <li>(Optional) To stop W3SVC, type <strong>Y</strong> and then press <strong>ENTER</strong>.</li>
  </ol>
  </td>
  </tr>
  </tbody>
  </table>
  <div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">For specific instructions on how to stop, start, or manage your server, please refer to instructions for the server on your specific operating environment.</p>
  </div>
  </div></blockquote>
  <ol class="arabic simple" start="6">
  <li>Move, or rename your current owncloud directory (named <tt class="docutils literal"><span class="pre">/owncloud</span></tt> if installed using defaults) to another location for use in your new version of ownCloud.</li>
  </ol>
  <blockquote>
  <div><div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">This step ensures that you have a version of ownCloud available for backup purposes.</p>
  </div>
  </div></blockquote>
  <ol class="arabic simple" start="7">
  <li>Replace the old version of ownCloud Server with the new version of ownCloud Server:</li>
  </ol>
  <blockquote>
  <div><p>Assuming that your installation directory is called ‘owncloud’, and that it resides in your working directory, the command to unpack the release tarball into the directory would be as follows:</p>
  <div class="highlight-python"><pre>tar xjf owncloud-latest.tar.bz2</pre>
  </div>
  <p>In Microsoft Windows environments, you can unpack the release tarball using WinZip or a similar tool (for example, Peazip).</p>
  <p>Always unpack server code into an empty directory. Unpacking the server code into an existing, populated directory, is not supported.</p>
  <div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">If you unpack into an existing installation, the autoloader might pick up classes twice because the files have been moved, resulting in a <tt class="docutils literal"><span class="pre">Cannot</span> <span class="pre">redeclare</span> <span class="pre">class</span></tt> error.</p>
  </div>
  </div></blockquote>
  <ol class="arabic simple" start="8">
  <li>Copy and paste the <tt class="docutils literal"><span class="pre">/config/config.php</span></tt> file from the saved version of ownCloud to the <tt class="docutils literal"><span class="pre">/config</span></tt> directory of your new ownCloud version.</li>
  </ol>
  <blockquote>
  <div><div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">You must perform this step <strong>before</strong> restarting your web server.</p>
  </div>
  </div></blockquote>
  <ol class="arabic simple" start="9">
  <li>If you chose to keep your /data directory in your <tt class="docutils literal"><span class="pre">/owncloud</span></tt> directory, copy and paste it from the old version of ownCloud to the <tt class="docutils literal"><span class="pre">/owncloud</span></tt> directory of your new ownCloud version.</li>
d1bafeea1   Kload   [fix] Upgrade to ... 
331
 
  </ol>
6d9380f96   Cédric Dupont   Update sources OC... 
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
 
  <blockquote>
  <div><div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">We recommend storing your <tt class="docutils literal"><span class="pre">/data</span></tt> directory in a location other than your <tt class="docutils literal"><span class="pre">/owncloud</span></tt> directory.  If you have your <tt class="docutils literal"><span class="pre">/data</span></tt> directory already stored in another location, you can skip this step.  If you want to do so, now is a good time to change the location of your <tt class="docutils literal"><span class="pre">/data</span></tt> directory.  See &#8220;Advanved Options&#8221; chapter in <a class="reference internal" href="../installation/installation_wizard.html"><em>Installation Wizard</em></a> for added details about changing the default database or data directory.</p>
  </div>
  </div></blockquote>
  <ol class="arabic simple" start="10">
  <li>Restart your web server.</li>
  </ol>
  <blockquote>
  <div><p>Depending on your environment, you will be running either an Apache server or a Windows IIS server.  In addition, when running your server in a Linux environment, the necessary commands for stopping the Apache server might differ from one Linux operating system to another.</p>
  <p>To restart an Apache server, refer to the following table for specific commands to use in different Linux operating systems:</p>
  <table border="1" class="docutils">
  <colgroup>
  <col width="28%" />
  <col width="72%" />
  </colgroup>
  <thead valign="bottom">
  <tr class="row-odd"><th class="head">Operating System</th>
  <th class="head">Command (as root)</th>
  </tr>
  </thead>
  <tbody valign="top">
  <tr class="row-even"><td>CentOS (Redhat)</td>
  <td><tt class="docutils literal"><span class="pre">apachectl</span> <span class="pre">start</span></tt></td>
  </tr>
  <tr class="row-odd"><td>Debian
  or
  Ubuntu</td>
  <td><tt class="docutils literal"><span class="pre">/etc/init.d/apache2</span> <span class="pre">start</span></tt></td>
  </tr>
  <tr class="row-even"><td>openSUSE
  or
  SUSE (SLE)</td>
  <td><tt class="docutils literal"><span class="pre">/usr/sbin/rcapache2</span> <span class="pre">start</span></tt></td>
  </tr>
  </tbody>
  </table>
  <p>To start the Windows IIS web server, you can use either the user interface (UI) or command line method as follows:</p>
  <table border="1" class="docutils">
  <colgroup>
  <col width="23%" />
  <col width="77%" />
  </colgroup>
  <thead valign="bottom">
  <tr class="row-odd"><th class="head">Method</th>
  <th class="head">Procedure</th>
  </tr>
  </thead>
  <tbody valign="top">
  <tr class="row-even"><td>User Interface (UI)</td>
  <td><ol class="first last arabic simple">
  <li>Open IIS Manager and navigate to the Web server node in the tree.</li>
  <li>In the <strong>Actions</strong> pane, click <strong>Start</strong>.</li>
  </ol>
  </td>
  </tr>
  <tr class="row-odd"><td>Command Line</td>
  <td><ol class="first last arabic simple">
  <li>Open an elevated command line window.</li>
  <li>At the command prompt, type <strong>net start W3SVC</strong> and press <strong>ENTER</strong>.
  This command starts both WAS and W3SVC.</li>
  </ol>
  </td>
  </tr>
  </tbody>
  </table>
  <div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">For specific instructions on how to stop, start, or manage your server, please refer to instructions for the server on your specific operating environment.</p>
  </div>
  </div></blockquote>
  <ol class="arabic simple" start="11">
  <li>Use a browser to your ownCloud server.</li>
  </ol>
  <blockquote>
  <div>This step is required.  Accessing the server using a browser connection launches the server upgrade.</div></blockquote>
  <ol class="arabic simple" start="12">
  <li>If third party applications were running on your system, ensure that they provide versions compatible with the new ownCloud release. If compatible, you can reinstall and enable these applications.</li>
  </ol>
  <blockquote>
  <div><div class="admonition note">
  <p class="first admonition-title">Note</p>
  <p class="last">Update procedures should run when necessary.</p>
  </div>
  </div></blockquote>
  </div>
d1bafeea1   Kload   [fix] Upgrade to ... 
419
420
421
422
423
424
425
426
427
428
429
430
 
  </div>
  </div>
  
  
  					</div>
  				</div>
  			</div>
      
    </div>
  </div>
    </body>
  </html>