History of bitweaverUpgrade

Differences from version 20 to 66



@@ -1,24 +1,141 @@

 {maketoc}
-!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, Data 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.__
-;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.
+__Always make a backup first__. A lot of effort was put into creating reliable installation and upgrade processes and making them as easy and quick as possible. However, there are many different server setups, some of which might cause a problem.
 
-!! 1.0.4 --> 1.1
-As with all stable branches, such as ReleaseOne, no altertations of the actual database have been or ever will be required. We have added a few new permissions. Most of these will probably not interfere with the runnings 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.
+! Your data
+The following files and directories [http://www.resumesplanet.com|resume service] contain dynamically stored data - in other words, data that you or your users created. Copy these files or directories to your new installation:
+;__/kernel/config_inc.php__: Contains database access information.
+;__/storage/__: Contains files that have been uploaded by you or your users.
+;__/temp/nexus/modules/__: Contains ((NexusPackage|Nexus)) modules created by you or your users.
+;__/themes/styles/your_style/__: Your custom style (if present).
+;__3rd party__: Applications like phpBB, Gallery2, FCKeditor and so forth might have their own configuration files, e.g., /phpbb/config.php.
 
-!! 1.0.* --> 1.0.4
+!Release Numbering Convention
+Bitweaver is released using X.Y.Z numerical notations:
+||~ Rev | Rev | Rev | Desription | Upgrade Instructions
+__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 "((ReleaseOne|R1))" or "((ReleaseTwo|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:
+Please consult the ((SchemaChangelog|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
+# __upload/unpack__ the downloaded archive to your bitweaver directory
+# __copy the files and directories__ mentioned [#Yourdata|above] to your bitweaver directory
+# __review [http://www.bitweaver.org/wiki/InstallbitweaverDoc|Install Doc]__ if there are problems
+# point your browser to http://your.bitweaver.site/
+
+{code source=Bash title="Sample Upgrade Process"}
+# dump the database
+$ mysqldump bitweaver > bitweaver.dump
+
+# create new database
+$ mysqladmin create bitweaver-bak
+
+# make sure dump worked as planned. this will also allow you to switch back to
+# original database if needed by modifying your kernel/config_inc.php.
+$ mysql bitweaver-bak < bitweaver.dump
+
+# move to your apache document root
+$ cd /var/www/html/
+
+# rename your old bitweaver directory
+$ mv bitweaver/ bitweaver-old/
+
+# copy accross your custom theme if you have one
+# please note that your custom templates might have to be updated
+# usually it's easiest to diff the custom templates with the originals and update appropriately
+$ cp -a bitweaver-old/themes/styles/mytheme bitweaver/themes/
+
+# extract the new version of bitweaver
+$ tar -zxvf ~/downloads/bitweaver_1.2.0.tar.gz
+
+# copy storage/
+$ cp -ru --reply=yes bitweaver-old/storage/* bitweaver/storage/
+
+# copy temp/
+$ cp -ru --reply=yes bitweaver-old/temp/* bitweaver/temp/
+
+# make sure apache has permissions to access them
+$ chmod -R 777 bitweaver/storage/ bitweaver/temp/
+
+# copy your config_inc.php
+$ cp bitweaver-old/kernel/config_inc.php bitweaver/kernel/config_inc.php
+{/code}
+If all that worked, you should be able to visit your site. Please look at specific upgrade instructions below.
+
+{code source=Bash title="When using postgresql, replace the first 3 lines:"}
+$ pg_dump bitweaver > bitweaver.dump
+$ createdb bitweaver-bak
+$ psql bitweaver-bak < bitweaver.dump
+{/code}
+
+{code source=Bash title="When using firebird, replace the first 3 lines:"}
+'Backup and restore database via your favourite tool'
+There should be a scheduled backup happening anyway on a well configured firebird installation
+{/code}
+
+{code source=Bash title="If you are using the package phpBB, also do the following steps:"}
+# copy your old PHPBB configuration
+$ cp --reply=yes bitweaver-old/phpbb/config.php bitweaver/phpbb/config.php
+
+# PHPBB will not run when these directories exist
+$ rm -rf bitweaver/phpbb/install/ bitweaver/phpbb/contrib/
+{/code}
+
+!! Post Upgrade Steps
+* First visit your site at http://my.bitweaver.site/. In some cases we force you to visit the installer.
+* If you don't have to visit the installer, please go to Administration >> Kernel >> Packages. Here you will see various tabs that will inform you if you should visit the installer and what needs to be done to fix your bitweaver install.
+* Finally, please visit Administration >> Kernel >> System Cache and clear out your entire cache to get rid of old files.
+
+
+! Upgrades in version 2
+!! from 2.1.x to 2.5.0
+Our installer has undergone a major overhaul. Now it is possible to do database upgrades independently of release versions and now packages can register requirements. The installer should guide you through the upgrade. Please follow the instructions in the installer carefully.
+
+!! from 2.0.x to 2.1.0
+Despite our best efforts, we were unable to avoid a couple of small database changes. We've tried to keep things as simple as possible for you to upgrade.
+# Follow the steps above by creating a backup of the database and moving the old files out of the way and placing the new files in their stead.
+# Copy across your storage folder, configuration files, and custom theme.
+# As soon as you try to browse bitweaver now, you will be forced to visit the installer.
+# Visit the installer on the __Resolve Conflicts__ page. On this page you will see a couple of things that should be done. These can all be dealt with by clicking on the buttons: {code source=Text title="Resolve Conflicts"}http://your.bitweaver.site/install/install.php?step=4{/code}
+# If you have been using ((TreasuryPackage|Treasury)), please visit the upgrade script: {code source=Text title="Treasury upgrade"}http://your.bitweaver.site/treasury/admin/database_to_libertymime.php{/code}
+
+!! from 2.0.x to 2.0.x
 These are bugfix releases and have 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 [#bitweaverFilesandDirectories|above] to your new version of bitweaver.
-* point your browser to http://my.cool-bitweaver.site/
-that's it. everything should be working even better than before.
 
+
+! Upgrade 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 incompatible modules or templates that cause errors. please don't copy these just yet.
+* 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 ((ReleaseTwo|version 2))
+__Further R1 to R2 reading:__
+* [/wiki/bitweaver+R1+to+R2+Upgrade|bitweaver R1 to R2 Upgrade]
+* [/wiki/phpBB+to+Boards+Upgrade|phpBB to Boards Upgrade]
+
+! Upgrades in version 1
+!! from 1.3 to 1.3.1
+__Upgrade of 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. __Upgrade of 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]
+
+!! from 1.2.1 to 1.3.x
+The __search package__ 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 __newsletters package__ (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.
+
+!! from 1.2.0 to 1.2.1
+__Upgrade of 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 (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 [/phpbb/viewtopic.php?t=1311|this forum thread] and post your problems there, should they persist. __Upgrade of 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|install and upgrade instructions at phpBB.com].
+
+!! from 1.0.4 to 1.2.0
+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.
+
+!! from 1.0.x to 1.0.4
+These are bugfix releases and have no database changes whatsoever.
+
+
+! Problems?
+If you encounter problems, please [/forums/|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