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.