
  U P G R A D E
  =============

  $Id: UPGRADE,v 1.4.4.5 2002/03/30 15:22:03 netsabes Exp $


  This file explains how to upgrade your personnal daCode. First read the part
  which you are concerned about depending of which version you upgrade from
  and to, and then read the general upgrade information which are the same for
  any version.
  
  This is exactly the way we do upgrade our main daCode homesite, if you have
  any problem, contact us as soon as possible to dacode-user@linuxfr.org,
  we'll try to help you.
  _____________________________________________________________________________

  Upgrade from 1.2.x to 1.4.x :


  - Download the last version 1.4 of daCode on :
    http://www.dacode.org/ and untar it in a tmp directory.

    If you used cvs to fetch your version, do upgrade using :

        cvs update -rdacode-1_4-stable-branch

    Be sure you don't have any cvs conflict, if you do, don't erase the files!
    Do fix the conflict manually. You will then be in 1.4 branch, and will be
    able to update at anytime to get the last 1.4 version. 1.4 should always be
    stable, so you can update safely (normally :-) 
    If you have the possibility, we recommand you using cvs instead of the
    tar.gz archive. It will be easier for you to update later.

  - Shutdown your Apache server with your usual command. If you don't have
    admin rights, then just skip this step, it should still work fine.

  - If you used cache, remove all the files from the cache directories. Then
    make a backup of all the files, in case something wrong appends. Make a
    backup of your database (mysqldump in case you use MySQL) as we will make
    changes. Then upgrade your database using the following commands.
    If you use MySQL, do use:

        mysql -u<user> -p<password> database < sql/dacode.mysql.1.2-1.4

    If you use PgSQL, do use:

        pgsql .... ( mettre)


  _____________________________________________________________________________
  
  Upgrade from 1.0.x to 1.2.x :


  - Download the last version 1.2 of daCode on
        http://www.daCode.org/ and untar it in a tmp directory.

  - Shutdown your Apache server with your usual command. If you don't have
    admin rights, then just skip this step, it should still work fine.

  - Make a backup of your database with mysqldump, we need to make changes.
    Modify your MySQL database with sql/dacode.mysql.1.0-1.2 with the
    following command:

        mysql -u<user> -p<password> database < sql/dacode.mysql.1.0-1.2

    You should not have anything printed as output. If you do then you
    probably found a bug, so put back your backup, and mail
    dacode-dev@linuxfr.org with all the details than can help us to track
    what's wrong.


  Note: If you changed a theme or made a personnal theme; then you might have
  to fix it. In html.php3 file you should change
       $this->newsbox_posted_by($row);
  by:
       $this->newsbox_posted_by($row,$preview);

  Also a calendar has been added, it uses new stylesheet codes which are .cal
  .calmonth and .calcurmonth. See the new themes, they include the right
  stylesheet. Also check them as you have much more boxes availables.

  _____________________________________________________________________________

  General upgrade information


  - Lots of new variable are coming out in config.sample. So make a backup of
    your config.php3 file, and edit config.sample to set yours. Then copy
    config.sample to config.php3. If your phplib is available publicly for
    visitors, remove config.sample to not give your database password !
    Then verify config.php3 is readable by apache user.

    *Don't manually add new variables to _your_ config.php3*

    You would probably forget some, so please do it the way we tell you to,
    it will work much better.

  - If you changed anything into the code, like in phplib/ or htdocs/, make a
    diff with 'diff' command and keep thoses somewhere in a file, like in
    ~/dacode.patch for example.

  - Copy the files htdocs/* and phplib/* in your directory.

  - If you did activate the cache in daCode, remove completly the cache dir
    with 'rm'. Both html cache and box cache.
    If you didn't, well you should have, it's much faster and less cpu
    consuming :-)

  - Start your Apache. It should work ! :)


  _____________________________________________________________________________

