UPGRADE

   1 Upgrading
   2 =========
   3
   4 StatusNet 1.1.1 to GNU social
   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
  13 Before you begin: Make backups. Always make backups. Of your entire
  14 directory structure and the database too. All tables. All data. Alles.
  15
  16     0. Stop your queue daemons 'php scripts/stopdaemon.php' should do it.
  17         Not everyone runs queue daemons, but the above command won't hurt.
  18
  19     1. Unpack your GNU social code to a fresh directory.
  20
  21     2. Synchronize your local files to the GNU social directory. These
  22         will be the local files such as avatars, config and files:
  23
  24             avatar/*
  25             background/*
  26             file/*
  27             local/*
  28             .htaccess
  29             config.php
  30
  31     3. Replace your old StatusNet directory with the new GNU social
  32         directory in your webserver root.
  33
  34     4. Run the upgrade script: 'php scripts/upgrade.php'
  35
  36     5. Start your queue daemons: 'php scripts/startdaemons.php'
  37
  38     6. Report any issues at https://gitorious.org/statusnet/gnu-social/
  39
  40
  41 Legacy StatusNet instructions
  42 -----------------------------
  43
  44 These instructions are here for historical and perhaps informational
  45 purposes.
  46
  47 If you've been using StatusNet 1.0 or lower, or if you've
  48 been tracking the "git" version of the software, you will probably
  49 want to upgrade and keep your existing data. Try these step-by-step
  50 instructions; read to the end first before trying them.
  51
  52 0. Download StatusNet and set up all the prerequisites as if you were
  53    doing a new install.
  54 1. Make backups of both your database and your Web directory. UNDER NO
  55    CIRCUMSTANCES should you try to do an upgrade without a known-good
  56    backup. You have been warned.
  57 2. Shut down Web access to your site, either by turning off your Web
  58    server or by redirecting all pages to a "sorry, under maintenance"
  59    page.
  60 3. Shut down XMPP access to your site, typically by shutting down the
  61    xmppdaemon.php process and all other daemons that you're running.
  62    If you've got "monit" or "cron" automatically restarting your
  63    daemons, make sure to turn that off, too.
  64 4. Shut down SMS and email access to your site. The easy way to do
  65    this is to comment out the line piping incoming email to your
  66    maildaemon.php file, and running something like "newaliases".
  67 5. Once all writing processes to your site are turned off, make a
  68    final backup of the Web directory and database.
  69 6. Move your StatusNet directory to a backup spot, like "statusnet.bak".
  70 7. Unpack your StatusNet 1.1.1 tarball and move it to "statusnet" or
  71    wherever your code used to be.
  72 8. Copy the config.php file and the contents of the avatar/, background/,
  73    file/, and local/ subdirectories from your old directory to your new
  74    directory.
  75 9. Copy htaccess.sample to .htaccess in the new directory. Change the
  76    RewriteBase to use the correct path.
  77 10. Upgrade the database.
  78
  79     NOTE: this step is destructive and cannot be
  80     reversed. YOU CAN EASILY DESTROY YOUR SITE WITH THIS STEP. Don't
  81     do it without a known-good backup!
  82
  83     In your new StatusNet 1.1.1 directory and AFTER YOU MAKE A
  84     BACKUP run the upgrade.php script like this:
  85
  86         php ./scripts/upgrade.php
  87
  88 11. Use mysql or psql client to log into your database and make sure that
  89     the notice, user, profile, subscription etc. tables are non-empty.
  90 12. Turn back on the Web server, and check that things still work.
  91 13. Turn back on XMPP bots and email maildaemon.
  92
  93 NOTE: the 1.0.0 version of StatusNet changed the URLs for all admin
  94 panels from /admin/* to /panel/*. This now allows the (popular)
  95 username 'admin', but blocks the considerably less popular username
  96 'panel'. If you have an existing user named 'panel', you should rename
  97 them before upgrading.
  98
  99 Privacy
 100 =======
 101
 102 With StatusNet 1.0, our default install profile is for private sites.
 103
 104 If you did not specify the privacy level of your site previously, it
 105 was public. Now, it's private.
 106
 107 If you upgrade a public site, you will need to reset the privacy
 108 level. You can do this in your config.php:
 109
 110        $config['site']['private'] = false;
 111
 112 ...or with setconfig.php in the db:
 113
 114        php setconfig.php site private false
 115
 116 ...or with the site admin panel.