PageRenderTime 26ms CodeModel.GetById 13ms RepoModel.GetById 1ms app.codeStats 0ms

/docs/html/upgrading.html

https://github.com/wraithan/OpenEats
HTML | 303 lines | 294 code | 9 blank | 0 comment | 0 complexity | 6331d6db062de95e81faf42e1565f0c1 MD5 | raw file
    

  1. 

  2. 

  3. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    4. 

  4.   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    5. 

  5. 

  6. <html xmlns="http://www.w3.org/1999/xhtml">
    7. 

  7.   <head>
    8. 

  8.     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    9. 

  9.     
    10. 

  10.     <title>3. Upgrade &mdash; OpenEats2 v2.2.0 documentation</title>
    11. 

  11.     <link rel="stylesheet" href="_static/default.css" type="text/css" />
    12. 

  12.     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    13. 

  13.     <script type="text/javascript">
    14. 

  14.       var DOCUMENTATION_OPTIONS = {
    15. 

  15.         URL_ROOT:    '',
    16. 

  16.         VERSION:     '2.2.0',
    17. 

  17.         COLLAPSE_INDEX: false,
    18. 

  18.         FILE_SUFFIX: '.html',
    19. 

  19.         HAS_SOURCE:  true
    20. 

  20.       };
    21. 

  21.     </script>
    22. 

  22.     <script type="text/javascript" src="_static/jquery.js"></script>
    23. 

  23.     <script type="text/javascript" src="_static/underscore.js"></script>
    24. 

  24.     <script type="text/javascript" src="_static/doctools.js"></script>
    25. 

  25.     <link rel="top" title="OpenEats2 v2.2.0 documentation" href="index.html" />
    26. 

  26.     <link rel="next" title="4. Configuration" href="config.html" />
    27. 

  27.     <link rel="prev" title="2. Installation" href="install.html" /> 
    28. 

  28.   </head>
    29. 

  29.   <body>
    30. 

  30.     <div class="related">
    31. 

  31.       <h3>Navigation</h3>
    32. 

  32.       <ul>
    33. 

  33.         <li class="right" style="margin-right: 10px">
    34. 

  34.           <a href="genindex.html" title="General Index"
    35. 

  35.              accesskey="I">index</a></li>
    36. 

  36.         <li class="right" >
    37. 

  37.           <a href="config.html" title="4. Configuration"
    38. 

  38.              accesskey="N">next</a> |</li>
    39. 

  39.         <li class="right" >
    40. 

  40.           <a href="install.html" title="2. Installation"
    41. 

  41.              accesskey="P">previous</a> |</li>
    42. 

  42.         <li><a href="index.html">OpenEats2 v2.2.0 documentation</a> &raquo;</li> 
    43. 

  43.       </ul>
    44. 

  44.     </div>  
    45. 

  45. 

  46.     <div class="document">
    47. 

  47.       <div class="documentwrapper">
    48. 

  48.         <div class="bodywrapper">
    49. 

  49.           <div class="body">
    50. 

  50.             
    51. 

  51.   <div class="section" id="upgrade">
    52. 

  52. <h1>3. Upgrade<a class="headerlink" href="#upgrade" title="Permalink to this headline"></a></h1>
    53. 

  53. <div class="section" id="upgrade-2-0-to-2-1">
    54. 

  54. <h2>3.1. Upgrade 2.0 to 2.1<a class="headerlink" href="#upgrade-2-0-to-2-1" title="Permalink to this headline"></a></h2>
    55. 

  55. <p>This procedure covers how to upgrade your existing 2.0 OpenEats2 site to version 2.1</p>
    56. 

  56. <div class="section" id="install">
    57. 

  57. <h3>3.1.1. Install<a class="headerlink" href="#install" title="Permalink to this headline"></a></h3>
    58. 

  58. <ul class="simple">
    59. 

  59. <li>Download the latest package from <a class="reference external" href="https://github.com/qgriffith/OpenEats">github</a></li>
    60. 

  60. <li>Unzip the file</li>
    61. 

  61. <li>Backup your database</li>
    62. 

  62. <li>Backup your current site files</li>
    63. 

  63. <li>From the unzip file, copy everything other then the settings.py, site-media/upload and site-media/uploads file into your current openeats directory, over writing
    64. 

  64. what is already there</li>
    65. 

  65. </ul>
    66. 

  66. </div>
    67. 

  67. <div class="section" id="config-file-changes">
    68. 

  68. <h3>3.1.2. Config File Changes<a class="headerlink" href="#config-file-changes" title="Permalink to this headline"></a></h3>
    69. 

  69. <p>Some minor changes need to be made to the settings.py file of your current site.</p>
    70. 

  70. <p>Remove the following from the installed apps section of the settings.py file</p>
    71. 

  71. <ul class="simple">
    72. 

  72. <li>admin_tools.theming</li>
    73. 

  73. <li>admin_tools.menu</li>
    74. 

  74. <li>admin_tools.menu</li>
    75. 

  75. </ul>
    76. 

  76. <p>Add the following to the installed apps section of the settings.py file on the <em>first</em> line:</p>
    77. 

  77. <div class="highlight-python"><div class="highlight"><pre><span class="s">&#39;grappelli.dashboard&#39;</span><span class="p">,</span>
    78. 

  78. </pre></div>
    79. 

  79. </div>
    80. 

  80. <p>Add the following to the installed apps section of the settings.py file:</p>
    81. 

  81. <div class="highlight-python"><div class="highlight"><pre><span class="s">&#39;django.contrib.staticfiles&#39;</span><span class="p">,</span>
    82. 

  82. </pre></div>
    83. 

  83. </div>
    84. 

  84. <p>Remove the following from the <em>context processors</em> section of the settings.py file:</p>
    85. 

  85. <div class="highlight-python"><div class="highlight"><pre><span class="s">&quot;grappelli.context_processors.admin_template_path&quot;</span><span class="p">,</span>
    86. 

  86. </pre></div>
    87. 

  87. </div>
    88. 

  88. <p>Add the following to the <em>context processors</em> section of the settings.py file:</p>
    89. 

  89. <div class="highlight-python"><div class="highlight"><pre><span class="s">&quot;openeats.context_processors.oetitle&quot;</span><span class="p">,</span>
    90. 

  90. </pre></div>
    91. 

  91. </div>
    92. 

  92. <p>Add the following line to the settings.py file:</p>
    93. 

  93. <div class="highlight-python"><div class="highlight"><pre><span class="n">LOCALE_PATHS</span> <span class="o">=</span> <span class="p">(</span>
    94. 

  94.    <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">BASE_PATH</span><span class="p">,</span> <span class="s">&#39;locale&#39;</span><span class="p">,)</span>
    95. 

  95. <span class="p">)</span>
    96. 

  96. </pre></div>
    97. 

  97. </div>
    98. 

  98. <p>Remove the following lines in your settings.py file:</p>
    99. 

  99. <div class="highlight-python"><div class="highlight"><pre><span class="n">ADMIN_TOOLS_INDEX_DASHBOARD</span> <span class="o">=</span> <span class="s">&#39;openeats.dashboard.CustomIndexDashboard&#39;</span>
    100. 

  100. <span class="n">ADMIN_TOOLS_APP_INDEX_DASHBOARD</span> <span class="o">=</span> <span class="s">&#39;openeats.dashboard.CustomAppIndexDashboard&#39;</span>
    101. 

  101. </pre></div>
    102. 

  102. </div>
    103. 

  103. <p>Add the following line to your settings.py file:</p>
    104. 

  104. <div class="highlight-python"><div class="highlight"><pre><span class="n">GRAPPELLI_INDEX_DASHBOARD</span> <span class="o">=</span> <span class="s">&#39;openeats.dashboard.CustomIndexDashboard&#39;</span>
    105. 

  105. </pre></div>
    106. 

  106. </div>
    107. 

  107. <p>Add the following lines to your settings.py file:</p>
    108. 

  108. <div class="highlight-python"><div class="highlight"><pre><span class="n">STATIC_ROOT</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">BASE_PATH</span><span class="p">,</span> <span class="s">&#39;static-files&#39;</span><span class="p">)</span>
    109. 

  109. <span class="n">STATIC_URL</span> <span class="o">=</span> <span class="s">&#39;/static-files/&#39;</span>
    110. 

  110. </pre></div>
    111. 

  111. </div>
    112. 

  112. <p>Change the <em>ADMIN_MEDIA_PREFIX</em> setting in the settings.py file to this:</p>
    113. 

  113. <div class="highlight-python"><div class="highlight"><pre><span class="n">ADMIN_MEDIA_PREFIX</span> <span class="o">=</span> <span class="n">STATIC_URL</span> <span class="o">+</span> <span class="s">&quot;grappelli/&quot;</span>
    114. 

  114. </pre></div>
    115. 

  115. </div>
    116. 

  116. <p>Add the following line under the <em>OpenEats Settings</em> section of the settings.py file:</p>
    117. 

  117. <div class="highlight-python"><div class="highlight"><pre><span class="n">OETITLE</span><span class="o">=</span><span class="s">&quot;OpenEats2&quot;</span>
    118. 

  118. </pre></div>
    119. 

  119. </div>
    120. 

  120. <p>You can set this to anything you want your site title to be, it doesn&#8217;t have to be set to <em>OpenEats2</em></p>
    121. 

  121. <p>Remove the following line from urls.py:</p>
    122. 

  122. <div class="highlight-python"><div class="highlight"><pre><span class="n">url</span><span class="p">(</span><span class="s">r&#39;^admin_tools/&#39;</span><span class="p">,</span> <span class="n">include</span><span class="p">(</span><span class="s">&#39;admin_tools.urls&#39;</span><span class="p">)),</span>
    123. 

  123. </pre></div>
    124. 

  124. </div>
    125. 

  125. </div>
    126. 

  126. <div class="section" id="removing-directories">
    127. 

  127. <h3>3.1.3. Removing directories<a class="headerlink" href="#removing-directories" title="Permalink to this headline"></a></h3>
    128. 

  128. <p>The following directories are no longer needed for version 2.1 and can be removed</p>
    129. 

  129. <ul class="simple">
    130. 

  130. <li>grappelli</li>
    131. 

  131. <li>site-media/admin</li>
    132. 

  132. <li>site-media/admin_tools</li>
    133. 

  133. </ul>
    134. 

  134. </div>
    135. 

  135. <div class="section" id="upgrade-third-party-apps">
    136. 

  136. <h3>3.1.4. Upgrade third party apps<a class="headerlink" href="#upgrade-third-party-apps" title="Permalink to this headline"></a></h3>
    137. 

  137. <p>To upgrade all the packages that OpenEats2 requires perform the following steps.</p>
    138. 

  138. <ul>
    139. 

  139. <li><p class="first">Activate your virtualenv</p>
    140. 

  140. </li>
    141. 

  141. <li><p class="first">Change to the directory that you unzipped the OpenEats2 files into</p>
    142. 

  142. </li>
    143. 

  143. <li><p class="first">Run the following command:</p>
    144. 

  144. <div class="highlight-python"><pre>pip install -r OE2_Requirements.txt --upgrade</pre>
    145. 

  145. </div>
    146. 

  146. </li>
    147. 

  147. </ul>
    148. 

  148. </div>
    149. 

  149. <div class="section" id="database-changes">
    150. 

  150. <h3>3.1.5. Database changes<a class="headerlink" href="#database-changes" title="Permalink to this headline"></a></h3>
    151. 

  151. <p>Run the following command from the OpenEats2 directory:</p>
    152. 

  152. <div class="highlight-python"><pre>./manage.py syncdb
    153. 

  153. ./manage.py migrate djangoratings 0001 --fake
    154. 

  154. ./manage.py migrate djangoratings 0002 --fake
    155. 

  155. ./manage.py migrate djangoratings 0003
    156. 

  156. ./manage.py migrate djangoratings 0004 --fake
    157. 

  157. ./manage.py migrate djangoratings 0005 --fake
    158. 

  158. ./manage.py migrate djangoratings
    159. 

  159. ./manage.py migrate sentry 0001 --fake
    160. 

  160. ./manage.py migrate sentry 0002 --fake
    161. 

  161. ./manage.py migrate sentry 0003 --fake
    162. 

  162. ./manage.py migrate sentry 0004 --fake
    163. 

  163. ./manage.py migrate sentry 0005 --fake
    164. 

  164. ./manage.py migrate sentry 0006 --fake
    165. 

  165. ./manage.py migrate sentry 0007 --fake
    166. 

  166. ./manage.py migrate sentry 0008 --fake
    167. 

  167. ./manage.py migrate sentry 0009 --fake
    168. 

  168. ./manage.py migrate sentry
    169. 

  169. ./manage.py migrate</pre>
    170. 

  170. </div>
    171. 

  171. </div>
    172. 

  172. <div class="section" id="third-party-static-files">
    173. 

  173. <h3>3.1.6. Third Party static files<a class="headerlink" href="#third-party-static-files" title="Permalink to this headline"></a></h3>
    174. 

  174. <p>Django 1.3 offers a new feature that pulls in all the css and image files from third party apps into one folder.
    175. 

  175. This does away with having to setup symlinks to them yourself.  The files are stored in the static-files directory.
    176. 

  176. To get the initial files set run the following command:</p>
    177. 

  177. <div class="highlight-python"><pre>./manage.py collectstatic</pre>
    178. 

  178. </div>
    179. 

  179. </div>
    180. 

  180. <div class="section" id="rebuild-search-index">
    181. 

  181. <h3>3.1.7. Rebuild Search Index<a class="headerlink" href="#rebuild-search-index" title="Permalink to this headline"></a></h3>
    182. 

  182. <p>The search engine was updated as part of this release so it is a good idea to run the following command to rebuild it:</p>
    183. 

  183. <div class="highlight-python"><pre>./manage.py rebuild_index</pre>
    184. 

  184. </div>
    185. 

  185. </div>
    186. 

  186. <div class="section" id="running">
    187. 

  187. <h3>3.1.8. Running<a class="headerlink" href="#running" title="Permalink to this headline"></a></h3>
    188. 

  188. <p>After the upgrade you can run the following command to start the internal Django webserver.  This will allow you to
    189. 

  189. test your site:</p>
    190. 

  190. <div class="highlight-python"><pre>./manage.py runserver 8000</pre>
    191. 

  191. </div>
    192. 

  192. </div>
    193. 

  193. </div>
    194. 

  194. <div class="section" id="upgrade-2-1-to-2-2">
    195. 

  195. <h2>3.2. Upgrade 2.1 to 2.2<a class="headerlink" href="#upgrade-2-1-to-2-2" title="Permalink to this headline"></a></h2>
    196. 

  196. <p>This procedure covers how to upgrade your existing 2.1 OpenEats2 site to version 2.2.  If you are upgrading from 2.0 to 2.2
    197. 

  197. you will need to follow the steps from Config File Changes down in the <em>Upgrading from 2.0 to 2.1</em> section.</p>
    198. 

  198. <div class="section" id="id1">
    199. 

  199. <h3>3.2.1. Install<a class="headerlink" href="#id1" title="Permalink to this headline"></a></h3>
    200. 

  200. <ul class="simple">
    201. 

  201. <li>Download the latest package from <a class="reference external" href="https://github.com/qgriffith/OpenEats">github</a></li>
    202. 

  202. <li>Unzip the file</li>
    203. 

  203. <li>Backup your database</li>
    204. 

  204. <li>Backup your current site files</li>
    205. 

  205. <li>From the unzip file, copy everything other then the settings.py, site-media/upload and site-media/uploads file into your current openeats directory, over writing
    206. 

  206. what is already there</li>
    207. 

  207. </ul>
    208. 

  208. </div>
    209. 

  209. <div class="section" id="id3">
    210. 

  210. <h3>3.2.2. Database changes<a class="headerlink" href="#id3" title="Permalink to this headline"></a></h3>
    211. 

  211. <p>Run the following command from the OpenEats2 directory:</p>
    212. 

  212. <div class="highlight-python"><pre>./manage.py migrate list</pre>
    213. 

  213. </div>
    214. 

  214. </div>
    215. 

  215. <div class="section" id="id4">
    216. 

  216. <h3>3.2.3. Running<a class="headerlink" href="#id4" title="Permalink to this headline"></a></h3>
    217. 

  217. <p>After the upgrade you can run the following command to start the internal Django webserver.  This will allow you to
    218. 

  218. test your site:</p>
    219. 

  219. <div class="highlight-python"><pre>./manage.py runserver 8000</pre>
    220. 

  220. </div>
    221. 

  221. </div>
    222. 

  222. </div>
    223. 

  223. </div>
    224. 

  224. 

  225. 

  226.           </div>
    227. 

  227.         </div>
    228. 

  228.       </div>
    229. 

  229.       <div class="sphinxsidebar">
    230. 

  230.         <div class="sphinxsidebarwrapper">
    231. 

  231.   <h3><a href="index.html">Table Of Contents</a></h3>
    232. 

  232.   <ul>
    233. 

  233. <li><a class="reference internal" href="#">3. Upgrade</a><ul>
    234. 

  234. <li><a class="reference internal" href="#upgrade-2-0-to-2-1">3.1. Upgrade 2.0 to 2.1</a><ul>
    235. 

  235. <li><a class="reference internal" href="#install">3.1.1. Install</a></li>
    236. 

  236. <li><a class="reference internal" href="#config-file-changes">3.1.2. Config File Changes</a></li>
    237. 

  237. <li><a class="reference internal" href="#removing-directories">3.1.3. Removing directories</a></li>
    238. 

  238. <li><a class="reference internal" href="#upgrade-third-party-apps">3.1.4. Upgrade third party apps</a></li>
    239. 

  239. <li><a class="reference internal" href="#database-changes">3.1.5. Database changes</a></li>
    240. 

  240. <li><a class="reference internal" href="#third-party-static-files">3.1.6. Third Party static files</a></li>
    241. 

  241. <li><a class="reference internal" href="#rebuild-search-index">3.1.7. Rebuild Search Index</a></li>
    242. 

  242. <li><a class="reference internal" href="#running">3.1.8. Running</a></li>
    243. 

  243. </ul>
    244. 

  244. </li>
    245. 

  245. <li><a class="reference internal" href="#upgrade-2-1-to-2-2">3.2. Upgrade 2.1 to 2.2</a><ul>
    246. 

  246. <li><a class="reference internal" href="#id1">3.2.1. Install</a></li>
    247. 

  247. <li><a class="reference internal" href="#id3">3.2.2. Database changes</a></li>
    248. 

  248. <li><a class="reference internal" href="#id4">3.2.3. Running</a></li>
    249. 

  249. </ul>
    250. 

  250. </li>
    251. 

  251. </ul>
    252. 

  252. </li>
    253. 

  253. </ul>
    254. 

  254. 

  255.   <h4>Previous topic</h4>
    256. 

  256.   <p class="topless"><a href="install.html"
    257. 

  257.                         title="previous chapter">2. Installation</a></p>
    258. 

  258.   <h4>Next topic</h4>
    259. 

  259.   <p class="topless"><a href="config.html"
    260. 

  260.                         title="next chapter">4. Configuration</a></p>
    261. 

  261.   <h3>This Page</h3>
    262. 

  262.   <ul class="this-page-menu">
    263. 

  263.     <li><a href="_sources/upgrading.txt"
    264. 

  264.            rel="nofollow">Show Source</a></li>
    265. 

  265.   </ul>
    266. 

  266. <div id="searchbox" style="display: none">
    267. 

  267.   <h3>Quick search</h3>
    268. 

  268.     <form class="search" action="search.html" method="get">
    269. 

  269.       <input type="text" name="q" size="18" />
    270. 

  270.       <input type="submit" value="Go" />
    271. 

  271.       <input type="hidden" name="check_keywords" value="yes" />
    272. 

  272.       <input type="hidden" name="area" value="default" />
    273. 

  273.     </form>
    274. 

  274.     <p class="searchtip" style="font-size: 90%">
    275. 

  275.     Enter search terms or a module, class or function name.
    276. 

  276.     </p>
    277. 

  277. </div>
    278. 

  278. <script type="text/javascript">$('#searchbox').show(0);</script>
    279. 

  279.         </div>
    280. 

  280.       </div>
    281. 

  281.       <div class="clearer"></div>
    282. 

  282.     </div>
    283. 

  283.     <div class="related">
    284. 

  284.       <h3>Navigation</h3>
    285. 

  285.       <ul>
    286. 

  286.         <li class="right" style="margin-right: 10px">
    287. 

  287.           <a href="genindex.html" title="General Index"
    288. 

  288.              >index</a></li>
    289. 

  289.         <li class="right" >
    290. 

  290.           <a href="config.html" title="4. Configuration"
    291. 

  291.              >next</a> |</li>
    292. 

  292.         <li class="right" >
    293. 

  293.           <a href="install.html" title="2. Installation"
    294. 

  294.              >previous</a> |</li>
    295. 

  295.         <li><a href="index.html">OpenEats2 v2.2.0 documentation</a> &raquo;</li> 
    296. 

  296.       </ul>
    297. 

  297.     </div>
    298. 

  298.     <div class="footer">
    299. 

  299.         &copy; Copyright 2011, Quenten Griffith.
    300. 

  300.       Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
    301. 

  301.     </div>
    302. 

  302.   </body>
    303. 

  303. </html>
    304.