MC4Y-Produktivitätssuite – Installation unter Windows
======================================================

Freie Software (GPL-3.0-or-later) von MY COACHING FOR YOU. English version: README.txt
Die Gesamtanleitung für alle Systeme steht in INSTALLATION.txt im Hauptordner des Pakets.


ERST ÜBERLEGEN: BRAUCHE ICH DIE SUITE?
  Möchten Sie die Werkzeuge nur allein nutzen und Ihre Arbeit als Dateien speichern, ist „Nur im Browser“
  einfacher: keine Installation, kein Administratorkennwort. Dafür im grafischen Installer (unten, Schritt 8)
  „Nur im Browser (am einfachsten)“ wählen – oder die Datei „mc4y-werkzeuge.zip“ auspacken und darin
  „index.html“ doppelklicken. Diese Anleitung hier ist für die ganze Suite (mit Anmeldung, gemeinsamer Ablage,
  Kalender, Wiki, Aufgaben und täglicher Sicherung) auf Ihrem eigenen Rechner.


WAS SIE BRAUCHEN
  - Windows 10 oder 11. So sehen Sie nach: Windows-Taste + R drücken, „winver“ tippen, Eingabetaste.
    Das Fenster „Info über Windows“ nennt „Windows 11“ oder „Windows 10“.
  - Das Kennwort eines Administratorkontos (ein Konto, das Programme installieren darf). Haben Sie den
    Rechner selbst eingerichtet, ist das meist Ihr eigenes Anmeldekennwort.
  - Internet: Der Installer lädt PHP von windows.php.net (etwa 35 MB) und, falls nötig, eine Laufzeit von
    Microsoft. PHP ist die Programmiersprache, in der die Suite läuft.
  - Etwa 15 Minuten Zeit und 1 GB freien Speicherplatz.


SCHRITT FÜR SCHRITT

Teil 1: Paket herunterladen und auspacken
  1. Laden Sie „mc4y-suite.zip“ herunter (Website von MY COACHING FOR YOU, Bereich „Experimentell – zum
     Ausprobieren“). Ihr Browser legt die Datei in „Downloads“.
  2. Öffnen Sie den Explorer (Windows-Taste + E) und klicken Sie links auf „Downloads“.
  3. Rechte Maustaste auf „mc4y-suite“ › „Eigenschaften“.
  4. Steht unten bei „Sicherheit“ „Die Datei stammt von einem anderen Computer …“: Häkchen bei „Zulassen“
     setzen. Dann „OK“.
  5. Rechte Maustaste auf „mc4y-suite“ › „Alle extrahieren …“ › „Extrahieren“.
  6. Doppelklicken Sie im neuen Fenster auf den Ordner „MC4Y-Suite-…“ (zum Beispiel „MC4Y-Suite-0.4.15“).

Teil 2: Installer starten
  7. Doppelklicken Sie auf „Installer-starten“.
     Kommt ein blaues Fenster „Der Computer wurde durch Windows geschützt“: „Weitere Informationen“ ›
     „Trotzdem ausführen“.
     Sie sehen jetzt ein schwarzes Fenster „MC4Y-Suite - Installer“ – offen lassen! – und kurz danach im
     Browser die Seite „Was möchten Sie einrichten?“.
     Öffnet sich kein Browser: Die lange Adresse unter „Oeffnet sich kein Browser“ im schwarzen Fenster
     markieren, kopieren und in die Adresszeile des Browsers einfügen.

Teil 3: Im Installer
  8. „Die Suite auf diesem Windows-Rechner“ anklicken, dann „Weiter →“.
  9. „Neu oder aktualisieren“: „Weiter →“.
 10. „Speicherorte“: Neben „Alle Orte auf“ ein Laufwerk anklicken (nur eines vorhanden: „Laufwerk C“).
     Unter den Feldern erscheinen grüne Hinweise wie „in Ordnung – wird angelegt“. Haben Sie ein zweites
     Laufwerk, legen Sie die „Täglichen Sicherungen“ am besten dorthin (Laufwerk-Knopf unter dem Feld).
     Dann „Weiter →“.
 11. „Werkzeuge“: alles ausgewählt lassen, „Weiter →“.
 12. „Voraussetzungen“: kurz warten. Häkchen bei „Ich bin einverstanden, …“ setzen, dann „Installieren“.
 13. Windows fragt „Möchten Sie zulassen, dass durch diese App Änderungen an Ihrem Gerät vorgenommen
     werden?“ – „Ja“ (ggf. Name und Kennwort eines Administrators eingeben).
 14. Warten (2 bis 10 Minuten), bis „Fertig installiert.“ erscheint.
 15. „Suite öffnen“ anklicken. Auf der Seite „Suite einrichten“ das erste Konto anlegen: Ihr Name,
     Anmeldename (ohne Leerzeichen), Kennwort mit mindestens 10 Zeichen (zweimal), dann „Einrichten und
     anmelden“.
 16. Zurück im Installer „Installer beenden“ anklicken.

Die Suite startet ab jetzt bei jedem Hochfahren von selbst. Adresse (nur auf diesem Rechner):
http://127.0.0.1:8090/ – am besten als Lesezeichen speichern (Strg + D).


SO PRÜFEN SIE, OB ES GEKLAPPT HAT
  1. Im Browser http://127.0.0.1:8090/ öffnen: Sie sehen die Anmeldeseite der Suite.
  2. Den Rechner neu starten und die Adresse noch einmal öffnen: Die Anmeldeseite ist wieder da.
  3. In der Suite „Verwaltung“ › „Systemprüfung“: Die meisten Zeilen sind grün.
  4. „Verwaltung“ › „Sicherung“ › „Jetzt sichern“, danach in der neuen Zeile „Prüfen“.


HÄUFIGE PROBLEME
  - Das schwarze Fenster schließt sich sofort: Das Paket ist nicht ausgepackt. Schritt 5 machen und
    „Installer-starten“ im ausgepackten Ordner starten.
  - „Weiter →“ bleibt grau: Unter einem Feld steht ein roter Hinweis – lesen und einen anderen Ordner oder
    ein anderes Laufwerk wählen.
  - „Port … ist belegt“: Im Schritt „Speicherorte“ bei „Port“ zum Beispiel 8091 eintragen; die Adresse ist
    dann http://127.0.0.1:8091/.
  - „PHP … startet nicht“: Es fehlt die Visual-C++-Laufzeit von Microsoft. Der Installer bietet sie im Schritt
    „Voraussetzungen“ an; sonst „vc_redist.x64.exe“ von Microsoft installieren.
  - Kein Administratorkennwort: die Person fragen, die den Rechner eingerichtet hat – oder „Nur im Browser“
    nutzen.


AKTUALISIEREN
  Neues „mc4y-suite.zip“ laden und die Teile 1 bis 3 noch einmal machen. Im Schritt „Neu oder aktualisieren“
  steht dann „Vorhandene Installation gefunden“, und „Aktualisieren“ ist gewählt. Inhalte, Konten und
  Einstellungen bleiben; die Datenbank wird vorher gesichert.


ENTFERNEN
  1. Im ausgepackten Paket den Ordner „install“ und darin „windows“ öffnen (oder im Programmordner der Suite,
     zum Beispiel C:\Program Files\MC4Y-Suite\install\windows).
  2. Auf „deinstallieren“ doppelklicken, Windows-Rückfrage mit „Ja“ beantworten.
  3. Bei „Suite deinstallieren? (j/n)“ j tippen und die Eingabetaste drücken.
  (Das Fenster spricht die Sprache von Windows; ist Windows englisch eingestellt, steht dort „Uninstall the
  suite? (y/n)“ – j und y bedeuten beide „ja“.)
  Ihre Inhalte bleiben im Datenordner (zum Beispiel C:\ProgramData\MC4Y-Suite-Daten). Sollen auch sie weg,
  löschen Sie diesen Ordner danach selbst – oder starten Sie „deinstallieren“ mit -DatenLoeschen (siehe unten).


FÜR FACHLEUTE

Sprache: Alle Skripte schreiben Deutsch oder Englisch – ohne Angabe in der Anzeigesprache von Windows. Mit
-Sprache de bzw. -Sprache en (sonst Umgebungsvariable MC4Y_SPRACHE) wählen Sie die Sprache; ein Skript, das sich
mit Administratorrechten neu startet, gibt sie weiter, und der grafische Installer gibt die Sprache seiner
Oberfläche mit. Installationsprotokoll, KURZANLEITUNG.txt (Server) und Verknüpfung („MC4Y-Produktivitaetssuite.url“
bzw. „MC4Y Productivity Suite.url“) folgen der gewählten Sprache. Das Bestätigungswort LOESCHEN gilt in beiden
Sprachen; datenordner-verschieben.ps1 und wiederherstellen.ps1 nehmen JA und YES an.

Die Skripte (nur ASCII, Windows PowerShell 5.1; jedes mit -Probelauf, der nichts verändert)
  installieren.bat / installieren.ps1          Einzelplatz Windows 10/11 (ohne grafischen Installer)
  installieren-server.bat / .ps1               Windows Server mit IIS, auf dem Server selbst
  auf-server-installieren.ps1                  Windows Server per Fernwartung (WinRM, Kerberos) vom Arbeitsplatz aus
  installer-dienst.ps1                         Helfer des grafischen Installers (127.0.0.1, Zufallsschlüssel)
  datenordner-verschieben.ps1                  Datenablage und/oder Sicherungen an neue Orte
  wiederherstellen.ps1                         Sicherung zurückspielen
  deinstallieren.bat / -server.bat             entfernen (Datenordner bleibt, außer -DatenLoeschen + LOESCHEN)
  zuruecksetzen.bat                            Einzelplatz-Datenordner leeren (Eingabe LOESCHEN)
  suite-betrieb.ps1                            gemeinsame Bausteine

Einzelplatz ohne grafischen Installer (Eingabeaufforderung im Paket; Windows fragt nach Administratorrechten):
  install\windows\installieren.bat -Probelauf
  install\windows\installieren.bat -PhpZip <php-8.x.y-nts-Win32-vs17-x64.zip> -PhpSha256 <Prüfsumme>
  ohne Fragen: -Programm E:\MC4Y-Suite -Daten E:\MC4Y-Suite-Daten -SicherungOrdner F:\MC4Y-Suite-Sicherungen
  PHP: https://windows.php.net/download/ („VS17 x64 Non Thread Safe“, Prüfsumme daneben). Das Skript legt das
  Konto mc4y-systemuser an (ohne Anmelderecht), die Aufgabe „MC4Y-Suite“ (php -S 127.0.0.1:8090 beim
  Systemstart) und „MC4Y-Suite-Sicherung“ (täglich), schreibt installation.json und das Protokoll
  installation_<Zeit>.log in den Programmordner.
  Aktualisieren: installieren.bat -Aktualisieren [-DatenNeu …] [-SicherungenNeu …] -OhneBrowser -OhneWarten
  (sichert vorher die Datenbank nach <Datenordner>\_update-sicherung).

Windows Server mit IIS (Einzelheiten: public/handbuch.html, Abschnitt 4):
  install\windows\installieren-server.bat -PhpZip … -PhpSha256 … -VcRedist C:\Pakete\vc_redist.x64.exe
  powershell -ExecutionPolicy Bypass -File install\windows\auf-server-installieren.ps1 -Server server.firma.local -PhpZip … -PhpSha256 … -VcRedist …
  Richtet IIS-Rollendienste, PHP mit eigener php.ini, den Anwendungspool „MC4Y-Suite“ (virtuelle Identität,
  kein Benutzerkonto), HTTPS mit selbst signiertem Zertifikat (oder -Zertifikat <Fingerabdruck>), die
  Firewall-Regel, Windows-Authentifizierung und die tägliche Sicherung ein und schreibt KURZANLEITUNG.txt in den
  Programmordner. Am Ende zeigt es den Einrichtungscode für das erste Konto.
  Aktualisieren: -Aktualisieren; umziehen: -Umziehen -Programm … .

Ohne Internet
  PHP-Paket (mit einer Datei gleichen Namens und der Endung .sha256) und vc_redist.x64.exe in einen Ordner
  „voraussetzungen“ neben installer.html legen.

Nicht aus einem Nextcloud- oder anderen Cloud-Ordner starten: Dabei gehen versteckte Dateien wie .htaccess
verloren. Immer frisch herunterladen und auspacken.
