Zuletzt bearbeitet vor 11 Monaten
von WikiSysop

Setup:Installationsanleitung/Installation von BlueSpice: Unterschied zwischen den Versionen

K (1 Version importiert)
Keine Bearbeitungszusammenfassung
Zeile 3: Zeile 3:


==Vorwort==
==Vorwort==
Mit BlueSpice 3 bieten wir eine einheitliche Möglichkeit der Installation als Gesamtpaket mit MediaWiki und BlueSpice an.<br />Diese Installationsanleitung gibt Ihnen Step-by-Step die Schritte vor, die Sie benötigen, um BlueSpice zu installieren.
Mit BlueSpice 4.1 bieten wir eine Installation als Gesamtpaket mit MediaWiki und BlueSpice an.


==Hinweise zum Dokument==
==Hinweise zur Anleitung==
Dieses Dokument gibt Ihnen einzig die Schritte zur Installation der Webanwendung vor. Zur Installation erweiterter Funktionen wie VisualEditor und ExtendedSearch beachten Sie bitte die entsprechende Dokumentation hierzu.<br />Wir gehen hier nicht auf Details zu Ihrer Betriebssysteminstallation ein, sondern gehen davon aus, dass Sie ihr System soweit konfiguriert und das Installationspaket bereits in einem Webroot Ihrer Wahl abgelegt haben, wo Sie es über Ihren Browser erreichen können. Details dazu finden Sie in unserer ausführlichen [[Setup:Installationsanleitung|Installationsanleitung]].<br />Weiterführende Hilfe zum Betriebssystem-Setup finden Sie in unserem [[Setup:Installationsanleitung/Kompendium|Kompendium]].
Diese Anleitung berücksichtigt nur die Installation der Webanwendung. Zur Installation erweiterter Funktionen wie VisualEditor und ExtendedSearch beachten Sie bitte die entsprechende Dokumentation hierzu.
 
<br />Wir gehen hier nicht auf Details zu Ihrer Betriebssysteminstallation ein, sondern gehen davon aus, dass Sie ihr System soweit konfiguriert und das Installationspaket bereits in einem Webroot Ihrer Wahl abgelegt haben, wo Sie es über Ihren Browser erreichen können. Details dazu finden Sie in unserer ausführlichen Info zur [[Setup:Installationsanleitung|Systemvorbereitung]]. Weiterführende Hilfe zum Betriebssystem-Setup finden Sie in unserem [[Setup:Installationsanleitung/Kompendium|Kompendium]].


==Die Installation in Einzelschritten==
==Die Installation in Einzelschritten==
Zeile 16: Zeile 18:
{| class="wikitable"
{| class="wikitable"
|-
|-
|[[Datei:Setup:bs3-install-01.png|300px|BlueSpice 3 Installation Step 1]]
|[[Datei:Setup:bs3-install-01.png|300px|BlueSpice 3 Installation Step 1|verweis=Special:FilePath/Setup:bs3-install-01.png]]
||Sollten Sie noch nicht alle nötigen Voraussetzungen für PHP erfüllen, werden Sie diese Einstiegsseite zum Setup noch nicht betrachten können. Bitte nehmen Sie dann zuerst die nötigen Korrekturen an Ihrer PHP-Installation vor.<br /><br />Andernfalls befinden Sie sich nun auf der im Screenshot gezeigten Seite. Klicken Sie auf "set up the wiki", um die Installation zu beginnen.
||Sollten Sie noch nicht alle nötigen Voraussetzungen für PHP erfüllen, werden Sie diese Einstiegsseite zum Setup noch nicht betrachten können. Bitte nehmen Sie dann zuerst die nötigen Korrekturen an Ihrer PHP-Installation vor.<br /><br />Andernfalls befinden Sie sich nun auf der im Screenshot gezeigten Seite. Klicken Sie auf "set up the wiki", um die Installation zu beginnen.
|-
|-
|[[Datei:Setup:bs3-install-02.png|300px|BlueSpice 3 Installation Step 2]]
|[[Datei:Setup:bs3-install-02.png|300px|BlueSpice 3 Installation Step 2|verweis=Special:FilePath/Setup:bs3-install-02.png]]
||Sie befinden sich jetzt in der Sprachauswahl. "Your language" definiert die Sprache, mit der Sie durch den Installer geführt werden, "Wiki language" die spätere Sprache Ihres Wikis.<br /><br />Bei der Wahl von "de" beachten Sie bitte die Unterscheidung zwischen de (Du-Form) und de-formal (Sie-Form).
||Sie befinden sich jetzt in der Sprachauswahl. "Your language" definiert die Sprache, mit der Sie durch den Installer geführt werden, "Wiki language" die spätere Sprache Ihres Wikis.<br /><br />Bei der Wahl von "de" beachten Sie bitte die Unterscheidung zwischen de (Du-Form) und de-formal (Sie-Form).
|-
|-
|[[Datei:Setup:bs3-install-03.png|300px|BlueSpice 3 Installation Step 3]]
|[[Datei:Setup:bs3-install-03.png|300px|BlueSpice 3 Installation Step 3|verweis=Special:FilePath/Setup:bs3-install-03.png]]
||Im nächsten Schritt werden Sie zum Installationscheck von MediaWiki geführt. Lesen Sie diesen aufmerksam durch, da eventuelle Hinweise zwar die Installation nicht blockieren, aber später in der Praxis zu Einschränkungen der Wiki-Funktionalität führen können. Nehmen Sie eventuell gewünschte Korrekturen an Ihrem System vor und laden Sie die Seite in Ihrem Browser neu bevor Sie mit dem Setup fortfahren.
||Im nächsten Schritt werden Sie zum Installationscheck von MediaWiki geführt. Lesen Sie diesen aufmerksam durch, da eventuelle Hinweise zwar die Installation nicht blockieren, aber später in der Praxis zu Einschränkungen der Wiki-Funktionalität führen können. Nehmen Sie eventuell gewünschte Korrekturen an Ihrem System vor und laden Sie die Seite in Ihrem Browser neu bevor Sie mit dem Setup fortfahren.
|-
|-
|[[Datei:Setup:bs3-install-04.png|300px|BlueSpice 3 Installation Step 4]]
|[[Datei:Setup:bs3-install-04.png|300px|BlueSpice 3 Installation Step 4|verweis=Special:FilePath/Setup:bs3-install-04.png]]
||Anschließend wird die Verbindung zur Datenbank konfiguriert.<br />Sie können hier entweder den root-User Ihres MySQL-Servers angeben und im folgenden Schritt einen zusätzlichen User vom Installer anlegen lassen, der nur Zugang zur BlueSpice-Datenbank hat. Auch die Datenbank wird so automatisch angelegt, sollte Sie noch nicht existieren. Alternativ können Sie bereits im Vorfeld einen Nutzer und auch eine Datenbank anlegen und direkt diese Angaben hier eintragen. Informationen zum manuellen Anlegen von Benutzer und Datenbank finden Sie in der [https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki#MariaDB/MySQL offiziellen Mediawiki-Dokumentation].
||Anschließend wird die Verbindung zur Datenbank konfiguriert.<br />Sie können hier entweder den root-User Ihres MySQL-Servers angeben und im folgenden Schritt einen zusätzlichen User vom Installer anlegen lassen, der nur Zugang zur BlueSpice-Datenbank hat. Auch die Datenbank wird so automatisch angelegt, sollte Sie noch nicht existieren. Alternativ können Sie bereits im Vorfeld einen Nutzer und auch eine Datenbank anlegen und direkt diese Angaben hier eintragen. Informationen zum manuellen Anlegen von Benutzer und Datenbank finden Sie in der [https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki#MariaDB/MySQL offiziellen Mediawiki-Dokumentation].
|-
|-
|[[Datei:Setup:bs3-install-05.png|300px|BlueSpice 3 Installation Step 5]]
|[[Datei:Setup:bs3-install-05.png|300px|BlueSpice 3 Installation Step 5|verweis=Special:FilePath/Setup:bs3-install-05.png]]
||Je nachdem, nach welchem Verfahren Sie im vorherigen Schritt vorgegangen sind können Sie jetzt einen exklusiven User für Ihre BlueSpice-Datenbank definieren. Haben Sie den Benutzer im Vorfeld bereits explizit für die Datenbank angelegt belassen Sie den Haken bei "Dasselbe Datenbankkonto wie während des Installationsvorgangs verwenden".
||Je nachdem, nach welchem Verfahren Sie im vorherigen Schritt vorgegangen sind können Sie jetzt einen exklusiven User für Ihre BlueSpice-Datenbank definieren. Haben Sie den Benutzer im Vorfeld bereits explizit für die Datenbank angelegt belassen Sie den Haken bei "Dasselbe Datenbankkonto wie während des Installationsvorgangs verwenden".
|-
|-
|[[Datei:Setup:bs3-install-06.png|300px|BlueSpice 3 Installation Step 6]]
|[[Datei:Setup:bs3-install-06.png|300px|BlueSpice 3 Installation Step 6|verweis=Special:FilePath/Setup:bs3-install-06.png]]
||Geben Sie den Namen für Ihr Wiki ein. Dieser Name wird in der Titelleiste Ihres Browsers ausgegeben sowie an diversen anderen Stellen wie bspw. in Notification-Mails. Achten Sie auf die richtige Schreibweise, da dieser Name im Nachhinein nur mit gewissem Aufwand und gewissen Risiken geändert werden kann.<br />
||Geben Sie den Namen für Ihr Wiki ein. Dieser Name wird in der Titelleiste Ihres Browsers ausgegeben sowie an diversen anderen Stellen wie bspw. in Notification-Mails. Achten Sie auf die richtige Schreibweise, da dieser Name im Nachhinein nur mit gewissem Aufwand und gewissen Risiken geändert werden kann.<br />
Außerdem vergeben Sie hier Username, Passwort und E-Mail-Adresse des ersten administrativen Benutzers, der vom Wiki während des Setups angelegt werden soll.
Außerdem vergeben Sie hier Username, Passwort und E-Mail-Adresse des ersten administrativen Benutzers, der vom Wiki während des Setups angelegt werden soll.
|-
|-
|[[Datei:Setup:bs3-install-07.png|300px|BlueSpice 3 Installation Step 7]]
|[[Datei:Setup:bs3-install-07.png|300px|BlueSpice 3 Installation Step 7|verweis=Special:FilePath/Setup:bs3-install-07.png]]
||In diesem Schritt geben Sie die Mailadresse an, die bei Notification-Mails als Absenderadresse verwendet werden soll.
||In diesem Schritt geben Sie die Mailadresse an, die bei Notification-Mails als Absenderadresse verwendet werden soll.
|-
|-
|[[Datei:Setup:bs3-install-08.png|300px|BlueSpice 3 Installation Step 8]]
|[[Datei:Setup:bs3-install-08.png|300px|BlueSpice 3 Installation Step 8|verweis=Special:FilePath/Setup:bs3-install-08.png]]
||Diesen Schritt können Sie direkt mit "Weiter" überspringen.
||Diesen Schritt können Sie direkt mit "Weiter" überspringen.
|-
|-
|[[Datei:Setup:bs3-install-09.png|300px|BlueSpice 3 Installation Step 9]]
|[[Datei:Setup:bs3-install-09.png|300px|BlueSpice 3 Installation Step 9|verweis=Special:FilePath/Setup:bs3-install-09.png]]
||Nach der erfolgreichen Installation von BlueSpice erhalten Sie diese Bestätigungsseite, die Sie mit "Weiter" bestätigen.
||Nach der erfolgreichen Installation von BlueSpice erhalten Sie diese Bestätigungsseite, die Sie mit "Weiter" bestätigen.
|-
|-
|[[Datei:Setup:bs3-install-10.png|300px|BlueSpice 3 Installation Step 10]]
|[[Datei:Setup:bs3-install-10.png|300px|BlueSpice 3 Installation Step 10|verweis=Special:FilePath/Setup:bs3-install-10.png]]
||Im letzten Schritt der Installation werden Sie zum Download der Konfigurationsdatei "LocalSettings.php" Ihrer Installation aufgefordert. Laden Sie diese herunter und legen Sie diese im Hauptverzeichnis Ihrer BlueSpice-Codebase ab.
||Im letzten Schritt der Installation werden Sie zum Download der Konfigurationsdatei "LocalSettings.php" Ihrer Installation aufgefordert. Laden Sie diese herunter und legen Sie diese im Hauptverzeichnis Ihrer BlueSpice-Codebase ab.
|-
|-
Zeile 50: Zeile 52:
|Öffnen Sie den Ordner <code>..\extensions\BluesSpiceFoundation</code> und bennen Sie die Unterordner <code>config.template</code> bzw. <code>data.template</code> um in <code>config</code> bzw. <code>data</code>. Diese Ordner sollten Schreib- und Lesezugriff haben, siehe [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|Dateisystemrechte]].
|Öffnen Sie den Ordner <code>..\extensions\BluesSpiceFoundation</code> und bennen Sie die Unterordner <code>config.template</code> bzw. <code>data.template</code> um in <code>config</code> bzw. <code>data</code>. Diese Ordner sollten Schreib- und Lesezugriff haben, siehe [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|Dateisystemrechte]].
|-
|-
|[[Datei:Setup:bs3-install-11.png|300px|BlueSpice 3 Installation Step 11]]
|[[Datei:Setup:bs3-install-11.png|300px|BlueSpice 3 Installation Step 11|verweis=Special:FilePath/Setup:bs3-install-11.png]]
||Wenn Sie nun auf die von Ihnen festgelegte URL von BlueSpice zugreifen erhalten Sie die vollendete Installation und können nun direkt mit der Benutzung von BlueSpice starten.
||Wenn Sie nun auf die von Ihnen festgelegte URL von BlueSpice zugreifen erhalten Sie die vollendete Installation und können nun direkt mit der Benutzung von BlueSpice starten.
|}
|}

Version vom 13. Dezember 2021, 18:25 Uhr

Vorwort[Bearbeiten | Quelltext bearbeiten]

Mit BlueSpice 4.1 bieten wir eine Installation als Gesamtpaket mit MediaWiki und BlueSpice an.

Hinweise zur Anleitung[Bearbeiten | Quelltext bearbeiten]

Diese Anleitung berücksichtigt nur die Installation der Webanwendung. Zur Installation erweiterter Funktionen wie VisualEditor und ExtendedSearch beachten Sie bitte die entsprechende Dokumentation hierzu.


Wir gehen hier nicht auf Details zu Ihrer Betriebssysteminstallation ein, sondern gehen davon aus, dass Sie ihr System soweit konfiguriert und das Installationspaket bereits in einem Webroot Ihrer Wahl abgelegt haben, wo Sie es über Ihren Browser erreichen können. Details dazu finden Sie in unserer ausführlichen Info zur Systemvorbereitung. Weiterführende Hilfe zum Betriebssystem-Setup finden Sie in unserem Kompendium.

Die Installation in Einzelschritten[Bearbeiten | Quelltext bearbeiten]

[[File:{{{file}}}|center]] Sollten Sie zusätzlich die kostenpflichtige Erweiterung "BlueSpiceWikiFarm" installieren, so achten Sie darauf, dass die Codebase nicht direkt im DocumentRoot Ihres Webservers bzw. VirtualHosts liegen darf, sondern zwingend im Unterordner /w liegen muss.


Rufen Sie zunächst mit Ihrem Browser die URL auf, unter der die Webanwendung erreichbar ist. Führen Sie anschließend folgende Schritte durch:

BlueSpice 3 Installation Step 1 Sollten Sie noch nicht alle nötigen Voraussetzungen für PHP erfüllen, werden Sie diese Einstiegsseite zum Setup noch nicht betrachten können. Bitte nehmen Sie dann zuerst die nötigen Korrekturen an Ihrer PHP-Installation vor.

Andernfalls befinden Sie sich nun auf der im Screenshot gezeigten Seite. Klicken Sie auf "set up the wiki", um die Installation zu beginnen.
BlueSpice 3 Installation Step 2 Sie befinden sich jetzt in der Sprachauswahl. "Your language" definiert die Sprache, mit der Sie durch den Installer geführt werden, "Wiki language" die spätere Sprache Ihres Wikis.

Bei der Wahl von "de" beachten Sie bitte die Unterscheidung zwischen de (Du-Form) und de-formal (Sie-Form).
BlueSpice 3 Installation Step 3 Im nächsten Schritt werden Sie zum Installationscheck von MediaWiki geführt. Lesen Sie diesen aufmerksam durch, da eventuelle Hinweise zwar die Installation nicht blockieren, aber später in der Praxis zu Einschränkungen der Wiki-Funktionalität führen können. Nehmen Sie eventuell gewünschte Korrekturen an Ihrem System vor und laden Sie die Seite in Ihrem Browser neu bevor Sie mit dem Setup fortfahren.
BlueSpice 3 Installation Step 4 Anschließend wird die Verbindung zur Datenbank konfiguriert.
Sie können hier entweder den root-User Ihres MySQL-Servers angeben und im folgenden Schritt einen zusätzlichen User vom Installer anlegen lassen, der nur Zugang zur BlueSpice-Datenbank hat. Auch die Datenbank wird so automatisch angelegt, sollte Sie noch nicht existieren. Alternativ können Sie bereits im Vorfeld einen Nutzer und auch eine Datenbank anlegen und direkt diese Angaben hier eintragen. Informationen zum manuellen Anlegen von Benutzer und Datenbank finden Sie in der offiziellen Mediawiki-Dokumentation.
BlueSpice 3 Installation Step 5 Je nachdem, nach welchem Verfahren Sie im vorherigen Schritt vorgegangen sind können Sie jetzt einen exklusiven User für Ihre BlueSpice-Datenbank definieren. Haben Sie den Benutzer im Vorfeld bereits explizit für die Datenbank angelegt belassen Sie den Haken bei "Dasselbe Datenbankkonto wie während des Installationsvorgangs verwenden".
BlueSpice 3 Installation Step 6 Geben Sie den Namen für Ihr Wiki ein. Dieser Name wird in der Titelleiste Ihres Browsers ausgegeben sowie an diversen anderen Stellen wie bspw. in Notification-Mails. Achten Sie auf die richtige Schreibweise, da dieser Name im Nachhinein nur mit gewissem Aufwand und gewissen Risiken geändert werden kann.

Außerdem vergeben Sie hier Username, Passwort und E-Mail-Adresse des ersten administrativen Benutzers, der vom Wiki während des Setups angelegt werden soll.

BlueSpice 3 Installation Step 7 In diesem Schritt geben Sie die Mailadresse an, die bei Notification-Mails als Absenderadresse verwendet werden soll.
BlueSpice 3 Installation Step 8 Diesen Schritt können Sie direkt mit "Weiter" überspringen.
BlueSpice 3 Installation Step 9 Nach der erfolgreichen Installation von BlueSpice erhalten Sie diese Bestätigungsseite, die Sie mit "Weiter" bestätigen.
BlueSpice 3 Installation Step 10 Im letzten Schritt der Installation werden Sie zum Download der Konfigurationsdatei "LocalSettings.php" Ihrer Installation aufgefordert. Laden Sie diese herunter und legen Sie diese im Hauptverzeichnis Ihrer BlueSpice-Codebase ab.
Öffnen Sie den Ordner ..\extensions\BluesSpiceFoundation und bennen Sie die Unterordner config.template bzw. data.template um in config bzw. data. Diese Ordner sollten Schreib- und Lesezugriff haben, siehe Dateisystemrechte.
BlueSpice 3 Installation Step 11 Wenn Sie nun auf die von Ihnen festgelegte URL von BlueSpice zugreifen erhalten Sie die vollendete Installation und können nun direkt mit der Benutzung von BlueSpice starten.



Feedback zur Dokumentation ist im Community-Forum möglich.

Diskussionen