UPGRADE

   1 Upgrading
   2 =========
   3
   4 StatusNet 1.1.x to GNU social 1.2.x
   5 -----------------------------------
   6
   7 We cannot support migrating from any other version of StatusNet than
   8 1.1.1. If you are running a StatusNet version lower than this, please
   9 follow the upgrade procedures for each respective StatusNet version.
  10
  11 You are now running StatusNet 1.1.1 and want to migrate to GNU social
  12 1.2.x. Beware there may be changes in minimum required version of PHP
  13 and the modules required, so review the INSTALL file (php5-intl is a
  14 newly added dependency for example).
  15
  16 * Before you begin: Make backups. Always make backups. Of your entire
  17 directory structure and the database too. All tables. All data. Alles.
  18
  19 To do a backup of the database, you can use a variant of this command
  20 (you will be interactively prompted for the db user's password):
  21     $ mysqldump -u dbuser -p dbname > social-backup.sql
  22
  23 0. Stop your queue daemons 'bash scripts/stopdaemons.sh' should do it.
  24     Not everyone runs queue daemons, but the above command won't hurt.
  25
  26 1. Unpack your GNU social code to a fresh directory. You can do this
  27     by cloning our git repository:
  28     $ git clone https://gitorious.org/social/mainline.git gnusocial
  29
  30 2. Synchronize your local files to the GNU social directory. These
  31     will be the local files such as avatars, config and files:
  32
  33         avatar/*
  34         background/*
  35         file/*
  36         local/*
  37         .htaccess
  38         config.php
  39
  40     This command will point you in the right direction on how to do it:
  41     $ rsync -avP statusnet/{.htaccess,avatar,background,file,local,config.php} gnusocial/
  42
  43 3. Replace your old StatusNet directory with the new GNU social
  44     directory in your webserver root.
  45
  46 4. Run the upgrade script: 'php scripts/upgrade.php'
  47    The upgrade script will likely take a long time because it will
  48     upgrade the tables to another character encoding and make other
  49     automated upgrades. Make sure it ends without errors. If you get
  50     errors, create a new task on https://bugz.foocorp.net/
  51
  52 5. Start your queue daemons: 'bash scripts/startdaemons.sh'
  53
  54 6. Report any issues at https://bugz.foocorp.net/ (tag GNU social)