X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=UPGRADE;h=db16cf2a60caaaf31d23a6e660ced8c6d993cef4;hb=89704bcdeec2bac07b0528d21cd2d15bedf8c4ec;hp=71607ea1ee5589b1ed36b3cb740e22f3beac11af;hpb=2b55641a9f0112b36943bbf30e6a12b211330a18;p=quix0rs-gnu-social.git diff --git a/UPGRADE b/UPGRADE index 71607ea1ee..db16cf2a60 100644 --- a/UPGRADE +++ b/UPGRADE @@ -1,17 +1,52 @@ Upgrading ========= -IMPORTANT NOTE: StatusNet 0.7.4 introduced a fix for some -incorrectly-stored international characters ("UTF-8"). For new -installations, it will now store non-ASCII characters correctly. -However, older installations will have the incorrect storage, and will -consequently show up "wrong" in browsers. See below for how to deal -with this situation. - -If you've been using StatusNet 0.7, 0.6, 0.5 or lower, or if you've +StatusNet 1.1.1 to GNU social +----------------------------- + +We cannot support migrating from any other version of StatusNet than +1.1.1. If you are running a StatusNet version lower than this, please +follow the upgrade procedures for each respective StatusNet version. + +You are now running StatusNet 1.1.1 and want to migrate to GNU social. + +Before you begin: Make backups. Always make backups. Of your entire +directory structure and the database too. All tables. All data. Alles. + + 0. Stop your queue daemons 'php scripts/stopdaemon.php' should do it. + Not everyone runs queue daemons, but the above command won't hurt. + + 1. Unpack your GNU social code to a fresh directory. + + 2. Synchronize your local files to the GNU social directory. These + will be the local files such as avatars, config and files: + + avatar/* + background/* + file/* + local/* + .htaccess + config.php + + 3. Replace your old StatusNet directory with the new GNU social + directory in your webserver root. + + 4. Run the upgrade script: 'php scripts/upgrade.php' + + 5. Start your queue daemons: 'php scripts/startdaemons.php' + + 6. Report any issues at https://gitorious.org/statusnet/gnu-social/ + + +Legacy StatusNet instructions +----------------------------- + +These instructions are here for historical and perhaps informational +purposes. + +If you've been using StatusNet 1.0 or lower, or if you've been tracking the "git" version of the software, you will probably -want to upgrade and keep your existing data. There is no automated -upgrade procedure in StatusNet 0.9.9. Try these step-by-step +want to upgrade and keep your existing data. Try these step-by-step instructions; read to the end first before trying them. 0. Download StatusNet and set up all the prerequisites as if you were @@ -32,58 +67,28 @@ instructions; read to the end first before trying them. 5. Once all writing processes to your site are turned off, make a final backup of the Web directory and database. 6. Move your StatusNet directory to a backup spot, like "statusnet.bak". -7. Unpack your StatusNet 0.9.9 tarball and move it to "statusnet" or +7. Unpack your StatusNet 1.1.1 tarball and move it to "statusnet" or wherever your code used to be. 8. Copy the config.php file and the contents of the avatar/, background/, file/, and local/ subdirectories from your old directory to your new directory. 9. Copy htaccess.sample to .htaccess in the new directory. Change the RewriteBase to use the correct path. -10. Rebuild the database. +10. Upgrade the database. NOTE: this step is destructive and cannot be reversed. YOU CAN EASILY DESTROY YOUR SITE WITH THIS STEP. Don't do it without a known-good backup! - If your database is at version 0.8.0 or higher in the 0.8.x line, you can run a - special upgrade script: - - mysql -u -p db/08to09.sql - - If you are upgrading from any 0.9.x version like 0.9.6, run this script: + In your new StatusNet 1.1.1 directory and AFTER YOU MAKE A + BACKUP run the upgrade.php script like this: - mysql -u -p db/096to097.sql + php ./scripts/upgrade.php - Despite the name, it should work for any 0.9.x branch. - - Otherwise, go to your StatusNet directory and AFTER YOU MAKE A - BACKUP run the rebuilddb.sh script like this: - - ./scripts/rebuilddb.sh rootuser rootpassword database db/statusnet.sql - - Here, rootuser and rootpassword are the username and password for a - user who can drop and create databases as well as tables; typically - that's _not_ the user StatusNet runs as. Note that rebuilddb.sh drops - your database and rebuilds it; if there is an error you have no - database. Make sure you have a backup. - For PostgreSQL databases there is an equivalent, rebuilddb_psql.sh, - which operates slightly differently. Read the documentation in that - script before running it. 11. Use mysql or psql client to log into your database and make sure that the notice, user, profile, subscription etc. tables are non-empty. 12. Turn back on the Web server, and check that things still work. -13. Turn back on XMPP bots and email maildaemon. Note that the XMPP - bots have changed since version 0.5; see above for details. - -If you're upgrading from very old versions, you may want to look at -the fixup_* scripts in the scripts directories. These will store some -precooked data in the DB. All upgraders should check out the inboxes -options below. - -NOTE: the database definition file, laconica.ini, has been renamed to -statusnet.ini (since this is the recommended database name). If you -have a line in your config.php pointing to the old name, you'll need -to update it. +13. Turn back on XMPP bots and email maildaemon. NOTE: the 1.0.0 version of StatusNet changed the URLs for all admin panels from /admin/* to /panel/*. This now allows the (popular) @@ -91,31 +96,21 @@ username 'admin', but blocks the considerably less popular username 'panel'. If you have an existing user named 'panel', you should rename them before upgrading. -Notice inboxes --------------- - -Notice inboxes are now required. If you don't have inboxes enabled, -StatusNet will no longer run. - -UTF-8 Database --------------- - -StatusNet 0.7.4 introduced a fix for some incorrectly-stored -international characters ("UTF-8"). This fix is not -backwards-compatible; installations from before 0.7.4 will show -non-ASCII characters of old notices incorrectly. This section explains -what to do. - -0. You can disable the new behaviour by setting the 'db''utf8' config - option to "false". You should only do this until you're ready to - convert your DB to the new format. -1. When you're ready to convert, you can run the fixup_utf8.php script - in the scripts/ subdirectory. If you've had the "new behaviour" - enabled (probably a good idea), you can give the ID of the first - "new" notice as a parameter, and only notices before that one will - be converted. Notices are converted in reverse chronological order, - so the most recent (and visible) ones will be converted first. The - script should work whether or not you have the 'db''utf8' config - option enabled. -2. When you're ready, set $config['db']['utf8'] to true, so that - new notices will be stored correctly. +Privacy +======= + +With StatusNet 1.0, our default install profile is for private sites. + +If you did not specify the privacy level of your site previously, it +was public. Now, it's private. + +If you upgrade a public site, you will need to reset the privacy +level. You can do this in your config.php: + + $config['site']['private'] = false; + +...or with setconfig.php in the db: + + php setconfig.php site private false + +...or with the site admin panel.