Setup:Installation Guide/Docker/Migration 4.4 to 4.5: Difference between revisions

Revision as of 13:52, 2 August 2024

Data has been stored in the directory referenced by WIKI_INSTALL_DIR. Now DATADIR is used.


OLD (`bluespice/bluespice-free` 4.4)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$WIKI_INSTALL_DIR/logs/`	-	Obsolete. New containers log everything to `stderr` / `stdout`
`$WIKI_INSTALL_DIR/www/bluespice/w/images/`	`$DATADIR/bluespice/images/`
`$WIKI_INSTALL_DIR/www/bluespice/w/cache/`		Obsolete. Cache folder has no persistent data
`$WIKI_INSTALL_DIR/www/bluespice/w/extensions/BlueSpiceFoundation/config/`	-	Obsolete. All contents of this directory have been migrated to the database in `4.4` already.
`$WIKI_INSTALL_DIR/www/bluespice/w/extensions/BlueSpiceFoundation/data/`	`$DATADIR/bluespice/extensions/BlueSpiceFoundation/data/`

Data have been stored in the directory referenced by WIKI_INSTALL_DIR.


OLD (`bluespice/bluespice-free` 4.4)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$WIKI_INSTALL_DIR/www/bluespice/w/LocalSettings.php`	`$DATADIR/bluespice/pre-init-settings.php` `$DATADIR/bluespice/post-init-settings.php`	Custom settings must be split up and added to those new files manually.

Data has been stored in the directory referenced by VOLUMES_DIR. Now DATADIR is used.

OLD (`bluespice/bluespice-pro` 4.2 and 4.3)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$VOLUMES_DIR/logs/`	-	Obsolete. New containers log everything to `stderr` / `stdout`
`$VOLUMES_DIR/bluespice/images/`	`$DATADIR/wiki/bluespice/images/`
`$VOLUMES_DIR/bluespice/cache/`		Obsolete. Cache folder has no persistent data
`$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/config/`	-	Obsolete. All contents of this directory have been migrated to the database in `4.4` already. ATTENTION: needs migration
`$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/data/`	`$DATADIR/wiki/bluespice/extensions/BlueSpiceFoundation/data/`
`$VOLUMES_DIR/backup`	`$DATADIR/wiki/backup`
`$VOLUMES_DIR/etc`	-	Obsolete
`$VOLUMES_DIR/mysql`	`$DATADIR/database/data and` `$DATADIR/database/logs`	No direct copy possible
`$VOLUMES_DIR/ssl`	`$DATADIR/proxy/certs`	Name CRT and Key file after URL: wiki.example.com.crt/wiki.example.com.key
`$VOLUMES_DIR/postfix`	-	Obsolete. Fill in MailConfig in .env (SMTP*)
`$VOLUMES_DIR/startup`	-	Obsolete
`$VOLUMES_DIR/kerberos`	`$DATADIR/kerberos`	`Move $VOLUMES_DIR/etc/bluespice/bluespice.keytab here and rename it kerberos.keytab`

Additional for Farm:

OLD (`bluespice/bluespice-farm` 4.2 and 4.3)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$VOLUMES_DIR/bluespice/_sf_instances/`	`$DATADIR/wiki/bluespice/_sf_instances/`
`$VOLUMES_DIR/bluespice/_sf_archive`	`$DATADIR/wiki/bluespice/_sf_archive`

OLD (`bluespice/bluespice-pro` 4.4)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$VOLUMES_DIR/bluespice/LocalSettings.php`	`$DATADIR/bluespice/pre-init-settings.php` `$DATADIR/bluespice/post-init-settings.php`	Fill in .env wiht relevant data. LocalSettings.php is not longer in use Custom settings must be split up and added to those new files manually.
`$VOLUMES_DIR/bluespice/settings.d`	`$DATADIR/bluespice/pre-init-settings.php` `$DATADIR/bluespice/post-init-settings.php`	Custom settings must be split up and added to those new files manually.

Check your $VOLUMES_DIR/bluespice/settings.d for local/custom changes. Special: *.local.php files and or 070-LDAP.php, 09*-<some-name>.php

Nearly 99% of the persistant Files of

OLD (`bluespice/bluespice-pro` 4.3 and 4.4)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$VOLUMES_DIR/logs/`	-	Obsolete. New containers log everything to `stderr` / `stdout`
`$VOLUMES_DIR/bluespice/images/`	`$DATADIR/wiki/bluespice/images/`
`$VOLUMES_DIR/bluespice/cache/`		Obsolete. Cache folder has no persistent data
`$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/config/`	-	Obsolete. All contents of this directory have been migrated to the database in `4.4` already. ATTENTION: might migration
`$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/data/`	`$DATADIR/wiki/bluespice/extensions/BlueSpiceFoundation/data/`
`$VOLUMES_DIR/backup`	`$DATADIR/wiki/backup`
`$VOLUMES_DIR/mariadb/data`	`$DATADIR/database/data`
`$VOLUMES_DIR/mariadb/logs`	`$DATADIR/database/logs`
`$DATADIR/proxy/certs`	`$DATADIR/proxy/certs`	Name CRT and Key file after URL: `wiki.example.com.crt` `wiki.example.com.key`
`$VOLUMES_DIR/kerberos`	`$DATADIR/kerberos`

Additional for Farm:

OLD (`bluespice/bluespice-farm` 4.2 and 4.3)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$VOLUMES_DIR/bluespice/_sf_instances/`	`$DATADIR/wiki/bluespice/_sf_instances/`
`$VOLUMES_DIR/bluespice/_sf_archive`	`$DATADIR/wiki/bluespice/_sf_archive`

OLD (`bluespice/bluespice-pro` 4.4)	NEW (`bluespice-deploy/composer` 4.5)	Comment
`$VOLUMES_DIR/bluespice/LocalSettings.php`	`$DATADIR/bluespice/pre-init-settings.php` `$DATADIR/bluespice/post-init-settings.php`	Fill in .env wiht relevant data. `LocalSettings.php` is not longer in use Custom settings must be split up and added to those new files manually.
`$VOLUMES_DIR/bluespice/settings.php`	`$DATADIR/bluespice/pre-init-settings.php` `$DATADIR/bluespice/post-init-settings.php`	Custom settings must be split up and added to those new files manually.

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

@@ Line 131: / Line 131: @@
 Custom settings must be split up and added to those new files manually.
 |-
-|<code>$VOLUMES_DIR/bluespice/settings.php</code>
+|<code>$VOLUMES_DIR/bluespice/settings.d</code>
 |
 *<code>$DATADIR/bluespice/pre-init-settings.php</code>
@@ Line 137: / Line 137: @@
 |Custom settings must be split up and added to those new files manually.
 |}
+Check your <code>$VOLUMES_DIR/bluespice/settings.d for local/custom changes. Special: *.local.php files and or 070-LDAP.php, 09*-<some-name>.php</code>
+Nearly 99% of the persistant Files of
 ==BlueSpice PRO "distributed-services"==
 ===Data===
 {| class="cuscosky"
-!OLD (<code>bluespice/bluespice-pro</code> 4.2 and 4.3)
+!OLD (<code>bluespice/bluespice-pro</code> 4.3 and 4.4)
 !NEW (<code>bluespice-deploy/composer</code> 4.5)
 !Comment