History of bitweaverUpgrade

Version 12

bitweaverUpgrade

How to Upgrade bitweaver

Created by: xing, Last modification: 11 Jul 2005 (15:02 UTC) by xing

bitweaverRelease Upgrades

whatever you do, always make a backup. whether you are about to do minor upgrades or large ones, please always backup your files and database first. we put a lot of effort into creating reliable installation / 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 probems ;)

bitweaver Files and Directories

the following files and directories contain dynamically stored data, which you have to copy to your new installation:
kernel/config_inc.php
This is the file, which is written during the installation process and which contains all the database access information. Without this file, you will be redirected to the install page as soon as you try to access bitweaver.
storage/
The storage directory contains all files that are uploaded to your site. if you omit this directory, your users can not access any files that have previously been uploaded.
temp/
The temp directory contains all cache related items and also it stores any custom modules created. Nexus creates such modules on the fly and hence, no custom modules or menus will work on your new site if you don't copy this folder accross as well.
3rd party applications
third party applications such as phpbb and gallery2 have their own configuration files. also, it is important that you check their upgrade process for individual packages if there have been database changes to these. please someone help with these, as i'm not familiar with these applications.

1.0.0 --> 1.0.1

This is a bug fix release and has no database changes whatsoever.
follow the following procedure:
  • 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.
  • point your browser to http://my.cool-bitweaver.site/
that's it. everything should be working even better than before.

Generic Database Upgrades / Conversions

bitweaver has a powerfull yet simple upgrader that is part of the InstallPackage. With a single click you can give your old site the power of bitweaver.

Our architecture for upgrading, like all of bitweaver, is modular and powerful. Every BitweaverPackage maintains its own upgrade script. This architecture enables you to upgrade *any* CMS to *any* bitweaver version. Anyone up for a drupal upgrader? *nuke upgrader? TW1.9 upgrader?

Currently it handles TikiWiki 1.8 and bitweaver ReleaseZero updates. It uses a lot of subselects so you will need a real database or at least MySQL 4.1.

How does it work?

install/upgrade.php does all the magic by looking at every BitweaverPackage's <package>/admin/upgrade_inc.php. This file has upgrade hashes of SQL *and* php for each package version and particular RDBMS as necessary. Below is a brief example. We suggest you look at liberty/admin/upgrade_inc.php if you are interested in seeing a complete example of how it works, or shoutbox/admin/upgrade_inc.php for a simpler example.

{CODE(in=>PHP)}
$updateHash = array(

'TW18' => array(
'2.0' => array(
'pgsql' => 'ALTER TABLE tiki_pages RENAME `pageId` TO `page_id`'
)
),

'2.0' => array(
'3.0' => array(
'sql92' => "ALTER TABLE tiki_pages ADD foo VARCHAR(20); UPDATE tiki_pages SET foo='bar';",
'php' => 'foreach( $hash as $key ) { doSomething(); } '
)
)

);
{CODE}
</package>
Page History
Date/CommentUserIPVersion
22 May 2010 (12:21 UTC)
jin62.80.184.17866
Current • Source
xing62.47.234.765
View • Compare • Difference • Source
xing62.47.236.17964
View • Compare • Difference • Source
Lester Caine81.138.11.13663
View • Compare • Difference • Source
xing62.47.234.5662
View • Compare • Difference • Source
laetzer85.178.27.14961
View • Compare • Difference • Source
laetzer85.178.39.19960
View • Compare • Difference • Source
xing62.47.249.359
View • Compare • Difference • Source
Lester Caine81.138.11.13658
View • Compare • Difference • Source
xing62.47.234.23457
View • Compare • Difference • Source
xing62.47.234.23456
View • Compare • Difference • Source
Will69.203.72.16155
View • Compare • Difference • Source
xing194.152.164.4554
View • Compare • Difference • Source
spiderr66.194.217.22253
View • Compare • Difference • Source
spiderr66.194.217.22152
View • Compare • Difference • Source
Kozuch194.212.43.9750
View • Compare • Difference • Source
Edwin24.92.192.15649
View • Compare • Difference • Source
Unknown194.63.141.20248
View • Compare • Difference • Source
Edwin24.92.192.15647
View • Compare • Difference • Source
Edwin24.92.192.15645
View • Compare • Difference • Source
Edwin24.92.192.15644
View • Compare • Difference • Source
laetzer85.178.59.14843
View • Compare • Difference • Source
laetzer85.178.53.8740
View • Compare • Difference • Source
xing194.152.164.4539
View • Compare • Difference • Source
jeff24.62.5.10338
View • Compare • Difference • Source
xing194.152.164.4537
View • Compare • Difference • Source