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

Revision as of 08:59, 23 July 2024

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. CacheFolder has no persitent 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. CacheFolder has no persitent 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/`	`$VDATADIR/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 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.

BlueSpice PRO "distributed-services"

Data

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. CacheFolder has no persitent 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/`	`$VDATADIR/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 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 91: / Line 91: @@
 |<code>$VOLUMES_DIR/postfix</code>
 | -
-|Obsolete
+|Obsolete. Fill in MailConfig in .env (SMTP*)
 |-
 |<code>$VOLUMES_DIR/startup</code>
@@ Line 101: / Line 101: @@
 |<code>Move $VOLUMES_DIR/etc/bluespice/bluespice.keytab here and rename it kerberos.keytab</code>
 |}
 Additional for Farm:
@@ Line 111: / Line 110: @@
 |-
 |<code>$VOLUMES_DIR/bluespice/_sf_instances/</code>
-| -
+| <code>$VDATADIR/wiki/bluespice/_sf_instances/</code>
-|Obsolete. New containers log everything to <code>stderr</code> / <code>stdout</code>
+|
 |-
-|<code>$VOLUMES_DIR/bluespice/_sf_archive</code> <code>a/</code>
+|<code>$VOLUMES_DIR/bluespice/_sf_archive</code>
-|<code>$DATADIR/wiki/bluespice/images/</code>
+|<code>$DATADIR/wiki/bluespice/_sf_archive</code>
 |
 |}
@@ Line 125: / Line 124: @@
 !Comment
 |-
-|<code>$WIKI_INSTALL_DIR/www/bluespice/w/LocalSettings.php</code>
+|<code>$VOLUMES_DIR/bluespice/LocalSettings.php</code>
+|
+*<code>$DATADIR/bluespice/pre-init-settings.php</code>
+*<code>$DATADIR/bluespice/post-init-settings.php</code>
+|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.
+|-
+|<code>$VOLUMES_DIR/bluespice/settings.php</code>
 |
 *<code>$DATADIR/bluespice/pre-init-settings.php</code>
 *<code>$DATADIR/bluespice/post-init-settings.php</code>
 |Custom settings must be split up and added to those new files manually.
 |}
 ==BlueSpice PRO "distributed-services"==
 ===Data===
+{| class="wikitable"
+!OLD (<code>bluespice/bluespice-pro</code> 4.2 and 4.3)
+!NEW (<code>bluespice-deploy/composer</code> 4.5)
+!Comment
+|-
+|<code>$VOLUMES_DIR/logs/</code>
+| -
+|Obsolete. New containers log everything to <code>stderr</code> / <code>stdout</code>
+|-
+|<code>$VOLUMES_DIR/bluespice/images/</code>
+|<code>$DATADIR/wiki/bluespice/images/</code>
+|
+|-
+|<code>$VOLUMES_DIR/bluespice/cache/</code>
+|
+|Obsolete. CacheFolder has no persitent data
+|-
+|<code>$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/config/</code>
+| -
+|Obsolete. All contents of this directory have been migrated to the database in <code>4.4</code> already. ATTENTION:  might migration
+|-
+|<code>$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/data/</code>
+|<code>$DATADIR/wiki/bluespice/extensions</code><code>/BlueSpiceFoundation/data/</code>
+|
+|-
+|<code>$VOLUMES_DIR/backup</code>
+|<code>$DATADIR/wiki/backup</code>
+|
+|-
+|<code>$VOLUMES_DIR/mariadb/data</code>
+|<code>$DATADIR/database/data</code>
+|
+|-
+|<code>$VOLUMES_DIR/mariadb/logs</code>
+|<code>$DATADIR/database/logs</code>
+|
+|-
+|<code>$DATADIR/proxy/certs</code>
+|<code>$DATADIR/proxy/certs</code>
+|Name CRT and Key file after URL:
+wiki.example.com.crt/wiki.example.com.key
+|-
+|<code>$VOLUMES_DIR/kerberos</code>
+|<code>$DATADIR/kerberos</code>
+|
+|}
+Additional for Farm:
+{| class="wikitable"
+!OLD (<code>bluespice/bluespice-farm</code> 4.2 and 4.3)
+!NEW (<code>bluespice-deploy/composer</code> 4.5)
+!Comment
+|-
+|<code>$VOLUMES_DIR/bluespice/_sf_instances/</code>
+| <code>$VDATADIR/wiki/bluespice/_sf_instances/</code>
+|
+|-
+|<code>$VOLUMES_DIR/bluespice/_sf_archive</code>
+|<code>$DATADIR/wiki/bluespice/_sf_archive</code>
+|
+|}
 ===Settings===
+{| class="wikitable"
+!OLD (<code>bluespice/bluespice-pro</code> 4.4)
+!NEW (<code>bluespice-deploy/composer</code> 4.5)
+!Comment
+|-
+|<code>$VOLUMES_DIR/bluespice/LocalSettings.php</code>
+|
+*<code>$DATADIR/bluespice/pre-init-settings.php</code>
+*<code>$DATADIR/bluespice/post-init-settings.php</code>
+|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.
+|-
+|<code>$VOLUMES_DIR/bluespice/settings.php</code>
+|
+*<code>$DATADIR/bluespice/pre-init-settings.php</code>
+*<code>$DATADIR/bluespice/post-init-settings.php</code>
+|Custom settings must be split up and added to those new files manually.
+|}