Fehlerbehebung für das Developer Portal

Verwenden Sie dieses Handbuch als Hilfe bei der Diagnose und Behebung von Developer Portal -Problemen in IBM® API Connect.

Produktinfo

Die folgenden Abschnitte enthalten Ratschläge zur Diagnose und Behebung einiger häufig auftretender Probleme. Anhand dieser Informationen können Sie ermitteln, ob eine bestimmte IBM API Connect Version 10 -Komponente fehlschlägt, ob es sich um ein Umgebungsproblem handelt und ob Sie eine Unterstützungsanforderung stellen sollten. Zu einigen Ratschlägen gehört die Überprüfung bestimmter Protokolldateien, damit Sie die Ursache des Problems eingrenzen können.
Hinweis: Im Das Hilfesymbol. Klicken Sie auf der Hilfeseite der Benutzeroberflächen von API Manager und API Designer auf die Kachel „Produktinformationen “, um Informationen zu Ihrem Produkt und Git Paketversionen zu erhalten. Die Produktinformationen von API Designer basieren auf dem zugehörigen Verwaltungsserver, aber die Informationen von Git basieren auf dem Ort, von dem sie heruntergeladen wurden.
  1. Warum treten Probleme mit meiner Developer Portal-Benutzerschnittstelle auf
  2. Warum habe ich Probleme, Drupal 8-basierte angepasste Module oder Untermotive im Drupal 9-basierten Developer Portal zu installieren?
  3. Stehen meine Upgrade-Probleme im Zusammenhang mit benutzerdefinierten Drupal Modulen oder Themen?
  4. Warum habe ich Migrationsprobleme mit nicht identischen Umgebungen?

Warum treten Probleme mit der Benutzerschnittstelle von Developer Portal auf?

Wenn Sie Probleme mit der Benutzerschnittstelle haben, führen Sie die folgenden Prüfungen durch:
  • Versuchen Sie, den Cache Ihres Browsers zu löschen, privates Browsing durchzuführen und verschiedene Browser zu verwenden. Prüfen Sie, ob es Unterschiede in der Funktionsweise gibt.
  • Überprüfen Sie die Größe des Browserfensters und die Bildschirmauflösung und versuchen Sie, die Werte der Einstellungen zu erhöhen und zu verringern.
  • Überprüfen Sie die Registerkarten "Console" und "Network" der Browser-Entwicklertools, da sie möglicherweise einige Diagnosehinweise bereitstellen.
  • Versuchen Sie, die Caches von Drupal über das Entwicklerportal zu löschen; weitere Informationen finden Sie unter Löschen der Server-Caches.

Wenn Sie eine Serviceanfrage stellen müssen, fügen Sie den Protokollen von IBM API Connect MustGather Informationen über die Uhrzeit und das Datum bei, an dem das Problem aufgetreten ist. Darüber hinaus ist ein Export der Browser-Entwicklertools-Konsole und der Netzausgabe hilfreich.

Warum treten bei der Installation von Drupal 8-basierten angepassten Modulen oder Untermotiven im auf Drupal 9 basierenden Developer PortalProbleme auf?

Ab IBM API Connect 10.0.3.0basiert das Developer Portal auf dem Content-Management-System von Drupal 9. Wenn Sie Drupal 8 angepasste Module oder Untermotive im Drupal 9-basierten Developer Portalinstallieren möchten, müssen Sie sicherstellen, dass sie mit Drupal 9 kompatibel sind, einschließlich des angepassten Codes, den sie enthalten, und beispielsweise keine veralteten APIs verwenden. Es gibt Werkzeuge, um Ihren eigenen Code zu überprüfen, wie z.B. drupal_check auf GitHub,, das Drupal Code auf Verwerfungen überprüft.

Beispiel: Alle Developer Portal -Sites, die Module oder Untermotive enthalten, die keine Drupal 9-Versionsdeklaration enthalten, können nicht aktualisiert werden und Fehler wie die folgende Ausgabe werden in den admin -Protokollen angezeigt:
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:34:49: check_d9_compat: Checking theme: emeraldgreen
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:34:49: check_d9_compat: ERROR: Incompatible core_version_requirement '' found for emeraldgreen
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:34:49: check_d9_compat: Checking theme: rubyred
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:34:49: check_d9_compat: ERROR: Incompatible core_version_requirement '8.x' found for rubyred
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:34:49: check_d9_compat: ERROR: Found themes incompatible with Drupal 9: emeraldgreen rubyred
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:34:49: check_d9_compat: ERROR: /tmp/restore_site.355ec8 is NOT Drupal 9 compatible
...
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:44:49: check_d9_compat: Checking module: custom_mod_1
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:44:49: check_d9_compat: ERROR: Incompatible core_version_requirement '' found for custom_mod_1
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:44:49: check_d9_compat: Checking module: custom_mod_2
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:44:49: check_d9_compat: ERROR: Incompatible core_version_requirement '8.x' found for custom_mod_2
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:44:49: check_d9_compat: ERROR: Found modules incompatible with Drupal 9: emeraldgreen rubyred
[     queue stdout] 14834 729319:355ec8:a7d29c 2021-09-04 20:44:49: check_d9_compat: ERROR: site1.com is NOT Drupal 9 compatible
Um Versionskompatibilitätsfehler zu beheben, sollten alle angepassten Module und Untermotive einen core_version_requirement -Schlüssel in ihrer Datei *.info.yml deklarieren, der die Drupal 9-Kompatibilität angibt. Zum Beispiel:
name: Example module
type: module
description: Purely an example
core: 8.x
core_version_requirement: '^8 || ^9'
package: Example module

# Information added by Drupal.org packaging script on 2020-05-31
version: '8.x-1.3'
project: 'example_module'
datestamp: 1590905415
In diesem Beispiel wird angegeben, dass das Modul mit allen Versionen von Drupal 8 und 9 kompatibel ist. Weitere Informationen finden Sie unter Drupal. Informieren Sie über Ihr Modul mit einer. info.yml Datei auf der Website drupal.org .

Wenn Sie über eine Sicherung einer Site verfügen, die wiederhergestellt werden muss, und der Versionskompatibilitätsfehler auftritt, die Datei *.info.yml des Moduls oder Motivs jedoch nicht ohne Weiteres geändert werden kann, können Sie die Sicherung der Site ändern.

Um die Sitesicherung zu ändern, extrahieren Sie sie, bearbeiten Sie die darin enthaltenen relevanten Dateien und tar die Sicherungsdatei erneut. Beachten Sie, dass durch diese Prozedur die ursprüngliche Sicherungsdatei überschrieben wird. Stellen Sie daher sicher, dass Sie eine separate Kopie der Originaldatei behalten, bevor Sie die Extraktion starten. Zum Beispiel:

  1. mkdir /tmp/backup
  2. cd /tmp/backup
  3. tar xfz path_to_backup.tar.gz
  4. Bearbeiten Sie die angepassten Modul-und Motivdateien, damit sie Drupal 9 kompatibel sind, und fügen Sie die richtige Einstellung für core_version_requirement hinzu.
  5. rm -f path_to_backup.tar.gz
  6. tar cfz path_to_backup.tar.gz
  7. cd /
  8. rm -rf /tmp/backup

Stehen meine Upgrade-Probleme im Zusammenhang mit benutzerdefinierten Drupal Modulen oder Themen?

Um die Funktionalität Ihrer Drupal Website zu verbessern, können Sie zusätzliche Module oder Themen installieren, die nicht von IBM bereitgestellt werden. Diese benutzerdefinierten Komponenten oder Komponenten von Drittanbietern können zwar erweiterte Funktionen bieten, aber auch Auswirkungen auf die Kernfunktionen haben und bei Upgrades Kompatibilitätsprobleme verursachen. Darüber hinaus sind diese Module oder Themen möglicherweise nicht mit den neueren Versionen der Module von Drupal oder IBM API Connect kompatibel oder enthalten Bugs oder Sicherheitslücken.
Hinweis: Der IBM Support deckt keine Probleme ab, die durch Komponenten von Drittanbietern oder benutzerdefinierte Module oder Themen verursacht werden.
Wenn Ihre Anpassung zu Upgrade-Fehlern führt, sollten Sie die folgenden Schritte in Betracht ziehen:
Hinweis: Vergewissern Sie sich immer, dass Ihre benutzerdefinierten Module und Themen mit der Zielversion des Upgrades kompatibel sind, bevor Sie fortfahren.
  1. Sichern Sie Ihre Anpassungen und Ihre Website-Konfiguration mithilfe der Exportfunktion. Weitere Informationen finden Sie unter Exportieren und Importieren von benutzerdefinierten Designs und Website-Konfigurationen.
  2. Wechseln Sie vorübergehend das Theme - setzen Sie das Site-Theme auf connect_theme und das Admin-Theme auf claro.
  3. Deaktivieren oder entfernen Sie vorübergehend die problematischen Module.
  4. Fahren Sie mit dem Upgrade fort.
  5. Nach einem erfolgreichen Upgrade können Sie Ihre Anpassungen erneut anwenden und testen
Weitere Informationen zum Auffinden Ihrer benutzerdefinierten Module und Designs finden Sie unter So finden Sie Ihre benutzerdefinierten Module und Designs im Entwicklerportal.

Weitere Informationen zum Upgrade Ihres Developer Portals finden Sie unter Vorbereitungen für das Upgrade Ihres Developer Portals auf Drupal 11.

Warum habe ich Migrationsprobleme mit nicht identischen Umgebungen?

Achten Sie beim Exportieren und Importieren von benutzerdefinierten Themes und Site-Konfigurationen darauf, dass die Quell- und die Zielumgebung von Drupal so weit wie möglich identisch sind. Unterschiedliche Umgebungen können häufig zu Migrationsfehlern oder unerwartetem Verhalten führen. Stellen Sie immer sicher, dass die Konfigurationen, aktivierten oder deaktivierten Module oder Themen in beiden Umgebungen identisch sind und das Datenbankschema in der Zielumgebung auf dem neuesten Stand ist.

Sie können jede Umgebung unter Verwaltung > Berichte > Statusbericht überprüfen.

Weitere Informationen zum Exportieren oder Importieren von benutzerdefinierten Designs und Site-Konfigurationen finden Sie unter Exportieren und Importieren von benutzerdefinierten Designs und Site-Konfigurationen.