"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "achievo-1.3.4/doc/UPGRADE" of archive achievo-1.3.4.tar.gz:

As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field. 
    1 Upgrading Achievo
    2 =================
    3 
    4 Read this first
    5 ---------------
    6 Depite our efforts to keep this UPGRADE file as accurate as possible, there
    7 might be situations in which the described procedure does not work.
    8 In this case send an email to sandy@achievo.org or visit our forums at
    9 http://www.achievo.org/forum and we will try to help you out.
   10 
   11 IMPORTANT
   12 ---------
   13 Upgrading is never without risk. ALWAYS BACKUP YOUR ACHIEVO DATABASE before
   14 attempting to upgrade. A good way to do the upgrade is to copy the entire 
   15 database. For example, if your database is achievo_0_6, and you want to 
   16 upgrade to Achievo 1.2, then copy the database to achievo_1_3. Then proceed
   17 with the instructions below.
   18 
   19 Support
   20 -------
   21 Upgrading is not always easy, especially if you need to upgrade to a version
   22 that is significantly newer than your current version. Ibuildings.nl can help
   23 with the conversion. For information about this kind of support, see:
   24 http://www.achievo.org/support/sponsor
   25 
   26 
   27 General upgrade instructions
   28 ============================
   29 
   30 These are the general upgrade instructions. Sometimes, additional information
   31 is provided for upgrading between certain versions. You will find this 
   32 additional information at the end of this document.
   33 
   34 Upgrading the software usually consists of replacing the Achievo sourcecode 
   35 with a newer version. It is usually possible to use the config file from your
   36 current Achievo installation, however, you might miss some config options that
   37 were added in a newer release. Therefor it is best to use the new configfile 
   38 and just change the settings again.
   39 
   40 As of Achievo 0.9.2, a setup.php script is provided to upgrade Achievo 
   41 databases. Take the following steps to perform the upgrade:
   42 
   43 1) Make sure the config.inc.php file is correct, especially the database 
   44    configuration and the administrator password.
   45 
   46    Important: in order to upgrade your database, the databaseuser used by 
   47    Achievo needs to have the following privileges on the Achievo database: 
   48    select, insert, update, delete, create and alter. 
   49    It is ok to remove the create and alter table privileges after the upgrade 
   50    process is completed.
   51 
   52 2) Point your browser to the setup.php script. For example, browse to:
   53     
   54    http://yourserver/achievo/setup.php (assuming Achievo is installed in the
   55    directory 'achievo' in your webservers' document root.)
   56    
   57    You will be presented with a login screen. You need to login as 
   58    administrator, with the password you specified in config.inc.php.
   59 
   60 3) The setup.php script will take you through the upgrade process. It will 
   61    verify if PHP is configured correctly to run this version of Achievo, and 
   62    migrate your database if necessary. Follow the directions on screen until 
   63    the script tells you that the upgrade is complete.
   64   
   65 
   66 Additional upgrade notes
   67 ========================
   68 
   69 This section contains information that you should read when upgrading to or 
   70 from a particular version of Achievo.
   71 
   72 Upgrading from Achievo 0.4.x
   73 ----------------------------
   74 Since Achievo 0.4, the authentication and authorization processes have changed
   75 significantly. If you upgrade from an Achievo version 0.4.x, there are a few
   76 things to note:
   77 - All passwords are reset to 'default'. Users should change their passwords 
   78   after their first login.
   79 - Access rights can not be preserved between these versions. After the 
   80   upgrade, you should go the the Employees menu, and edit the Security 
   81   Profiles. By default, all users present in Achievo 0.4 are placed in the 
   82   'Default Group' profile. 
   83