Sample Scenario: Node does not start during installation or upgrade

To troubleshoot such a scenario, you would typically want to inspect the following:

  • Are all the required bundles available or not?
  • Is the correct bundle version installed or upgraded?
  • Is any required bundle in the RESOLVED state instead of being in the ACTIVE state?

You can use the OSGi diagnostic tool to find out this information easily, as follows.

  1. Access the OSGi Diagnostic tool by selecting Infrastructure > Diagnostic Tool.
  2. In the Select node dropdown, select the appropriate node and navigate to the Bundle tab.
  3. To find out whether all the required bundles are available:
    1. To download a list of all the bundles for easier comparison, click Export to CSV or Export to JSON.
    2. To find out the bundles which are dependent on a specific bundle, double-click the bundle name. Details are provided in the Dependency Details, Exported Packages, Imported Packages, and Headers tabs.
  4. To find out whether the correct version is installed or upgraded, use the information in the Release Unit Version column.

  5. To find out whether bundles are in the Resolved state:
    1. Search for "RESOLVED" in the Search field.

      The table lists all the bundles which are not active, that is, there is an issue with the bundle.

    2. Now that you know which bundle might be the cause of the issue, use the OSGi Console to start or stop the bundle and check the log for a possible cause.