History of bitweaverUpgrade
Version 53
bitweaverUpgrade
How to Upgrade bitweaver
Whatever you do, always make a backup. We put a lot of effort into creating reliable installation and upgrade processes and making them as easy and quick as possible, however there are so many different setups and you might be using the one that causes a problem.
Your data
The following files and directories contain dynamically stored data - in other words, data that you or your users created. You'll want to copy that to your new installation:- /kernel/config_inc.php
- Contains all the database access information.
- /storage/
- Contains all files that have been uploaded by your users.
- /temp/
- Contains some cached items, but also custom modules like your Nexus menus.
- 3rd party applications
- phpBB, Gallery2, FCKeditor and so forth have their own configuration files, e.g., /phpbb/config.php
Release Numbering Convention
bitweaver is released using X.Y.Z numerical notations which are standard in the software industry. here is a breif overview:X | 0 | 0 | This is the major release, and indicates significant architectural changes in the database schema and code structure. This is the number used for "R1" or "R2", etc. | You will need to run the GUI installer and follow the upgrade path. Be sure to run a test upgrade on a backup database first in case there are errors in the upgrade. |
X | Y | 0 | This is the minor release which indicates no architectural or database changes have been made, however new packages or significant features have been added. | Simply replace your install with the last source (being mindful of retaining your storage/ directory and kernel/config_ing.php - we highly recommend cvs checkouts to make upgrading a breeze. |
X | Y | Z | This is a bug fix release that simply fixes issues with existing code. No architectural or database changes have been made. | Same as minor release. See above. |
Database changes:
For detailed information on what changes have occurred, please consult the schema changelog page for any changes that have been made to any package. We never make table alterations to stable branches. However you might find that some permissions have been added to the database.General procedure to upgrade:
- make a backup of your files (and database if possible - just to be on the safe side).
- upload / unpack the downloaded archive in the same location as it was before.
- copy the files and directories mentioned above to your new version of bitweaver.
- review Install Doc as things like permissions can cause problems.
- point your browser to http://my.cool-bitweaver.site/
Sample Upgrade Process
$ mysqldump bitweaver > bitweaver.dump # dump the database
$ mysqladmin create bitweaver-1-2 # create new database
$ mysql bitweaver-1-2 < bitweaver.dump # import database into new database
$ cd /var/www/html/ # move to your apache document root
$ mv bitweaver/ bitweaver-old/ # rename your old bitweaver directory
$ cp -a bitweaver-old/themes/styles/mytheme bitweaver/themes/ # copy accross your custom theme if you have one
$ tar -zxvf ~/downloads/bitweaver_1.2.0.tar.gz # extract the new version of bitweaver
$ cp -ru --reply=yes bitweaver-old/storage/* bitweaver/storage/ # copy storage/
$ cp -ru --reply=yes bitweaver-old/temp/* bitweaver/temp/ # copy temp/
$ chmod -R 777 bitweaver/storage/ bitweaver/temp/ # make sure apache has permissions to access them
$ sed -e 's/"bitweaver"/"bitweaver-1-2"/g' bitweaver-old/kernel/config_inc.php > bitweaver/kernel/config_inc.php
# copy config_inc.php while changing the $gBitDbName value
When using postgresql, replace the first 3 lines:
$ pg_dump bitweaver > bitweaver.dump
$ createdb bitweaver-1-2
$ psql bitweaver-1-2 < bitweaver.dump
If you are using the package phpBB, also do the following steps:
$ cp --reply=yes bitweaver-old/phpbb/config.php bitweaver/phpbb/config.php # copy your old PHPBB configuration
$ rm -rf bitweaver/phpbb/install/ bitweaver/phpbb/contrib/ # PHPBB will not run when these directories exist
Upgrades from version 1 to version 2
from 1.3 to 2.0
Unpack bitweaver version 2 to some directory and copy your old directories /storage/ and /temp/ into there. Point your browser to yourbitweaver.org/install/install.php and chose the option Upgrade from R1. The installer will now ask for database details. Then, the installer converts your database and your installed packages. After this is done, you can intall new packages from the new version. If something went not so perfect, the installer will point you to it later. This could be missing tables (installer will then try to create them) or unassigned permissions (installer lets you fix them). Some tricks and tipps:- be sure to have the file /storage/bit_setup_inc.php in place
- compare your old /kernel/config_inc.php with the new one just created
- don't copy files from /temp/templates_c/, rather delete the contents of this folder (or click admin -> system cache -> clear all)
- if you're using your own custom style, it might hold uncompatible modules or templates that cause errors
- upgrading from version 1.1 or 1.2 to version 2.0 does not require you to install 1.3 first, any version 1 can be upgraded directly by the installer of version 2