Vorlagen Download/Bildkarten und Setup:Installationsanleitung/Installation von BlueSpice: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
VisuellWikitext
Keine Bearbeitungszusammenfassung
 
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
<div class="downloadarea">
== Download des Installationspakets ==
<span class="getButton">[[Medium:HW-Bildkarten.zip|Download]]</span>
{{DISPLAYTITLE:Installation BlueSpice 4}}
{{Hinweisbox|boxtype=Neutral|icon=yes|Note text=Das Installationspaket finden Sie als [https://bluespice.com/de/download Download ] auf bluespice.com.


[[File:Image cards large.png|450x450px|verweis=Special:FilePath/Image_cards_large.png]]
</div>Diese Vorlage erstellt eine Reihe von Bildern, die für die Verlinkung von Wiki-Seiten vorgesehen sind.


== <span class="mw-headline">Import der Vorlage</span> ==
Legen Sie das Installationspaket in einem Webroot Ihrer Wahl ab (siehe auch [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|folder structure recommendations]] für Windows-Installationen), wo Sie es über Ihren Browser erreichen können.
Die benötigte Import-Datei befindet sich im Archiv HW-Bildkarten.zip. Sie enthält die Datei HW-Bildkarten.xml.


<span><span /><span /><span /><span /><span /><span /><br /></span>
Führen Sie auf der Seite ''Spezial:Import'' in Ihrem Wiki folgende Schritte durch:


# '''Entpacken''' Sie die zip-Datei.
Stellen Sie sicher, dass die [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|Dateisystemrechte]] richtig eingestellt sind.|bgcolor=}}
# '''Klicken''' Sie Browse... und wählen Sie die Datei ''HW-Bildkarten.xml.''
==Einleitung==
# '''Geben''' Sie ein Interwiki-Präfix '''an'''. Da dieses Feld erforderlich ist, geben Sie hier einfach ''hw'' (für hallowelt) ein.
Mit BlueSpice 4 bieten wir eine Installation als Gesamtpaket mit MediaWiki 1.35 und BlueSpice an.
# '''Belassen''' Sie die Vorauswahl ''Zu den Standard-Speicherorten importieren''.
# '''Klicken''' Sie ''Datei hochladen...'' .


<span style="color: rgb(37, 37, 37)">Die Vorlage ist nun in Ihrem Wiki verfügbar <span style="color: rgb(37, 37, 37)">.</span></span>
{{Hinweisbox|boxtype=Wichtig|icon=|Note text=Bei einer Neuinstallation von BlueSpice 4 kann es nötig sein, im Anschluss update.php auszuführen, falls Sie eine Fehlermeldung bekommen.|bgcolor=}}Diese Anleitung berücksichtigt nur die Installation der Webanwendung. Zur Installation erweiterter Funktionen wie [[Setup:Installationsanleitung/Kompendium/VisualEditor Konfiguration|VisualEditor]] und [[Setup:Installationsanleitung/Kompendium/ExtendedSearch Konfiguration|ExtendedSearch]] beachten Sie bitte die entsprechende Dokumentation hierzu.


== <span class="mw-headline">Enthaltene Importdateien</span> ==
Wir gehen hier nicht auf Details zu Ihrer Betriebssysteminstallation ein, sondern gehen davon aus, dass Sie die [[Setup:Installationsanleitung#Systemanforderungen .C3.BCberpr.C3.BCfen|Systemanforderungen]]  überprüft sowie die  [[Setup:Installationsanleitung|Systemvorbereitung]] durchgeführt haben.
The xml import erstellt folgende Seiten:


*Vorlage:Bildkarten
Weiterführende Hilfe zum Betriebssystem-Setup finden Sie in unserem [[Setup:Installationsanleitung/Kompendium|Kompendium]].
*Vorlage:Bildkarten/start
==Die Installation in Einzelschritten==
*Vorlage:Bildkarten/end
{{Hinweisbox|boxtype=Hinweis|Note text=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.}}
*Vorlage:Bildkarten/styles.css


==Bildkarten darstellen==
Rufen Sie zunächst mit Ihrem Browser die URL auf, unter der die Webanwendung erreichbar ist. Führen Sie anschließend folgende Schritte durch:
 
{| class="wikitable" style=""
===Allgemeines===
|-
 
|[[Datei:Setup:mediawiki-setup-page.png|alternativtext=MediaWiki 1.35 setup screen php error|300x300px]]
*'''Start- und Endvorlagen:''' Jedes Kartenset benötigt die ''Startvorlage'' (Bildkarten/start) und die ''Endvorlage'' (Bildkarten/end). Stellen Sie sicher, dass Sie die Endvorlage direkt nach der letzten Bildkarte ohne Zeilenumbruch hinzufügen. Wenn Sie einen Zeilenumbruch haben, sehen Sie nach der letzten Karte ein unnötiges Leerzeichen.
||'''Schritt 1: Installationssetup starten'''
*'''Kartengrößen:''' Sie können zwischen mittleren (Standard), kleinen und großen Bildkarten wählen. Standardmäßig wird die mittlere Größe  angezeigt.
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.<span /><span /><br /><span /><span /><br />Andernfalls befinden Sie sich nun auf der im Screenshot gezeigten Seite. Klicken Sie auf "set up the wiki", um die Installation zu beginnen.
*'''Bilder oder Icons:''' Sie können wählen, ob Sie Bildkarten oder Icon-lkarten erstellen möchten. Icon-karten sind nur in den Größen ''klein'' und ''mittel'' darstellbar. Wenn Sie Bilder verwenden möchten, müssen Sie diese zuerst in Ihr Wiki hochladen.
 
<span><span /><span /><span /><span /><span /><span /><span /><br /></span>
[[Vorlagen Download/Bildkarten#Einstellungen|siehe unten: Liste aller Einstellungen]]
 
===Bildkarten===
Wählen Sie ein Startlayout aus den Beispielen auf dieser Seite. Kopieren Sie einfach den Beispielcode und fügen Sie ihn im Quellbearbeitungsmodus auf einer Wikiseite ein.
 
{{Hinweisbox|boxtype=important|icon=|Note text=Kopierte Inhalte immer über  '''<code>Strg+Umschalt+v</code>''' in den Quelltexteinfügen. Ansonsten können zusätzliche Formattierungs-Anweisungen erzeugt werden, die das Funktionieren der Vorlage verhindern.|bgcolor=}}
 
====Bildkarten einfügen====
Standardmäßig werden die Bildkarten in mittlerer Größe angezeigt.[[File:Image cards standard.png|center|thumb|950x950px|Standard-sized cards|verweis=Special:FilePath/Image_cards_standard.png]]
 
<span><span /><span /><span /><span /><span /><span /><span /><span /><span /><span /><br /></span>
 
'''Code zum Kopieren:'''
 
(Setzen Sie anschließend die gewünschten Dateinamen für i''magname='' aus Ihrem Wiki ein)<syntaxhighlight lang="text">
{{Bildkarten/start|cardsize=}}
{{Bildkarten|imgname=yourimage1.jpg|label=London|imglink=https://google.de|alt=office in London headquarters}}
{{Bildkarten|imgname=yourimage2.jpg|label=Helsinki|imglink=http://google.de|alt=}}
{{Bildkarten|imgname=yourimage3.jpg|label=Madrid|imglink=Main Page|alt=}}
{{Bildkarten|imgname=yourimage4.jpg|label=Hamburg|imglink=Main Page|alt=}}
{{Bildkarten|imgname=yourimage5.jpg|label=Regensburg|imglink=|alt=}}{{Bildkarten/end}}
</syntaxhighlight>
 
====Große Bildkarten====
[[File:Image cards large.png|center|thumb|850x850px|Large Bildkarten|verweis=Special:FilePath/Image_cards_large.png]]
 
<span><span /><span /><span /><span /><br /></span>
Code zum Kopieren:
 
(Setzen Sie anschließend die gewünschten Dateinamen für i''magname='' aus Ihrem Wiki ein)
<syntaxhighlight lang="text">
{{Bildkarten/start|cardsize=large|flexwrap=wrap}}
{{Bildkarten|imgname=yourimage1.jpg|label=Sales & Marketing|imglink=Main Page}}
{{Bildkarten|imgname=yourimage2.jpg|label=IT Admin|imglink=Main Page}}
{{Bildkarten|imgname=yourimage3.jpg|label=Development|imglink=Main Page}}
{{Bildkarten|imgname=yourimage4.jpg|label=Tech Support|imglink=Main Page}}
{{Bildkarten|imgname=yourimage5.jpg|label=Accounting|imglink=Main Page}}
{{Bildkarten|imgname=yourimage6.jpg|label=Management|imglink=Main Page}}{{Bildkarten/end}}
</syntaxhighlight>
[[File:Image cards bootstrap icons.png|thumb|Bootstrap icon name|verweis=Special:FilePath/Image_cards_bootstrap_icons.png]]
 
===Icon-Karten===
Für Icon-karten können Sie die meisten aktuellen Bootstrap-Symbole verwenden. Wählen Sie auf [https://icons.getbootstrap.com/ der Bootstrap-Icons-Website] ein Icon aus, indem Sie darauf klicken. Kopieren Sie den Namen des Icons in Ihre Vorlage.<span /><span /><br />
*<span>Icon-Karten unterstützen die Kartengrößen ''medium''(Standard) und ''small,'' aber nicht die Größe ''large''.</span>
 
<span><span /><span /><span /><span /><span /><span /><span /><span /><br /></span>
 
[[File:Image cards icons.png|center|thumb|950x950px|Icon cards|verweis=Special:FilePath/Image_cards_icons.png]]
 
<span><span /><span /><span /><span /><span /><span /><span /><span /><br /></span>
Code zum Kopieren:
 
(Setzen Sie anschließend die gewünschten Dateinamen für i''magname='' aus Ihrem Wiki ein)<syntaxhighlight lang="text">
{{Bildkarten/start|cardsize=}}
{{Bildkarten|iconname=bi bi-gear|iconcolor=Tomato|label=Processes|imglink=Main Page|alt=}}
{{Bildkarten|iconname=bi bi-lightbulb|label=How-to's|imglink=Main Page|alt=}}
{{Bildkarten|iconname=bi bi-eyeglasses|label=Knowledge base|imglink=https://google.de|alt=}}
{{Bildkarten|iconname=bi bi-signpost|label=Directories|imglink=Main Page|alt=}}
{{Bildkarten|iconname=bi bi-geo-alt|label=Locations|imglink=|alt=}}{{Bildkarten/end}}
</syntaxhighlight>
==Einstellungen==
 
===Vorlage:Bildkarten/start===
{| class="wikitable" style="width:100%;"
! style="background-color:rgb(234, 236, 240);text-align:center;width:200px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |Parameter
! style="background-color:rgb(234, 236, 240);text-align:center;width:180px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |Value
! style="background-color:rgb(234, 236, 240);text-align:center;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |Description
|- style="box-sizing: inherit;"
| style="width:200px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |cardsize
| style="width:180px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |
*medium (can stay empty, it is the default)
*small
*large
| style="box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |Setzt die Größe der einzelnen Karten.
|-
|-
| rowspan="2" |justifycontent
|[[Datei:Setup:bs4-install-02.png|alternativtext=Sprachauswahl|links|300x300px]]
|
||'''Schritt 2: Sprachauswahl'''
*space-between (default)
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.<span /><span /><br /><span /><span /><br />Bei der Wahl von "de" beachten Sie bitte die Unterscheidung zwischen de (Du-Form) und de-formal (Sie-Form).
| Verteilt die Karten gleichmäßig auf dem verfügbaren Platz in einer Zeile.
|-
|-
|  
|[[Datei:Setup:bs4-install-03.png|alternativtext=Installationscheck|300x300px]]
*flex-start
||'''Schritt 3: MediaWiki Installationscheck'''
| Wenn es einen Umbruch zu einer anderen Zeile gibt (z.B. über die Einstellung flexwrap=wrap), werden die Karten linksbündig ausgerichtet.
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.
|-
|-
| flexwrap
|[[Datei:Setup:bs4-install-04.png|alternativtext=Verbindung zur Datenbank|300x300px]]
|
||'''Schritt 4: Datenbankverbindung'''
* nowrap (default)
Anschließend wird die Verbindung zur Datenbank konfiguriert.<span /><span /><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 [[mediawikiwiki:Manual:Installing_MediaWiki#MariaDB/MySQL|offiziellen Mediawiki-Dokumentation]].
|Karten werden kleiner, wenn neue Bilder hinzugefügt werden. Es erfolgt kein Zeilenumbruch.
|-
|-
|flexwrap
|[[Datei:Setup:bs4-install-05.png|alternativtext=Datenbankeinstellungen|300x300px]]
|
||'''Schritt 5: Datenbankbenutzer definieren'''
*wrap
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".
|Die Karten behalten ihre Originalgröße. Bilder, die nicht in die erste Reihe passen, werden in die nächste Reihe verschoben.
Diese Einstellung sollte vor allem mit ''cardsize=large'' verwendet werden.
|}
 
===Vorlage:Bildkarten===
{| class="wikitable" style="width:100%;"
! style="background-color:rgb(234, 236, 240);text-align:center;width:200px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |
! style="background-color:rgb(234, 236, 240);text-align:center;width:180px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |Value
! style="background-color:rgb(234, 236, 240);text-align:center;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |Description
|-
|-
| style="width:200px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |imgname
|[[Datei:Setup:bs4-install-06.png|alternativtext=Wikiname und Adminkonto|300x300px]]
| style="width:180px;box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" | e.g.:
||'''Schritt 6: Wikiname und Adminkonto anlegen'''
 
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.<span /><span /><br />
meinbild.jpg, meinbild.png
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.
| style="box-sizing:inherit;padding:0.2em 0.4em;border:1px solid rgb(162, 169, 177);" |Name des Bildes ohne Namensraum-Präfix.
Es darf kein Wert angegeben sein, wenn Icons anstelle von Bildern verwendet werden.
|-
|-
| label
|[[Datei:Setup:bs4-install-07.png|alternativtext=Email-Einstellungen|300x300px]]
|e.g.:  
||'''Schritt 7: Email Optionen'''
London
In diesem Schritt geben Sie die Mailadresse an, die bei Notification-Mails als Absenderadresse verwendet werden soll.
|Beschriftung, die unter dem Bild/Symbol angezeigt wird.
|-
|-
|imglink
|[[Datei:Setup:bs4-install-08.png|alternativtext=Installationshinweis|300x300px]]
|e.g.:
||'''Schritt 8: Installation'''
Hauptseite
Diesen Schritt können Sie direkt mit "Weiter" überspringen.
 
Hilfe:Hauptseite
 
https://google.de
|Link zu einer Wiki-Seite oder einer Website.
Der Link ist optional.
|-
|-
|alt
|[[Datei:Setup:bs4-install-09.png|alternativtext=Bestätigungsseite|300x300px]]
|e.g.:
||'''Schritt 9: Installationsbestätigung'''
Büro am Standort London
Nach der erfolgreichen Installation von BlueSpice erhalten Sie diese Bestätigungsseite, die Sie mit "Weiter" bestätigen.
| Bereitgestellt zur Unterstützung von Benutzern mit Bildschirmlesegeräten.
Bei Verwendung von Icons ist diese Angabe nicht notwendig, da Icons nur als Hintergrundbilder geladen werden.
|-
|-
|iconname
|[[Datei:Setup:bs4-install-10.png|alternativtext=Localsettings-Datei|300x300px]]
| e.g.:
||'''Schritt 10: Localsettings.php bereitstellen'''
bi bi-lightbulb
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.
|Wird anstelle von ''imgname'' verwendet, wenn Icons als Bild verwendet werden.
|-
|-
|iconcolor
|
|e.g.:
|'''Schritt 11: Konfiguration'''
Tomato,
Öffnen Sie den Ordner <code><installpath-bluespice>\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]].


<nowiki>#</nowiki>607d8b
<span><br /></span>
|HTML-Farbwert. Es sind  [https://www.w3schools.com/colors/colors_names.asp gültige Farbbezeichnungen] oder (meistens) [https://www.w3schools.com/colors/colors_schemes.asp HEX-]Werte möglich.
Führen Sie  <code><php installpath-bluespice>\maintenance\update.php</code> von der Konsole aus.
|-
|[[Datei:Setup:bs4-install-11.png|mini]]
||'''Schritt 12: Wiki aufrufen'''
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.
|}
|}
{{Hinweisbox|boxtype=Hinweis|Note text=Wenn das Wiki nicht geladen wird, geben Sie der Gruppe "users" change-permissions für den Ordner C:\Windows\Temp.}}
==BlueSpice WikiFarm==
Wenn Sie  WikiFarm installieren, folgen Sie diesen  [[:de:Setup:Installationsanleitung/Installation_BlueSpice_WikiFarm|Anweisungen]]. Ansonsten springen Sie zum [[Setup:Installationsanleitung/Installation von BlueSpice#Nächster Schritt|nächsten Schritt]].
Öffnen Sie eine Befehlszeile und ändern Sie den Ordner <code><installpath-bluespice></code>. Führen Sie folgenden Befehl aus:
*<code>php maintenance/update.php</code> ''(Linux)''
*<code>php maintenance\update.php</code> ''(Windows)''
<span><br /></span>
==Nächster Schritt==
{{Hinweisbox|boxtype=Hinweis|Note text=Wenn die Seite nicht lädt, geben Sie der Gruppe "users" Änderungs-Rechte für den Ordner C:\Windows\Temp.}}
Aus Sicherheitsgründen wird empfohlen, im Anschluss an die Installation den Zugriff auf den Pfad <code>mw-config/</code> zu unterbinden. Dies kann folgendermaßen umgesetzt werden:
=Linux=
Fügen Sie in Apache der Datei <code>000-bluespice.conf</code> folgenden Eintrag hinzu:
<pre>
    <Directory /var/www/bluespice/w/mw-config>
        Require all denied
    </Directory>
</pre>
=Windows=
Legen Sie in IIS eine Datei <code>web.config</code> im Unterverzeichnis <code>mw-config/</code> mit diesem Inhalt an:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <security>
            <authentication>
                <anonymousAuthentication enabled="false" />
            </authentication>
        </security>
    </system.webServer>
</configuration>
</pre>
<headertabs /><notabtoc/>
Bitte beachten Sie, dass dieser Eintrag unter Umständen zeitweise wieder entfernt werden muss, wenn der Web-Installer für ein Update der Applikation genutzt wird.
{{Hinweisbox|boxtype=Wichtig|Note text=Als nächsten Schritt können Sie den  [[Setup:Installationsanleitung/Kompendium/VisualEditor_Konfiguration|VisualEditor]] und die [[Setup:Installationsanleitung/Kompendium/ExtendedSearch_Konfiguration|Extendedsearch]] konfigurieren.}}
[[de:{{FULLPAGENAME}}]]
[[en:Setup:Installation_Guide/With_Installer]]

Version vom 19. Januar 2023, 15:41 Uhr

Download des Installationspakets

Das Installationspaket finden Sie als Download auf bluespice.com.


Legen Sie das Installationspaket in einem Webroot Ihrer Wahl ab (siehe auch folder structure recommendations für Windows-Installationen), wo Sie es über Ihren Browser erreichen können.


Stellen Sie sicher, dass die Dateisystemrechte richtig eingestellt sind.

Einleitung

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

Wichtig!Bei einer Neuinstallation von BlueSpice 4 kann es nötig sein, im Anschluss update.php auszuführen, falls Sie eine Fehlermeldung bekommen.

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 die Systemanforderungen überprüft sowie die Systemvorbereitung durchgeführt haben.

Weiterführende Hilfe zum Betriebssystem-Setup finden Sie in unserem Kompendium.

Die Installation in Einzelschritten

Hinweis: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:

MediaWiki 1.35 setup screen php error Schritt 1: Installationssetup starten

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.

Sprachauswahl
 Schritt 2: Sprachauswahl

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).

Installationscheck Schritt 3: MediaWiki Installationscheck

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.

Verbindung zur Datenbank Schritt 4: Datenbankverbindung

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.

Datenbankeinstellungen Schritt 5: Datenbankbenutzer definieren

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".

Wikiname und Adminkonto Schritt 6: Wikiname und Adminkonto anlegen

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.

Email-Einstellungen Schritt 7: Email Optionen

In diesem Schritt geben Sie die Mailadresse an, die bei Notification-Mails als Absenderadresse verwendet werden soll.

Installationshinweis Schritt 8: Installation

Diesen Schritt können Sie direkt mit "Weiter" überspringen.

Bestätigungsseite Schritt 9: Installationsbestätigung

Nach der erfolgreichen Installation von BlueSpice erhalten Sie diese Bestätigungsseite, die Sie mit "Weiter" bestätigen.

Localsettings-Datei Schritt 10: Localsettings.php bereitstellen

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.

Schritt 11: Konfiguration

Öffnen Sie den Ordner <installpath-bluespice>\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.


Führen Sie <php installpath-bluespice>\maintenance\update.php von der Konsole aus.

Setup:bs4-install-11.png
Schritt 12: Wiki aufrufen

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.

Hinweis:Wenn das Wiki nicht geladen wird, geben Sie der Gruppe "users" change-permissions für den Ordner C:\Windows\Temp.

BlueSpice WikiFarm

Wenn Sie WikiFarm installieren, folgen Sie diesen Anweisungen. Ansonsten springen Sie zum nächsten Schritt.

Öffnen Sie eine Befehlszeile und ändern Sie den Ordner <installpath-bluespice>. Führen Sie folgenden Befehl aus:

  • php maintenance/update.php (Linux)
  • php maintenance\update.php (Windows)

Nächster Schritt

Hinweis:Wenn die Seite nicht lädt, geben Sie der Gruppe "users" Änderungs-Rechte für den Ordner C:\Windows\Temp.


Aus Sicherheitsgründen wird empfohlen, im Anschluss an die Installation den Zugriff auf den Pfad mw-config/ zu unterbinden. Dies kann folgendermaßen umgesetzt werden:

Fügen Sie in Apache der Datei 000-bluespice.conf folgenden Eintrag hinzu: 

    <Directory /var/www/bluespice/w/mw-config>
        Require all denied
    </Directory>


Legen Sie in IIS eine Datei web.config im Unterverzeichnis mw-config/ mit diesem Inhalt an: 

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <security>
            <authentication>
                <anonymousAuthentication enabled="false" />
            </authentication>
        </security>
    </system.webServer>
</configuration>

Bitte beachten Sie, dass dieser Eintrag unter Umständen zeitweise wieder entfernt werden muss, wenn der Web-Installer für ein Update der Applikation genutzt wird.


Wichtig!Als nächsten Schritt können Sie den VisualEditor und die Extendedsearch konfigurieren.


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

Abgerufen von „https://de.wiki.bluespice.com/w/index.php?title=Vorlagen_Download/Bildkarten&oldid=6728“
Keine Kategorien vergebenBearbeiten

Diskussionen