No edit summary |
No edit summary Tag: 2017 source edit |
||
| (3 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
This page contains instructions for a patch update (e.g. from version 4.1.x to a higher version 4.1.x+). | This page contains instructions for a patch update (e.g., from version 4.1.x to a higher version 4.1.x+). | ||
== | ==Backup== | ||
First, you need to make a backup of your database:<syntaxhighlight lang="bash"> | |||
mysqldump -u root -p --all-databases > all_databases.sql | mysqldump -u root -p --all-databases > all_databases.sql | ||
</syntaxhighlight>To make your code base more secure, save it to a secure location of your choice<syntaxhighlight lang="bash"> | </syntaxhighlight>To make your code base more secure, save it to a secure location of your choice:<syntaxhighlight lang="bash"> | ||
#Linux bash | #Linux bash | ||
cp -r codebase your_secure_place | cp -r codebase your_secure_place | ||
| Line 13: | Line 13: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Renew the code base == | ==Renew the code base== | ||
Unzip archive (new Wiki version). Overwrite the old wiki code base with the new wiki version code | Unzip the archive (new Wiki version). Overwrite the old wiki code base with the new wiki version code:<syntaxhighlight lang="bash"> | ||
#Linux bash | #Linux bash | ||
cp -r new_version_codebase old_version_codebase | cp -r new_version_codebase old_version_codebase | ||
| Line 24: | Line 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Local settings and | ==Local settings and data== | ||
[[File:cutedResult.png|right|1025x1025px|alt=Screenshot of the file structure of the cuted result]] | [[File:cutedResult.png|right|1025x1025px|alt=Screenshot of the file structure of the cuted result]] | ||
===Compare local files and some manual made settings=== | |||
The following files and folders contain local changes: | The following files and folders contain local changes: | ||
*settings files | |||
* settings files | **settings.d/ folder<span><span /><span /><span /><span /><span /></span> '''OR''' | ||
** settings.d/ folder<span><span /><span /><span /><span /><span | ** all files that contain 'local.php' in settings.d/ folder <span /><span /><span /><span /><span /><span /><span /><span /><span /><br /> | ||
** all files that contain 'local.php' in settings.d/ folder <span /><span /><span /><span /><span /><span /><br /> | *extension/BlueSpiceFoundation/config/ folder (only available until BlueSpice 4.2.x){{Bsvs|bsvTo=4.2.x}} | ||
* extension/BlueSpiceFoundation/config/ folder | *images/ folder | ||
* images/ folder | *all LocalSettings.php files<span><span /><span /><span /><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 /><span /><span /><span /><span /><br /> | ||
* all LocalSettings.php files<span><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 /><span /><br /> | |||
===Copy from your backup Local files and some manual made settings=== | |||
For a fast copy, use this bash command: | For a fast copy, use this bash command: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
| Line 51: | Line 50: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Run the update == | ==Run the update== | ||
After all preparations are done and code base is overwritten, do the following steps: | 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) | #open a console and go to the installation folder (LocalSettings.php directory-level, see: right-image) | ||
# enter the following command:<syntaxhighlight lang="bash"> | #enter the following command:<syntaxhighlight lang="bash"> | ||
php maintenance/update.php | php maintenance/update.php | ||
</syntaxhighlight> | </syntaxhighlight> | ||
{{Messagebox|boxtype=note|Note text=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 == | ==Check your current Version== | ||
Open the page <code>Special:Version</code> in your Wiki and check ''BlueSpice(Credits)'':[[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)'':[[File:version43_cuted.png|alt=Version information on special page "Version"|center]] | ||
== If problems occur == | ==If problems occur== | ||
* Visit our [https://sourceforge.net/p/bluespice/support-requests/ SourceForge] support forum or [http://sourceforge.net/tracker/?func=add&group_id=358032&atid=1494709 report a bug]. | *Visit our [https://sourceforge.net/p/bluespice/support-requests/ SourceForge] support forum or [http://sourceforge.net/tracker/?func=add&group_id=358032&atid=1494709 report a bug]. | ||
* 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]. | *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><span /><span /><br /></span> | <span><span /><span /><span /><span /><span /><br /></span> | ||
[[de:Setup:Installationsanleitung/Patch_Update]] | [[de:Setup:Installationsanleitung/Patch_Update]] | ||
[[en:{{FULLPAGENAME}}]] | [[en:{{FULLPAGENAME}}]] | ||
Latest revision as of 11:52, 27 March 2024
This page contains instructions for a patch update (e.g., from version 4.1.x to a higher version 4.1.x+).
Backup
First, you need to make a backup 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 the 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:
- settings files
- settings.d/ folder OR
- all files that contain 'local.php' in settings.d/ folder
- extension/BlueSpiceFoundation/config/ folder (only available until BlueSpice 4.2.x) -v4.2.x
- 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
Open the page Special:Version in your Wiki and check BlueSpice(Credits):
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.
