Leitfaden zur Fehlerbehebung: BarTender Print Portal
Überblick
BarTender Print Portal ist eine webbasierte Anwendung, mit der Benutzer von überall aus drucken können, indem sie auf die Website zugreifen, auf der das Print Portal gehostet wird. Die Anwendung läuft in den Internet Information Services (IIS) und basiert auf .NET Core. Dieser Artikel hilft Ihnen, sich mit einigen Komponenten vertraut zu machen und häufige Probleme zu lösen. Die Liste ist nicht vollständig, sollte Ihnen aber den Einstieg erleichtern. Dieser Leitfaden soll bei der Fehlerbehebung auf Seiten von BarTender helfen, da die Fehlerbehebung von IIS etwas außerhalb des Umfangs dieses Artikels liegt.
Gilt für
BarTender 2021 und neuer
Informationen
Um Probleme mit einer beliebigen Version des BarTender Print Portals zu beheben, stellen Sie sicher, dass Sie die neueste Version Ihrer Edition verwenden, damit Sie nicht versuchen, ein Problem zu beheben, das bereits gelöst wurde. Weitere Informationen finden Sie unter So aktualisieren Sie auf die aktuelle Revision von BarTender.
Sie sollten außerdem die IIS-Webverwaltungskonsole auf Ihrem System installiert haben. Diese Konsole finden Sie unter Windows-Features oder Server-Features. Wenn Sie Schwierigkeiten haben, die Feature-Liste zu finden, wenden Sie sich bitte an einen IT-Fachmann.
Komponenten des BarTender Print Portals
BarTender Print Portal ist auf eine Reihe von Komponenten angewiesen, darunter mehrere Dienste, die den Betrieb der Anwendung sicherstellen. Hier sind einige der wichtigsten Dienste:
- BarTender Systemdienst – verantwortlich für die Kommunikation mit der BarTender Systemdatenbank.
- BarTender Print Scheduler-Dienst – verwaltet die Druck-Engines, die im nächsten Abschnitt erwähnt werden.
- .Net/Tcp Port Sharing Service – ein Windows-Dienst, der die Kommunikation zwischen BarTender Print Portal und dem BarTender Print Scheduler für Druckaufträge unterstützt.
Neben den für den Betrieb benötigten Diensten gibt es zwei Hauptkomponenten im Detail:
Druck-Engines
Druck-Engines sind im Grunde BarTender Designer, der als Dienst läuft und je nach Bedarf dynamisch gestartet und gestoppt wird, um die Anforderungen des BarTender Print Portals zu erfüllen. Diese Druck-Engines werden vom BarTender Print Scheduler-Dienst verwaltet und benötigen keine Benutzerinteraktion.
Wenn ein Benutzer einen Druckauftrag erstellt, indem er auf die Drucken-Schaltfläche klickt, wird automatisch eine Druck-Engine gestartet, falls noch keine läuft. Sie öffnet das Dokument, verarbeitet alle vom BarTender Print Portal gesendeten Daten und sendet dann einen Druckauftrag an den Windows-Druckspooler, der den Auftrag an Ihren Drucker weiterleitet. In BarTender 2021 und neuer sind die Druck-Engines auch für die Anzeige der Etikettenvorschau zuständig.
Systemdatenbank
Die BarTender Systemdatenbank ist eine SQL-Datenbank, die hinter der gesamten BarTender Suite arbeitet. Dies kann eine lokale Datenbank sein, die über die Administrationskonsole oder den Installationsassistenten installiert wurde, oder eine zentrale Datenbank auf einem dedizierten Server.
In allen Versionen von BarTender ist die Systemdatenbank erforderlich, um das BarTender Print Portal auszuführen. Die Anwendung funktioniert ohne sie nicht.
Berechtigungen für den normalen Betrieb
BarTender Print Portal benötigt bestimmte Berechtigungen für den normalen Betrieb. Dabei handelt es sich nicht um Berechtigungen zur Steuerung des Zugriffs einzelner Benutzer, sondern um Berechtigungen, damit die Komponenten ihre Aufgaben effektiv ausführen können. Diese Berechtigungen ermöglichen es dem BarTender Print Portal Folgendes zu tun:
- Zugriff auf Etiketten, diese öffnen und drucken.
- Zugriff auf Drucker, lokal oder im Netzwerk.
- Zugriff auf die Liste der Active Directory-Benutzer und -Gruppen (für BarTender 2021 und neuer).
- Zugriff auf Librarian.
Dies ist keine vollständige Liste, deckt aber einige der wichtigsten Funktionen ab, die das BarTender Print Portal für den Betrieb benötigt. Standardmäßig läuft das BarTender Print Portal unter einem lokalen Administratorkonto, das Zugriff auf lokal installierte Drucker und das Print Portal-Verzeichnis auf Ihrem System hat. Manchmal reicht das jedoch nicht aus und Berechtigungsprüfungen schlagen fehl.
Es gibt drei Hauptpunkte, an denen Berechtigungsprobleme auftreten können: den BarTender Print Scheduler-Dienst, die IIS App Pool-Identität und das Systemdatenbank-Login.
Für den Print Scheduler-Dienst und die App Pool-Identität benötigen Sie ein Windows-Konto mit folgenden Eigenschaften:
- Lokaler Administrator sein, da Zugriff auf das Print Portal-Dateiverzeichnis benötigt wird
- Zugriff auf Domänenebene haben, wenn Sie Domänenressourcen wie Drucker oder Netzlaufwerke verwenden möchten. Es muss kein Domänenadministrator sein.
- Berechtigungen zum Lesen der Benutzer- und Gruppenliste im Active Directory haben (für BarTender 2021 und neuer)
- Das Passwort darf nicht geändert werden. Sie möchten keine Berechtigungsfehler, wenn Ihre Passwort-Richtlinie nach ein paar Monaten greift.
- Die Gruppenrichtlinie für die lokale Anmeldung besitzen. Ohne diese kann kein Dienst oder App Pool ausgeführt werden.
- Berechtigungen für den Zugriff auf die Systemdatenbank haben. Dies ist nur erforderlich, wenn Sie die Windows-Authentifizierung verwenden.
Es wird empfohlen, für den Print Scheduler und die App Pool-Identität dasselbe Konto zu verwenden. Sie können das Konto zuerst dem Dienst hinzufügen, um die Berechtigungen zu testen, da die App Pool-Identität bei fehlenden Berechtigungen oft keine Fehlermeldungen anzeigt.
Für die Systemdatenbank wird empfohlen, die SQL-Authentifizierung zu verwenden, um Berechtigungsprobleme mit der Windows-Authentifizierung zu vermeiden. Weitere Informationen finden Sie unter Berechtigungen für eine Systemdatenbank konfigurieren (Video – 5:45).
Berechtigungen für den BarTender Print Scheduler-Dienst festlegen
Um das Konto für den Print Scheduler-Dienst zu ändern, gehen Sie bitte wie folgt vor:
- Öffnen Sie die Windows-App Dienste, indem Sie danach im Startmenü suchen oder sie in der Systemsteuerung aufrufen.
- Scrollen Sie nach unten zum BarTender Print Scheduler-Dienst.
- Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie Eigenschaften.
- Klicken Sie auf die Registerkarte Anmelden.
- Wählen Sie Dieses Konto und geben Sie Benutzername und Passwort ein. Denken Sie daran, den Domänennamen hinzuzufügen, sonst versucht der Dienst, mit einem lokalen Konto zu starten.
- Nachdem Sie die Zugangsdaten eingegeben haben, klicken Sie auf OK und bestätigen Sie die Hinweise zum Kontowechsel.
- Klicken Sie mit der rechten Maustaste auf den BarTender Print Scheduler-Dienst und wählen Sie Neu starten, um den Dienst unter dem neuen Konto neu zu starten.
Wenn beim Starten Fehler auftreten, überprüfen Sie, ob das Konto alle im vorherigen Abschnitt aufgeführten Berechtigungen hat, und wiederholen Sie die Schritte gegebenenfalls.
Berechtigungen für die IIS App Pool-Identität festlegen
Um das Konto für die IIS App Pool-Identität zu ändern, gehen Sie bitte wie folgt vor:
- Starten Sie den Internet Information Services (IIS) Manager.
- Klicken Sie auf den Pfeil neben Ihrem Servernamen, um die Baumstruktur zu öffnen.
- Klicken Sie auf Anwendungspools.
- Klicken Sie mit der rechten Maustaste auf BPP_AppPool und wählen Sie Erweiterte Einstellungen.
- Scrollen Sie nach unten und suchen Sie die Einstellung Identität. Der Wert ist wahrscheinlich fett markiert, da eine benutzerdefinierte lokale Identität von BarTender erstellt wurde.
- Klicken Sie auf Identität und dann auf die Schaltfläche mit den Auslassungspunkten [...] rechts daneben. Dadurch öffnet sich das Einstellungsdialogfeld.
- Klicken Sie auf die Schaltfläche Festlegen.
- Geben Sie den vollständigen Benutzernamen und das Passwort ein. Denken Sie daran, den Domänennamen hinzuzufügen, damit der App Pool weiß, dass ein Domänenbenutzer verwendet werden soll.
- Klicken Sie auf OK und schließen Sie alle Dialoge, um zum IIS-Manager zurückzukehren.
- Mit weiterhin ausgewähltem BPP_AppPool klicken Sie im rechten Menü auf Anhalten und dann auf Starten. Dadurch wird der App Pool mit dem neuen Konto neu gestartet.
Wenn Fehlermeldungen erscheinen, überprüfen Sie, ob die eingegebenen Zugangsdaten korrekt sind und das Konto alle Anforderungen aus dem vorherigen Abschnitt erfüllt.
Kompatibilität
Damit das BarTender Print Portal reibungslos läuft, muss es auf einem kompatiblen Betriebssystem ausgeführt werden. Eine Liste der unterstützten Betriebssysteme und Versionen finden Sie hier: Von BarTender unterstützte Windows-Versionen. Wenn Sie das BarTender Print Portal auf einem nicht kompatiblen Betriebssystem ausführen, zum Beispiel BarTender 2021 auf Windows Server 2008, können Dienste und Druck-Engines möglicherweise nicht richtig laufen und es kann zu Abstürzen oder unregelmäßigem Verhalten beim Drucken kommen. Um dies zu vermeiden, prüfen Sie die Liste vor der Installation des BarTender Print Portals.
Es wird außerdem empfohlen, die Bit-Version von BarTender an die Bit-Version des Betriebssystems anzupassen. Wenn Sie Windows 64-Bit verwenden, installieren Sie auch die 64-Bit-Version von BarTender. So stellen Sie die Kompatibilität mit IIS und den BarTender-Diensten sicher und sorgen dafür, dass die Druck-Engines effizient laufen.
Fehlerbehebung für BarTender 2021 und neuer
Klicken Sie auf das Symptom oder die Fehlermeldung, um den Abschnitt mit den Schritten zur Fehlerbehebung anzuzeigen.
Print Scheduler konnte nicht erreicht werden
BarTender Print Portal ist auf den BarTender Print Scheduler-Dienst angewiesen, um Vorschaubilder zu erstellen, Druckvorschauen zu generieren und Druckaufträge auszuführen. Wenn das Print Portal den Dienst nicht erreichen kann, sehen Sie möglicherweise eine Fehlermeldung wie diese:
Für diesen Fehler gibt es verschiedene Gründe, zum Beispiel wurde der Dienst per Kommandozeile oder in der Dienste-Verwaltung gestoppt, das Konto, unter dem der Dienst läuft, hat sein Passwort geändert oder etwas hat die Kommunikation gestört.
Um den Dienst wieder zum Laufen zu bringen, gehen Sie bitte wie folgt vor:
- Starten Sie die Dienste-Verwaltung, indem Sie danach im Startmenü suchen.
- Scrollen Sie zum BarTender Print Scheduler-Dienst.
- Wenn der Dienst gestoppt ist, klicken Sie mit der rechten Maustaste darauf und wählen Sie Starten. Wenn der Dienst läuft, klicken Sie mit der rechten Maustaste und wählen Sie Neu starten.
Wenn Sie eine Fehlermeldung bezüglich eines falschen Benutzernamens oder Passworts erhalten, siehe Berechtigungen für den BarTender Print Scheduler-Dienst festlegen
Wenn weiterhin Probleme auftreten, auch nachdem Sie alle diese Schritte ausprobiert haben, überprüfen Sie die Kompatibilität zwischen Ihrem Betriebssystem und der BarTender-Version. Wenn Sie eine nicht unterstützte Kombination verwenden, können Anwendung und Dienste Schwierigkeiten bei der Kommunikation haben. Weitere Informationen finden Sie im Kompatibilitätsabschnitt.
Druckauftrag abgebrochen: Datei konnte nicht geöffnet, gelesen oder zugegriffen werden
Diese Fehlermeldung ist eine Art Sammelmeldung für Dateifehler und bezieht sich in der Regel auf zwei Dinge: Berechtigungen oder fehlende verknüpfte Dateien. Hier ein Beispiel und wie Sie diese Fehlermeldung interpretieren können:
- Neben Druckauftrag abgebrochen steht die Bedingung, die den Fehler verursacht hat. In diesem Beispiel ist es ein Datensatz, also eine verknüpfte Datenbank. Die Etikettendatei hat also Probleme beim Öffnen der Datenbank.
- In der zweiten Zeile steht, was nicht geöffnet werden konnte. In diesem Fall ist es eine CSV-Datenbank.
- Die dritte Zeile gibt kurz an, was das Problem ist. Hier konnte die Datei oder der definierte Ordner nicht gefunden werden.
Diese Fehlermeldung bedeutet also, dass die Datei am im Etikettendokument angegebenen Speicherort nicht existiert oder der Print Scheduler-Dienst keine Berechtigung hat, auf das Verzeichnis zuzugreifen, sodass die Datei als fehlend erscheint.
Wenn Sie auf solche Fehler stoßen, öffnen Sie zunächst die Etikettendatei.
- Erscheinen Fehlermeldungen?
- Können Sie die Datenbank im Daten-Setup-Dialog durchsuchen oder wird angezeigt, dass keine Verbindung zur Datenbank hergestellt werden kann?
- Fehlen Bilder und werden durch rote Xs angezeigt?
- Können Sie das Etikett aus BarTender Designer drucken oder erscheinen Fehlermeldungen?
Wenn eines dieser Probleme auftritt, müssen Sie es beheben, bevor Sie dieses Etikett drucken können.
Wenn das Etikett problemlos gedruckt wird, liegt möglicherweise ein Berechtigungsproblem vor. Wenn der Print Scheduler-Dienst keine der verknüpften Ressourcen wie Bilder oder Datenbanken erreichen kann, um den Auftrag korrekt zu drucken, erscheint ebenfalls diese Fehlermeldung. Wie Sie das Problem beheben, erfahren Sie im Abschnitt zu Berechtigungen.
Benutzer- oder Gruppenliste erscheint leer beim Festlegen von Berechtigungen
Wenn Sie versuchen, Berechtigungen für Ordner im BarTender Print Portal festzulegen, erscheint Ihr Dialogfeld leer, wenn Sie als Speicherort die Domäne auswählen, wie im Screenshot unten:
Das bedeutet, dass das BarTender Print Portal die Active Directory-Benutzer und -Gruppen nicht abrufen konnte. Es hat keine Berechtigung dazu. Um das zu beheben, müssen Sie ein Konto im IIS App Pool hinterlegen, das Berechtigungen zum Lesen der Active Directory-Liste hat. In der Regel reicht ein Domänenkonto. Sprechen Sie mit Ihrer IT, wenn Sie Fragen dazu haben, ob Ihr Konto die Liste lesen kann.
Um das IIS App Pool-Konto zu ändern, folgen Sie bitte dieser Anleitung.
Nicht alle Benutzer oder Gruppen werden in der Domänenliste angezeigt
Auch wenn Sie ein Domänenkonto zum IIS App Pool hinzugefügt haben, kann es vorkommen, dass Benutzer und Gruppen zufällig in der Liste fehlen.
Es gab ein Problem, bei dem BarTender Print Portal nicht in der Lage war, eine vollständige Liste aus einem sehr großen Active Directory mit zehntausenden oder mehr Einträgen abzurufen. Bitte aktualisieren Sie auf BarTender 2021 R5 oder neuer, um dieses Problem zu beheben.
Es wurden keine Stammordner konfiguriert
Nachdem Sie die Sicherheit für einzelne Ordner konfiguriert haben, erhalten Sie oder Ihre Benutzer beim Durchsuchen des Print Portals möglicherweise eine Fehlermeldung wie diese:
Dies kann eine berechtigte Fehlermeldung sein, wenn es keine Ordner gibt, die der Benutzer sehen darf.
Wenn jedoch ein bestimmter Benutzer Berechtigungen für einen Ordner hat und Sie trotzdem diese Fehlermeldung sehen, kann dies verschiedene Ursachen haben:
App Pool-Berechtigungen
Beim Überprüfen, ob ein Benutzer Berechtigungen für einen Ordner hat, fragt BarTender Print Portal das Active Directory, zu welchen Gruppen der Benutzer gehört. Schlägt diese Überprüfung fehl, wird dem Benutzer standardmäßig der Zugriff verweigert. Die Überprüfung hängt von der Identität des App Pools ab und kann fehlschlagen, wenn das Passwort geändert oder das Konto entfernt wurde oder Ähnliches passiert ist.
Wenn das Problem an fehlenden Berechtigungen liegt, versuchen Sie, das Passwort für die Identität erneut einzugeben oder ein Konto zu verwenden, das Berechtigungen für die Kommunikation mit dem Active Directory hat. Weitere Informationen finden Sie im Abschnitt zu Berechtigungen.
Falscher Gruppentyp
Im Active Directory gibt es verschiedene Gruppentypen mit unterschiedlichen Zwecken. Für die Authentifizierung sollten Sie nur eine Gruppe vom Typ "Sicherheit" auswählen. Wird stattdessen eine andere Gruppe wie z. B. eine Verteilergruppe für E-Mail-Verteilerlisten gewählt, schlägt die Überprüfung mit dem Active Directory fehl.
Wenn die App Pool-Identität korrekt ist, aber Gruppen trotzdem keine gültigen Benutzer anzeigen, aktualisieren Sie BarTender, damit nur Sicherheitsgruppen in der Liste angezeigt werden. Nach dem Update konfigurieren Sie die Ordnerberechtigungen im BarTender Print Portal neu.
Print Portal reagiert nicht beim Navigieren durch Ordner
Beim Navigieren durch Ordner im Print Portal scheint die Anwendung nicht mehr zu reagieren. Dies passiert, wenn es ein Problem mit der Verbindung zur Systemdatenbank gibt. Es gibt verschiedene Gründe, warum keine Verbindung zur Systemdatenbank besteht:
- Der Datenbank-Host ist offline
- Die Datenbank existiert nicht mehr
- Die Systemdatenbank wurde nicht eingerichtet
- Der aktuelle Benutzer hat keine Berechtigung zur Verbindung
Verbindungsprobleme
Da ein Großteil der BarTender Suite auf die Systemdatenbank angewiesen ist, sollten Sie zuerst in der Administration Console nachsehen, wo die Verbindung eingerichtet wird. Gehen Sie dazu wie folgt vor:
- Öffnen Sie die Administration Console über das Startmenü.
- Wechseln Sie im linken Menü zu Systemdatenbank.
- Überprüfen Sie die Angaben im oberen Bereich des rechten Fensters.
Eine funktionierende Datenbankverbindung zeigt den Status "Verbunden" an. Wenn Sie einen anderen Status, fehlende Daten oder einen Hinweis sehen, dass keine Systemdatenbank eingerichtet ist, verwenden Sie den Link zum Systemdatenbank-Assistenten, um Ihre Datenbankverbindung zu konfigurieren und eine Datenbank einzurichten. Hier finden Sie eine Anleitung für diesen Prozess. Es wird dringend empfohlen, SQL-Authentifizierung zu verwenden, um das nächste große Problem – Berechtigungen – zu vermeiden. Dieses Video zeigt Ihnen, wie Sie dies in einer neuen Datenbank einrichten. Wenn Ihre Datenbank verwaltet wird, wenden Sie sich bitte an Ihren Datenbankadministrator.
Berechtigungsprobleme
Wenn die Administration Console den Status "Verbunden" anzeigt, Sie aber weiterhin eine Systemdatenbank-Fehlermeldung im BarTender Print Portal erhalten, handelt es sich wahrscheinlich um ein Berechtigungsproblem. Unabhängig von der Authentifizierungsmethode (Windows oder SQL) benötigt ein Konto sechs grundlegende Berechtigungen für den ordnungsgemäßen Betrieb. Fehlt eine dieser sechs Berechtigungen, ist der normale Betrieb eingeschränkt und es kann sogar angezeigt werden, dass keine Verbindung zur Systemdatenbank besteht.
Überprüfen Sie zunächst, welches Konto für die Verbindung zur Systemdatenbank verwendet wird. Gehen Sie dazu wie folgt vor:
- Öffnen Sie die Administration Console.
- Wählen Sie im linken Menü Systemdatenbank.
- Klicken Sie auf Systemdatenbank-Assistent.
- Wählen Sie Verbindungseinstellungen anpassen. Auf dem nächsten Bildschirm wird die Authentifizierungsmethode angezeigt.
- Wenn SQL-Authentifizierung verwendet wird, notieren Sie sich den Kontonamen im Dialogfeld.
- Wenn Windows-Authentifizierung verwendet wird, notieren Sie sich den Namen des Kontos, das den IIS App Pool ausführt.
Nachdem Sie den Kontonamen haben, können Sie mit dieser Anleitung überprüfen, ob Ihr Konto alle erforderlichen Berechtigungen hat. Wenn Sie nicht wissen, wie das geht, oder Ihre Datenbank verwaltet wird, wenden Sie sich bitte an Ihren Datenbankadministrator und teilen Sie ihm mit, dass Sie diese sechs grundlegenden Berechtigungen benötigen.
Ein unbekannter Fehler ist aufgetreten
Beim Versuch zu drucken, kann ein unbekannter Fehler wie dieser auftreten:
Dies ist eine allgemeine Fehlermeldung, die angezeigt wird, wenn kein anderer Fehlertext zur Verfügung steht. Häufig hängt dies mit einem Problem am Etikett oder an einer mit dem Etikett verbundenen Ressource zusammen. Bei einer solchen allgemeinen Fehlermeldung sollten Sie das Etikett selbst überprüfen, um die Ursache zu finden.
Verknüpfte Ressourcen
Die häufigste Ursache sind fehlende Ressourcen. Öffnen Sie das Etikett und prüfen Sie es.
- Erscheinen beim Öffnen Fehlermeldungen?
- Können Sie im Dialogfeld "Datenquellen einrichten" die Datenbank durchsuchen oder wird angezeigt, dass keine Verbindung zur Datenbank besteht?
- Fehlen Bilder und werden durch rote X-Symbole angezeigt?
- Können Sie das Etikett in BarTender Designer drucken oder erscheinen Fehlermeldungen?
Wenn eines dieser Probleme auftritt, müssen Sie es beheben, bevor Sie das Etikett drucken können.
Wenn das Etikett problemlos gedruckt wird, könnte es sich um ein Berechtigungsproblem handeln. Wenn der Print Scheduler-Dienst keine der verknüpften Ressourcen wie Bilder oder Datenbanken abrufen kann, um den Druckauftrag korrekt auszuführen, erscheint ebenfalls diese Fehlermeldung. Wie Sie das Problem beheben, erfahren Sie im Abschnitt zu Berechtigungen.
Verknüpfte Datenbanken
Datenbanken, die mit einem Etikett verknüpft sind, können etwas komplizierter sein, da hier mehrere Faktoren eine Rolle spielen. Beim Herstellen einer Verbindung zu einer Datenbank im Print Portal wird entweder das Konto des IIS App Pools (bei Windows-Authentifizierung) oder die im Etikett gespeicherten Zugangsdaten (bei Datenbank-Authentifizierung) verwendet. Textdatenbanken geben meist Dateifehler aus, wenn die Verbindung fehlschlägt, daher bezieht sich dieser Abschnitt eher auf relationale Datenbanken.
Hier sind einige mögliche Ursachen für einen Datenbankfehler:
- Die Datenbank wurde verschoben oder umbenannt
- Die Datenbank ist offline
- Die ODBC-Verbindung ist als User-DSN statt als System-DSN eingerichtet
- Die für die Verbindung benötigten Zugangsdaten sind nicht im Etikett gespeichert.
- Die Datenbank verwendet Windows-Authentifizierung und der aktuelle Benutzer, der BarTender Print Portal ausführt, ist nicht berechtigt, auf die Datenbank zuzugreifen.
Da es viele verschiedene Datenbanktypen und Verbindungen gibt, ist dies keine vollständige Liste und nicht jede Option passt zu jeder Datenbankverbindung. Am besten öffnen Sie das Etikett, prüfen den Verbindungstyp und gehen von dort aus weiter vor.
- Öffnen Sie den Datenbank-Dialog über Datei > Datenbankverbindung einrichten.
- Wenn beim Öffnen des Dialogs oder beim Durchsuchen der Datensätze ein Verbindungsfehler auftritt, wurde die Datenbank wahrscheinlich verschoben, umbenannt, ist offline oder aus einem anderen Grund nicht verfügbar. Sie müssen die Datenbank finden und prüfen, ob sie verfügbar und online ist. Wenn Ihre Datenbank verwaltet wird, wenden Sie sich an Ihren Datenbankadministrator.
- Im Dialogfeld "Datenbank einrichten" klicken Sie auf den Datenbank-Setup-Assistenten und prüfen die Verbindungsdetails.
- Wird die Verbindung über Windows-Authentifizierung oder Datenbank-Authentifizierung hergestellt?
- Sind die Zugangsdaten im Dokument gespeichert (bei Datenbank-Authentifizierung)?
- Sind die Zugangsdaten korrekt?
- Wenn Sie eine ODBC-Verbindung verwenden, prüfen Sie die DSN-Konfigurationen.
Nachdem Sie alle Fehler behoben, die Authentifizierung überprüft und die Zugangsdaten im Dokument gespeichert haben (außer bei Windows-Authentifizierung), speichern Sie das Dokument und legen Sie es wieder im Print Portal-Ordner ab.
Überblick
BarTender Print Portal ist eine webbasierte Anwendung, mit der Benutzer von überall aus drucken können, indem sie die Website aufrufen, auf der das Print Portal gehostet wird. Die Anwendung läuft in den Internet Information Services (IIS) und basiert auf .NET Core. Dieser Artikel hilft Ihnen, sich mit einigen Komponenten vertraut zu machen und häufige Probleme zu lösen. Die Liste ist nicht vollständig, sollte Ihnen aber den Einstieg erleichtern. Dieser Leitfaden soll bei der Fehlerbehebung auf Seiten von BarTender helfen, da die Fehlerbehebung von IIS nicht im Fokus dieses Artikels steht.
Gilt für
BarTender 2016 und 2019
Informationen
Um Probleme mit einer beliebigen Version des BarTender Print Portals zu beheben, stellen Sie sicher, dass Sie die neueste Version Ihrer Edition verwenden, damit Sie nicht versuchen, ein Problem zu beheben, das bereits gelöst wurde. Weitere Informationen finden Sie unter So aktualisieren Sie auf die aktuelle Revision von BarTender.
Sie sollten außerdem die IIS-Webverwaltungskonsole auf Ihrem System installiert haben. Diese Konsole finden Sie unter Windows-Features oder Server-Features. Wenn Sie die Feature-Liste nicht finden, wenden Sie sich bitte an einen IT-Fachmann.
Komponenten des BarTender Print Portals
BarTender Print Portal ist auf verschiedene Komponenten angewiesen, darunter mehrere Dienste, die den Betrieb der Anwendung sicherstellen. Hier sind einige der wichtigsten Dienste:
- BarTender Systemdienst – verantwortlich für die Kommunikation mit der BarTender-Systemdatenbank
- BarTender Print Scheduler-Dienst – verwaltet die Druck-Engines, die im nächsten Abschnitt erwähnt werden
- .Net/Tcp Port Sharing Service – ein Windows-Dienst, der die Kommunikation zwischen BarTender Print Portal und BarTender Print Scheduler für Druckaufträge unterstützt
Neben den für den Betrieb benötigten Diensten gibt es zwei Hauptkomponenten im Detail:
Druck-Engines
Druck-Engines sind im Grunde BarTender Designer, der als Dienst läuft und je nach Bedarf dynamisch gestartet und gestoppt wird, um die Anforderungen des BarTender Print Portals zu erfüllen. Diese Druck-Engines werden vom BarTender Print Scheduler-Dienst verwaltet und benötigen keine Benutzerinteraktion.
Wenn ein Benutzer einen Druckauftrag erstellt, indem er auf die Drucken-Schaltfläche klickt, wird automatisch eine Druck-Engine gestartet, falls noch keine läuft. Sie öffnet das Dokument, verarbeitet alle vom BarTender Print Portal gesendeten Daten und sendet dann einen Druckauftrag an den Windows-Druckspooler, der den Auftrag an Ihren Drucker weiterleitet. Ab BarTender 2021 sind die Druck-Engines auch für die Anzeige der Etikettenvorschau zuständig.
Systemdatenbank
Die BarTender-Systemdatenbank ist eine SQL-Datenbank, die hinter der gesamten BarTender Suite arbeitet. Dies kann eine lokale Datenbank sein, die über die Administrationskonsole oder den Installationsassistenten eingerichtet wurde, oder eine zentrale Datenbank auf einem dedizierten Server.
In allen Versionen von BarTender ist die Systemdatenbank erforderlich, um das BarTender Print Portal auszuführen. Ohne sie funktioniert die Anwendung nicht.
Berechtigungen für den normalen Betrieb
BarTender Print Portal benötigt bestimmte Berechtigungen für den normalen Betrieb. Dabei handelt es sich nicht um Berechtigungen zur Steuerung des Zugriffs einzelner Benutzer, sondern um Berechtigungen, damit die Komponenten ihre Aufgaben ordnungsgemäß ausführen können. Diese Berechtigungen ermöglichen es dem BarTender Print Portal Folgendes zu tun:
- Zugriff auf Etiketten, diese öffnen und drucken
- Zugriff auf Drucker, lokal oder im Netzwerk
- Zugriff auf die Liste der Active Directory-Benutzer und -Gruppen (für BarTender 2021 und neuer)
- Zugriff auf Librarian
Dies ist keine vollständige Liste, deckt aber einige der wichtigsten Funktionen ab, die das BarTender Print Portal für den Betrieb benötigt. Standardmäßig läuft das BarTender Print Portal unter einem lokalen Administratorkonto, das Zugriff auf lokal installierte Drucker und das Print Portal-Verzeichnis auf Ihrem System hat. Manchmal reicht das jedoch nicht aus und Berechtigungsprüfungen schlagen fehl.
Es gibt drei Hauptpunkte, an denen Berechtigungsprobleme auftreten können: den BarTender Print Scheduler-Dienst, die IIS App Pool-Identität und das Systemdatenbank-Login.
Für den Print Scheduler-Dienst und die App Pool-Identität benötigen Sie ein Windows-Konto mit folgenden Eigenschaften:
- Lokaler Administrator sein, da Zugriff auf das Print Portal-Dateiverzeichnis benötigt wird
- Zugriff auf Domänenebene haben, wenn Sie Domänenressourcen wie Drucker oder Netzlaufwerke nutzen möchten. Es muss kein Domänenadministrator sein.
- Das Passwort darf sich nicht ändern. Sie möchten keine Berechtigungsfehler, wenn Ihre Passwort-Richtlinie nach ein paar Monaten greift.
- Die Berechtigung für die lokale Anmeldung in der Gruppenrichtlinie besitzen. Ohne diese kann kein Dienst oder App Pool ausgeführt werden.
- Berechtigungen für den Zugriff auf die Systemdatenbank haben. Dies ist nur erforderlich, wenn Sie Windows-Authentifizierung verwenden.
Es wird empfohlen, für den Print Scheduler und die App Pool-Identität dasselbe Konto zu verwenden. Sie können das Konto zuerst dem Dienst hinzufügen, um die Berechtigungen zu testen, da die App Pool-Identität bei fehlenden Berechtigungen oft keine Fehlermeldungen anzeigt.
Für die Systemdatenbank empfiehlt es sich, die SQL-Authentifizierung zu verwenden, um Berechtigungsprobleme mit der Windows-Authentifizierung zu vermeiden. Weitere Informationen finden Sie unter Berechtigungen für eine Systemdatenbank konfigurieren (Video – 5:45).
Berechtigungen für den BarTender Print Scheduler-Dienst festlegen
Um das Konto für den Print Scheduler-Dienst zu ändern, gehen Sie bitte wie folgt vor:
- Öffnen Sie die Windows-App Dienste, indem Sie danach im Startmenü suchen oder sie in der Systemsteuerung aufrufen.
- Scrollen Sie nach unten zum BarTender Print Scheduler-Dienst.
- Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie Eigenschaften.
- Klicken Sie auf die Registerkarte Anmelden.
- Wählen Sie Dieses Konto und geben Sie Benutzername und Passwort ein. Denken Sie daran, den Domänennamen hinzuzufügen, sonst versucht der Dienst, mit einem lokalen Konto zu starten.
- Nachdem Sie die Zugangsdaten eingegeben haben, klicken Sie auf OK und bestätigen Sie die Hinweise zum Kontowechsel.
- Klicken Sie mit der rechten Maustaste auf den BarTender Print Scheduler-Dienst und wählen Sie Neu starten, um den Dienst unter dem neuen Konto neu zu starten.
Wenn beim Starten Fehler auftreten, überprüfen Sie, ob das Konto alle im vorherigen Abschnitt genannten Berechtigungen hat, und wiederholen Sie die Schritte gegebenenfalls.
Berechtigungen für die IIS App Pool-Identität festlegen
Um das Konto für die IIS App Pool-Identität zu ändern, gehen Sie bitte wie folgt vor:
- Starten Sie den Internet Information Services (IIS) Manager.
- Klicken Sie auf den Pfeil neben Ihrem Servernamen, um die Baumstruktur zu öffnen.
- Klicken Sie auf Anwendungspools.
- Klicken Sie mit der rechten Maustaste auf BPP_AppPool und wählen Sie Erweiterte Einstellungen.
- Scrollen Sie nach unten und suchen Sie die Einstellung Identität. Der Wert ist wahrscheinlich fett markiert, da eine benutzerdefinierte lokale Identität von BarTender erstellt wurde.
- Klicken Sie auf Identität und dann auf die Schaltfläche mit den Auslassungspunkten [...] rechts daneben. Dadurch öffnet sich das Einstellungsdialogfeld.
- Klicken Sie auf die Schaltfläche Festlegen.
- Geben Sie den vollständigen Benutzernamen und das Passwort ein. Denken Sie daran, den Domänennamen hinzuzufügen, damit der App Pool weiß, dass ein Domänenbenutzer verwendet werden soll.
- Klicken Sie auf OK und schließen Sie alle Dialoge, um zum IIS-Manager zurückzukehren.
- Mit ausgewähltem BPP_AppPool klicken Sie rechts auf Anhalten und dann auf Starten. Dadurch wird der App Pool mit dem neuen Konto neu gestartet.
Wenn Fehlermeldungen erscheinen, überprüfen Sie, ob die eingegebenen Zugangsdaten korrekt sind und das Konto alle Anforderungen aus dem vorherigen Abschnitt erfüllt.
Kompatibilität
Damit das BarTender Print Portal reibungslos läuft, muss es auf einem kompatiblen Betriebssystem ausgeführt werden. Eine Liste der unterstützten Betriebssysteme und Versionen finden Sie hier: Von BarTender unterstützte Windows-Versionen. Wenn Sie das BarTender Print Portal auf einem nicht kompatiblen Betriebssystem ausführen, funktionieren Dienste und Druck-Engines möglicherweise nicht richtig und es kann zu Abstürzen oder unregelmäßigem Verhalten beim Drucken kommen. Um dies zu vermeiden, prüfen Sie die Liste vor der Installation des BarTender Print Portals.
Es wird außerdem empfohlen, die Bit-Version von BarTender an die Bit-Version des Betriebssystems anzupassen. Wenn Sie Windows 64-Bit verwenden, installieren Sie auch BarTender 64-Bit. So stellen Sie die Kompatibilität mit IIS und den BarTender-Diensten sicher und sorgen dafür, dass die Druck-Engines effizient laufen.
Fehlerbehebung für BarTender 2016 & 2019
Klicken Sie auf eine Fehlermeldung, um den Abschnitt mit den Schritten zur Fehlerbehebung anzuzeigen
Kein Zugriff auf die BarTender-Systemdatenbank möglich
BarTender Print Portal ist für verschiedene Vorgänge auf die Systemdatenbank angewiesen. Wenn Verbindungsprobleme auftreten, sehen Sie eine Meldung wie diese:
Es gibt einige Gründe, warum keine Verbindung zur Systemdatenbank besteht:
- Der Datenbank-Host ist offline.
- Die Datenbank existiert nicht mehr.
- Die Systemdatenbank wurde nicht eingerichtet.
- Der aktuelle Benutzer hat keine Berechtigung zur Verbindung.
Verbindungsprobleme
Da ein Großteil der BarTender Suite auf die Systemdatenbank angewiesen ist, empfiehlt es sich, in der Administrationskonsole zu beginnen, wo die Verbindung eingerichtet wird. Gehen Sie dazu wie folgt vor:
- Öffnen Sie die Administrationskonsole über das Startmenü.
- Wechseln Sie im linken Menü zu Systemdatenbank.
- Überprüfen Sie die Angaben im oberen Bereich des rechten Fensters.
Eine funktionierende Datenbankverbindung zeigt den Status „Verbunden“ an. Wenn Sie einen anderen Status, fehlende Daten oder einen Hinweis sehen, dass keine Systemdatenbank eingerichtet ist, verwenden Sie den Link zum Systemdatenbank-Assistenten, um Ihre Datenbankverbindung zu konfigurieren und eine Datenbank einzurichten. Hier finden Sie eine Anleitung für diesen Prozess. Es wird dringend empfohlen, die SQL-Authentifizierung zu verwenden, um das nächste große Problem – Berechtigungen – zu vermeiden. Dieses Video zeigt Ihnen, wie Sie dies in einer neuen Datenbank einrichten. Wenn Ihre Datenbank verwaltet wird, wenden Sie sich bitte an Ihren Datenbankadministrator.
Berechtigungsprobleme
Wenn die Administrationskonsole den Status „Verbunden“ anzeigt, Sie aber im BarTender Print Portal weiterhin eine Systemdatenbank-Fehlermeldung erhalten, handelt es sich wahrscheinlich um Berechtigungsprobleme. Unabhängig von der Authentifizierungsmethode (Windows oder SQL) benötigt ein Konto sechs grundlegende Berechtigungen für den ordnungsgemäßen Betrieb. Fehlt eine dieser sechs Berechtigungen, ist der normale Betrieb eingeschränkt und es kann sogar angezeigt werden, dass keine Verbindung zur Systemdatenbank besteht.
Prüfen Sie zunächst, welches Konto für die Verbindung zur Systemdatenbank verwendet wird. Gehen Sie dazu wie folgt vor:
- Öffnen Sie die Administrationskonsole.
- Wählen Sie im linken Menü Systemdatenbank.
- Klicken Sie auf Systemdatenbank-Assistent.
- Wählen Sie Verbindungseinstellungen anpassen. Auf dem nächsten Bildschirm wird die Authentifizierungsmethode angezeigt.
- Wenn die Methode SQL-Authentifizierung ist, notieren Sie den im Dialogfeld angegebenen Kontonamen.
- Wenn die Methode Windows-Authentifizierung ist, notieren Sie den Namen des Kontos, das den IIS App Pool ausführt.
Nachdem Sie den Kontonamen haben, können Sie mit dieser Anleitung überprüfen, ob Ihr Konto alle erforderlichen Berechtigungen besitzt. Wenn Sie nicht wissen, wie das geht, oder Ihre Datenbank verwaltet wird, wenden Sie sich bitte an Ihren Datenbankadministrator und teilen Sie ihm mit, dass Sie diese sechs grundlegenden Berechtigungen benötigen.
Verbindung zum BarTender Print Scheduler-Dienst fehlgeschlagen
BarTender Print Portal ist auf den BarTender Print Scheduler-Dienst angewiesen, um Druckvorschauen zu erstellen und einen Druckauftrag auszuführen. Wenn Print Portal den Dienst nicht erreichen kann, um ihn zu nutzen, kann eine Fehlermeldung wie diese erscheinen:
Für diesen Fehler gibt es verschiedene Ursachen, zum Beispiel wurde der Dienst über die Kommandozeile oder in der Dienste-Verwaltung gestoppt, das Konto, das den Dienst ausführt, hat sein Passwort geändert, oder etwas hat die Kommunikation gestört.
Um den Dienst wieder zum Laufen zu bringen, gehen Sie bitte wie folgt vor:
- Öffnen Sie die Dienste-Verwaltung, indem Sie danach im Startmenü suchen oder sie in der Systemsteuerung aufrufen.
- Scrollen Sie nach unten zum Dienst „BarTender Print Scheduler“.
- Wenn der Dienst gestoppt ist, klicken Sie mit der rechten Maustaste darauf und wählen Sie Starten. Wenn der Dienst bereits läuft, klicken Sie mit der rechten Maustaste und wählen Sie Neu starten.
Wenn Sie eine Fehlermeldung bezüglich eines falschen Benutzernamens oder Passworts erhalten, lesen Sie bitte BarTender Print Scheduler Service-Berechtigungen festlegen
Wenn weiterhin Probleme auftreten, auch nachdem Sie alle diese Schritte ausprobiert haben, überprüfen Sie die Kompatibilität zwischen Ihrem Betriebssystem und der BarTender-Version. Bei einer inkompatiblen Kombination kann es zu Kommunikationsproblemen zwischen Anwendung und Diensten kommen. Weitere Informationen finden Sie im Kompatibilitätsabschnitt.
Diese Anforderung an PrintScheduler/Service hat innerhalb des festgelegten Zeitlimits keine Antwort erhalten
BarTender Print Portal ist auf den BarTender Print Scheduler-Dienst angewiesen, um Druckvorschauen zu erstellen und einen Druckauftrag auszuführen. In manchen Fällen bricht die Kommunikation zwischen beiden plötzlich ab und Sie erhalten diese lange Fehlermeldung:
Für diese Fehlermeldung gibt es einige mögliche Lösungen, aber die einfachste und häufigste ist, den BarTender Print Scheduler-Dienst einfach neu zu starten:
- Öffnen Sie die Dienste-Verwaltung, indem Sie danach im Startmenü suchen oder sie in der Systemsteuerung aufrufen.
- Scrollen Sie nach unten zum Dienst „BarTender Print Scheduler“.
- Wenn der Dienst gestoppt ist, klicken Sie mit der rechten Maustaste darauf und wählen Sie Starten. Wenn der Dienst bereits läuft, klicken Sie mit der rechten Maustaste und wählen Sie Neu starten.
Wenn Sie eine Fehlermeldung bezüglich eines falschen Benutzernamens oder Passworts erhalten, lesen Sie bitte BarTender Print Scheduler Service-Berechtigungen festlegen. Dies kann daran liegen, dass das Konto, das den Dienst ausführt, sein Passwort geändert hat. Es wird empfohlen, ein Konto zu verwenden, dessen Passwort sich nicht ändert.
Druckauftrag abgebrochen: Datei konnte nicht geöffnet, gelesen oder zugegriffen werden
Diese Fehlermeldung ist eine Art Sammelmeldung für Dateifehler und bezieht sich in der Regel auf zwei Dinge: Berechtigungen oder fehlende verknüpfte Dateien. Hier ein Beispiel und wie Sie diese Fehlermeldung interpretieren können:
- Neben „Print Job Aborted“ steht die Bedingung, die den Fehler verursacht hat. In diesem Beispiel ist es ein Datensatz, also eine verknüpfte Datenbank. Die Etikettendatei hat also Probleme beim Öffnen der Datenbank.
- Als nächstes steht, was nicht geöffnet werden kann. In diesem Fall ist es eine CSV-Datenbank.
- Danach folgen kurze Details zum Problem. Hier konnte die Datei nicht gefunden oder der definierte Ordner nicht gefunden werden.
Diese Fehlermeldung bedeutet also, dass die Datei am im Etikettendokument angegebenen Speicherort nicht existiert oder der Print Scheduler-Dienst keine Berechtigung hat, auf das Verzeichnis zuzugreifen, sodass die Datei als fehlend erscheint.
Wenn Sie auf solche Fehler stoßen, öffnen Sie als ersten Schritt die Etikettendatei.
- Erscheinen beim Öffnen Fehlermeldungen?
- Können Sie die Datenbank im Dialogfeld „Daten-Setup“ durchsuchen oder wird angezeigt, dass keine Verbindung zur Datenbank hergestellt werden kann?
- Fehlen Bilder und werden durch rote X angezeigt?
- Können Sie das Etikett aus BarTender Designer drucken oder erscheinen auch hier Fehlermeldungen?
Wenn eines dieser Probleme auftritt, müssen Sie es beheben, bevor Sie das Etikett drucken können.
Wenn Sie feststellen, dass das Etikett problemlos gedruckt wird, liegt möglicherweise ein Berechtigungsproblem vor. Wenn der Print Scheduler-Dienst nicht auf verknüpfte Ressourcen wie Bilder oder Datenbanken zugreifen kann, um den Auftrag korrekt zu drucken, erscheint ebenfalls diese Fehlermeldung. Wie Sie das Problem beheben, erfahren Sie im Abschnitt zu Berechtigungen.
Der Datensatz konnte nicht erstellt werden
Beim Drucken oder in der Vorschau eines Etiketts erscheint am unteren Bildschirmrand eine Fehlermeldung wie diese:
Diese Meldung ist ein Datenbankfehler und zeigt an, dass etwas mit der in der Etikettendatei gespeicherten Datenbankverbindung nicht stimmt. Beim Verbinden mit einer Datenbank im Print Portal wird entweder das Konto des IIS App Pools (bei Windows-Authentifizierung) oder die im Etikett gespeicherten Zugangsdaten (bei Datenbank-Authentifizierung) verwendet. Textdatenbanken verursachen bei Verbindungsproblemen meist Dateifehler, daher bezieht sich dieser Abschnitt eher auf relationale Datenbanken.
Mögliche Ursachen für diese Fehlermeldung:
- Die Datenbank wurde verschoben oder umbenannt.
- Die Datenbank ist offline.
- Die ODBC-Verbindung ist als User-DSN statt als System-DSN eingerichtet.
- Die für die Verbindung benötigten Zugangsdaten sind nicht im Etikett gespeichert.
- Die Datenbank verwendet Windows-Authentifizierung und der aktuelle Benutzer, der BarTender Print Portal ausführt, ist nicht berechtigt, auf die Datenbank zuzugreifen.
Da es viele verschiedene Datenbanktypen und -verbindungen gibt, ist dies keine vollständige Liste und nicht jede Option passt zu jeder Verbindung. Am besten öffnen Sie das Etikett, prüfen den Verbindungstyp und gehen von dort aus weiter. Öffnen Sie dazu den Datenbank-Dialog über Datei > Datenbankverbindung einrichten.
- Wenn beim Öffnen des Dialogs oder beim Durchsuchen der Datensätze ein Verbindungsfehler auftritt, wurde die Datenbank wahrscheinlich verschoben, umbenannt, ist offline oder anderweitig nicht verfügbar. Sie müssen die Datenbank suchen und prüfen, ob sie verfügbar und online ist. Wenn Ihre Datenbank verwaltet wird, wenden Sie sich an Ihren Datenbankadministrator.
- Im Dialog „Datenbank-Setup“ klicken Sie auf den Datenbank-Setup-Assistenten und prüfen die Verbindungsdetails
- Wird die Verbindung über Windows-Authentifizierung oder Datenbank-Authentifizierung hergestellt?
- Sind die Zugangsdaten im Dokument gespeichert (bei Datenbank-Authentifizierung)?
- Sind die Zugangsdaten korrekt?
- Wenn Sie eine ODBC-Verbindung nutzen, prüfen Sie die DSN-Konfigurationen.
Nachdem Sie alle Fehler behoben, die Authentifizierung geprüft und die Zugangsdaten im Dokument gespeichert haben (außer bei Windows-Authentifizierung), speichern Sie das Dokument und legen Sie es wieder im Print Portal-Ordner ab.
Brauchen Sie noch Hilfe? Kontaktieren Sie uns!