How to Use Selang to Get Endpoint Status

Document ID : KB000010340
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

World View in Enterprise Management is used to get a list of endpoints with their last update times, but sometimes it is useful to get this information in a text output for reporting purposes. Particularly, if the environment contains a large number of endpoints, getting the entire output in a string of text makes it easier to parse and search.

Instructions:

To generate a list of endpoints with the last update time, use the command below.

selang -s -c "host DMS__@; sr HNODE * props(HNODE_KEEP_ALIVE)"

 

Example:

# selang -s -c "host DMS__@; sr HNODE * props(HNODE_KEEP_ALIVE)" 

Target host: localhost 

(DMS__@localhost) 

Successfully connected 

INFO: Target host's version is 12.91.0302 

Windows OS info: Windows NT Version:6.2, 

13 Dec 2016 10:05:23 Eastern Standard Time 

 

(DMS__@localhost) 

Data for HNODE 'endpoint1' 

----------------------------------------------------------- 

Last Heartbeat : 17-Sep-2016 21:41 

 

Data for HNODE 'endpoint2' 

----------------------------------------------------------- 

Last Heartbeat : 05-Dec-2016 09:41 

 

Data for HNODE 'endpoint3' 

----------------------------------------------------------- 

Last Heartbeat : 13-Dec-2016 04:22 

 

Once done generating the list of endpoints and desired information, use the command below to display all properties again. If this command is not run, the World View will not display properly. This is because the props switch sets flags internally. If sr HNODE * is run without the props switch (which is how World View gets its information), it will use the last setting.

 

selang -s -c "host DMS__@; sr HNODE * props(all)"

Additional Information:

Multiple properties can be used in the same command using a comma separated list within the props switch. Here are some additional properties that are useful.

HNODE_VERSION  :  Displays the full version of the endpoints.

HNODE_INSTALL_STATUS  :  Displays the install status.

To obtain a list of all possible properties, stop PIM services and browse to the DMS folder, then run the command `dbmgr -d D HNODE`. This can be done on a test system to prevent any down time.

 

If the result of the command does not show all endpoints, change the query_size value in either seos.ini or in the Windows registry. See the Implementation Guide for more information.

https://docops.ca.com/ca-privileged-identity-manager/12-9-01/EN/reference/configuration-files/the-seos-ini-initialization-file/lang

https://docops.ca.com/ca-privileged-identity-manager/12-9-01/EN/reference/registry/lang-registry