Migration 4.4 to 4.5

BlueSpice FREE "all-in-one"

Data

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/

Settings

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.

BlueSpice PRO "all-in-one"

Data

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

Settings

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

BlueSpice PRO "distributed-services"

Data

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

Settings

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.