OBS/Adminhilfe/Git Fork/Anleitung

Dies ist eine zugriffsgeschützte Seite.

Wiki » Admin-Hilfe

Admin-Hilfe

FAQ

• System Überwachung
• DEP deaktivieren
• Darstellung unter Windows 7
• Einwahl auf Windows 2000 Server
• Preislisten
  • Preislistenpflege
• Datenbank Sicherung
• Customize
• Zentrale
• Support Macro
• Service Debug
• Historienprotokoll (Datenänderung OBS)
• Fernwartungsprobleme
• Startparameter
• Fehler beim Kassenabschluss
• Diverse Informationen

FIBU

• E-BANKO Löschen
• Buchungsmöglichkeiten mit offenen Posten

Häufige Fehler FAQs

• Shop Fehler
• OBS-MAIL Fehler
• OBS-FTP Fehler
• Service Fehler
• Druck Fehler
• FIBU Fehler
• Preis-Fehler
• MySQL-Fehler

Allgemeines

• Home Office Kompendium
• Zeiterfassung & Termine Firma Bergau

Tools

• Auflistung verschiedener Tools
• Videos mit Demo Builder
• Autohotkey
• Videos mit Open Broadcaster Software
• OBS-Monitor

• Kassendruck für Terminalserverbetrieb einrichten
• KundenSysInfo
• OBS Update
• OBS Update(alt)
• OBS Versionshistorie
• Flex Archiv Kontrolle
• RTF-Umstellung
• Druckumstellung
• PDF-Generierung
• Support Berechnen
• OBS Kosten und Berechnung
• OBS-Hilfetexte erstellen
• Nützliche Batch-Befehle (CMD)

Widgets

• OBS Logs/Protokolle
• MySQL Process Liste
• Ticketsystem

• Tankkarten für E-Autos anlegen (Bergau Ladesäulen)
• Lebenszyklen für Software

Wiki Hilfe

Syntax

• Tabellen
• Bilder
• Videos
• Dokumente
• Häufig Verwendet
• OBS/Adminhilfe/Artikel: HTML-Befehle für Textformatierung
• Textverknüpfungen
• Einzelnachweise
• Testseite

• Wiki-Seiten erstellen
• Wiki Suche verwenden
• Wiki-Admin
• Wiki Benutzer erstellen-bearbeiten

Wiki-Gruppen Benutzerlisten

• Administrator
• Programmierer
• Expert
• Bürokraten
• IT-Techniker
• Officestar

• Veraltete Seiten
• Documentation Insight
• Formatierungshilfe

MySQL

MySQL Installation

• MySQL Installieren
• MySQL Tuning & Einstellungen
• Admin/SQL-Benutzer
• MySQL Upgrade
• MySQL ODBC Treiber

• MySQL Tipps
• MySQL-Fehler
• MySQL Aufgaben
• MySQL Join Erläuterungen
• Datenbankdump
• MySQL8 Shell
• Reguläre Ausdrücke

Programmierung und Mergen

Delphi

Einrichtung

• Delphiinstallation
• Delphi 5 Konfiguration
• Delphi 10 Konfiguration
• Vererbung Objectpascal
• Delphi IMP_*.PAS Dateien
• Delphi-Virus (W32.Induc.A!dcu)
• ADOM Update
• Allgemeine Fragen und Tipps zu Delphi
• Packages
• Generics in Delphi XE8

• Guideline
• Syntax-Regeln
• DebugTimer
• Arbeiten mit SQLite
• Schnittstelle testen
• Semaphoren
• Threading
• MemoryLeak Hunt
• Collections
• Pax-Freigabe
• Reguläre Ausdrücke

MMX

• MMX
• Einstellungen
• Code Explorer
• Source Indexer
• Navigation and Move
• Text Tools
• Code Generierung & Refactoring

Git/SmartGit

• Anleitung

Programm Update

• Übersicht
• Programm.ini

Schaltflächen

• Source einspielen Main zu User
• Source einspielen User zu User
• User Sourcen sichern
• Source Änderungen in den Versionen
• F5 - Projekte
• F6 - Protokoll
• F7 - Protokoll Löschen
• F8 - Update
• F9 - FTP

F10: Weitere Funktionen

• Übersicht

PAX

• Konvertierung
• Ereignisbehandlung
• SQL-Export
• Customize-Scripte
• Listenrework

Nützliche Funktionen

• Barcodes

SteVe

• Einrichtung

OBS-Administration / Installation

Einrichtung

MySQL

• MySQL Installieren

OBS

• OBS Installation
• Artikelpflege Besonderheiten
• OBS.ini

Dienste

• Dienste auf verschiedenen Servern
• Problembehandlung
• Mail
  • EMAILROU.ini
• FTP
  • FTP Synchronisation
• Fax
• OBS Update
• Startparameter für Dienste

Kasse/Notfallkasse

• OBS Kasseneinrichtung
• Notfallkasse
• Notfallkassendrucksystem
• TSE Einrichtung

Replikation

• Allgemeine Informationen
• Segel Daten Replikation

Zentrale

Fleet-Management einrichten

• Fleet-Management einrichten

VirtualUI

• VirtualUI einrichten
• VirtualUI Tipps und Probleme

OBS Umzug

• Serverumzug
• OBS Umzug Checklist

Admin Funktionen

Service Firmen

• Service Firmen Liste
  • F6 Einwahl

F10

• A ras.pbk
• B Command Line Interpreter
• C File Zilla Benutzer XML erzeugen
• D1 OBS_UPDATE.EXE zum OBS Update Server hochladen
• D2 SUPPORT_MACRO zum OBS Update Server hochladen
• H1 Remote Service Protokoll-Übersicht (Alles)
• H Remote ServiceProtokoll-Übersicht
• I Remote Service Commands
  • Eingabemaske
  • Multi-Kommando
• I1 (Admin) Globaler Hinweis für Updates
• J Liste der OBS Updates
• K Angemeldete Service Firmen
• L Systeminformationen einlesen
• M Kundendaten anzeigen
• M1 Kundendatenbankinformationen anzeigen
• N Kundendaten einlesen
• O Kunden-Update Informationen anzeigen
• P Modul Registrierung OBS
• Q App Verwaltung
• S1 Firmen Statistik Protokolle OBS
• S2 Statistik Notfallkassen

• Service Firmen Eingabemaske
• Remotecon

O Support

• A Update Programme
• B Datenbankoperationen
• C Tools

D Programmierer-Tools

• Datenbank verfremden

V Crypt Autologin Edit

• Zugang.ini

• E Interne Sonderprogramme
• G Service Tools
• H Script-Tools
• I Flex Archive

J Update Marko Lib/Pmode/Script Lib

• A Macro Library
• C Script Library

kundenspezifische Anpassungen

• UserDB.sys

OBS Protokolle

• HistorieProto

OBS DEMO

• OBS-Demo Allgemeines

Shop-Administration

• Shop Übersicht Voraussetzungen und Einrichtung

modified eCommerce

• REST

modified eCommerce 2.x

• FAQ
• Installation
• Einrichtung PayPal Checkout

modified eCommerce 1.06

• Shop modified eCommerce

Amazon

• Schnittstelle Amazon

VShop 4.0

• Shop VShop

Kundeninformationen

OfficeStar

• Allgemeine Informationen
• Hinweiszeiten

MDS

• Skrip-Automatische Ablage von Dokumenten

Installation

SmartGit und OBS

1. Sourcen ziehen
2. SmartGit installieren
   https://www.syntevo.com/smartgit/download/
   
   Name: Nachname, Vorname
   Mail: nachname.vorname@obs
   View: Log
3. Repository - Clone:
   http://192.168.254.162/root/obs.git
   Path: C:\Bergau\OBS\Dev\tempsource
   
   Anmeldedaten:
   dev
   Siehe Passwortverwaltung!
4. .git-Ordner und .gitignore-Datei aus C:\Bergau\OBS\Dev\tempsource in den dev-Ordner ziehen und den dev\tempsource-Ordner löschen (Achtung: Sind versteckte Dateien!)
5. In SmartGit: Wenn Meldung aufploppt: Remove Repository. Sonst Rechtsklick aufs tempsource-Repository - Delete
6. In SmartGit: Repository - Add or Create... - C:\Bergau\OBS\Dev öffnen
7. Alle Änderungen im Workingtree discarden (Dabei gehen mögliche Änderungen an Dateien, die vor der Installation von SmartGit gemacht wurden, verloren, also relevante Dateien einmal sichern, um die Änderungen nach dem Discard wieder einzumergen. Für neue Arbeitsplätze ist das egal, da kann ruhig alles discarded werden.)
8. Bei Workingtree-Warnung in Smartgit: dev\.git\config bearbeiten: 'tempsource' aus dem Workingtree-Eintrag entfernen

Bugfix

In SmartGit: Remote - Add:

http://192.168.254.162/root/bugfix.git  
xBugfix

Remote Halde

In SmartGit: Remote - Add:

http://192.168.254.162/root/obs2.git  
Remote_Halde

Modified Shop

1. Clone:
   http://192.168.254.162/root/modified2-obs-shop.git
   C:\Bergau\OBS
   shop
   
   Anmeldedaten:
   Siehe Passwortverwaltung!

App

1. Clone:
   http://192.168.254.162/root/app.git
   C:\Bergau\OBS
   app
   
   Anmeldedaten:
   Siehe Passwortverwaltung!

Einstellungen

Repository → Settings

Encoding

Beim Encoding sollte windows-1252 ausgewählt werden.

Edit → Preferences

Commands

Automatically save stash on common commands, if they fail due to local changes (Zusätzlich:'git config rebase.autoStash true' (Siehe Anleitung))

Low-level Properties

Edit - Preferences - Low-level Properties:

tooltip.compactLineLimit : 10 (setzt die Standardgröße von Tooltips, damit mehr angezeigt wird, ohne, dass man F1 drücken muss)
changes.maximumFileSize : 3000000 (damit auch große Dateien wie die OBSDB.sys bearbeitet werden können)
branches.delete.preselectDeleteFromRemote : true (Damit beim Löschen von Remote-branches der Bestätigungshaken vorbelegt ist)

Fenstereinstellungen

Branches-Fenster

Sort Refs by Commit Time: Damit Tags absteigend angezeigt werden.

Git-Shell öffnen

Für weitere Einstellungen.

Arbeitsabläufe

Unstable

Entwickler

1. Fetch, Unstable-Branch auschecken, 'Pull' zum Versionen ziehen; Wenn gefragt wird, was mit Änderungen passieren soll: 'Stash and Reapply'
   
2. Programmieren...
   
3. Gab es zwischenzeitlich neue Sourcen sollte zunächst "Save Stash" ausgeführt, Unstable ausgecheckt und anschließend "Apply Stash" ausgeführt werden.
4. neuen Branch (Rechtsklick - 'add branch') vom Unstable: '<kürzel>-<beschreibung>'; Darauf achten, dass der neue Branch ausgecheckt ist (aktiv, Haken davor)
5. Für diesen Branch relevante Änderungen commiten (In SmartGit: Working Tree (Changes) - Dateien auswählen - Commit - Bezeichnung eingeben); Branches auf ein Commit begrenzen. Wenn schon eines gemacht wurde: Local - Undo Last Commit
   
6. Branch pushen, zurück auf unstable wechseln (checkout), lokalen Branch löschen.
   
7. Bei mehreren, unabhängigen Änderungen: zurück zu Schritt 3.
   

• Darauf achten, keine Abhängigkeiten der Commits untereinder zu haben!
  
• Wenn Änderungen länger in Entwicklung sind: Rebase (Änderungsbranch auschecken (Haken davor), dann Rechtsklick auf den unstable-Branch -> Rebase ... to here), um die Änderungen auf den aktuellen Source-Stand zu bringen
  

Merger

1. Unstable auswählen
2. Bei allen grünen Merge-Zweigen von unten nach oben:
   1. [Rechtsklick - Cherry-Pick] auf commits mit grünen 'merge'-Branches
   2. grünen Branch löschen (auch remote!)
3. Versions-Tag setzen
   
4. Unstable pushen
   
5. Version erstellen (Auf Drucklib-Änderungen achten!)
   

Jörn

• Wenn jemand anderes die Unstable gemacht hat: Unstable ziehen: Auschecken, Fetch, Pull.
• Normales Programmieren: Mit Haken vor Unstable: Änderungen machen, stagen, committen.
• Änderungen von Anderen einmergen:

1. Eigene Änderungen Stagen und Commiten
2. In der Commit-Liste: Commits, die mit merge/<name>-<beschreibung> markiert sind, anklicken.
3. Unten unter Changes die Änderungen einsehen und bewerten
4. Wenn Änderungen gut: Rechtsklick auf den Commit, der mit merge/<name>-<beschreibung> markiert ist -> Cherry-Pick Commit
5. Rechtsklick der mit merge/<name>-<beschreibung> markiert ist -> 'merge/<name>-<beschreibung>' -> Delete

• Version erstellen: Alle Änderungen stagen und committen, pushen. Wenn die Version Live bei uns aufgespielt wird: Versionstag setzen.

Bugfix/Hotfix

Entwickler

1. Änderung siehe Unstable zum Mergen geben
   
2. Neuen Branch '<kürzel>-<Beschreibung>' von Version erstellen und auschecken
   
3. [Rechtsklick - Cherry-Pick] auf den Commit mit der Änderung
   

Merger

1. Neuen Branch auf das alte Versionstag erstellen und auschecken
   
2. Für alle Änderungen:
   
   1. [Rechtsklick - Cherry-Pick] auf commits mit grünen 'bugfix'-Branches
      
   2. Grüne Bugfix-Branches löschen
      
3. neues Versionstag setzen
   
4. Version erstellen...
   
5. Unstable-Branch auschecken
   
6. Bugfix-Branch löschen
   
7. Rechtsklick aufs Tag: Push to gitlab
   

Begriffe

Begriff	Erklärung	Entspricht
Repository	Verzeichnis, das mit git verwaltet wird. Im Verzeichnis liegt ein .git-Ordner, in dem die Änderungen und Einstellungen erfasst werden.
Remote	Server, auf dem ein Repository zentral verwaltet wird. Dieser kann pro Repository eingestellt werden. Es können auch mehrere Remotes für ein Repository eingerichtet werden. Auf dem Remote-Verzeichnis können verschiedene Benutzer mit unterschiedlichen Berechtigungen arbeiten.	PROGRAMM-UPDATE\OBS_SOURCE
Commit	Sourcenstand. Ein Commit besteht aus Informationen über den Autor, das Datum und Abhängigkeiten von anderen Commits. Im Commit werden die Änderungen seit dem letzten Commmit zeilengenau festgehalten.
Branch	Verweis auf ein Commit. Kann mit einem Remote-Branch verknüpft sein und durch Pull auf den Stand des Remote-Branches gebracht werden. Rote Branches sind nur lokal verfügbar, grüne Branches liegen auf dem Remote. Durch Doppelklick (Checkout) kann ein Branch aktiv gemacht werden. Dabei werden alle Dateien im Arbeitsverzeichnis durch den Stand ersetzt, der im Commit festgehalten wurde, auf das der Branch zeigt.
Checkout	Einen Branch oder Commit betreten, ändert die Dateien im Arbeitsverzeichnis auf den Stand des Commits, das ausgecheckt wird.
Tag	Verweis auf ein Commit. Kann ans Remote gepusht werden.	Version in der Updater-Liste
Fetch	Überträgt alle Änderungen vom Remote in das lokale Repository, OHNE das Veränderungen an den lokalen (roten) Branches oder dem Arbeitsverzeichnis durchgeführt werden.
Pull	Zieht die Commits aus dem Remote-Branch (grün) in den ausgecheckten lokalen (roten) Branch. Alle Commits, die übernommen werden, werden mit einem weißen Punkt davor gekennzeichnet. Die Dateien im Arbeitsverzeichnis werden auf den Stand des Commits gebracht, auf den der Remote-Branch zeigt.	Aktuelle Sourcen ziehen
Push	Überträgt den aktuell ausgecheckten Branch an Remote. Erstellt aus einem roten Branch einen grünen Branch, den alle sehen können, nach dem sie gefetcht haben.	Zum Mergen geben
Stage	Bestätigt Änderungen zeilengenau als erwünscht und markiert sie zum Übernehmen beim Committen.
Committen	Speichert alle gestageten Dateien als neuen Sourcestand in den ausgecheckten, lokalen (roten) Branch.
Amend	Macht den letzten Commit rückgängig und zieht alle Änderungen wieder in das Staging. Erlaubt es, einen Commit zu korrigieren oder zusätzliche Änderung vor dem Mergen hinzuzufügen.

Whitelist

Um Dateien zur Whitelist hinzuzufügen, muss die .gitignore-Datei bearbeitet werden, die in \dev liegt.

Mit # können darin Kommentare geschrieben werden werden.

* ist ein Platzhalter für beliebig viele Zeichen.

• 'obs/*' erlaubt alle Dateien im obs-Ordner.
• 'obs/*.pas' erlaubt alle .pas-Dateien im obs-Ordner.
• 'obs/userdb_*.sys' erlaubt alle .sys-Dateien im obs-Ordner, die mit 'userdb_' beginnen.

** ist ein Platzhalter für beliebig viele Unterverzeichnisse ('Rekursiv')

Änderungen sollten sofort nach dem Speichern als Änderugn im Working Tree sichtbar sein. Anschließend können die neuen Dateien und die .gitignore-Änderung comitted und zum Mergen gegeben werden.

Dateien, die einmal hinzugefügt wurden, müssen gelöscht werden, um ignoriert werden zu können.

Gitlab-Server

Wir verwalten unser git mit gitlab, liegt (Stand 12-2019) als Debian-VM auf dem VNode2-Host. Einwahl im RDM, Zugangsdaten sind in der Passwortverwaltung.

Dort ist gitlab-ee per apt installiert.

Zum Updaten:

sudo apt-get update
sudo apt list -a gitlab-ee
sudo apt-get install gitlab-ee=<aktuelle mittelversion>
sudo apt-get install gitalb-ee=<aktuelle major-version> 

Danach braucht der Server etwa 10 Minuten, um wieder erreichbar zu sein. Vorher gibt es http-500-Fehler.

Die gitlab-Datenbank ist eine sqlite-Datenbank, da muss also kein Server gepatcht werden.

Die Technik erstellt regelmäßig Backups von den VMs.