Dokumentation

Probleme mit dem Status eines OSGi-Bundles in AEM

Last update: Thu Feb 13 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Wenn in der AEM-Produktionsumgebung der Status von OSGi-Bundles auf potenzielle Probleme bei der Bundle-Bereitstellung oder -Konfiguration hinweist, identifizieren Sie Bundle-Status, verstehen Sie, was jeder Status bedeutet, und beheben Sie diese basierend auf dem angezeigten Status.

Beschreibung description

Umgebung

Adobe Experience Manager (AEM) Managed Services v6.5

Problem/Symptome

In der AEM-Produktion sind OSGi-Bundles möglicherweise nicht immer erwartungsgemäß aktiv. Die folgenden Symptome können beobachtet werden:

  • Pakete erscheinen fragmentiert.
  • Pakete werden aufgelöst, aber nicht aktiv.
  • Die Pakete sind aktiv und funktionieren normal.

Diese Status zeigen Probleme mit der Bundle-Bereitstellung oder -Konfiguration an, die behoben werden müssen, um sicherzustellen, dass alle Services ordnungsgemäß funktionieren.

Auflösung resolution

So beheben Sie Probleme im Zusammenhang mit dem OSGi-Bundle-Status in AEM:

  1. Identifizieren Sie Bundle-Status:

    • Überprüfen Sie den Status der einzelnen Bundles in der Systemkonsole, um festzustellen, welche fragmentiert, aufgelöst oder aktiv sind.

  2. Grundlegendes zu Bundle-Status:

    • Das OSGi-Framework stellt Bundle-Status je nach Status unterschiedlich dar.

      • Aufgelöste Bundles: Hierbei handelt es sich um Bundles, die installiert wurden und alle Abhängigkeiten erfüllt, aber noch nicht aktiv sind. Sie sind startbereit.

        • Wenn sich Bundles im aufgelösten Status befinden, listet die Kopfzeile der Systemkonsole die Anzahl der Bundles in jedem Status auf und bietet so einen klaren Überblick über den Bundle-Lebenszyklus. Aufgelöste Bundles werden separat hervorgehoben, um anzugeben, dass sie startbereit, aber noch nicht aktiv sind. Dies hilft bei der Identifizierung von Bundles, die möglicherweise Aufmerksamkeit oder manuelles Eingreifen benötigen, um in den aktiven Status zu wechseln.
        • Ein aufgelöstes Bundle in OSGi bedeutet, dass das Framework alle erforderlichen Pakete und Services gefunden hat, die für das Bundle erforderlich sind, und dass es startbereit ist. Sie ist jedoch noch nicht aktiv.

      • Fragmentpakete: Diese können nicht unabhängig aufgelöst oder gestartet werden. Sie werden an ein Host-Bundle angehängt, um zusätzliche Ressourcen oder Code bereitzustellen.

        • Fragment-Bundles werden verwendet, um die Funktionen eines Host-Bundles zu erweitern. Sie stellen zusätzliche Ressourcen oder Code für das Host-Bundle bereit und verbessern dessen Funktionalität.
        • Ein Fragment-Bundle ist ein Hilfsprogramm und kann nicht allein funktionieren. Sie muss mit einem Host-Bundle verknüpft sein, damit sie aufgelöst und gestartet werden kann.

  3. Aktionsschritte für aufgelöste Bundles:

    • Stellen Sie sicher, dass alle erforderlichen Konfigurationen oder Abhängigkeiten ordnungsgemäß eingerichtet sind.
    • Starten Sie diese Bundles manuell, wenn sie nicht automatisch von „Aufgelöst“ in „Aktiv“ wechseln, nachdem alle Bedingungen erfüllt wurden.

  4. Adressieren fragmentierter Bundles:

    • Stellen Sie sicher, dass jedes Fragment korrekt mit dem vorgesehenen Host-Bundle verknüpft ist.
    • Vergewissern Sie sich, dass das Host-Bundle betriebsbereit ist und die von Fragmenten bereitgestellten zusätzlichen Ressourcen integrieren kann.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f