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

Latest revision as of 11:48, 9 August 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. 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 custom changes like *.local.php files and or 070-LDAP.php, 09*-<some-name>.php

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.

@@ Line 2: / Line 2: @@
 ===Data===
 Data has been stored in the directory referenced by <code>WIKI_INSTALL_DIR</code>. Now <code>DATADIR</code> is used.
-{| class="wikitable"
+{| class="cuscosky"
 |+
 !OLD (<code>bluespice/bluespice-free</code> 4.4)
@@ Line 18: / Line 18: @@
 |<code>$WIKI_INSTALL_DIR/www/bluespice/w/cache/</code>
 |
-|Obsolete. CacheFolder has no persitent data
+|Obsolete. Cache folder has no persistent data
 |-
 |<code>$WIKI_INSTALL_DIR/www/bluespice/w/&#xAD;extensions/BlueSpiceFoundation/config/</code>
@@ Line 31: / Line 31: @@
 ===Settings===
 Data have been stored in the directory referenced by <code>WIKI_INSTALL_DIR</code>.
-{| class="wikitable"
+{| class="cuscosky"
 |+
 !OLD (<code>bluespice/bluespice-free</code> 4.4)
@@ Line 47: / Line 47: @@
 ===Data===
 Data has been stored in the directory referenced by <code>VOLUMES_DIR</code>. Now <code>DATADIR</code> is used.
-{| class="wikitable"
+{| class="cuscosky"
 !OLD (<code>bluespice/bluespice-pro</code> 4.2 and 4.3)
 !NEW (<code>bluespice-deploy/composer</code> 4.5)
@@ Line 62: / Line 62: @@
 |<code>$VOLUMES_DIR/bluespice/cache/</code>
 |
-|Obsolete. CacheFolder has no persitent data
+|Obsolete. Cache folder has no persistent data
 |-
 |<code>$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/config/</code>
@@ Line 104: / Line 104: @@
 Additional for Farm:
-{| class="wikitable"
+{| class="cuscosky"
 !OLD (<code>bluespice/bluespice-farm</code> 4.2 and 4.3)
 !NEW (<code>bluespice-deploy/composer</code> 4.5)
@@ Line 119: / Line 119: @@
 ===Settings===
-{| class="wikitable"
+{| class="cuscosky"
 !OLD (<code>bluespice/bluespice-pro</code> 4.4)
 !NEW (<code>bluespice-deploy/composer</code> 4.5)
@@ Line 128: / Line 128: @@
 *<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
+|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.
 |-
-|<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 custom changes like *.local.php files and or 070-LDAP.php, 09*-<some-name>.php</code>
 ==BlueSpice PRO "distributed-services"==
 ===Data===
-{| class="wikitable"
+{| 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
@@ Line 155: / Line 159: @@
 |<code>$VOLUMES_DIR/bluespice/cache/</code>
 |
-|Obsolete. CacheFolder has no persitent data
+|Obsolete. Cache folder has no persistent 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
+|Obsolete. All contents of this directory have been migrated to the database in <code>4.4</code> already.
+'''ATTENTION:  might need migration'''
 |-
 |<code>$VOLUMES_DIR/bluespice/extensions/BlueSpiceFoundation/data/</code>
@@ Line 180: / Line 185: @@
 |<code>$DATADIR/proxy/certs</code>
 |Name CRT and Key file after URL:
-wiki.example.com.crt/wiki.example.com.key
+* <code>wiki.example.com.crt</code>
+* <code>wiki.example.com.key</code>
 |-
 |<code>$VOLUMES_DIR/kerberos</code>
@@ Line 189: / Line 197: @@
 Additional for Farm:
-{| class="wikitable"
+{| class="cuscosky"
 !OLD (<code>bluespice/bluespice-farm</code> 4.2 and 4.3)
 !NEW (<code>bluespice-deploy/composer</code> 4.5)
@@ Line 204: / Line 212: @@
 ===Settings===
-{| class="wikitable"
+{| class="cuscosky"
 !OLD (<code>bluespice/bluespice-pro</code> 4.4)
 !NEW (<code>bluespice-deploy/composer</code> 4.5)
@@ Line 213: / Line 221: @@
 *<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
+|Fill in .env with relevant data. <code>LocalSettings.php</code> is  not longer in use
-Custom settings must be split up and added to those new files manually.
+Custom settings must be added to post-init-settings.php manually
 |-
-|<code>$VOLUMES_DIR/bluespice/settings.php</code>
+|<code>$VOLUMES_DIR/bluespice/settings.d</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.
+|Custom settings must be added to post-init-settings.php manually.
 |}
+[[de:Setup:Installationsanleitung/Docker/Migration_4.4_to_4.5]]