system-ipojo-instances

Retrieves the list of iPOJO component instances running in the system along with their status. Cluster administrator permission is required.

Command properties

Property	Description
Command type	Driver query
Required permission	Cluster administrator
License usage	Not counted
Parallel execution	Not supported
Distributed execution	Not supported

Syntax

system-ipojo-instances

Options

None

Output fields

Field	Type	Description
instance	string	Name of the iPOJO component instance
status	string	Instance status. One of `VALID`, `INVALID`, or `STOPPED`.

Error codes

Parsing errors

Error code	Message	Description
95040	No read permission. Cluster administrator permission is required.	The user does not have cluster administrator permission

Runtime errors

N/A

Description

The system-ipojo-instances command retrieves the list and status of iPOJO component instances running in the OSGi framework. Each functional module of Logpresso is implemented as an iPOJO component.

If an instance has a status of INVALID or STOPPED, the corresponding feature may not be functioning correctly.

Cluster administrator permission is required to run this command.

Examples

Retrieve all iPOJO instance list
```
system-ipojo-instances
```
Retrieves the list and status of all iPOJO component instances running in the system.
Retrieve instances with abnormal status
```
system-ipojo-instances | search status != "VALID"
```
Retrieves only instances whose status is not VALID.
Search for a specific component instance
```
system-ipojo-instances | search instance == "*logdb*"
```
Retrieves only components whose instance name contains logdb.