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

Revision as of 11:06, 9 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 with 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 need 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 with relevant data. `LocalSettings.php` is not longer in use Custom settings must be added to post-init-settings.php manually
`$VOLUMES_DIR/bluespice/settings.d`	`$DATADIR/bluespice/pre-init-settings.php` `$DATADIR/bluespice/post-init-settings.php`	Custom settings must be added to post-init-settings.php manually.

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