system-bundles
Retrieves the list of OSGi bundles installed in the system. Requires cluster administrator permission.
Command properties
| Item | Description |
|---|---|
| Command type | Driver query |
| Required permission | Cluster administrator permission |
| License usage | Not counted |
| Parallel execution | Not supported |
| Distributed execution | Not supported |
Syntax
system-bundles
Options
None
Output fields
| Field | Type | Description |
|---|---|---|
| id | long | Bundle ID |
| symbolic_name | string | Bundle symbolic name |
| version | string | Bundle version |
| status | string | Current bundle status. Returns one of ACTIVE, INSTALLED, RESOLVED, STARTING, UNINSTALLED. |
| build_timestamp | timestamp | Time the bundle was packaged (Bnd-LastModified value from the bundle manifest). Returns null if this value is not present. |
Error codes
Parse errors
| Error code | Message | Description |
|---|---|---|
| 95040 | 읽기 권한이 없습니다. 클러스터 관리자 권한이 필요합니다. | The user does not have cluster administrator permission. |
Runtime errors
N/A
Description
The system-bundles command retrieves the list of OSGi bundles installed in the system. Results are returned sorted by bundle ID in ascending order.
If any bundle has a status other than ACTIVE, the corresponding app or plugin may not be operating correctly.
This command requires cluster administrator permission.
Examples
-
Retrieve the full list of bundles
system-bundlesRetrieves a list of all bundles installed in the system.
-
Retrieve bundles that are not active
system-bundles | search status != "ACTIVE"Retrieves only bundles whose status is not
ACTIVE. -
Search for a specific bundle
system-bundles | search symbolic_name == "*logpresso*"Retrieves only bundles whose symbolic name contains
logpresso.