[Sommaire] [Imprimer]

   1  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   2  <html xmlns="http://www.w3.org/1999/xhtml">
   3  <head>
   4  <!-- Version Info:
   5  
   6  $Source: /cvsroot/e107/e107_0.7/e107_docs/README_UPGRADE.html,v $
   7  $Revision: 1.6 $
   8  $Date: 2007/02/03 17:52:02 $
   9  $Author: e107steved $
  10  
  11  -->
  12  <title>e107 Readme</title>
  13  <link rel="stylesheet" href="style.css" type="text/css" />
  14  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  15  <meta http-equiv="content-style-type" content="text/css" />
  16  </head>
  17  <body>
  18  <div id='mainbox'> <a href="http://e107.org"><img src="../e107_images/logo.png" alt="Logo" style="border:0" /></a> <br />
  19    <br />
  20    <span class="smalltext">© Steve Dunstan 2002. See gpl.txt for license details.</span><br />
  21    <hr />
  22    <br />
  23    <a id='latest_info'></a><span class="headertext">Latest Information</span><br />  Please see the documentation at <a href="http://e107.org">e107.org</a> for the latest <a href="http://wiki.e107.org/?title=HOWTO:Install_e107">installation</a> and <a href="http://wiki.e107.org/?title=HOWTO:Upgrade_to_a_newer_version_of_e107_0.7xx">upgrade</a> documents. If you are upgrading from version 0.617 or earlier, there is a separate <a href="http://wiki.e107.org/?title=HOWTO:Upgrade_e107_from_0.6xx">upgrade guide</a>. The information on the web site supercedes any information in this file.
  24    
  25    There is also additional information on troubleshooting any problems which might arise, and on how to set up and use E107.
  26    <br /><br />
  27    <hr />
  28    <br />
  29    <a id='upgrading'></a><span class="headertext">Upgrading</span><br />
  30    <br />
  31  0.6175 -> .7 Upgrade Guide
  32  <pre>
  33  e107 has undergone a lot of changes from .617 to .7 and bkwon has compiled a comprehensive list of these over
  34  at <a href="e107faq.org">e107faq.org</a>. There are also changelogs for the various versions of 0.7 in the documentation at <a href="http://e107.org">e107.org</a>.
  35  
  36  Essential Points
  37  
  38      * If you are upgrading an English site from .617 you will need the separate English iso-8859-1 language pack, as the
  39        default core English language pack is now in the UTF character set. If you do not do this some characters in your
  40        database content will display corrupted.
  41      * If your .617 site is non English you will need to make sure the .7 lan pack in your language is both available and in the same
  42        character set as your current .617 language pack. If it is not in the same character set as your original,
  43        some characters in your content, if not all, will display corrupted.
  44      * The plugins you currently use on your .617 site may not work with .7 so you must check this before upgrading your site.
  45      * .7 is almost a complete rewrite of .617 and so there are many database changes. For this reason it is essential
  46        that you make a backup of your site using PhpMyAdmin or another third party SQL backup - do not use the e107 core
  47        database backup system in e107 as this does not work. I know everyone always says you should backup - but for once this
  48        time it's really meant as we will not be able to help you if you lose content or it gets corrupted and with such
  49        heavy database changes this could be possible.
  50  
  51  
  52  Warning!
  53  There are files related to htmlArea, the WYSIWYG system in the 0.6xx branch of e107 that are known to be exploitable. These must be
  54  removed immediately. Please delete the following directories and all their contents from your server:
  55  e107_handlers/htmlarea/
  56  e107_admin/htmlarea/
  57  
  58  Upgrade process
  59  
  60     1. Download the .7 core zip and your required .7 language pack (English iso-8859-1 for English sites).
  61     2. Login to your site and go to the admin area and set your maintenance flag to true (Admin => Maintenance).
  62        This will close your site off to visitors whilst you perform the upgrade.
  63     3. Check your database validity by using the tool located at Admin => Database => Check Database Validity. If you have
  64        any errors do not continue with the upgrade process as these must be fixed first.
  65     4. Go back to your admin area frontpage.
  66     5. Extract the contents of the core zip and upload the files to your server - overwriting the existing .617 files.
  67     6. Extract the contents of the language pack (in this release its just one file - English.php) and upload the file(s) to
  68        your server - overwriting the existing one(s).
  69     7. Refresh your admin front page in your browser and you will see an update available button appear.
  70        Click this to take to you to the update page (Alternatively you can reach the update page through Admin =>Database =>
  71        Check For Updates).
  72     8. Click the .617 to .7 core update button. This will run the first step in the upgrade process.
  73        When it finishes you will see several new buttons appear for the upgrade routines for forum, content
  74        and statistics. Even if you do not use these e107 features, run each update anyway.
  75     9. Once all updates have been processed you should no longer have buttons on the updates page and you have completed
  76        the upgrade process.
  77    10. Go back to the database validity tool and check once again that everything passes ok.
  78  
  79  
  80  
  81  You may notice some e107 elements have gone missing - forum, chatbox, content, links, etc... well don't worry
  82  they haven't really! A large part of the e107 core has been 'pluginfied' and you will find all these elements are
  83  now stand alone plugins and can be located under Admin => Plugins. A point to note with links is that your existing
  84  links page links have been separated from the main 'site links' and the upgrade routine has moved them to the new
  85  links page plugin.
  86  
  87  Reviews, articles and content have also been pluginfied and incorporated into one plugin called 'Content Management'.
  88  If you used any of these features in 0.6xx or want to use this new plugin for new content, you will need to
  89  change some additional directory permissions for the new plugin. Please see the relevant entry regards this under
  90  'Permissions'.
  91  
  92  Version .7 comes with a new theme, Jayya, which has been designed for the admin area of the site and is intended to
  93  make administration more user friendly, implementing several new features for this job. If you would like to try it
  94  out, go to Admin => Theme Manager and change the admin area theme to 'Jayya'.
  95  
  96  Because of the huge number of changes in .7 and on the basis it's an almost total rewrite, there may be some
  97  problems when you upgrade. If you find a specific bug please post this in the bugtracker here on e107.org so that
  98  we may fix the issue in the next release of the system. Thanks.
  99  
 100  Permissions: Core
 101  The following permissions should be set for using e107 core (most of these will have already been set this way
 102  from your previous 0.6xx install):
 103  
 104  chmod 777: e107_themes/
 105  chmod 777: e107_plugins/
 106  chmod 777: e107_files/public/
 107  chmod 777: e107_files/public/avatars/
 108  chmod 777: e107_files/cache/
 109  
 110  Permissions: Plugins
 111  The following permissions will need to be set if you were using statistics in your 0.6xx site or wish to use the new
 112  Statistic Logging plugin at some point in the future:
 113  
 114  chmod 777: e107_plugins/log/logs/
 115  
 116  The following permissions will need to be set if you were using the links page in your 0.6xx site or wish to use the new
 117  links page plugin at some point in the future:
 118  
 119  chmod 777: e107_plugins/links_page/cat_images/
 120  chmod 777: e107_plugins/links_page/link_images/
 121  
 122  The following permissions will need to be set if you were using Reviews / Articles or Content in your 0.6xx site or
 123  wish to use the new Content Management plugin at some point in the future:
 124  
 125  chmod 777: e107_plugins/content/images/cat/
 126  chmod 777: e107_plugins/content/images/cat/16/
 127  chmod 777: e107_plugins/content/images/cat/48/
 128  chmod 777: e107_plugins/content/images/file/
 129  chmod 777: e107_plugins/content/images/file/tmp/
 130  chmod 777: e107_plugins/content/images/icon/
 131  chmod 777: e107_plugins/content/images/icon/tmp/
 132  chmod 777: e107_plugins/content/images/image/
 133  chmod 777: e107_plugins/content/images/image/tmp/
 134  chmod 777: e107_plugins/content/menus/
 135  
 136  
 137  Troubleshooting
 138  If you have any problems with the upgrade such as being locked out of your site please clear your cache by deleting
 139  the php files in e107_files/cache/.
 140  
 141  CVS Users
 142  If you have upgraded your 0.6xx install to 0.7 using a CVS nightly build or downloading directly from the CVS
 143  repository, you need to check what character set you are currently using. You will find this information displayed
 144  on your admin area front page under the 'Site Info' menu where it says 'Charset'. If under Charset it says you are
 145  using 'utf-8' then you need only download the main core zip and upgrade with that. Your charset is the default that
 146  0.7 runs with and so is included in the main zip. However, if the Charset says iso-8859-1 and you run an English site
 147  then you must download the separate English iso-8858-1 language pack alongside the main core zip and overwrite the
 148  language files in the core zip with those you find in the iso-8858-1 zip. For non English sites make sure to get your
 149  language in the same Charset as is listed on the admin area frontpage under Site Info.
 150  </pre>
 151    <a id='disclaimer'></a><span class="headertext">Disclaimer</span><br />
 152    <br />
 153    This software is free and as such comes without warranty as stated in the GNU GPL License (included in this package). Any problems encountered due to deficiencies in this software are not the responsibility of the author. <br />
 154  </div>
 155  </body>
 156  </html>