OmniSeller Upload-Service Installation
OmniSeller Upload-Service Installation
Der OmniSeller Upload-Service ist ein Windows-Dienst, der Artikeldaten aus Sage 100 an verschiedene E-Commerce-Plattformen überträgt.
Systemvoraussetzungen
=== Hardware ===
* Mindestens 4 GB RAM (8 GB empfohlen)
* 500 MB freier Festplattenspeicher
* Netzwerkverbindung zum SQL Server und zu den Ziel-Shops
=== Software ===
* Windows Server 2016 oder neuer / Windows 10 oder neuer
* .NET 6.0 Runtime oder neuer
* SQL Server 2016 oder neuer (für Sage 100 Datenbank)
* Sage 100 mit OmniSeller-Erweiterungen (CoreService muss installiert sein)
=== Netzwerk ===
* Zugriff auf SQL Server (Standard: Port 1433)
* Ausgehende HTTPS-Verbindungen (Port 443) zu:
** <code>api.omnisellerservices.de</code> (OmniSeller API)
** Shop-URLs (je nach Konfiguration)
* Optional: TCP-Port 10084 für lokale Kommunikation mit dem Setup
Installation
Schritt 1: Download
Das Installationspaket kann über das OmniSeller Setup heruntergeladen werden:
* Automatisch über das Setup (empfohlen)
* Manuell: <code><nowiki>https://omniseller365.de/setups/service/OmniSeller.Upload.Service.install.zip</nowiki></code>
Schritt 2: Entpacken
Das ZIP-Archiv in das gewünschte Installationsverzeichnis entpacken:
<source lang="text">
C:\Program Files\OmniSeller\Upload-Service\
</source>
Inhalt des Archivs:
* <code>OmniSeller.Upload.exe</code> – Hauptprogramm
* <code>*.dll</code> – Abhängigkeiten
* <code>licenses.txt</code> – Lizenzinformationen
* <code>runtimes\</code> – Plattform-spezifische Bibliotheken
Schritt 3: Erstkonfiguration
Beim ersten Start wird automatisch eine <code>OmniSeller.ini</code> erstellt. Diese muss konfiguriert werden:
<source lang="ini">
[DatabaseSettings]
ConnectionString = Server=SQLSERVER;Database=OLDemoReweAbfD#;User Id=sa;Password=geheim;
ConnectionStringEncrypted = 0
</source>
Siehe auch: OmniSeller.ini Referenz
Schritt 4: Dienst installieren
Den Dienst als Windows-Dienst registrieren:
<source lang="cmd">
OmniSeller.Upload.exe install
</source>
Oder über den Schalter:
<source lang="cmd">
OmniSeller.Upload.exe /INSTALLSERVICE
</source>
Hinweis: Administrator-Rechte erforderlich!
Schritt 5: Dienst starten
<source lang="cmd">
net start OmniSellerUpload
</source>
Oder über die Windows-Dienstverwaltung (<code>services.msc</code>).
Deinstallation
=== Dienst stoppen ===
<source lang="cmd">
net stop OmniSellerUpload
</source>
=== Dienst entfernen ===
<source lang="cmd">
OmniSeller.Upload.exe uninstall
</source>
Oder:
<source lang="cmd">
OmniSeller.Upload.exe /UNINSTALLSERVICE
</source>
=== Dateien löschen ===
Das Installationsverzeichnis manuell löschen.
Kommandozeilen-Parameter
Der Upload-Service unterstützt verschiedene Kommandozeilen-Parameter:
=== Service-Installation ===
{| class="wikitable"
! Parameter !! Beschreibung
|-
| <code>install</code> || Dienst als Windows-Service installieren
|-
| <code>uninstall</code> || Dienst deinstallieren
|-
| <code>/INSTALLSERVICE</code> || Alias für install (startet mit Admin-Rechten neu)
|-
| <code>/UNINSTALLSERVICE</code> || Alias für uninstall
|}
=== Diagnose ===
{| class="wikitable"
! Parameter !! Beschreibung
|-
| <code>/HELP</code> || Hilfe anzeigen
|-
| <code>/VERSION</code> || Versionsinformationen anzeigen
|-
| <code>/CHECKENV</code> || Umgebung prüfen (Pfade, Rechte, etc.)
|-
| <code>/TESTDB</code> || Datenbankverbindung testen
|-
| <code>/SHOWCONFIG</code> || Aktuelle Konfiguration anzeigen
|-
| <code>/CACHEINFO</code> || Cache-Statistiken anzeigen
|-
| <code>/LASTERRORS [n]</code> || Letzte n Fehler aus dem Log anzeigen (Standard: 10)
|}
=== Wartung ===
{| class="wikitable"
! Parameter !! Beschreibung
|-
| <code>/CLEARLOGS</code> || Log-Dateien bereinigen
|-
| <code>/RESETPERSISTENCE</code> || Persistenz-Daten zurücksetzen
|-
| <code>/encrypt</code> || ConnectionString verschlüsseln
|}
=== Laufzeit ===
{| class="wikitable"
! Parameter !! Beschreibung
|-
| <code>/VERBOSE</code> || Debug-Modus aktivieren
|-
| <code>/RUNANYWAY</code> || Start erzwingen auch wenn andere Instanz läuft
|}
Verzeichnisstruktur
Nach der Installation:
<source lang="text">
C:\Program Files\OmniSeller\Upload-Service\
├── OmniSeller.Upload.exe # Hauptprogramm
├── OmniSeller.ini # Konfiguration (wird erstellt)
├── *.dll # Abhängigkeiten
├── licenses.txt # Lizenzen
├── logs\ # Log-Dateien
│ ├── myservice.log # Aktuelles Log
│ └── myservice20260206.log # Archivierte Logs
├── preislogiclog.txt # Preis-Debug-Log (optional)
└── runtimes\ # Plattform-Bibliotheken
</source>
Mehrere Instanzen
Der Upload-Service unterstützt mehrere Instanzen für verschiedene Mandanten:
Instanz-Verzeichnisse
Jede Instanz benötigt ein eigenes Verzeichnis mit eigener <code>OmniSeller.ini</code>:
<source lang="text">
C:\Program Files\OmniSeller\Upload-Service-Mandant1\
C:\Program Files\OmniSeller\Upload-Service-Mandant2\
</source>
Service-Name
Jede Instanz benötigt einen eindeutigen Service-Namen. Dieser wird in der Datei <code>ServiceName.txt</code> im Instanz-Verzeichnis festgelegt:
<source lang="text">
OmniSellerUpload_Mandant1
</source>
Troubleshooting
Dienst startet nicht
- Prüfen ob .NET 6.0 installiert ist: <code>dotnet --info</code>
# Log-Dateien prüfen: <code>logs\myservice.log</code>
# Datenbankverbindung testen: <code>OmniSeller.Upload.exe /TESTDB</code>
# Umgebung prüfen: <code>OmniSeller.Upload.exe /CHECKENV</code>
Verbindungsfehler zur Datenbank
- ConnectionString in <code>OmniSeller.ini</code> prüfen
# SQL Server erreichbar? <code>telnet SQLSERVER 1433</code>
# Firewall-Regeln prüfen
# SQL Server-Authentifizierung aktiviert?
Keine Uploads
- Change Tracking aktiviert? <code>[ChangeTracking] Enabled = 1</code>
# Tracking-Optionen aktiviert? (TrackPrices, etc.)
# Portale konfiguriert? <code>[Portal1] Enabled = 1</code>
# Preis-Debug aktivieren: <code>[Log] Pricelog = 1</code>
Hohe CPU/Speicher-Auslastung
- IntervalMs erhöhen (z.B. auf 10000)
# Cache-Einstellungen prüfen
# Log-Dateien bereinigen: <code>/CLEARLOGS</code>
Updates
Automatisch (empfohlen)
Das OmniSeller Setup prüft automatisch auf neue Versionen und bietet Updates an.
Manuell
- Dienst stoppen: <code>net stop OmniSellerUpload</code>
# Backup der <code>OmniSeller.ini</code> erstellen
# Neue Dateien aus dem ZIP entpacken (überschreiben)
# Dienst starten: <code>net start OmniSellerUpload</code>
Hinweis: Die <code>OmniSeller.ini</code> wird beim Update nicht überschrieben.
Logging
Standard-Log
Pfad: <code>logs\myservice.log</code>
Enthält:
* Start/Stop des Services
* Verarbeitete Artikel
* Fehler und Warnungen
* API-Kommunikation
Preis-Debug-Log
Aktivieren in <code>OmniSeller.ini</code>:
<source lang="ini">
[Log]
Pricelog = 1
</source>
Pfad: <code>preislogiclog.txt</code>
Enthält detaillierte Informationen zur Preisverarbeitung.