History of bitweaverUpgrade

{maketoc}

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 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 we haven't been able to test ;) __Upgrading from 1.x.x to 1.y.y does NOT require that you run the installer__ - unless you would like to add new packages.


! Your data
The following files and directories contain dynamically stored data - in other words, ++yellow:data that you or your users created.++ You'll want to copy that 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 across 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.__
;phpbb/config.php: This is the file, which is written by the PHPBB installation process and which contains all database access information for the Forums module. Your new site will prompt you to install PHPBB unless this file is present.
;Database changes: Please consult the SchemaChangelog page for any changes that have occurred to any package. __We never make table alterations to stable branches__, however you might find that some permissions have been added to the database. if so, please add these by hand with the simple INSERT statements listed on SchemaChangelog.


! 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 [#bitweaverFilesandDirectories|above] to your new version of bitweaver.
# point your browser to http://my.cool-bitweaver.site/

{code source=Bash title="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
{/code}

{code source=Bash title="When using postgresql, replace the first 3 lines:"}
$ pg_dump bitweaver > bitweaver.dump
$ createdb bitweaver-1-2
$ psql bitweaver-1-2 < bitweaver.dump
{/code}

{code source=Bash title="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
{/code}


! Examples by version
!! 1.x -> 2.0
* forum posting about an [http://www.bitweaver.org/forums/viewtopic.php?p=3586#3586|experimental R1 -> R2 upgrade]
* ...


!! 1.3 -> 1.3.1
!!! bitweaver
As usual, no database changes have been made. Please upgrade in a similar fashion as outlined [#SampleUpgradeProcess|below]. Please make sure to backup your data.

!!! phpBB
phpBB was upgraded to 2.0.20 and requires that you use the phpBB upgrade script. Please view the upgrade instructions that are supplied with phpBB on how to proceed: [http://www.phpbb.com/support/documents.php?mode=install|phpBB install and upgrade instructions]


!! 1.2.1 -> 1.3
The package __search__ has undergone a major re-vamp. It now allows you to re-index your entire site in the admin screen. Make sure to do so after you install 1.3. this will allow users to search all the content on your site reliably. Other than that, all you need to do is visit the installer to install the package __newsletters__ (if you want to use them on your site). Third party applications have all stayed the same and things like __phpBB__ don't require any special treatment.


!! 1.2.0 -> 1.2.1
!!! bitweaver
Beginning with this version, the installer informs you of any permissions that might not be in use anymore and of permissions that have not been added to your database yet. Please visit this screen after upgrading the filebase of your bitweaver install. You can access the page by pointing your browser to the __Resolve Conflicts__ page in the installer: http://my.site.com/install/install.php?step=4

We have had several reports about __not being able to log in__ to the site after upgrading. If you are experiencing such a problem, please visit [/forums/viewtopic.php?t=1311|this forum thread] and post your problems there, should they persist.

!!! phpBB
phpBB was upgraded to 2.0.19 and requires that you use the phpBB upgrade script. Please view the upgrade instructions that are supplied with phpBB on how to proceed: [http://www.phpbb.com/support/documents.php?mode=install|phpBB install and upgrade instructions]


!! 1.0.4 --> 1.2
As with all stable branches, such as ((ReleaseOne)), no alterations of your database are required. We have added a few new permissions. Most of these will probably not interfere with the running of your site, however we recommend that you have a look through ((SchemaChangelog)) for further details and instructions on how to add them to your database.


!! 1.0.x --> 1.0.4
These are bugfix releases and have no database changes whatsoever.


! Problems?
If you encounter problems, please [/forums/viewforum.php?f=5|ask for support in the forum].
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