================================================================ Was auf sva.tyrveil.com muss - Version __VERSION__ ================================================================ Lade den Inhalt dieses Ordners in das Wurzelverzeichnis der Subdomain, außer dieser Anleitung selbst: SquadManager-__VERSION__.zip SquadManager-Setup-__VERSION__.exe icon.png index.html die Downloadseite version.json als Letztes Die Reihenfolge ist wichtig: version.json zuletzt. Solange sie noch auf die alte Version zeigt, bekommt niemand einen Link auf eine Datei, die noch gar nicht oben liegt. Danach müssen diese Adressen erreichbar sein: https://sva.tyrveil.com/ https://sva.tyrveil.com/version.json https://sva.tyrveil.com/SquadManager-__VERSION__.zip https://sva.tyrveil.com/SquadManager-Setup-__VERSION__.exe ALTE DATEIEN ENTFERNEN ---------------------- Nach dem Hochladen die Zip- und Setup-Dateien früherer Fassungen vom Server löschen, also alle SquadManager-*.zip und SquadManager-Setup-*.exe mit einer anderen Nummer als __VERSION__, und falls noch vorhanden: SquadVoiceActivation-3.2.zip SquadVoiceActivation-Setup-3.2.exe Solange sie online liegen, kann jemand mit einer alten Fassung anfangen. KONTEN UND SQUADS: EINMALIG EINRICHTEN -------------------------------------- Seit 1.6.0 gibt es Konten, Akten auf dem Server und Squads. Dafür liegt neben diesem Ordner zusätzlich dist\sva-privat. Einmalig: 1. Den Ordner sva-privat in das Hauptverzeichnis des Webspace laden, NEBEN den Ordner sva.tyrveil.com - nicht hinein. Im Plesk-Dateimanager ist das die Ebene, auf der auch sva.tyrveil.com und httpdocs liegen. Dort ist er aus dem Internet nicht erreichbar. 2. In sva-privat die Datei config.beispiel.php kopieren und die Kopie config.php nennen. Darin eintragen: 'passwort' das Datenbank-Passwort aus Plesk 'einrichtungs_schluessel' eine lange Zufallszeichenkette, mindestens 24 Zeichen 3. Den Inhalt von dist\server wie oben nach sva.tyrveil.com laden. Neu dabei sind die Ordner api, konto, verwaltung und einrichten.php. 4. https://sva.tyrveil.com/einrichten.php öffnen und den Schlüssel eingeben. Die Seite prüft PHP, legt die Tabellen an und schickt an info@tyrveil.com einen Link, mit dem du das Passwort für die Verwaltung festlegst. 5. In config.php den einrichtungs_schluessel wieder leeren: '' Damit ist einrichten.php abgeschaltet. 6. Die Verwaltung liegt unter https://sva.tyrveil.com/verwaltung/ Zeigt einrichten.php "config.php fehlt", obwohl sie oben liegt: In Plesk unter PHP-Einstellungen muss open_basedir das Hauptverzeichnis des Webspace erlauben. Die Voreinstellung {WEBSPACEROOT}{/}{:}{TMP}{/} tut das. Bei späteren Updates nur sva-privat\app ersetzen. config.php und den Ordner daten (Porträts) nie überschreiben oder löschen. ZUM VERTEILEN ------------- Deinen Freunden gibst du nur noch diesen Link. Er ändert sich nie: https://sva.tyrveil.com Die Seite liest beim Öffnen version.json und bietet immer den neuesten Installer an. Sie erklärt auch die Windows-Warnung beim ersten Start ("Der Computer wurde durch Windows geschützt" -> Weitere Informationen -> Trotzdem ausführen). NGINX ----- Meist genügt die vorhandene Konfiguration. Hilfreich im server-Block: location ~* \.(zip|exe)$ { add_header Content-Disposition "attachment"; } location = /version.json { add_header Cache-Control "no-cache"; default_type application/json; } location = /index.html { add_header Cache-Control "no-cache"; } Die Zeile zu version.json ist die wichtigste: Ohne sie kann ein zwischengeschalteter Zwischenspeicher noch die alte Versionsnummer ausliefern, nachdem du längst eine neue hochgeladen hast. Zeigt https://sva.tyrveil.com/ trotz hochgeladener index.html weiter "403 Forbidden", fehlt im server-Block die Zeile index index.html; WIE DAS UPDATE FUNKTIONIERT --------------------------- Das Programm ruft beim Start version.json ab. Steht dort eine höhere Versionsnummer als die installierte, erscheint unten im Fenster ein Hinweisbalken mit einer Schaltfläche. Ein Klick lädt die ZIP, prüft die Prüfsumme, ersetzt die Programmdateien und startet neu. Ist der Server nicht erreichbar, passiert schlicht nichts - das Programm läuft dann ganz normal ohne Hinweis weiter. NEUE VERSION VERÖFFENTLICHEN ---------------------------- 1. In squad_manager.py VERSION anpassen und BUILD um eins erhöhen. Der Bau vergleicht BUILD mit dem Server und warnt, wenn es nicht höher ist - dann bekäme niemand das Update. 2. Im Quellordner ausführen: .venv\Scripts\python.exe werkzeuge\baue_release.py 3. Den Inhalt von dist\server\ hochladen, wie oben beschrieben Der Bauvorgang berechnet die Prüfsumme selbst und trägt sie in version.json ein. Diese Datei niemals von Hand bearbeiten: Stimmt die Prüfsumme nicht mit der ZIP überein, verweigert das Programm das Update - genau so ist es gedacht. In version.json steht "version" immer auf 4.1, die echte Nummer unter "anzeige". Das ist Absicht: Programme bis 4.0 lesen nur "version" und bekommen so das Update auf die neue Zählung ab 1.5.0. Das Feld "hinweis" darfst du füllen, es erscheint im Hinweisbalken des Programms und auf der Downloadseite: "hinweis": "Mikrofonliste aufgeräumt" Halte es kurz, es steht neben der Schaltfläche. WARUM HTTPS PFLICHT IST ----------------------- Das Programm lädt ausschließlich über HTTPS und lehnt http:// ab. Ein Updater, der Programmcode über eine unverschlüsselte Verbindung holt, ließe sich in einem fremden WLAN umleiten - dann käme fremder Code auf die Rechner deiner Freunde. Die Prüfsumme allein schützt davor nicht, weil ein Angreifer auch sie mitliefern könnte.