MC4Y – alle Pakete in einem
===========================

Fassung 0.4.30 · freie Software (GPL-3.0-or-later, siehe LIZENZ.txt) · English version: mc4y-all.zip
MY COACHING FOR YOU, Peter Hoenig – https://www.my-coaching4you.de/

In diesem Paket stecken alle MC4Y-Programmpakete auf einmal. Sie laden also EINE Datei herunter und haben
danach alles auf dem Rechner – die Suite, die Werkzeuge für den Browser, die Taskleiste, die Agenten und
Crawler für die CMDB, die Home-Assistant-Integration, das Werkzeug zum Verteilen und den HTML-PY-Editor.

Jedes Paket bleibt eine eigene ZIP-Datei im Unterordner „pakete“. Beim Auspacken bekommt jedes seinen
eigenen Ordner. Das hat zwei Gründe: Sie können einzelne Teile weglassen, und die Startskripte für Mac und
Linux behalten ihre Ausführungsrechte (die gehen beim Umpacken unter Windows verloren).

Es wird nichts installiert, nichts gestartet und nichts aus dem Netz geladen, solange Sie es nicht selbst
tun. Das Auspacken allein ändert an Ihrem Rechner nichts.


INHALT

  pakete/mc4y-suite.zip                Die ganze Suite: Server (PHP), alle Werkzeuge, Module (Dokumente,
                                       Wiki, Notizen, Aufgaben, Kalender, CMDB, Lösungsdatenbank),
                                       Installation für Windows, Linux und macOS, Handbuch.
                                       → Ordner „MC4Y-Suite-0.4.30“

  pakete/mc4y-werkzeuge.zip            Alle Werkzeuge nur im Browser – ohne Installation, ohne Anmeldung,
                                       ohne PHP. Der einfachste Weg, auch auf älteren Rechnern.
                                       → Ordner „MC4Y-Werkzeuge-0.4.30“

  pakete/mc4y-taskleiste.zip           Die Taskleiste für den Schreibtisch (Windows, Linux, macOS). Sie
                                       verbindet sich mit einer Suite, läuft aber auch ohne.
                                       → Ordner „MC4Y-Taskleiste“

  pakete/mc4y-erkennung.zip            Agenten und Crawler, die Geräte und installierte Software an die
                                       CMDB der Suite melden (Windows, Linux, Raspberry Pi, macOS, Android).
                                       → Ordner „MC4Y-CMDB-Erkennung“

  pakete/mc4y-cmdb-homeassistant.zip   Integration für Home Assistant: meldet die dort verwalteten Geräte
                                       an die CMDB.
                                       → Ordner „MC4Y-CMDB-HomeAssistant“

  pakete/mc4y-verteiler.zip            „Geräte verbinden“: rollt die Agenten auf viele Rechner auf einmal
                                       aus (Windows über WinRM, Linux und macOS über SSH).
                                       → Ordner „MC4Y-CMDB-Verteiler“

  pakete/html-py-editor.zip            HTML-PY-Editor: Baukasten für eine eigene Website, mit Hochladen
                                       per SFTP/FTPS. Gehört nicht zur Suite, braucht Python.
                                       → Ordner „html-py-editor“

  Alles-auspacken.bat                  Windows: Doppelklick packt alle Pakete aus.
  auspacken.ps1                        Windows: dasselbe als PowerShell-Skript (mit Optionen).
  auspacken.sh                         Linux und macOS: packt alle Pakete aus.
  auspacken.command                    macOS: Doppelklick-Starter für auspacken.sh.
  LIZENZ.txt                           Lizenzhinweis.


WELCHER WEG PASST ZU MIR?

  Ich will erst einmal nur hineinschauen
    → Nur „mc4y-werkzeuge.zip“ auspacken und darin „index.html“ doppelklicken. Fertig, kein Server.

  Ich will die Suite auf meinem Rechner (ein Arbeitsplatz)
    → „mc4y-suite.zip“ auspacken und im Ordner die Anleitung „INSTALLATION.txt“ lesen. Am einfachsten geht
      es mit dem grafischen Installer (Doppelklick auf „Installer-starten.bat“ bzw. „installer-starten.command“).
    → Danach „mc4y-taskleiste.zip“ auspacken, wenn Sie die Werkzeuge vom Schreibtisch aus starten möchten.

  Ich will die Suite auf einem Server für mehrere Leute
    → „mc4y-suite.zip“ auspacken, „INSTALLATION.txt“ Abschnitt „Server“ lesen.

  Ich will wissen, welche Geräte und Programme in meinem Netz laufen
    → Erst die Suite einrichten, dann in der Suite unter „CMDB › Erkennung“ einen Einrichtungsschlüssel
      erzeugen und mit „mc4y-erkennung.zip“ (und bei vielen Rechnern „mc4y-verteiler.zip“) weitermachen.

  Ich will eine eigene Website bauen
    → „html-py-editor.zip“ auspacken, darin die Anleitung lesen.


WAS SIE BRAUCHEN

  - Zum Auspacken: nichts außer dem Betriebssystem (Windows, macOS oder Linux). Etwa 2 Minuten.
  - Platz auf der Festplatte: rund 60 MB für das Paket, rund 90 MB ausgepackt.
  - Für die Suite selbst: siehe deren Anleitung (sie bringt PHP mit bzw. lädt es beim Einrichten).
  - Für die Agenten, den Verteiler und den HTML-PY-Editor: Python 3.8 oder neuer.


SCHRITT FÜR SCHRITT – WINDOWS 10/11

  1. Öffnen Sie den Ordner „Downloads“ (Windows-Taste, „Downloads“ tippen, Eingabetaste).
  2. Klicken Sie mit der rechten Maustaste auf „mc4y-alles“ und dann auf „Alle extrahieren …“.
  3. Klicken Sie auf „Extrahieren“.
     Sie sehen jetzt einen Ordner „MC4Y-Alles-0.4.30“ und darin diese Datei.
     Tipp: Über „Durchsuchen …“ können Sie vorher einen festen Ort wählen, zum Beispiel „Dokumente“.
  4. Öffnen Sie den Ordner „MC4Y-Alles-0.4.30“.
  5. Doppelklicken Sie auf „Alles-auspacken“ (bzw. „Alles-auspacken.bat“).
     Es öffnet sich ein schwarzes Fenster. Es zeigt zuerst, was es auspacken wird, und fragt nach, wenn ein
     Ordner schon vorhanden ist.
     Warnt Windows („Der Computer wurde durch Windows geschützt“): auf „Weitere Informationen“ und dann auf
     „Trotzdem ausführen“ klicken. Das Skript ist unverändert, wie es im Paket liegt.
  6. Am Ende steht „Fertig.“ mit der Liste der Ordner. Schließen Sie das Fenster.
  7. Öffnen Sie den Ordner, den Sie brauchen (siehe „Welcher Weg passt zu mir?“), und lesen Sie dort
     „LIESMICH.txt“.

  Lieber ohne Skript? Dann packen Sie im Ordner „pakete“ jede ZIP-Datei einzeln aus: rechte Maustaste ›
  „Alle extrahieren …“ › „Extrahieren“. Das Ergebnis ist dasselbe.


SCHRITT FÜR SCHRITT – MAC (macOS 12 oder neuer)

  1. Öffnen Sie das Terminal: cmd + Leertaste, „Terminal“ tippen, Eingabetaste.
  2. Packen Sie das Paket aus (bitte so, nicht per Doppelklick – das Archivprogramm von macOS verliert
     mitunter die Ausführungsrechte). Tippen Sie:

        ditto -x -k ~/Downloads/mc4y-alles.zip ~/mc4y

     Sie sehen keine Ausgabe – das ist richtig. Im Benutzerordner liegt jetzt „mc4y/MC4Y-Alles-0.4.30“.
  3. Nehmen Sie die Internet-Markierung von den Dateien:

        xattr -dr com.apple.quarantine ~/mc4y

  4. Wechseln Sie in den Ordner und packen Sie die Pakete aus:

        cd ~/mc4y/MC4Y-Alles-0.4.30
        bash auspacken.sh

     Das Skript zeigt zuerst, was es tun wird, und fragt nach, wenn ein Ordner schon vorhanden ist.
  5. Am Ende steht „Fertig.“ mit der Liste der Ordner.
  6. Öffnen Sie den Ordner, den Sie brauchen, und lesen Sie dort „LIESMICH.txt“.

  Hinweis: „Operation not permitted“ heißt, dass macOS den Ordner schützt (Schreibtisch, Dokumente,
  Downloads, iCloud- oder Nextcloud-Ordner). Arbeiten Sie dann wie oben im Benutzerordner (~).


SCHRITT FÜR SCHRITT – LINUX (auch Raspberry Pi)

  1. Öffnen Sie ein Terminal.
  2. Packen Sie das Paket aus und wechseln Sie hinein:

        cd ~ && unzip -q ~/Downloads/mc4y-alles.zip
        cd MC4Y-Alles-0.4.30

     Fehlt „unzip“:  sudo apt-get install unzip   (bzw. dnf, zypper, pacman)
  3. Packen Sie die Pakete aus:

        sh auspacken.sh

  4. Am Ende steht „Fertig.“ mit der Liste der Ordner.

  Liegt das Paket auf einer Netzfreigabe, kopieren Sie es vorher in Ihren Benutzerordner – von einer
  eingehängten Freigabe aus lassen sich Skripte oft nicht ausführen.


SO PRÜFEN SIE, OB ES GEKLAPPT HAT

  - Neben dem Ordner „pakete“ liegen jetzt sieben weitere Ordner, einer je Paket.
  - In „MC4Y-Werkzeuge-0.4.30“ liegt „index.html“. Doppelklicken Sie darauf: Der Browser zeigt die Seite
    „MC4Y-Werkzeuge“ mit allen Werkzeugen. Damit wissen Sie, dass das Auspacken vollständig war.
  - In „MC4Y-Suite-0.4.30“ liegen die Ordner „app“, „public“ und „install“ sowie „INSTALLATION.txt“.


OPTIONEN DER AUSPACK-SKRIPTE (wenn Sie mögen)

  Windows:   powershell -ExecutionPolicy RemoteSigned -File .\auspacken.ps1 -Probelauf
  Linux/Mac: sh auspacken.sh --probelauf

    --probelauf / -Probelauf    zeigt nur, was geschehen würde; ändert nichts
    --ziel <Ordner> / -Ziel     packt in einen anderen Ordner aus (Standard: dieser Ordner)
    --ja / -Ja                  frischt vorhandene Ordner ohne Rückfrage auf
    --lang de|en / -Sprache     Sprache der Ausgaben


HÄUFIGE PROBLEME

  - „Der Ordner pakete fehlt“: Die heruntergeladene ZIP-Datei wurde nicht ganz ausgepackt. Bitte noch
    einmal auspacken (Windows: rechte Maustaste › „Alle extrahieren …“; Mac: der Befehl mit ditto oben).

  - Windows führt „Alles-auspacken“ nicht aus (Meldung zur Ausführungsrichtlinie): Öffnen Sie PowerShell
    (Windows-Taste, „PowerShell“ tippen), wechseln Sie mit „cd“ in den Ordner und starten Sie:
        powershell -ExecutionPolicy RemoteSigned -File .\auspacken.ps1
    Die Datei ist nicht verändert; Windows markiert nur alles, was aus dem Internet kommt.

  - Der Virenscanner meldet sich: Die Skripte packen nur ZIP-Dateien aus. Sie laden nichts nach, starten
    kein Programm und schreiben keinen Autostart-Eintrag. Falls Ihr Virenscanner sie trotzdem wegnimmt,
    packen Sie die Pakete von Hand aus (siehe oben) – das Ergebnis ist dasselbe.

  - „bash: ./auspacken.sh: Keine Berechtigung“ (Linux/Mac): Dann liegt das Paket auf einer Freigabe oder
    das Ausführungsrecht ist weg. Starten Sie es mit „sh auspacken.sh“ bzw. „bash auspacken.sh“ – so ist
    das Recht nicht nötig.

  - Zu wenig Platz: Sie brauchen nicht alles. Packen Sie nur die Pakete aus, die Sie wirklich wollen, und
    löschen Sie danach den Ordner „pakete“.


AKTUALISIEREN

  Es gibt keine Automatik. Ein neues Gesamtpaket laden, auspacken und das Auspack-Skript erneut starten:

      https://www.my-coaching4you.de/downloads/experimentell/software/mc4y-alles.zip

  Die Ordner werden dabei aufgefrischt; Ihre eigenen Dateien bleiben. Für die INSTALLIERTE Suite gilt
  zusätzlich deren Anleitung („Aktualisieren“) – die Installation wird nicht allein durch das Auspacken
  erneuert. Ihre Arbeitsdaten liegen getrennt davon und bleiben unberührt.


ENTFERNEN

  Ziehen Sie die ausgepackten Ordner in den Papierkorb. Haben Sie die Suite, die Taskleiste oder einen
  Agenten INSTALLIERT, nutzen Sie vorher den jeweiligen Deinstaller (siehe die Anleitung im Ordner) –
  sonst bleiben Dienst, Aufgabe oder Menüeintrag zurück.


FÜR FACHLEUTE

  - Das Gesamtpaket enthält die unveränderten Einzelpakete. Prüfsummen lassen sich also gegen die
    einzelnen Downloads vergleichen (Windows: Get-FileHash, Linux/Mac: shasum -a 256).
  - Die Auspack-Skripte nutzen nur Bordmittel: Expand-Archive bzw. System.IO.Compression unter Windows,
    unzip oder „python3 -m zipfile“ unter Linux und macOS.
  - Jedes Paket hat genau einen Wurzelordner; die Skripte lesen ihn aus dem Archiv und überspringen
    Pakete, die keinen eindeutigen Wurzelordner haben.
  - Vorhandene Ordner werden aufgefrischt, nicht gelöscht: gleichnamige Dateien werden ersetzt, alles
    andere bleibt liegen.
  - Die Sprache der Ausgaben steht in „sprache.txt“ (eine Zeile, „de“ oder „en“); -Sprache bzw. --lang
    gehen vor, danach die Sprache des Systems.

Die Programme werden unentgeltlich und ohne jede Gewährleistung bereitgestellt (siehe LIZENZ.txt).
