Setup:Installation Guide/Patch Update: Difference between revisions

Revision as of 15:15, 9 February 2023

This page contains instructions for a patch update (e.g. from version 4.1.x to a higher version 4.1.x+).

Back-up

Firstly, you need to make a back-up of your database

mysqldump -u root -p --all-databases > all_databases.sql

To make your code base more secure, save it to a secure location of your choice

#Linux bash
cp -r codebase your_secure_place

# Win bash
xcopy codebase your_secure_place\ /E

Renew the code base

Unzip archive (new Wiki version). Overwrite the old wiki code base with the new wiki version code.

#Linux bash
cp -r new_version_codebase old_version_codebase
rm -rf new_version_codebase

#Win bash
xcopy new_version_codebase old_version_codebase\ /E/H #path/ -  to tell xcopy that path is a directory.
rmdir new_version_codebase /Q/S

Local settings and Data

Compare Local files and some manual made settings

The following files and folders contain local changes:

skins/ folder
settings files
- settings.d/ folder
  OR
- all files that contain 'local.php' in settings.d/ folder
extension/BlueSpiceFoundation/config/ folder
images/ folder
all LocalSettings.php files

Copy from your backup Local files and some manual made settings

For a fast copy, use this bash command:

#Linux Bash
cd your_secure_place
cp -r images/ LocalSettings.* settings.d/ codebase/
cp -r /extensions/BlueSpiceFoundation/config /codebase/extensions/BlueSpiceFoundation/

#Win Bash
cd your_secure_place
for %I in (images/ LocalSettings.* settings.d/) do copy %I codebase/
for %I in (config/ data/) do copy %I codebase/extensions/BlueSpiceFoundation/

Run the update

After all preparations are done and code base is overwritten, do the following steps:

open a console and go to the installation folder (LocalSettings.php directory-level, see: right-image)
enter the following command:
```
php maintenance/update.php
```

Note: If you use Linux for your BlueSpice installation, please note that the file system permissions may be lost when overwriting the code base!

Check your current Version

Version information on special page "Version"

Open the page Special:Version in your Wiki and check 'BlueSpice(Credits)' see: right-image

If problems occur

Visit our SourceForge support forum or report a bug.

For general questions regarding the installation, maintenance, and usage of BlueSpice free, go to our SourceForge help forum.

To submit feedback about this documentation, visit our community forum.

@@ Line 31: / Line 31: @@
 * skins/ folder
 * settings files
-** settings.d/ folder<span><span /><span /><span /><br /></span>       OR <span /><span />
+** settings.d/ folder<span><span /><span /><span /><span /><br /></span>       OR <span /><span />
-** all files that contain 'local.php' in settings.d/ folder <span /><span /><span /><span /><br />[[File:File localMathPHP.png|alt=screenshot of localMathPHP folder]]
+** all files that contain 'local.php' in settings.d/ folder <span /><span /><span /><span /><span /><br />[[File:File localMathPHP.png|alt=screenshot of localMathPHP folder]]
 * extension/BlueSpiceFoundation/config/ folder
 * images/ folder
-* all LocalSettings.php  files<span><span /><span /><span /><br /></span> [[File:File settingsPHP.png|alt=example screenshot of a list of LocalSettings.php files.]] <span /><span /><span /><span /><br />
+* all LocalSettings.php  files<span><span /><span /><span /><span /><br /></span> [[File:File settingsPHP.png|alt=example screenshot of a list of LocalSettings.php files.]] <span /><span /><span /><span /><span /><br />
 ====== Copy from your backup Local files and some manual made settings ======
@@ Line 60: / Line 60: @@
 <blockquote>Note: If you use Linux for your BlueSpice installation, please note that the file system permissions may be lost when overwriting the code base!</blockquote>
 == Check your current Version ==
-[[File:version43 cuted.png|rechts|alt=Version information on special page "Version"]]
+[[File:version43_cuted.png|alt=Version information on special page "Version"|center]]
 Open the page <code>Special:Version</code> in your Wiki and check 'BlueSpice(Credits)' see: right-image
@@ Line 68: / Line 68: @@
 For general questions regarding the installation, maintenance, and usage of BlueSpice free, go to our [https://sourceforge.net/p/bluespice/discussion/1249668/ SourceForge help forum].
-<span><br /></span>
+<span><span /><br /></span>
 [[de:Setup:Installationsanleitung/Patch_Update]]
 [[en:{{FULLPAGENAME}}]]