| | |
| | | ## 6. "Rechner einrichten" – Verteilungs-Mechanismus |
| | | |
| | | Route `/einrichten` (app.py) erzeugt bei Bedarf ein individuelles |
| | | Installations-Paket (ZIP mit `einrichten.ps1` + `Rechner-einrichten-starten.bat`), |
| | | Installations-Paket (ZIP mit `einrichten.ps1` + `Rechner-einrichten-starten.bat` |
| | | **+ den echten Installer-Dateien/ZIPs selbst** unter `tools/<id>.<endung>`), |
| | | statt vorab für jede Mitarbeiter/Tool-Kombination ein festes Skript zu pflegen. |
| | | |
| | | **Wichtige Design-Entscheidung (Runde r16):** Die Installer-Dateien werden |
| | | bereits beim Erzeugen des Pakets (auf dem PC, der die Checkliste ausfüllt) |
| | | eingebettet, nicht erst beim Ausführen auf dem Zielrechner nachgeladen. Ein |
| | | früherer Ansatz lud die Dateien per `Invoke-WebRequest` zur Laufzeit vom |
| | | Server nach – das erforderte Netzwerkzugriff des Zielrechners auf den Server |
| | | in genau dem Moment der Einrichtung, was in der Praxis nicht immer gegeben |
| | | ist (z. B. Rechner noch nicht ans Firmennetz angebunden). Jetzt braucht der |
| | | Zielrechner für die eigentliche Installation **kein Netzwerk mehr** – nur die |
| | | abschließende, optionale Meldung ans zentrale Protokoll (`/zuweisungen/neu`) |
| | | versucht noch einen Netzwerkzugriff, scheitert dieser, bleibt trotzdem das |
| | | lokale Protokoll (`protokoll.log`) vollständig. |
| | | |
| | | Ablauf beim Ausführen auf dem Zielrechner: |
| | | 1. `.bat` kopiert sich selbst + das `.ps1` nach `C:\ClientBibliothek` |
| | | 1. `.bat` kopiert den **kompletten entpackten Ordner** (inkl. `tools/`- |
| | | Unterordner mit den echten Installer-Dateien) nach `C:\ClientBibliothek` |
| | | (per `xcopy /E /I /Y`) |
| | | 2. Self-Elevation (Admin-Rechte-Anfrage) über `Start-Process -Verb RunAs` |
| | | 3. Automatische Windows-Defender-Ausnahme für `C:\ClientBibliothek` |
| | | (`Add-MpPreference -ExclusionPath`) – ein einziger Pfad statt vieler |
| | | Einzelausnahmen |
| | | 4. Pro ausgewähltem Tool: entweder stille Installation (Download + Ausführung |
| | | mit hinterlegtem Silent-Parameter, `.msi` läuft über `msiexec`) oder – bei |
| | | Tools ohne einzelne Installer-Datei ("Ordner-Typ", z. B. portable |
| | | Programme wie Blender) – Download als ZIP nach `C:\ClientBibliothek\pakete\`, |
| | | **bewusst ohne automatisches Entpacken** (Entscheidung in Runde r14: der |
| | | Zielort für portable Tools variiert, das soll eine Person bewusst |
| | | 4. Pro ausgewähltem Tool: entweder stille Installation aus der **lokal |
| | | mitgelieferten** Datei unter `tools/<id>.<endung>` (mit hinterlegtem |
| | | Silent-Parameter, `.msi` läuft über `msiexec`) oder – bei Tools ohne |
| | | einzelne Installer-Datei ("Ordner-Typ", z. B. portable Programme wie |
| | | Blender) – die mitgelieferte ZIP-Datei wird nach `C:\ClientBibliothek\pakete\` |
| | | kopiert, **bewusst ohne automatisches Entpacken** (Entscheidung in Runde |
| | | r14: der Zielort für portable Tools variiert, das soll eine Person bewusst |
| | | entscheiden) |
| | | 5. Lokales Protokoll unter `C:\ClientBibliothek\protokoll.log` |
| | | 6. Automatischer POST an `/zuweisungen/neu` auf dem Server, um das zentrale |
| | | 6. Optionaler POST an `/zuweisungen/neu` auf dem Server, um das zentrale |
| | | Protokoll zu befüllen (Rechnername wird dabei über `$env:COMPUTERNAME` |
| | | automatisch erkannt) |
| | | automatisch erkannt) – best effort, kein Abbruch bei Fehlschlag |
| | | |
| | | Die Ordner-Struktur unter `C:\ClientBibliothek`: |
| | | - `\downloads` – transiente Installer-Dateien, werden nach Gebrauch gelöscht |
| | | - `\tools` – die mitgelieferten Installer-Dateien/ZIPs (Quelle für die |
| | | Installation, kommen direkt aus dem heruntergeladenen Paket) |
| | | - `\pakete` – ZIPs von portablen Tools, bleiben bewusst liegen |
| | | - `\protokoll.log` – lokale Mitschrift |
| | | |
| | | Serverseitig teilen sich `/einrichten` (POST) und `/software/<id>/download` |
| | | die Hilfsfunktion `_zippe_ordner_in_bytes()` für das ZIP-Packen eines |
| | | Ordners, um Code-Duplikation zu vermeiden. |
| | | |
| | | **Der Client-Ordner-Pfad ist eine Konstante** (`CLIENT_ORDNER` in `app.py`, |
| | | aktuell `C:\ClientBibliothek`) – zentral anpassbar, falls die Infrastruktur |
| | | einen anderen Standardpfad vorgibt. |