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

(Created page with "== BlueSpice FREE "all-in-one" == == BlueSpice PRO "all-in-one" == == BlueSpice PRO "distributed-services" ==")
 
No edit summary
 
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== BlueSpice FREE "all-in-one" ==
== BlueSpice FREE "all-in-one" ==
===Data===
Data has been stored in the directory referenced by <code>WIKI_INSTALL_DIR</code>. Now <code>DATADIR</code> is used.
{| class="cuscosky"
|+
!OLD (<code>bluespice/bluespice-free</code> 4.4)
!NEW (<code>bluespice-deploy/composer</code> 4.5)
!Comment
|-
|<code>$WIKI_INSTALL_DIR/logs/</code>
| -
|Obsolete. New containers log everything to <code>stderr</code> / <code>stdout</code>
|-
|<code>$WIKI_INSTALL_DIR/www/bluespice/w/images/</code>
|<code>$DATADIR/bluespice/images/</code>
|
|-
|<code>$WIKI_INSTALL_DIR/www/bluespice/w/cache/</code>
|
|Obsolete. Cache folder has no persistent data
|-
|<code>$WIKI_INSTALL_DIR/www/bluespice/w/&#xAD;extensions/BlueSpiceFoundation/config/</code>
| -
|Obsolete. All contents of this directory have been migrated to the database in <code>4.4</code> already.
|-
|<code>$WIKI_INSTALL_DIR/www/bluespice/w/&#xAD;extensions/BlueSpiceFoundation/data/</code>
|<code>$DATADIR/bluespice/&#xAD;extensions/BlueSpiceFoundation/data/</code>
|
|}


== BlueSpice PRO "all-in-one" ==
===Settings===
Data have been stored in the directory referenced by <code>WIKI_INSTALL_DIR</code>.
{| class="cuscosky"
|+
!OLD (<code>bluespice/bluespice-free</code> 4.4)
!NEW (<code>bluespice-deploy/composer</code> 4.5)
!Comment
|-
|<code>$WIKI_INSTALL_DIR/www/bluespice/w/LocalSettings.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" ==
==BlueSpice PRO "all-in-one"==
===Data===
Data has been stored in the directory referenced by <code>VOLUMES_DIR</code>. Now <code>DATADIR</code> is used.
{| class="cuscosky"
!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. 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: needs 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/etc</code>
| -
|Obsolete
|-
|<code>$VOLUMES_DIR/mysql</code>
|<code>$DATADIR/database/data and</code>  <code>$DATADIR/database/logs</code>
|No direct copy possible
|-
|<code>$VOLUMES_DIR/ssl</code>
|<code>$DATADIR/proxy/certs</code>
|Name CRT and Key file after URL:
wiki.example.com.crt/wiki.example.com.key
|-
|<code>$VOLUMES_DIR/postfix</code>
| -
|Obsolete. Fill in MailConfig in .env (SMTP*)
|-
|<code>$VOLUMES_DIR/startup</code>
| -
|Obsolete
|-
|<code>$VOLUMES_DIR/kerberos</code>
|<code>$DATADIR/kerberos</code>
|<code>Move $VOLUMES_DIR/etc/bluespice/bluespice.keytab here and rename it kerberos.keytab</code>
|}
 
Additional for Farm:
 
{| class="cuscosky"
!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>$DATADIR/wiki/bluespice/_sf_instances/</code>
|
|-
|<code>$VOLUMES_DIR/bluespice/_sf_archive</code>
|<code>$DATADIR/wiki/bluespice/_sf_archive</code>
|
|}
 
===Settings===
{| class="cuscosky"
!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 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.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.
|}
 
 
 
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="cuscosky"
!OLD (<code>bluespice/bluespice-pro</code> 4.3 and 4.4)
!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. 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 need 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:
 
* <code>wiki.example.com.crt</code>
 
* <code>wiki.example.com.key</code>
|-
|<code>$VOLUMES_DIR/kerberos</code>
|<code>$DATADIR/kerberos</code>
|
|}
 
Additional for Farm:
 
{| class="cuscosky"
!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>$DATADIR/wiki/bluespice/_sf_instances/</code>
|
|-
|<code>$VOLUMES_DIR/bluespice/_sf_archive</code>
|<code>$DATADIR/wiki/bluespice/_sf_archive</code>
|
|}
 
===Settings===
{| class="cuscosky"
!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 with relevant data. <code>LocalSettings.php</code> is  not longer in use
Custom settings must be added to post-init-settings.php manually
|-
|<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 added to post-init-settings.php manually.
|}
 
[[de:Setup:Installationsanleitung/Docker/Migration_4.4_to_4.5]]

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.