|
|
| Zeile 1: |
Zeile 1: |
| = 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.
| | Mit dem '''OmniSeller Setup''' installieren Sie den Upload-Service in wenigen Minuten. Das Setup führt Sie Schritt für Schritt durch die Einrichtung. |
|
| |
|
| == Systemvoraussetzungen == | | == Was Sie benötigen == |
|
| |
|
| === Hardware ===<br>* Mindestens 4 GB RAM (8 GB empfohlen)<br>* 500 MB freier Festplattenspeicher<br>* Netzwerkverbindung zum SQL Server und zu den Ziel-Shops
| | Bevor Sie beginnen, stellen Sie sicher dass: |
|
| |
|
| === Software ===<br>* Windows Server 2016 oder neuer / Windows 10 oder neuer<br>* .NET 6.0 Runtime oder neuer<br>* SQL Server 2016 oder neuer (für Sage 100 Datenbank)<br>* Sage 100 mit OmniSeller-Erweiterungen (CoreService muss installiert sein)
| | * ✅ Windows 10 oder Windows Server installiert ist<br>* ✅ Sie Administratorrechte auf dem Computer haben<br>* ✅ Sage 100 auf dem Computer oder im Netzwerk erreichbar ist<br>* ✅ Sie die Zugangsdaten für die Sage 100 Datenbank kennen<br>* ✅ Eine Internetverbindung besteht (für Download und Aktivierung) |
|
| |
|
| === Netzwerk ===<br>* Zugriff auf SQL Server (Standard: Port 1433)<br>* Ausgehende HTTPS-Verbindungen (Port 443) zu:<br>** <code>api.omnisellerservices.de</code> (OmniSeller API)<br>** Shop-URLs (je nach Konfiguration)<br>* Optional: TCP-Port 10084 für lokale Kommunikation mit dem Setup | | == Installation starten == |
|
| |
|
| == Installation ==
| | '''1.''' Starten Sie <code>OmniSeller.Setup.exe</code> |
|
| |
|
| === Schritt 1: Download ===
| | '''2.''' Bei der Erstinstallation werden Sie nach dem Installationsordner gefragt: |
|
| |
|
| Das Installationspaket kann über das OmniSeller Setup heruntergeladen werden:<br>* Automatisch über das Setup (empfohlen)<br>* Manuell: <code><nowiki>https://omniseller365.de/setups/service/OmniSeller.Upload.Service.install.zip</nowiki></code>
| | [[File:Setup_Pfadauswahl.png|400px|Installationsordner wählen]] |
|
| |
|
| === Schritt 2: Entpacken ===
| | Der Standardpfad <code>C:\OmniVersum\APPS</code> wird empfohlen. Klicken Sie auf '''OK'''. |
|
| |
|
| Das ZIP-Archiv in das gewünschte Installationsverzeichnis entpacken:<br><source lang="text"><br>C:\Program Files\OmniSeller\Upload-Service\<br></source> | | '''3.''' Das Setup öffnet sich mit dem Assistenten: |
|
| |
|
| '''Inhalt des Archivs:'''<br>* <code>OmniSeller.Upload.exe</code> – Hauptprogramm<br>* <code>*.dll</code> – Abhängigkeiten<br>* <code>licenses.txt</code> – Lizenzinformationen<br>* <code>runtimes\</code> – Plattform-spezifische Bibliotheken
| | [[File:Setup_Startseite.png|600px|Setup Startseite]] |
|
| |
|
| === Schritt 3: Erstkonfiguration === | | == Die Setup-Schritte == |
|
| |
|
| Beim ersten Start wird automatisch eine <code>OmniSeller.ini</code> erstellt. Diese muss konfiguriert werden:
| | Das Setup führt Sie durch 6 einfache Schritte. Folgen Sie einfach den Anweisungen auf dem Bildschirm. |
|
| |
|
| <source lang="ini"><br>[DatabaseSettings]<br>ConnectionString = Server=SQLSERVER;Database=OLDemoReweAbfD#;User Id=sa;Password=geheim;<br>ConnectionStringEncrypted = 0<br></source>
| | === 📦 Schritt 1: Core-Dienst installieren === |
|
| |
|
| Siehe auch: [[OmniSeller.ini Referenz]]
| | Der Core-Dienst bereitet Ihre Sage 100 Datenbank vor. |
|
| |
|
| === Schritt 4: Dienst installieren ===
| | # Klicken Sie auf '''Core-Dienst installieren'''<br># Warten Sie bis die Installation abgeschlossen ist<br># Ein grüner Haken zeigt den Erfolg an ✅ |
|
| |
|
| Den Dienst als Windows-Dienst registrieren:
| | === 🔌 Schritt 2: Datenbankverbindung einrichten === |
|
| |
|
| <source lang="cmd"><br>OmniSeller.Upload.exe install<br></source>
| | Verbinden Sie das Setup mit Ihrer Sage 100 Datenbank: |
|
| |
|
| Oder über den Schalter:<br><source lang="cmd"><br>OmniSeller.Upload.exe /INSTALLSERVICE<br></source>
| | # Klicken Sie auf '''Verbindung hinzufügen'''<br># Wählen Sie Ihren SQL Server aus der Liste<br># Wählen Sie die Sage 100 Datenbank<br># Geben Sie Benutzername und Passwort ein<br># Klicken Sie auf '''Verbindung testen'''<br># Bei Erfolg: '''Speichern''' |
|
| |
|
| '''Hinweis:''' Administrator-Rechte erforderlich!
| | [[File:Setup_Verbindung.png|500px|Datenbankverbindung einrichten]] |
|
| |
|
| === Schritt 5: Dienst starten ===
| | '''Tipp:''' Wenn Sie mehrere Sage-Mandanten haben, fügen Sie für jeden eine Verbindung hinzu. |
|
| |
|
| <source lang="cmd"><br>net start OmniSellerUpload<br></source>
| | === 📝 Schritt 3: Datenbank aktualisieren === |
|
| |
|
| Oder über die Windows-Dienstverwaltung (<code>services.msc</code>).
| | Das Setup führt automatisch alle notwendigen Datenbank-Erweiterungen aus. |
|
| |
|
| == Deinstallation ==
| | # Klicken Sie auf '''Skripte ausführen'''<br># Warten Sie bis alle Skripte durchgelaufen sind<br># Alle Einträge sollten grün sein ✅ |
|
| |
|
| === Dienst stoppen ===<br><source lang="cmd"><br>net stop OmniSellerUpload<br></source>
| | '''Bei Fehlern:''' Notieren Sie die Fehlermeldung und kontaktieren Sie den Support. |
|
| |
|
| === Dienst entfernen ===<br><source lang="cmd"><br>OmniSeller.Upload.exe uninstall<br></source> | | === 🔑 Schritt 4: OmniSeller-Konto verknüpfen === |
|
| |
|
| Oder:<br><source lang="cmd"><br>OmniSeller.Upload.exe /UNINSTALLSERVICE<br></source>
| | Verbinden Sie Ihre Installation mit Ihrem OmniSeller-Konto: |
|
| |
|
| === Dateien löschen ===<br>Das Installationsverzeichnis manuell löschen.
| | # Klicken Sie auf '''Anmelden'''<br># Geben Sie Ihre OmniSeller Zugangsdaten ein<br># Der API-Schlüssel wird automatisch eingetragen |
|
| |
|
| == Kommandozeilen-Parameter ==
| | '''Noch kein Konto?''' Klicken Sie auf '''Konto erstellen''' und folgen Sie den Anweisungen. |
|
| |
|
| Der Upload-Service unterstützt verschiedene Kommandozeilen-Parameter:
| | === 🚀 Schritt 5: Upload-Service installieren === |
|
| |
|
| === Service-Installation ===<br>{| class="wikitable"<br>! Parameter !! Beschreibung<br>|-<br>| <code>install</code> || Dienst als Windows-Service installieren<br>|-<br>| <code>uninstall</code> || Dienst deinstallieren<br>|-<br>| <code>/INSTALLSERVICE</code> || Alias für install (startet mit Admin-Rechten neu)<br>|-<br>| <code>/UNINSTALLSERVICE</code> || Alias für uninstall<br>|}
| | Jetzt wird der eigentliche Upload-Service installiert: |
|
| |
|
| === Diagnose ===<br>{| class="wikitable"<br>! Parameter !! Beschreibung<br>|-<br>| <code>/HELP</code> || Hilfe anzeigen<br>|-<br>| <code>/VERSION</code> || Versionsinformationen anzeigen<br>|-<br>| <code>/CHECKENV</code> || Umgebung prüfen (Pfade, Rechte, etc.)<br>|-<br>| <code>/TESTDB</code> || Datenbankverbindung testen<br>|-<br>| <code>/SHOWCONFIG</code> || Aktuelle Konfiguration anzeigen<br>|-<br>| <code>/CACHEINFO</code> || Cache-Statistiken anzeigen<br>|-<br>| <code>/LASTERRORS [n]</code> || Letzte n Fehler aus dem Log anzeigen (Standard: 10)<br>|}
| | # Suchen Sie in der Liste '''OmniSeller Upload-Service'''<br># Klicken Sie auf '''Installieren'''<br># Warten Sie bis die Installation abgeschlossen ist<br># Klicken Sie auf '''Starten''' |
|
| |
|
| === Wartung ===<br>{| class="wikitable"<br>! Parameter !! Beschreibung<br>|-<br>| <code>/CLEARLOGS</code> || Log-Dateien bereinigen<br>|-<br>| <code>/RESETPERSISTENCE</code> || Persistenz-Daten zurücksetzen<br>|-<br>| <code>/encrypt</code> || ConnectionString verschlüsseln<br>|}
| | [[File:Setup_Services.png|600px|Upload-Service installieren]] |
|
| |
|
| === Laufzeit ===<br>{| class="wikitable"<br>! Parameter !! Beschreibung<br>|-<br>| <code>/VERBOSE</code> || Debug-Modus aktivieren<br>|-<br>| <code>/RUNANYWAY</code> || Start erzwingen auch wenn andere Instanz läuft<br>|}
| | Der Service läuft nun im Hintergrund und überträgt Ihre Artikeldaten automatisch. |
|
| |
|
| == Verzeichnisstruktur == | | === ✅ Fertig! === |
|
| |
|
| Nach der Installation:
| | Die Installation ist abgeschlossen. Der Upload-Service:<br>* Läuft automatisch im Hintergrund<br>* Startet automatisch mit Windows<br>* Überträgt Änderungen an Ihre Online-Shops |
|
| |
|
| <source lang="text"><br>C:\Program Files\OmniSeller\Upload-Service\<br>├── OmniSeller.Upload.exe # Hauptprogramm<br>├── OmniSeller.ini # Konfiguration (wird erstellt)<br>├── *.dll # Abhängigkeiten<br>├── licenses.txt # Lizenzen<br>├── logs\ # Log-Dateien<br>│ ├── myservice.log # Aktuelles Log<br>│ └── myservice20260206.log # Archivierte Logs<br>├── preislogiclog.txt # Preis-Debug-Log (optional)<br>└── runtimes\ # Plattform-Bibliotheken<br></source>
| | == Nach der Installation == |
|
| |
|
| == Mehrere Instanzen == | | === Funktioniert alles? === |
|
| |
|
| Der Upload-Service unterstützt mehrere Instanzen für verschiedene Mandanten:
| | So prüfen Sie ob der Service läuft: |
|
| |
|
| === Instanz-Verzeichnisse ===
| | # Drücken Sie '''Windows + R'''<br># Geben Sie <code>services.msc</code> ein<br># Suchen Sie '''OmniSeller Upload-Service'''<br># Status sollte '''Wird ausgeführt''' sein |
|
| |
|
| Jede Instanz benötigt ein eigenes Verzeichnis mit eigener <code>OmniSeller.ini</code>:
| | === Einstellungen anpassen === |
|
| |
|
| <source lang="text"><br>C:\Program Files\OmniSeller\Upload-Service-Mandant1\<br>C:\Program Files\OmniSeller\Upload-Service-Mandant2\<br></source>
| | Die wichtigsten Einstellungen können Sie im Setup unter '''Schritt 2: SQL-Verbindungen''' ändern. |
|
| |
|
| === Service-Name ===
| | Für erweiterte Einstellungen siehe: [[OmniSeller.ini Referenz]] |
|
| |
|
| Jede Instanz benötigt einen eindeutigen Service-Namen. Dieser wird in der Datei <code>ServiceName.txt</code> im Instanz-Verzeichnis festgelegt:
| | == Updates == |
| | |
| <source lang="text"><br>OmniSellerUpload_Mandant1<br></source>
| |
| | |
| == Troubleshooting ==
| |
| | |
| === Dienst startet nicht ===
| |
|
| |
|
| # Prüfen ob .NET 6.0 installiert ist: <code>dotnet --info</code><br># Log-Dateien prüfen: <code>logs\myservice.log</code><br># Datenbankverbindung testen: <code>OmniSeller.Upload.exe /TESTDB</code><br># Umgebung prüfen: <code>OmniSeller.Upload.exe /CHECKENV</code>
| | Das Setup informiert Sie automatisch über verfügbare Updates: |
|
| |
|
| === Verbindungsfehler zur Datenbank ===
| | # Starten Sie das Setup<br># Gehen Sie zu '''Schritt 5: Weitere Dienste'''<br># Ist ein Update verfügbar, sehen Sie '''Aktualisieren'''<br># Klicken Sie darauf – das Update wird automatisch installiert |
| | |
| # ConnectionString in <code>OmniSeller.ini</code> prüfen<br># SQL Server erreichbar? <code>telnet SQLSERVER 1433</code><br># Firewall-Regeln prüfen<br># SQL Server-Authentifizierung aktiviert? | |
| | |
| === Keine Uploads ===
| |
| | |
| # Change Tracking aktiviert? <code>[ChangeTracking] Enabled = 1</code><br># Tracking-Optionen aktiviert? (TrackPrices, etc.)<br># Portale konfiguriert? <code>[Portal1] Enabled = 1</code><br># Preis-Debug aktivieren: <code>[Log] Pricelog = 1</code>
| |
| | |
| === Hohe CPU/Speicher-Auslastung ===
| |
| | |
| # IntervalMs erhöhen (z.B. auf 10000)<br># Cache-Einstellungen prüfen<br># Log-Dateien bereinigen: <code>/CLEARLOGS</code>
| |
| | |
| == Updates ==
| |
|
| |
|
| === Automatisch (empfohlen) === | | == Häufige Fragen == |
|
| |
|
| Das OmniSeller Setup prüft automatisch auf neue Versionen und bietet Updates an.
| | === Der SQL Server wird nicht gefunden === |
|
| |
|
| === Manuell ===
| | * Ist der SQL Server eingeschaltet?<br>* Läuft der SQL Server Browser-Dienst?<br>* Ist eine Firewall aktiv? (Port 1433 muss offen sein) |
|
| |
|
| # Dienst stoppen: <code>net stop OmniSellerUpload</code><br># Backup der <code>OmniSeller.ini</code> erstellen<br># Neue Dateien aus dem ZIP entpacken (überschreiben)<br># Dienst starten: <code>net start OmniSellerUpload</code>
| | === Der Download schlägt fehl === |
|
| |
|
| '''Hinweis:''' Die <code>OmniSeller.ini</code> wird beim Update nicht überschrieben.
| | * Prüfen Sie Ihre Internetverbindung<br>* Ist ein Proxy aktiv? Fragen Sie Ihre IT-Abteilung |
|
| |
|
| == Logging ==
| | '''Offline-Installation:''' Laden Sie die ZIP-Dateien auf einem anderen PC herunter und kopieren Sie sie nach <code>C:\temp</code>. Das Setup verwendet dann diese Dateien. |
|
| |
|
| === Standard-Log === | | === Der Dienst startet nicht === |
|
| |
|
| Pfad: <code>logs\myservice.log</code>
| | # Öffnen Sie den Ordner <code>C:\OmniVersum\APPS\OmniSeller.Upload\logs</code><br># Öffnen Sie die neueste Log-Datei<br># Die Fehlermeldung hilft bei der Diagnose |
|
| |
|
| Enthält:<br>* Start/Stop des Services<br>* Verarbeitete Artikel<br>* Fehler und Warnungen<br>* API-Kommunikation
| | === Keine Artikel werden übertragen === |
|
| |
|
| === Preis-Debug-Log === | | Prüfen Sie in der <code>OmniSeller.ini</code>:<br><source lang="ini"><br>[ChangeTracking]<br>Enabled = 1<br></source> |
|
| |
|
| Aktivieren in <code>OmniSeller.ini</code>:<br><source lang="ini"><br>[Log]<br>Pricelog = 1<br></source>
| | Muss auf <code>1</code> stehen! |
|
| |
|
| Pfad: <code>preislogiclog.txt</code>
| | == Hilfe und Support == |
|
| |
|
| Enthält detaillierte Informationen zur Preisverarbeitung.
| | Bei Problemen:<br>* 📧 E-Mail: support@omniseller.de<br>* 📞 Telefon: siehe Ihre Lizenzunterlagen<br>* 📖 Dokumentation: [[OmniSeller Dokumentation]] |
|
| |
|
| == Siehe auch == | | == Siehe auch == |
|
| |
|
| * [[OmniSeller.ini Referenz]]<br>* [[OmniSeller Upload-Service: Change Tracking]]<br>* [[OmniSeller CoreService Installation]] | | * [[OmniSeller.ini Referenz]] – Alle Einstellungen erklärt<br>* [[OmniSeller Upload-Service: Change Tracking]] – Automatische Übertragung einrichten<br>* [[OmniSeller Portal-Konfiguration]] – Shops verbinden |
|
| |
|
| [[Kategorie:OmniSeller]]<br>[[Kategorie:Upload-Service]]<br>[[Kategorie:Installation]]<br> | | [[Kategorie:OmniSeller]]<br>[[Kategorie:Erste Schritte]]<br>[[Kategorie:Installation]]<br> |
