Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
Ini-Dateien
Die Ini-Dateien lassen sich am leichtesten mit dem 'PepUpdateServer' erstellen.
Hier werden automatische die Ini-Dateien mit verschlüsselten Passwörtern erstellt.
Server.ini
Gebrauch in PEP und Lizenzverwaltung. Datei neben pep.exe.
Entwicklungsstand 22.10.2026: Die neuen Optionen und das verschlüsselte Format benötigen die zusammengehörigen aktuellen Anmeldekomponenten und den aktuellen Updater. Diese Dokumentation bestätigt keine Installation auf einzelnen Arbeitsplätzen.
Ein Wert pro Zeile; ausgelassene Zwischenwerte mit einer leeren Zeile erhalten:
SERVER\INSTANZ PEP_DATENBANK SINGLEWIN 30 german SAVEDUSER showserver=false showdb=false
| Zeile | Inhalt |
|---|---|
| 1 | Server, gegebenenfalls mit Instanzname |
| 2 | Datenbank |
| 3, optional | WIN = Windowsanmeldung; SINGLE = Einzelsitzung; SINGLEWIN = Einzelsitzung mit automatischer Windowsanmeldung |
| 4, optional | Verbindungszeitlimit |
| 5, optional | Sprache |
| 6, optional | SAVEDUSER: zuletzt gespeicherten Benutzernamen vorgeben |
Sichtbarkeit im Anmeldedialog
Zusätzliche benannte Zeilen showserver=true und showdb=true geben das jeweilige Eingabefeld frei. Ohne Angabe oder mit false sind die Felder verborgen. 1 und 0 sind ebenfalls möglich. Groß-/Kleinschreibung ist unerheblich; bei mehrfacher Angabe gilt die letzte. Keine Abschnittsnamen oder Kommentarzeilen ergänzen.
Das Serverregister bleibt immer sichtbar und enthält Verbindung konfigurieren …. Sind beide Schalter aus, bleiben nur die Verbindungsfelder verborgen. Ein freigegebenes Serverfeld startet maskiert; Server anzeigen blendet es ein. Die Verbindungswerte werden auch bei unsichtbaren Feldern benutzt.
Verbindung konfigurieren … erscheint nur, wenn beide Eingabefelder verborgen sind. Bei einem oder beiden sichtbaren Feldern wird der Button nicht angezeigt. Nach der Freigabe verschwindet er; stattdessen sind die Felder und Verbindung speichern sichtbar.
Über Verbindung konfigurieren … im Serverregister lässt sich die Auswahl mit dem bestehenden PEP-Superadmin-Kennwort vorübergehend freigeben, auch bei falschem oder unerreichbarem Server. Verbindung speichern schreibt die gewählte Datei verschlüsselt. Danach bleibt die normale Anmeldung erforderlich. Siehe Anmeldung.
server_test.ini
Optional neben server.ini. Es genügen genau zwei Zeilen:
TESTSERVER\INSTANZ PEP_TEST
Die Testdatei ersetzt ausschließlich Server und Datenbank. Alle übrigen Einstellungen stammen immer aus server.ini: Anmeldeart, Zeitlimit, Sprache, gespeicherter Benutzer und showserver/showdb. Zusätzliche Optionen in der Testdatei werden nicht verwendet.
Ist die Datei vorhanden, bietet das Serverregister zusätzlich Testumgebung, auch wenn beide Eingabefelder verborgen bleiben. Nach dem Umschalten bewusst anmelden. Eine fehlende, unvollständige oder beschädigte ausgewählte Testdatei löst eine Meldung aus; es erfolgt kein stiller Rückfall auf die Standardverbindung. Explizites Speichern schreibt für die Testdatei nur die beiden Ziele.
Verschlüsselung und Updater
Unverschlüsselte Dateien bleiben lesbar. Nach einer vollständig erfolgreichen Anmeldung wird die tatsächlich benutzte Klartextdatei automatisch verschlüsselt. Bei einer Testanmeldung betrifft das nur server_test.ini. Fehlgeschlagene oder abgebrochene Anmeldungen verändern die Dateien nicht. Bereits verschlüsselte Dateien bleiben ohne erneutes Schreiben erhalten.
Im PepUpdateSrv kann beim Erstellen von server.ini die Option INI bereits jetzt verschlüsseln (portabler Sichtschutz) gewählt werden. Ohne Auswahl entsteht zunächst Klartext und wird bei der ersten erfolgreichen PEP-Anmeldung umgewandelt. showserver/showdb können dort ebenfalls gewählt werden. Der bestehende Veröffentlichungsweg bleibt erhalten.
Das Format beginnt mit PEP4-SERVERINI-V1: und funktioniert auch für mehrere Clients bzw. auf einem Netzlaufwerk. Es ist bewusst ein Sichtschutz gegen neugierige Augen: Die Entschlüsselung ist im Client verfügbar. Dateirechte und normale Authentifizierung bleiben erforderlich; Benutzerpasswörter gehören nicht in diese Datei. Beschädigte oder unbekannte verschlüsselte Formate werden abgewiesen.
Für die automatische Umwandlung sind Schreibrechte auf Datei und Ordner erforderlich. Ohne diese bleibt die erfolgreiche Anmeldung gültig, die Datei kann aber nicht umgewandelt werden. Änderungen werden über eine temporäre Datei ausgetauscht. Aktuelle Leser gemeinsam ausliefern; alte Klartextleser sind für das neue Format nicht vorgesehen.
softuhr4.ini
Gebrauch in SoftUhr4 (Software-Stempeluhr).
Dateiname: softuhr4.ini
Speicherort: Arbeitsverzeichnis von SoftUhr4. Lege die Datei neben SoftUhr4.exe ab und stelle bei einer Windows-Verknüpfung unter Ausführen in diesen Ordner ein.
Die Datei enthält einen Wert pro Zeile, ohne Abschnittsnamen oder Schlüssel=Wert-Angaben.
| Zeile | Inhalt | Beispiel |
|---|---|---|
| 1 | SQL-Server, bei Bedarf mit Instanzname | SQLSERVER\PEP |
| 2 | Name der PEP4-Datenbank | pep4 |
| 3 | Numerische Terminal-ID einer in PEP4 angelegten und für SoftUhr gültigen Uhr | 10 |
| 4 | Nur für SQL-Anmeldung: beliebiger Zusatzwert, zum Beispiel x. Der Inhalt wird nicht ausgewertet. | x |
Windows-Anmeldung
Verwende genau drei Zeilen. SoftUhr4 verbindet sich mit den Windows-Anmeldedaten des angemeldeten Benutzers:
SQLSERVER\PEP pep4 10
SQL-Anmeldung
Ergänze eine vierte Zeile, zum Beispiel x:
SQLSERVER\PEP pep4 10 x
SoftUhr4 verwendet dann die SQL-Anmeldung. Falls keine gültigen gespeicherten Zugangsdaten vorhanden sind, öffnet sich der Anmeldedialog. Benutzername und Passwort gehören nicht in die INI-Datei. Gespeicherte Zugangsdaten verwaltet SoftUhr4 separat in %LOCALAPPDATA%\SoftUhr4\softuhr4.pass.
Wichtig: Die Anzahl der Zeilen bestimmt die Anmeldeart: genau drei Zeilen = Windows-Anmeldung, mehr als drei Zeilen = SQL-Anmeldung. Füge deshalb keine zusätzlichen Leer- oder Kommentarzeilen ein. Servername, Datenbank und Terminal-ID in den Beispielen musst du durch die Werte deiner Installation ersetzen.
Nach dem Start prüft SoftUhr4 die Datenbankverbindung, die Benutzerzuordnung und die Terminal-ID. Bei fehlender Datei erscheint „ini-Datei nicht gefunden“, bei weniger als drei Zeilen „Fehler in der ini-Datei“. Eine ungültige Terminal-ID wird als „Softuhr-ID Fehler“ gemeldet.
Stand: 07.10.2026; anhand des SoftUhr4-Quellcodes geprüft, kein Anmeldetest durchgeführt.
zwworker.ini
Gebrauch vom ZwWorker
Dateiname: server.ini Speicherort: Ordner, in dem auch die pep.exe gespeichert ist
nomutex.txt
Ohne die Datei, wird ein zweiter Start der Applikation auf einem Rechner unterbunden. Ist die Datei vorhanden, dann kann die Applikation mehrfach parallel gestartet werden.
performance.txt
Diese Datei aktiviert Optimierungen des Programms, indem visuelle Effekte reduziert oder abgeschaltet werden. Folgende Schalter stehen zur Verfügung, diese Optionen müssen Zeilenweise aufgeführt werden.
Einstellungen
| Schalter | Beschreibung |
|---|---|
| directx | Aktiviert die Nutzung von DirectX-Beschleunigung (kann auf Terminal-Servern negative Auswirkungen haben. DirektX ist im Standard aktiviert |
| api | Aktiviert die Darstellung durch die Windows API |
| gdi+ | Aktiviert die GDI+ Darstellung (Auf Windows7-Rechnern empfohlen) |
| bonusskins | Registriert weitere Skins, ohne diese Option ist der Ladevorgang schneller |
| formskin | Deaktiviert Formskins |
| visualstyle | Deaktiviert visuelle Stile |
| xp | Deaktivert XP-Stile |
| flat | Deaktiviert eine Großteil von visuellen Effekten, Darstellung eher flach |
| animation | Reduziert die Animationen von Steuerelemente |
| bar | Optimiert die Darstellung der Navigation |
Das Beispiel reduziert die Effekte maximal und ist optimiert für RemoteDesktop-Verbindungen (RDP / Terminalserver):
gdi+ formskin visualstyle xp flat animation bar
listdb.txt
Zeigt im Anmelde-Dialog die verfügbaren Datenbanken als Combo-Box.
font.txt
Ändert die systemweite Schriftart und Größe.
Tahoma 10