BlueSpice Helpdesk - Benutzerbeiträge [de]

Setup:Installationsanleitung/Upgrade

2023-02-13T06:20:13Z

Mrosengarth:

{{DISPLAYTITLE:Upgrade von BlueSpice 3 auf BlueSpice 4}}

==Systemanforderungen==
===Browser===
{{#dpl:title=Setup:Systemanforderungen|include=#Browser}}
===Serverumgebung===
{{#dpl:title=Setup:Systemanforderungen|include=#Serverumgebung}}
{{Hinweisbox|boxtype=Hinweis|icon=|Note text=Möglicherweise müssen Sie externe Repos hinzufügen, um die richtige PHP auf Ihrem Server zu erhalten! Bitte überprüfen Sie ihren Paketmanager auf die verfügbaren PHP-Versionen auf Ihrem System.|bgcolor=}}
==Backup erstellen==
Erstellen Sie zuerst einen temporären Migrationsordner und kopieren Sie alle nötigen Daten:<syntaxhighlight lang="bash">
mkdir /tmp/migration
cd /tmp/migration
wikifolder=/path/to/wikifolder
cp -r $wikifolder/images .
cp -r $wikifolder/extensions/BlueSpiceFoundation/config .
cp -r $wikifolder/LocalSettings.* .
#check for for locals in settings.d
find $wikifolder/settings.d/ -iname '*.local.php' -exec cp --parent {} /tmp/migration \;

</syntaxhighlight>Suchen Sie zusätzlich nach spezialisierten php Dateien in <code>settings.d</code> (normalerweise <code>090-</code> oder <code>099-</code> ).
==Upgrade Schritt 1==
Dieser Schritt muss vor dem Upgrade Schritt 2 durchgeführt werden.{{Hinweisbox|boxtype=warning|icon=|Note text=BlueSpice 4.x kann Wikiseiten und Dateien, die von '''gelöschten Benutzern''' erstellt wurden, nicht verarbeiten. Um Datenverlust zu vermeiden, führen Sie alle Upgrade-Schritte durch!|bgcolor=}}
===Erstellen eines "Ersatzbenutzers" for gelöschte Benutzer===
Erstellen Sie in BlueSpice 3.x einen Ersatzbenutzer mit irgendeinem Passwort:
php maintenance/createAndPromote.php --force DeletedUser someR4ndomPass
{{Hinweisbox|boxtype=note|icon=|Note text=Eventuell müssen Sie Authentifizierungs-Plugins wie LDAP-Stack, SAML oder OpenIDConnect-Erweiterungen vorübergehend deaktivieren.|bgcolor=}}

 
Rufen Sie die <code>user_id</code> des Ersatzbenutzers ab, indem Sie folgenden Befehl in der Datenbank ausführen:
SELECT user_id FROM user WHERE user_name = "DeletedUser";
==Sql Dump==
Erstellen Sie Ihr Daten-Backup:<syntaxhighlight lang="bash">
mysqldump -u root -p bluespice > migrationdump.sql
</syntaxhighlight>
==Optionale Migrationsdateien==
Wenn eine der folgenden Funktionen auf Ihre Installation zutrifft, prüfen Sie, ob Migrationsschritte erforderlich sind. Fügen Sie in diesem Fall alles zu Ihrer ''tar''-Datei hinzu und senden Sie diese an den neuen Server.

Beispiele für Dateien, die Sie möglicherweise berücksichtigen müssen:

* ssl-certs
* apache.conf
* ldapprovider.json
* kerberos files (krb5.conf/keyfile)

==Migration in das neue Wiki==
''Grep'' <code>LocalSettings.php</code> für <code>wgDB</code> :<syntaxhighlight lang="bash">
grep wgDB LocalSettings.*
LocalSettings.local.php:$wgDBserver = "Your-IP";
LocalSettings.local.php:$wgDBname = "Your-datbase-name";
LocalSettings.local.php:$wgDBuser = "Your-database-user";
LocalSettings.local.php:$wgDBpassword = "Your-password";
</syntaxhighlight>

 
erstellen Sie die '''Datenbank''' und '''DBuser''' mit '''DBpassword'''. Gewähren Sie '''DBuser''' in ''mysql'' alle Rechte auf der Datenbank.

Migrieren Sie die Daten:<syntaxhighlight lang="bash">
mysql -u root -p bluespice < migration.sql
cp -r images $wikifolder
cp -r extensions $wikifolder
cp -r LocalSettings.php $wikifolder
setWikiPerm $wikifolder

</syntaxhighlight>
====LocalSettings.php modifzieren====
Ersetzen Sie:<syntaxhighlight lang="php">
$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
</syntaxhighlight>mit:<syntaxhighlight lang="php">
$wgLogos = [ '1x' => "$wgResourceBasePath/resources/assets/wiki.png" ];

</syntaxhighlight>
*Überprüfen Sie weitere <code>LocalSettings.*</code> Dateien auf Anpassungen aus der alten BlueSpice Installation.
*Vergleichen Sie die migrierte <code>settings.d/*.local.php</code> mit der neuen <code>settings.d/*.php</code> und überprüfen Sie diese auf individuelle (wahrscheinlich veraltete) Konfigurationen. Verfahren Sie ebenso mit <code>09*-Customer.php</code>.
*Kopieren Sie nötige Einstellungen zu <code>$wikifolder/settings.d/</code> .
==Upgrade Schritt 2==
Weisen Sie alle Seiten und Dateien ohne gültigen Bearbeitungs-Benutzer Ihrem neu erstellten Ersatzbenutzer zu:<syntaxhighlight lang="bash">
cd $wikifolder
php extensions/BlueSpiceFoundation/maintenance/PrepareActorMigration.php --unknownUserId=<user-id-from-step I. > --unknownUserName=DeletedUser
</syntaxhighlight>
==Optional==
*Kopieren Sie die folgenden Dateien (falls in Ihrem Fall zutreffend): <code>apache.conf</code>, <code>krb5.conf,</code> <code>Kerberos-key</code>, <code>ldapprovider.json</code>
*Fügen Sie dem VirtualHost in <code>Apache.conf</code> nach den rewrite Regeln folgendes hinzu:
AllowEncodedSlashes NoDecode
==Letzte Schritte==
Führen Sie folgende Maintenance-Skripte aus:<syntaxhighlight lang="bash">
cd $wikifolder
php maintenance/update.php --quick
php extensions/BlueSpiceExtendedSearch/maintenance/initBackends.php --quick
php extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php --quick

screen
while [ "$(php maintenance/showJobs.php)" != "0" ]; do php maintenance/runJobs.php --maxjobs 100; done

</syntaxhighlight>Der letzte Schritt wird etwas dauern.
==Bekannte mögliche Probleme nach dem Upgrade==
===Probleme mit VisualEditor===
<div>
Fügen Sie zu <code>includes/libs/http/MultiHttpClient.php</code> nach Zeile 327 folgende Angaben hinzu:
curl_setopt( $ch, CURLOPT_SSL_VERIFYHOST, 0 );
curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, 0 );
</div>

[[en:Setup:Installation_Guide/Upgrade]]
[[de:{{FULLPAGENAME}}]]

SocialEntity:367

2022-03-15T06:02:02Z

Mrosengarth:

{
"wikipageid": 966,
"namespace": 0,
"titletext": "Setup:Installationsanleitung/Systemvorbereitung/Linux/Vorwort",
"description": "",
"parentid": 0,
"id": 367,
"ownerid": 16,
"type": "wikipage",
"archived": false,
"tags": [
"Setup:Installationsanleitung/Systemvorbereitung/Linux/Vorwort"
],
"resolved": false
}

Setup:Installationsanleitung/Systemvorbereitung/Linux/Vorwort

2022-03-15T06:02:02Z

Mrosengarth:

{{DISPLAYTITLE:Vorwort}}

Dieses Kapitel behandelt die Systemvorbereitung einer kompletten Linux Server-Umgebung, um anschließend BlueSpice darauf zu betreiben.

Aufgrund der Vielfalt an Linux-Distributionen am Markt muss sich diese Dokumentation auf eine Distribution festlegen. Zum Einsatz kommt hier Debian in Version 11 (bullseye).

Des weiteren kommt Apache als Webserver zum Einsatz sowie Jetty als Applikationsserver. Auf Alternativen wird in den jeweiligen Artikeln kurz eingegangen.

Starten Sie zunächst mit der [[Setup:Installationsanleitung/Systemvorbereitung/Linux/Apache_und_PHP|Installation von Apache und PHP]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/Python

2022-03-11T11:45:28Z

Mrosengarth:

__TOC__

{{Hint|file=icon_optional.png|text=Python mit der Erweiterung Pygmentize wird für das Rendering der MediaWiki-Erweiterung [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight/de SyntaxHighlight] benötigt, die Bestandteil von BlueSpice ist. Sollten Sie die Funktionalität nicht benötigen, so ist die Installation von Python nicht relevant für die Installation und den Betrieb von BlueSpice.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

Downloaden Sie Python direkt beim [https://www.pyhton.org Hersteller].

[[File:Setup:systempreparation_python_01.png|border|center|600px|Python 01]]

{{Hint|file=hint.png|text=Im Folgenden wird Python in Version 3.10.2 verwendet und dient nur beispielhaft für die jeweils aktuellste Version, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.}}
==Installation==
Öffnen Sie die soeben heruntergeladene Datei.

Bestätigen Sie beide Checkboxen (1) und klicken anschließend auf "Customize installation" (2):

[[File:Setup:systempreparation_python_02.png|border|center|600px|Python 02]]

Bestätigen Sie den nächsten Schritt mit "Next".

[[File:Setup:systempreparation_python_03.png|border|center|600px|Python 03]]

Achten Sie bitte darauf, Python für alle Benutzer zu installieren (1), wählen Sie einen sinnvollen Pfad aus, möglichst ohne Leer- und Sonderzeichen (2) und starten Sie die Installation mit Klick auf "Install" (3).

[[File:Setup:systempreparation_python_04.png|border|center|600px|Python 04]]

{{Hint|file=hint.png|text=Diese Dokumentation geht von der von uns [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur unter Windows|empfohlenen Ordnerstruktur]] aus. Aus diesem Grund wird an dieser Stelle PHP in den Ordner C:\bluespice\bin\elasticsearch-6.8.23 entpackt. Haben Sie individuelle Wünsche, so passen Sie diese Pfade nach eigenem Verständnis an.}}

Nach erfolgter Installation deaktivieren Sie bitte die Limitierung der Pfadlänge auf 260 Zeichen.

[[File:Setup:systempreparation_python_05.png|border|center|600px|Python 05]]

Beenden Sie nun die Installation mit Klick auf "Close".

[[File:Setup:systempreparation_python_06.png|border|center|600px|Python 06]]

=Installation von Pygmentize=
Öffnen Sie die PowerShell (auf älteren Windows-Versionen die Eingabeaufforderung) mit Admin-Berechtigungen. Klicken Sie hierzu mit der rechten Maustaste auf "Start" (1) und wählen "Windows PowerShell(Administrator)" (2):

[[File:Setup:systempreparation_python_07.png|border|center|Python 07]]

Geben Sie den Befehl "pip install pygments" ein und warten Sie, bis der folgende Prozess abgeschlossen ist.

[[File:Setup:systempreparation_python_08.png|border|center|600px|Python 08]]

==Abschluss==
Ihr Windows-Server ist nun fertig vorbereitet für die eigentliche Installation von BlueSpice.

Setup:Installationsanleitung/Systemvorbereitung/Windows/Elasticsearch

2022-03-11T10:43:55Z

Mrosengarth:

__TOC__

{{Hint|file=icon_optional.png|text=Elasticsearch ist Voraussetzung für den Betrieb der Erweiterten Suche. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diese in Ihrer BlueSpice-Installation verwenden möchten.}}

{{Hint|file=hint.png|text=Für den Betrieb der Elasticsearch ist [[Setup:Installationsanleitung/Systemvorbereitung/Windows/OpenJDK|OpenJDK]] Voraussetzung. Sollten Sie dies noch nicht installiert haben, so folgen Sie dem eben genannten Link.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

BlueSpice ist derzeit mit Elasticsearch 6.x ab Version 6.8.21 kompatibel. Elasticsearch > 6.8.x wird derzeit nicht unterstützt.

Die jeweils aktuelle Version können Sie [https://github.com/elastic/elasticsearch/releases dieser Liste] entnehmen. Daraus ergibt sich folgender direkter Download-Link: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<Versionsnummer>.zip also bspw. <code>https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.8.23.zip</code>.

Folgen Sie dabei den Download-Anweisungen Ihres Browsers.

{{Hint|file=hint.png|text=Im Folgenden wird die Elasticsearch-Version 6.8.23 verwendet und dient nur beispielhaft für die jeweils aktuellste Version der Versionsreihe 6.x, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.}}
==Entpacken des ZIP-Archivs==
Entpacken Sie das soeben heruntergeladene ZIP-Archiv in einen sinnvollen Systempfad auf Ihrer Festplatte.

{{Hint|file=hint.png|text=Diese Dokumentation geht von der von uns [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur unter Windows|empfohlenen Ordnerstruktur]] aus. Aus diesem Grund wird an dieser Stelle PHP in den Ordner C:\bluespice\bin\elasticsearch-6.8.23 entpackt. Haben Sie individuelle Wünsche, so passen Sie diese Pfade nach eigenem Verständnis an.}}

==Installation des Plugins ingest-attachment==
Wechseln Sie in das Verzeichnis "C:\bluespice\bin\elasticsearch-6.8.23\bin" (1) und führen auf eine freie Fläche des Explorer-Fensters einen Rechtsklick mit gedrückter Shift-Taste aus. Klicken Sie dann auf "PowerShell-Fenster hier öffnen" (2) bzw auf älteren Windows-Versionen auf "Eingabeaufforderung hier öffnen":

[[File:Setup:systempreparation_elasticsearch_01.png|border|center|600px|Elasticsearch 01]]

Führen Sie dort den Befehl ".\elasticsearch-plugin.bat install -b ingest-attachment" aus:

[[File:Setup:systempreparation_elasticsearch_02.png|border|center|600px|Elasticsearch 02]]

{{Hint|file=hint.png|text=Sollte Ihr Server über keine aktive Internetverbindung verfügen, so [https://artifacts.elastic.co/downloads/elasticsearch-plugins/ingest-attachment/ingest-attachment-6.8.23.zip downloaden Sie das Plugin ingest-attachment als zip-Archiv]. Achten Sie dabei auf die korrekte Versionsnummer in diesem Downloadlink. Installieren Sie das Plugin anschließend wie [https://www.elastic.co/guide/en/elasticsearch/plugins/current/plugin-management-custom-url.html direkt beim Hersteller dokumentiert].}}
==Installation des Elasticsearch Dienstes==
Führen Sie anschließend den Befehl "elasticsearch-service.bat install" aus und warten Sie, bis der Prozess abgeschlossen ist:

[[File:Setup:systempreparation_elasticsearch_03.png|border|center|600px|Elasticsearch 03]]

==Elasticsearch Dienst konfigurieren und starten==
Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "services.msc" ein (1) und bestätigen mit "OK" (2):

[[File:Setup:systempreparation_elasticsearch_04.png|border|center|Elasticsearch 04]]

Suchen Sie den Service "Elasticsearch 6.8.23" und öffnen Sie diesen mit einem Doppelklick:

[[File:Setup:systempreparation_elasticsearch_05.png|border|center|600px|Elasticsearch 05]]

Wählen Sie als Starttyp "Automatisch" (1) und starten Sie den Dienst (2). Nachdem der Dienst gestartet ist, schließen Sie das Fenster mit "OK" (3):

[[File:Setup:systempreparation_elasticsearch_06.png|border|center|Elasticsearch 06]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/Python|Python]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB

2022-03-10T14:58:29Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=BlueSpice speichert Ihre Inhalte in einer Datenbank, für die Sie einen entsprechenden Server installieren müssen. Die hier aufgeführten Schritte sind zwingend erforderlich.}}

{{Hint|file=hint.png|text=Alternativ können Sie an dieser Stelle auch MySQL einsetzen, wir empfehlen aber den im folgenden Dokument beschriebenen Datenbankserver MariaDB.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

Öffnen Sie im Internet Explorer die [https://downloads.mariadb.org/mariadb offizielle Download-Seite]. Sofern nicht bereits alles korrekt ausgefüllt sein sollte, wählen Sie die aktuellste Version von MariaDB (1), das Betriebssystem Windows (2), die Architektur x86_64 (3) und das MSI-Paket (4). Anschließend klicken Sie auf "Download" (5) und folgen den weiteren Downloadanweisungen.

[[File:Setup:systempreparation_mariadb_01.png|border|600px|center|MariaDB 01]]

{{Hint|file=hint.png|text=Im Folgenden wird die MariaDB-Version 10.7.3 verwendet und dient nur beispielhaft für die aktuellste Version 10.7.x, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.}}
==Installation==
Öffnen Sie die soeben heruntergeladene MSI-Datei.

Starten Sie die Installation durch Klick auf "Next":

[[File:Setup:systempreparation_mariadb_02.png|border|center|MariaDB 02]]

Bestätigen Sie die Lizenzvereinbarung (1) und klicken Sie auf "Next" (2):

[[File:Setup:systempreparation_mariadb_03.png|border|center|MariaDB 03]]

Den nächsten Schritt bestätigen Sie durch Klick auf "Next":

[[File:Setup:systempreparation_mariadb_04.png|border|center|MariaDB 04]]

Vergeben Sie ein Kennwort für den administrativen User ("root") des Datenbankservers (1) und klicken Sie auf "Next" (2):

[[File:Setup:systempreparation_mariadb_06.png|border|center|MariaDB 06]]

Den nächsten Schritt bestätigen Sie durch Klick auf "Next":

[[File:Setup:systempreparation_mariadb_07.png|border|center|MariaDB 07]]

Starten Sie nun die Installation:

[[File:Setup:systempreparation_mariadb_08.png|border|center|MariaDB 08]]

Nach Abschluss der Installation beenden Sie den Installer:

[[File:Setup:systempreparation_mariadb_09.png|border|center|MariaDB 09]]

==Umgebungsvariable setzen==
Um MariaDB problemlos auf der Kommandozeile von Windows nutzen zu können, ist es nötig, eine Umgebungsvariable in Windows zu konfigurieren. Führen Sie hierzu folgende Schritte durch:

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "SystemPropertiesAdvanced.exe" ein (1) und bestätigen mit OK (2):

[[File:Setup:systempreparation_mariadb_10.png|border|center|MariaDB 10]]

Klicken Sie auf "Umgebungsvariablen":

[[File:Setup:systempreparation_mariadb_11.png|border|center|MariaDB 11]]

Im unteren Bereich des jetzt geöffneten Fensters führen Sie einen Doppelklick auf die Zeile "Path" aus:

[[File:Setup:systempreparation_mariadb_12.png|border|center|MariaDB 12]]

Klicken Sie auf "Neu":

[[File:Setup:systempreparation_mariadb_13.png|border|center|MariaDB 13]]

Fügen Sie den Pfad zu Ihrer Installation von MariaDB hinzu, in dem sich u.a. die Datei mysql.exe befindet. Standardmäßig ist dies der Pfad <code>C:\Program Files\MariaDB 10.7\bin</code>

[[File:Setup:systempreparation_mariadb_14.png|border|center|MariaDB 14]]

Schließen Sie alle soeben geöffneten Fenster nacheinander wieder mit Klick auf "OK".

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/SOpenJDK|OpenJDK]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP

2022-03-09T14:37:36Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Der Quelltext von BlueSpice basiert auf der Scriptsprache "PHP". Diese muss auf Ihrem Server installiert werden, um BlueSpice betreiben zu können. Die hier aufgeführten Schritte sind zwingend erforderlich.}}

{{Hint|file=hint.png|text=PHP wird nicht mit einem "klassischen Installationspaket" installiert, sondern die Sourcen werden heruntergeladen und über den [[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_Manager|im vorhergehenden Schritt installierten PHP Manager]] in IIS eingebunden.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

Öffnen Sie in Ihrem Browser die [https://windows.php.net/download/ offizielle Download-Seite für Windows auf php.net] (1). Suchen Sie hier die derzeit aktuellste Version 7.4.x (2) 64-bit Non Thread Safe (3) und laden diese herunter (4):

[[File:Setup:systempreparation_php_01.png|border|center|600px|PHP 01]]

Folgen Sie den weiteren Download-Anweisungen.

{{Hint|file=hint.png|text=Beachten Sie bitte, dass BlueSpice derzeit nicht mit PHP 8.x kompatibel ist.}}

{{Hint|file=hint.png|text=Im Folgenden wird die PHP-Version 7.4.28 verwendet und dient nur beispielhaft für die aktuellste Version 7.4.x, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.}}
==Entpacken des ZIP-Archivs==
Entpacken Sie das soeben heruntergeladene ZIP-Archiv in einen sinnvollen Systempfad auf Ihrer Festplatte.

{{Hint|file=hint.png|text=Diese Dokumentation geht von der von uns [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|empfohlenen Ordnerstruktur]] aus. Aus diesem Grund wird an dieser Stelle PHP in den Ordner C:\bluespice\bin\php-7.4.28 entpackt. Haben Sie individuelle Wünsche, so passen Sie diese Pfade nach eigenem Verständnis an.}}

==Umgebungsvariable setzen==
Um PHP problemlos auf der Kommandozeile von Windows nutzen zu können, ist es nötig, eine Umgebungsvariable in Windows zu konfigurieren. Führen Sie hierzu folgende Schritte durch:

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "SystemPropertiesAdvanced.exe" ein (1) und bestätigen mit OK (2):

[[File:Setup:systempreparation_php_02.png|border|center|PHP 02]]

Klicken Sie auf "Umgebungsvariablen":

[[File:Setup:systempreparation_php_03.png|border|center|PHP 03]]

Im unteren Bereich des jetzt geöffneten Fensters führen Sie einen Doppelklick auf die Zeile "Path" aus:

[[File:Setup:systempreparation_php_04.png|border|center|PHP 04]]

Klicken Sie auf "Neu":

[[File:Setup:systempreparation_php_05.png|border|center|PHP 05]]

Fügen Sie den Pfad zu Ihrer entpackten PHP-Version hinzu, in dem sich die Datei php.exe befindet.

[[File:Setup:systempreparation_php_06.png|border|center|PHP 06]]

Schließen Sie alle soeben geöffneten Fenster nacheinander wieder mit Klick auf "OK".

==Überprüfung der Umgebungsvariable==
Um sicherzustellen, dass die Umgebungsvariable richtig gesetzt wurde, führen Sie folgende Schritte durch:

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "cmd" ein (1) und bestätigen mit OK (2):

[[File:Setup:systempreparation_php_07.png|border|center|PHP 07]]

In der jetzt geöffneten Eingabeaufforderung geben Sie "php -v" (1) und drücken die Enter-Taste. Die gefundene PHP-Version wird Ihnen angezeigt (2).

[[File:Setup:systempreparation_php_08.png|border|600px|center|PHP 08]]

Ist dies nicht der Fall, so wurde der Pfad zur Datei php.exe in den Umgebungsvariablen falsch angegeben.

==Einbinden von PHP in IIS==
In den folgenden Schritten wird PHP in IIS eingebunden und IIS so konfiguriert, dass ein funktionierendes Basis-Setup entsteht.

Rufen Sie zunächst den IIS-Manager auf. Geben Sie hierzu die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "inetmgr" ein (1) und bestätigen mit OK (2):

[[File:Setup:systempreparation_php_09.png|border|center|PHP 09]]

Wählen Sie im linken Bereich Ihren Servernamen aus (1) und führen Sie anschließend einen Doppelklick auf "PHP Manager" (2) durch:

[[File:Setup:systempreparation_php_10.png|border|600px|center|PHP 10]]

Klicken Sie "Register new PHP version":

[[File:Setup:systempreparation_php_11.png|border|600px|center|PHP 11]]

Im folgenden Fenster wählen Sie den Durchsuchen-Button:

[[File:Setup:systempreparation_php_12.png|border|center|PHP 12]]

Wechseln Sie zum Pfad, in den Sie zuvor PHP entpackt haben (1), markieren dort die "php-cgi.exe" (2) und bestätigen den Dialog mit "Open" (3):

[[File:Setup:systempreparation_php_13.png|border|600px|center|PHP 13]]

Bestätigen Sie nochmals mit "OK":

[[File:Setup:systempreparation_php_14.png|border|center|PHP 14]]

Klicken Sie auf "Configure error reporting":

[[File:Setup:systempreparation_php_15.png|border|600px|center|PHP 15]]

Aktivieren Sie den Punkt "Production machine" (1) und wählen Sie einen Pfad und eine Datei Ihrer Wahl, wo PHP seine Log-Datei ablegen soll (2). Bestätigen Sie mit "Apply" (3):

[[File:Setup:systempreparation_php_16.png|border|600px|center|PHP 16]]

{{Hint|file=hint.png|text=Auch hier wird von der [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|empfohlenen Ordnerstruktur]] ausgegangen. Sollte der Pfad, den Sie hier angeben, noch nicht existieren, so legen Sie diesen bitte vor dem Klick auf "Apply" an. }}

Klicken Sie im Hauptfenster auf "Enable or disable an extension":

[[File:Setup:systempreparation_php_19.png|border|600px|center|PHP 19]]

Achten Sie darauf, dass folgende Erweiterungen aktiviert sind:

[[File:Setup:systempreparation_php_20.png|border|600px|center|PHP 20]]

Um eine Erweiterung zu aktivieren, suchen Sie diese im Bereich "Disabled" heraus (1) und aktivieren diese durch Klick auf "Enable" (2):

[[File:Setup:systempreparation_php_21.png|border|600px|center|PHP 21]]

Öffnen Sie die Konfigurationsdatei php.ini:

[[File:Setup:systempreparation_php_22.png|border|600px|center|PHP 22]]

Ersetzen Sie die Zeile extension=php_opcache.dll durch <code>zend_extension=php_opcache.dll</code>:

[[File:Setup:systempreparation_php_23.png|border|600px|center|PHP 23]]

Des Weiteren nehmen Sie in dieser Datei bitte folgende Änderungen an diesen Optionen vor:

{|
! style="background-color:#eaeaea;border:1px solid #000;padding:5px;" |Name
! style="background-color:#eaeaea;border:1px solid #000;padding:5px;" |Wert
! style="background-color:#eaeaea;border:1px solid #000;padding:5px;" |Kommentar
|-
| style="border:1px solid #000;padding:5px;" |date.timezone
| style="border:1px solid #000;padding:5px;" |"Europe/Berlin"
| style="border:1px solid #000;padding:5px;" |Bitte wählen Sie die für Sie zutreffende [https://www.php.net/manual/en/timezones.php Zeitzone] Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |max_execution_time
| style="border:1px solid #000;padding:5px;" |600
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |post_max_size
| style="border:1px solid #000;padding:5px;" |1024M
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |upload_max_filesize
| style="border:1px solid #000;padding:5px;" |1024M
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |opcache.enable
| style="border:1px solid #000;padding:5px;" |1
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.enable_cli
| style="border:1px solid #000;padding:5px;" |0
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.memory_consumption
| style="border:1px solid #000;padding:5px;" |512
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.max_accelerated_files
| style="border:1px solid #000;padding:5px;" |1000000
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.validate_timestamps
| style="border:1px solid #000;padding:5px;" |1
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.revalidate_freq
| style="border:1px solid #000;padding:5px;" |2
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.optimization_level
| style="border:1px solid #000;padding:5px;" |0x7FFF9FFF
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.blacklist_filename
| style="border:1px solid #000;padding:5px;" |C:\bluespice\etc\opcache.blacklist
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |zlib.output_compression
| style="border:1px solid #000;padding:5px;" |On
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |zlib.output_compression_level
| style="border:1px solid #000;padding:5px;" |9
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|}

Speichern und schließen Sie die Datei.

Im Anschluss erstellen Sie den Ordner <code>C:\bluespice\etc</code> und erstellen darin eine Textdatei mit dem Namen <code>opcache.blacklist</code> mit dem Inhalt <code>C:\bluespice\var\www\w\extensions\BlueSpiceFoundation\config\*</code>

Im nächsten Schritt erweitern Sie den Baum auf der linken Seite, bis die "Default Web Site" sichtbar wird:

[[File:Setup:systempreparation_php_24.png|border|600px|center|PHP 24]]

Führen Sie auf diese einen Rechtsklick aus (1) und klicken auf "Entfernen" (2):

[[File:Setup:systempreparation_php_25.png|border|600px|center|PHP 25]]

Den folgenden Dialog bestätigen Sie mit "Ja":

[[File:Setup:systempreparation_php_26.png|border|center|PHP 26]]

Führen Sie einen Rechtsklick auf "Sites" aus (1) und klicken auf "Website hinzufügen" (2):

[[File:Setup:systempreparation_php_27.png|border|600px|center|PHP 27]]

Vergeben Sie den Sitename "BlueSpice" (1) und wählen den Pfad auf Ihrem Server aus, in dem sich Ihre BlueSpice-Installation später befinden wird (2). Bestätigen Sie mit "OK" (3):

[[File:Setup:systempreparation_php_28.png|border|center|PHP 28]]

Die soeben angelegte Seite wird jetzt in der IIS-Übersicht gelistet:

[[File:Setup:systempreparation_php_29.png|border|600px|center|PHP 29]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB|MariaDB]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/OpenJDK

2022-01-25T14:22:08Z

Mrosengarth:

__TOC__

{{Hint|file=icon_optional.png|text=OpenJDK ist Voraussetzung für den Betrieb der Erweiterten Suche und des PDF-Exports. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie einen oder mehrere dieser Dienste in Ihrer BlueSpice-Installation verwenden möchten.}}

{{Hint|file=hint.png|text=In der folgenden Dokumentation arbeiten wir mit OpenJDK in Version 17.0.2, da diese zum Zeitpunkt der Erstellung aktuell war. Natürlich können Sie auch andere Versionen einsetzen, sofern diese den von uns veröffentlichen Systemvoraussetzungen entsprechen. Bitte beachten Sie, dass Sie dann die Angaben dieser Dokumentation entsprechend anpassen müssen.}}
==Download==
Öffnen Sie die [https://jdk.java.net/ offizielle Webseite auf java.net] (1) und klicken Sie auf "JDK 17" (2):

[[File:Setup:systempreparation_openjdk_01.png|border|center|600px|OpenJDK 01]]

Laden Sie das ZIP-Archiv für Windows herunter:

[[File:Setup:systempreparation_openjdk_02.png|border|center|600px|OpenJDK 02]]

==Entpacken des ZIP-Archivs==
{{Hint|file=hint.png|text=Wir legen dieser Dokumentation die [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|von uns empfohlene Ordnerstruktur]] zugrunde. Möchten Sie dies individuell anpassen, so müssen Sie die Pfade selber nach Ihrem eigenen Kenntnisstand anpassen.}}

Entpacken Sie das soeben heruntergeladene ZIP-Archiv nach ''C:\BlueSpice\bin'', dann sollte sich die Ordnerstruktur ''C:\BlueSpice\bin\jdk-17.0.2'' ergeben.

==Umgebungsvariable setzen==
Drücken Sie die Tastenkombination Windows + R

Im folgenden Dialog tragen Sie "SystemPropertiesAdvanced.exe" ein (1) und bestätigen mit OK (2):

[[File:Setup:systempreparation_openjdk_03.png|border|center|399px|OpenJDK 03]]

Klicken Sie auf "Umgebungsvariablen...":
[[File:Setup:systempreparation_openjdk_04.png|border|center|400px|OpenJDK 04]]

Klicken Sie auf "Neu...":
[[File:Setup:systempreparation_openjdk_05.png|border|center|400px|OpenJDK 05]]

Legen Sie als Name der Variablen "JAVA_HOME" (1) fest, als Wert der Variablen geben Sie das Verzeichnis Ihrer OpenJDK-Installation an, die Sie soeben nach C:\bluespice\bin kopiert haben (2). Hier können Sie sich die Arbeit durch Benutzung des "Verzeichnis durchsuchen" Buttons (3) erleichtern. Klicken Sie anschließend auf "OK" (4):

[[File:Setup:systempreparation_openjdk_06.png|border|center|400px|OpenJDK 06]]

Schließen Sie alle soeben geöffneten Fenster nacheinander wieder mit Klick auf "OK".

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/Apache_Tomcat|Apache Tomcat]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP

2022-01-25T14:19:43Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Der Quelltext von BlueSpice basiert auf der Scriptsprache "PHP". Dies muss auf Ihrem Server installiert werden, um BlueSpice betreiben zu können. Die hier aufgeführten Schritte sind zwingend erforderlich.}}
==Download==
==Entpacken des ZIP-Archivs==
==Umgebungsvariable setzen==
==Überprüfung der Umgebungsvariable==
==Einbinden von PHP in IIS==
==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB|MariaDB]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP Manager

2022-01-25T14:19:15Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=PHP Manager bindet auf komfortable Weise PHP in Ihre IIS-Installation ein. Die hier aufgeführten Schritte sind zwingend erforderlich.}}
==Download==
Öffnen Sie die [https://www.iis.net/downloads/community/2018/05/php-manager-150-for-iis-10 offizielle Webseite auf iis.net] (1) und klicken Sie auf "Download this extension" (2).

[[File:Setup:systempreparation_phpmanager_01.png|border|center|600px|PHP Manager 01]]

Den folgenden Dialog bestätigen Sie mit "OK":

[[File:Setup:systempreparation_phpmanager_02.png|border|center|600px|PHP Manager 02]]

Folgen Sie den weiteren Anweisungen Ihres Browsers zum Download.

==Installation==
Öffnen Sie die soeben heruntergeladene Installationsdatei.

Starten Sie die Installation durch Klick auf "Next >":

[[File:Setup:systempreparation_phpmanager_03.png|border|center|400px|PHP Manager 03]]

Bestätigen Sie die Lizenz (1) und klicken Sie auf "Next >" (2):

[[File:Setup:systempreparation_phpmanager_04.png|border|center|400px|PHP Manager 04]]

Die Installation wird jetzt durchgeführt. Das Setup-Programm können Sie nach Abschluss beenden:

[[File:Setup:systempreparation_phpmanager_05.png|border|center|400px|PHP Manager 05]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP|PHP]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/Microsoft Visual C++ Redistributable

2022-01-25T14:18:40Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Die Installation von Visual C++ Redistributable wird benötigt, um PHP in der Version 7.x unter Windows betreiben zu können. Die hier aufgeführten Schritte sind zwingend erforderlich.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

Microsoft stellt eigenen Aussagen zufolge unter einem gleichbleibenden [https://aka.ms/vs/17/release/vc_redist.x64.exe Downloadlink] das entsprechende Installationspaket zur Verfügung ([https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170 Dokumentation bei Microsoft]). Laden Sie dieses Setup-Paket herunter.

==Installation==
Öffnen Sie das Setup, bestätigen Sie die Lizenzbedingungen (1) und führen Sie die Installation durch (2):

[[File:Setup:systempreparation_ms_redist_01.png|border|center|400px|Visual C++ Redistributable 01]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_Manager|PHP Manager]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/Microsoft Visual C++ Redistributable

2022-01-25T14:18:19Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Die Installation von Visual C++ Redistributable wird benötigt, um PHP in der Version 7.x unter Windows betreiben zu können. Die hier aufgeführten Schritte sind zwingend erforderlich.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

Microsoft stellt eigenen Aussagen zufolge unter einem gleichbleibenden [https://aka.ms/vs/17/release/vc_redist.x64.exe Downloadlink] das entsprechende Installationspaket zur Verfügung ([https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170 Dokumentation bei Microsoft]). Laden Sie dieses Setup-Paket herunter.

==Installation==
Öffnen Sie das Setup, bestätigen Sie die Lizenzbedingungen (1) und führen Sie die Installation durch (2):

[[File:Setup:systempreparation_ms_redist_01.png|border|center|400px|Visual C++ Redistributable 01]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_Manager|PHP Manager]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/urlrewrite

2022-01-25T14:17:16Z

Mrosengarth:

__TOC__

{{Hint|file=icon_optional.png|text=Das Modul "urlrewrite" für IIS ist nur nötig, wenn Sie Weiterleitungsregeln in Ihrem Webserver konfigurieren wollen. Wenn Sie eine von uns empfohlene Installation durchführen wollen, auch gemäß den Empfehlungen der Wiki Media Foundation, so ist es zwingend erforderlich.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

Öffnen Sie die [https://www.iis.net/downloads/microsoft/url-rewrite offizielle Webseite auf iis.net] (1) und klicken Sie auf "additional downloads" (2):

[[File:Setup:systempreparation_urlrewrite_01.png|border|center|600px|urlrewrite 01]]

Downloaden Sie den Ihrer Ihrer Sprache gewünschten "x64 installer":

[[File:Setup:systempreparation_urlrewrite_02.png|border|center|600px|urlrewrite 02]]
==Installation==
Öffnen Sie das Setup, bestätigen Sie die Lizenzbedingungen (1) und führen Sie die Installation durch (2):

[[File:Setup:systempreparation_urlrewrite_03.png|border|center|400px|urlrewrite 03]]
==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/Microsoft_Visual_C++_Redistributable|Microsoft Visual C++ Redistributable]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/urlrewrite

2022-01-25T14:16:44Z

Mrosengarth:

__TOC__

{{Hint|file=icon_optional.png|text=Das Modul "urlrewrite" für IIS ist nur nötig, wenn Sie Weiterleitungsregeln in Ihrem Webserver konfigurieren wollen. Wenn Sie eine von uns empfohlene Installation durchführen wollen, auch gemäß den Empfehlungen der Wiki Media Foundation, so ist es zwingend erforderlich.}}
==Download==
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}

Öffnen Sie die [https://www.iis.net/downloads/microsoft/url-rewrite offizielle Webseite auf iis.net] (1) und klicken Sie auf "additional downloads" (2):

[[File:Setup:systempreparation_urlrewrite_01.png|border|center|600px|urlrewrite 01]]

Downloaden Sie den Ihrer Ihrer Sprache gewünschten "x64 installer":

[[File:Setup:systempreparation_urlrewrite_02.png|border|center|600px|urlrewrite 02]]
==Installation==
Öffnen Sie das Setup, bestätigen Sie die Lizenzbedingungen (1) und führen Sie die Installation durch (2):

[[File:Setup:systempreparation_urlrewrite_03.png|border|center|400px|urlrewrite 03]]
==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/Microsoft_Visual_C++_Redistributable|Microsoft Visual C++ Redistributable]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/IIS-Webserver

2022-01-25T14:15:32Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Der Webserver liefert Ihre BlueSpice-Installation an die Browser der Benutzer aus. Ohne einen Webserver ist BlueSpice nicht verwendbar. Die hier aufgeführten Schritte sind zwingend erforderlich.}}
==Einleitende Informationen==
Wir empfehlen, für einen Live-Betrieb von BlueSpice sowohl unter Linux als auch unter Windows möglichst auf den systemoptimierten Webserver zurückzugreifen. Aus diesem Grund wird auf die Dokumentation einer Installation von Apache ''("XAMP")'' unter Windows verzichtet.

Dieses Kapitel führt die Einzelschritte auf, die die Installation des Microsoft IIS-Webservers unter Windows Server >= 2016 beschreiben.

==Öffnen des Server-Manager und der Rollenverwaltung==
Öffnen Sie zunächst den Server-Manager. Sofern nicht anders konfiguriert, startet dieser automatisch, sobald Sie sich am Server anmelden. Außerdem finden Sie diesen im Startmenü unter dem Suchbegriff "Server-Manager".

Sie befinden sich jetzt in folgender Ansicht:

[[File:Setup:systempreparation_iis_01.png|border|center|400px|IIS Webserver 01]]

Klicken Sie auf "Verwalten" (1) und anschließend auf "Rollen und Features hinzufügen" (2):

[[File:Setup:systempreparation_iis_02.png|border|center|400px|IIS Webserver 02]]

==Installation von IIS im Rollenmanager==
Sie befinden sich jetzt im Rollenmanager.

Klicken Sie nun solange auf "Weiter >", bis Sie den Bereich "Serverrollen" (1) erreicht haben. Dort aktivieren Sie die Rolle "Web Server (IIS)" (2):

[[File:Setup:systempreparation_iis_03.png|border|center|400px|IIS Webserver 03]]

Das sich mit der Auswahl der Rolle öffnende Popup bestätigen Sie mit "Features hinzufügen":

[[File:Setup:systempreparation_iis_04.png|border|center|400px|IIS Webserver 04]]

Klicken Sie auf "Weiter >":

[[File:Setup:systempreparation_iis_05.png|border|center|400px|IIS Webserver 05]]

Sie befinden sich jetzt im Bereich "Features". Klicken Sie hier ebenfalls auf "Weiter >":

[[File:Setup:systempreparation_iis_06.png|border|center|400px|IIS Webserver 06]]

Auch den nächsten Dialog bestätigen Sie mit "Weiter >":

[[File:Setup:systempreparation_iis_07.png|border|center|400px|IIS Webserver 07]]

Sie befinden sich im Bereich Rollendienste. Hier aktivieren Sie unter "Sicherheit" (1) die Option "Windows-Authentifizierung" (2) sowie unter "Anwendungsentwicklung" (3) den Punkt "CGI" (4) und bestätigen Sie mit "Weiter >" (5):

[[File:Setup:systempreparation_iis_08.png|border|center|400px|IIS Webserver 08]]

Aktivieren Sie hier den Punkt "Zielserver bei Bedarf automatisch neu starten" (1) und klicken Sie auf "Installieren" (2):

[[File:Setup:systempreparation_iis_09.png|border|center|400px|IIS Webserver 09]]

Sobald die Installation abgeschlossen ist beenden Sie den Dialog mit "Schließen":

[[File:Setup:systempreparation_iis_10.png|border|center|400px|IIS Webserver 10]]

Nach erfolgreichem Abschluss aller genannten Schritte ist der IIS-Webserver jetzt installiert. Kontrollieren Sie die Funktionalität, indem Sie einen auf dem Server verfügbaren Browser starten und die URL http://localhost/ aufrufen. Bei korrekter Installation sehen Sie die Willkommens-Seite des IIS-Webservers:

[[File:Setup:systempreparation_iis_11.png|border|center|400px|IIS Webserver 11]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/urlrewrite|urlrewrite]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/.NET Framework 3.5

2022-01-25T14:13:45Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Das .NET Framework 3.5 wird von einigen der im folgenden zu installierenden Programme benötigt. Die hier aufgeführten Schritte sind zwingend erforderlich.}}

{{Hint|file=hint.png|text=Das Setup des .NET Framework schlägt unter Umständen fehl, wenn sich Ihr Server in einer Domäne befindet und auf einen WSUS-Server zugreift. Eine Lösung wäre, dass Sie den Server temporär aus der Domäne nehmen für diesen Teil des Setups oder [http://woshub.com/how-to-install-net-framework-3-5-on-windows-server-2016/ die Dokumentation aus dieser externen Quelle befolgen].}}
==Öffnen des Server-Manager und der Rollenverwaltung==
Öffnen Sie zunächst den Server-Manager. Sofern nicht anders konfiguriert, startet dieser automatisch, sobald Sie sich am Server anmelden. Außerdem finden Sie diesen im Startmenü unter dem Suchbegriff "Server-Manager".

Sie befinden sich jetzt in folgender Ansicht:

[[File:Setup:systempreparation_net_framework_01.png|border|center|400px|.NET Framework 3.5 01]]

Klicken Sie auf "Verwalten" (1) und anschließend auf "Rollen und Features hinzufügen" (2):

[[File:Setup:systempreparation_net_framework_02.png|border|center|400px|.NET Framework 3.5 02]]

==Installation des Frameworks im Rollenmanager==
Sie befinden sich jetzt im Rollenmanager.

Klicken Sie nun solange auf "Weiter >", bis Sie den Bereich "Features" (1) erreicht haben. Dort aktivieren Sie die Rolle ".NET Framework 3.5-Funktionen" (2). Anschließend gehen Sie einen Schritt weiter (3):

[[File:Setup:systempreparation_net_framework_03.png|border|center|400px|.NET Framework 3.5 03]]

Aktivieren Sie hier den Punkt "Zielserver bei Bedarf automatisch neu starten" (1) und klicken Sie auf "Installieren" (2):

[[File:Setup:systempreparation_net_framework_04.png|border|center|400px|.NET Framework 3.5 04]]

Sobald die Installation abgeschlossen ist beenden Sie den Dialog mit "Schließen":

[[File:Setup:systempreparation_net_framework_05.png|border|center|400px|.NET Framework 3.5 05]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/IIS-Webserver|IIS-Webserver]].

Setup:Installationsanleitung/Systemvorbereitung/Windows/Setzen der Systemrechte des temporären Windows-Ordners

2022-01-25T14:13:09Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Diverse nachfolgende Programme benötigen Rechte zum Beschreiben des Ordners C:\Windows\Temp. Diese sind standardmäßig nicht entsprechend gesetzt. Um reibungslos alle weiteren Schritte durchführen zu können und auch BlueSpice betreiben zu können müssen Sie diese Rechte nun zunächst setzen.}}
==Vorgehen==
Öffnen Sie den Datei-Explorer:

[[File:Setup:systempreparation_temp_permissions_01.png|border|center|600px|Windows file permissions 01]]

Führen Sie einen Rechtsklick auf den Ordner "Temp" (1) aus und öffnen Sie im Kontextmenü den Punkt "Eigenschaften" (2):

[[File:Setup:systempreparation_temp_permissions_02.png|border|center|600px|Windows file permissions 02]]

In der Registerkarte "Sicherheit" (1) öffnen die erweiterten Einstellungen (2):

[[File:Setup:systempreparation_temp_permissions_03.png|border|center|600px|Windows file permissions 03]]

Klicken Sie auf "Weiter":

[[File:Setup:systempreparation_temp_permissions_04.png|border|center|600px|Windows file permissions 04]]

Klicken Sie auf "Hinzufügen":

[[File:Setup:systempreparation_temp_permissions_05.png|border|center|600px|Windows file permissions 05]]

Wählen Sie "Prinzipal auswählen":

[[File:Setup:systempreparation_temp_permissions_06.png|border|center|600px|Windows file permissions 06]]

Stellen Sie sicher, dass im Feld "Suchpfad" (1) Ihre lokale Maschine ausgewählt ist. Wenn nicht öffnen Sie den Dialog "Pfade" (2):

[[File:Setup:systempreparation_temp_permissions_07.png|border|center|600px|Windows file permissions 07]]

Dort wählen Sie den obersten Pfad der Liste (1) und schließen den Dialog wieder (2):

[[File:Setup:systempreparation_temp_permissions_08.png|border|center|600px|Windows file permissions 08]]

Nun geben Sie in das Freitextfeld den Benuternamen "Jeder" ein (1). Bestätigen Sie mit "OK" (2).

[[File:Setup:systempreparation_temp_permissions_09.png|border|center|600px|Windows file permissions 09]]

{{Hint|file=hint.png|text=Sollten Sie in der Grundinstallation von Windows Server eine englische Version mit deutschem Sprachpaket installiert haben oder Sie gar direkt mit einer englischen Installation arbeiten so wird dieser Prozess fehlschlagen. In diesem Fall lautet der Username nicht "Jeder" sondern "everyone".}}

Setzen Sie den Haken "Ändern" (1) und schließen Sie den Dialog (2):

[[File:Setup:systempreparation_temp_permissions_10.png|border|center|600px|Windows file permissions 10]]

Die weiteren Dialoge schließen Sie nun alle mit "OK" bzw. "Ja". Die Rechte sind damit entsprechend gesetzt.

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/.NET_Framework_3.5|.NET Framework 3.5]].

Setup:Installationsanleitung/Systemvorbereitung/Windows

2022-01-25T14:08:46Z

Mrosengarth:

Dieser Teil des Handbuchs führt Sie Schritt für Schritt durch die Systemvorbereitung von Windows, um anschließend BlueSpice installieren zu können.

Folgen Sie nun diesen Kapiteln in der aufgeführten Reihenfolge. Sie finden direkt am Ende eines jeden Kapitels einen Link auf das nachfolgende Kapitel.

Schenken Sie bitte außerdem dem Kapitel "Vorwort" Beachtung. Es enthält zusätzliche Informationen zu diesem Handbuch.

*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Vorwort|Vorwort]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Setzen der Systemrechte des temporären Windows-Ordners|Setzen der Systemrechte des temporären Windows-Ordners]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/.NET Framework 3.5|.NET Framework 3.5]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/IIS-Webserver|IIS-Webserver]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/urlrewrite|urlrewrite]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Microsoft_Visual_C++_Redistributable|Microsoft Visual C++ Redistributable]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_Manager|PHP Manager]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP|PHP]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB|MariaDB]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/OpenJDK|OpenJDK]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Apache_Tomcat|Apache Tomcat]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Elasticsearch|Elasticsearch]]
*[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Python|Python]]

Setup:Installationsanleitung/Systemvorbereitung/Windows/IIS-Webserver

2022-01-25T14:07:51Z

Mrosengarth:

__TOC__

{{Hint|file=icon_required.png|text=Der Webserver liefert Ihre BlueSpice-Installation an die Browser der Benutzer aus. Ohne einen Webserver ist BlueSpice nicht verwendbar. Die hier aufgeführten Schritte sind zwingend erforderlich.}}
==Einleitende Informationen==
Wir empfehlen, für einen Live-Betrieb von BlueSpice sowohl unter Linux als auch unter Windows möglichst auf den systemoptimierten Webserver zurückzugreifen. Aus diesem Grund wird auf die Dokumentation einer Installation von Apache ''("XAMP")'' unter Windows verzichtet.

Dieses Kapitel führt die Einzelschritte auf, die die Installation des Microsoft IIS-Webservers unter Windows Server >= 2016 beschreiben.

==Öffnen des Server-Manager und der Rollenverwaltung==
Öffnen Sie zunächst den Server-Manager. Sofern nicht anders konfiguriert, startet dieser automatisch, sobald Sie sich am Server anmelden. Außerdem finden Sie diesen im Startmenü unter dem Suchbegriff "Server-Manager".

Sie befinden sich jetzt in folgender Ansicht:

[[File:Setup:systempreparation_iis_01.png|border|center|400px|IIS Webserver 01]]

Klicken Sie auf "Verwalten" (1) und anschließend auf "Rollen und Features hinzufügen" (2):

[[File:Setup:systempreparation_iis_02.png|border|center|400px|IIS Webserver 02]]

==Installation von IIS im Rollenmanager==
Sie befinden sich jetzt im Rollenmanager.

Klicken Sie nun solange auf "Weiter >", bis Sie den Bereich "Serverrollen" (1) erreicht haben. Dort aktivieren Sie die Rolle "Web Server (IIS)" (2):

[[File:Setup:systempreparation_iis_03.png|border|center|400px|IIS Webserver 03]]

Das sich mit der Auswahl der Rolle öffnende Popup bestätigen Sie mit "Features hinzufügen":

[[File:Setup:systempreparation_iis_04.png|border|center|400px|IIS Webserver 04]]

Klicken Sie auf "Weiter >":

[[File:Setup:systempreparation_iis_05.png|border|center|400px|IIS Webserver 05]]

Sie befinden sich jetzt im Bereich "Features". Klicken Sie hier ebenfalls auf "Weiter >":

[[File:Setup:systempreparation_iis_06.png|border|center|400px|IIS Webserver 06]]

Auch den nächsten Dialog bestätigen Sie mit "Weiter >":

[[File:Setup:systempreparation_iis_07.png|border|center|400px|IIS Webserver 07]]

Sie befinden sich im Bereich Rollendienste. Hier aktivieren Sie unter "Sicherheit" (1) die Option "Windows-Authentifizierung" (2) sowie unter "Anwendungsentwicklung" (3) den Punkt "CGI" (4) und bestätigen Sie mit "Weiter >" (5):

[[File:Setup:systempreparation_iis_08.png|border|center|400px|IIS Webserver 08]]

Aktivieren Sie hier den Punkt "Zielserver bei Bedarf automatisch neu starten" (1) und klicken Sie auf "Installieren" (2):

[[File:Setup:systempreparation_iis_09.png|border|center|400px|IIS Webserver 09]]

Sobald die Installation abgeschlossen ist beenden Sie den Dialog mit "Schließen":

[[File:Setup:systempreparation_iis_10.png|border|center|400px|IIS Webserver 10]]

Nach erfolgreichem Abschluss aller genannten Schritte ist der IIS-Webserver jetzt installiert. Kontrollieren Sie die Funktionalität, indem Sie einen auf dem Server verfügbaren Browser starten und die URL http://localhost/ aufrufen. Bei korrekter Installation sehen Sie die Willkommens-Seite des IIS-Webservers:

[[File:Setup:systempreparation_iis_11.png|border|center|400px|IIS Webserver 11]]

==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/urlrewrite|urlrewrite]].

Benutzer:Mrosengarth

2022-01-25T14:06:16Z

Mrosengarth: create user page