Troubleshooting
Selbstsigniertes Zertifikat
Jira kann so konfiguriert werden, dass sichere Verbindungen über HTTPS unterstützt werden. In diesem Fall werden alle HTTP-Requests von Jira auf HTTPS umgeleitet. Wenn ein selbstsigniertes Zertifikat von Jira verwendet wird, können sich sowohl der Jira Sync als auch der Sync-Konfigurator nicht mehr mit Jira verbinden, da sie das selbstsignierte Zertifikat ablehnen. Das Zertifikat muss in Windows als vertrauenswürdig markiert werden, damit der Jira Sync eine Verbindung herstellen kann. Dies machen Sie wie folgt:
Internet-Explorer öffnen
Navigieren Sie zur Jira-URL
Klicken Sie auf Weiter zu dieser Website
Klicken Sie in der Adressleiste auf Zertifikatsfehler
Klicken Sie auf Zertifikate anzeigen
Zur Registerkarte Details wechseln
Klicken Sie auf Kopieren in Datei
Wählen Sie die DER-Kodierung
Klicken Sie auf Weiter
Wählen Sie jira.cer als Dateinamen
Klicken Sie auf Next und dann auf Finish
MMC öffnen (win+r, mmc)
Klicken Sie auf Datei und dann auf Snap-In hinzufügen/entfernen
Wählen Sie Zertifikate aus und klicken Sie auf Hinzufügen
Computerkonto auswählen
Klicken Sie auf Next und dann auf Finish
Klicken Sie auf OK
Klicken Sie im Baum mit der rechten Maustaste auf "Trusted People".
Alle Aufgaben auswählen und importieren
Klicken Sie auf Weiter
Klicken Sie auf Durchsuchen und wählen Sie das zuvor gespeicherte Zertifikat aus
Klicken Sie auf Weiter und erneut auf Weiter und auf Fertigstellen
Danach können Sie den Internet Explorer erneut öffnen und wieder zur Jira-URL navigieren. Nun sollte keine Zertifikatswarnung mehr angezeigt werden. Bitte beachten Sie, dass es wichtig ist, das Zertifikat auf dem Computerkonto zu installieren. Andernfalls wird Ihr aktuelles Benutzerkonto dem Zertifikat vertrauen, nicht aber dem Servicekonto, unter dem das aqua Backend läuft.
Fehler bei der Konfiguration
Login nicht möglich
Prüfen Sie, ob Captchas aktiviert sind. Eventuell hilft es, sich einmal über den Browser anzumelden. Wenn die Anmeldung vorher möglich war, können Sie auch prüfen, ob Sie ein API Token benötigen. Gehen Sie dazu wie folgt vor:
1. Gehen Sie auf die Atlassian Website: https://id.atlassian.com/manage/api-tokens
2. Anmeldung mit dem Benutzer, der als Sync-Benutzer verwendet werden soll.
3. Erstellen Sie ein API-Token (Speichern Sie Ihr Token an einem sicheren Ort. Das Token kann die Multi-Factor-Authentifizierung über die API umgehen)
4. Verwenden Sie in Jira Sync die E-Mail-Adresse des Benutzers, der das Token erstellt hat, als Benutzernamen und das Token als Passwort.
5. Verwenden Sie Jira Sync wie zuvor.
"Failed" Nachricht
Server nicht erreichbar, Verbindung prüfen
Nichts wird synchronisiert
a) Prüfen Sie, ob der Jira Sync User produktiv in aqua genutzt wird. Ist das der Fall, so wird der Sync nicht funktionieren
b) Prüfen Sie die Zeitzonen Ihrer Jira und aqua Umgebung.
"Sequence contains no elements"
Falscher IssueType.
"No jira user found"
Prüfen Sie mit dem jira Addon 'REST API Browser', ob der Benutzer per E-Mail oder Benutzername gefunden werden kann. Fügen Sie '/plugins/servlet/restbrowser' hinter Ihrer jira URL ein, um das Addon nach der Installation zu öffnen und mit dem Userpicker (api/2/user/picker) nach den Benutzern zu suchen. Prüfen Sie, ob Ihr jira-Benutzer die Berechtigung zum Suchen von Benutzern hat.
SyncError - Ich finde mein Element nicht
Im Folgenden finden Sie eine Matrix der häufigsten Fehler und wie sie behoben werden können:
1
Element in Jira vorhanden, aber nicht in aqua
a)
Nicht erfolgreich angelegt
b)
Element in aqua verschoben
Bitte kontaktieren Sie den Support. Eine DB Query ist nötig, um das Element wieder dem aktuellen Sync zuzuweisen. Bitte beachten Sie, dass das Verschieben von Elementen über Projektgrenzen hinaus in der Regel eine destruktive Tätigkeit ist, welche zu unerwartetem Verhalten führen kann.
c)
Element in aqua gelöscht
Löschen Sie das Element auch in Jira. Alternativ, kontaktieren Sie bitte den Support. Eine DB Query ist nötig, um das Element wieder dem aktuellen Sync zuzuweisen.
2
Element existiert in aqua, aber nicht in Jira
a)
Issue Type geändert
Beim Ändern der Issue-Type werden Elemente nicht mehr synchronisiert. Seien Sie bitte vorsichtig, wenn Sie die Issue-Type ändern, besonders wenn mehr als eine Synchronisation für verschiedene konfigurierte Objekte stattfindet.
Last updated