History of bitweaverUpgrade

Differences from version 57 to 66



@@ -1,17 +1,17 @@

 {maketoc}
 
-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.
+__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.
 
 ! 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.
-;/theme/styles/your_theme/: If you have a custom theme you'll want to make sure you copy it over.
-;3rd party applications: phpBB, Gallery2, FCKeditor and so forth have their own configuration files, e.g., /phpbb/config.php
+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.
 
 !Release Numbering Convention
-bitweaver is released using X.Y.Z numerical notations which are standard in the software industry. here is a breif overview:
+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.

@@ -19,14 +19,14 @@

 ||
 
 ! Database changes:
-For detailed information on what changes have occurred, 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.
+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 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 [#Yourdata|above] to your new version of bitweaver.
-# __review [http://www.bitweaver.org/wiki/InstallbitweaverDoc|Install Doc]__ as things like permissions can cause problems.
-# point your browser to http://my.cool-bitweaver.site/
+# 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

@@ -46,6 +46,8 @@

 $ 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

@@ -69,6 +71,11 @@

 $ 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:"}

@@ -78,15 +85,24 @@

 # 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.
-# First 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 accross your storage, temp and configuration files
-# Due to the database changes a couple of additional steps are required. First you need to 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?setp=4{/code}
-# If you have been using ((TreasuryPackage)), one additional step is required. Please visit the upgrade script: {code source=Text title="Treasury upgrade"}http://your.bitweaver.site/treasury/admin/database_to_libertymime.php{/code}
+# 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.
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