Advanced Agent Search

In environments comprising of a large number of components, it is often very difficult for administrators to remember which agent manages each of the monitored components, and whether upgrade/upgrade now has been enabled for those agents or not. eG Enterprise therefore, provides this page, using which administrators can search for and view details of agents based on a given component name, component type, and/or IP address(es). In addition, this interface permits the display of agents based on upgrade status (i.e., whether auto-upgrade/Upgrade now has been enabled/not), and allows administrators to instantly enable/disable upgrade for one/more of the listed agents.

To access this page, click on the icon available in the Admin tab. Then select the Advanced Search option from the Upgrade sub-menu in the Agents tile of the eG administrative interface.

The AGENTS UPGRADE - ADVANCED SEARCH page appears next.

1. First, select a Search criteria.

2. If you want to view the details of agents monitoring specific components, select Component from Search criteria drop-down and specify a search string in the Component/Agent name text box.

3. Then, click the Search button. The result set that appears displays the details of agents that are monitoring those components which have names that embed the specified string.

4. In the same way, to view the details of all the agents that are monitoring components of a particular type, select the Component/Agent type from the drop-down, and click the Search button to retrieve the results.

5. Similarly, you can also view the details of agents of a particular status, by selecting the desired option from the Status drop-down. You can thus choose to view information pertaining to agents for which auto upgrade is disabled/enabled, or upgrade now is disabled/enabled.

6. Where multiple versions of eG agents co-exist, you can use this page to identify those agents that are yet to be upgraded to the latest version. For this, select an agent version from the Agent version drop-down and click the Search button. The details of all agents that are of the chosen version will be listed in this page.

7. Alternatively, a combination of search criteria based on Component/Agent type and Status can also be specified.

8. Also, instead of filtering your agent-view on the basis of a specific component name, type, or agent status, you can simply provide an IP address or range of IP addresses by selecting the IP Address option from the Search criteria drop-down for which agent information is required. Clicking on the Search button then, will display the details of all agents with host/nick names that are associated with the given IP address(es).

9. However, regardless of the search criteria specified, the following information is typically retrieved and displayed in the ADVANCED SEARCH page:

   • COMPONENT/AGENT NAME

   • COMPONENT/AGENT TYPE

   • AGENT NAME - All the nick names that map to the IP address of the displayed Component Name

   • Whether AUTO UPGRADE and UPGRADE NOW have been enabled for the agent or not

   • The current VERSION of the eG agent

   • The OPERATING SYSTEM on which the eG agent functions

   • The ID of the LAST UPGRADED PACKAGE

   • LAST UPGRADED TIME - The time at which the agent was last upgraded

10. By default, the agent information displayed is sorted in the ascending order of the contents of the COMPONENT/AGENT NAME column. To sort the agent details on any other column, click on the corresponding column heading. For instance, to sort the agent details on the basis of the contents of the COMPONENT/AGENT TYPE column, just click on the column label, COMPONENT/AGENT TYPE. This will automatically sort the agent information in the ascending order of the component types displayed in the COMPONENT/AGENT TYPE column. An ‘up arrow’ mark will appear against the COMPONENT/AGENT TYPE column label to indicate the same. Clicking on the ‘up arrow’ once again will switch the sort order from ascending to descending and will change the ‘up arrow’ to the ‘down arrow’.

11. At any point in time, you can clear the displayed information by clicking on the Clear button.

12. As stated earlier, the ADVANCED SEARCH page not only provides agent information, but also allows you to enable/disable auto-upgrade or the ‘Upgrade now’ capabilities of the agents. To enable the auto-upgrade capability of multiple eG agents simultaneously, click on the check boxes that prefix every row of information (in the ADVANCED SEARCH page) related to these agents, and click the Set Auto Upgrade button.

13. If the auto-upgrade capability was enabled successfully for the chosen agents, then the AUTO UPGRADE column that appears next, will indicate the same.

14. Similarly, to disable the auto-upgrade capability, select the check boxes prefixing the corresponding agent details, and click the Disable Auto Upgrade button. The AUTO UPGRADE column will then indicate whether the auto-upgrade capability of those agents was successfully disabled or not.

15. Likewise, you can enable/disable the ‘Upgrade now’ capability of agents by first selecting the check boxes corresponding to the agent information, and clicking the Upgrade Now or Cancel Upgrade Now buttons (as the case may be).

Note:

• The Upgrade Now capability can be enabled only for those agents for which the Auto Upgrade capability has been enabled.

• If the Auto Upgrade capability is disabled for an agent, the Upgrade Now capability of that agent (if previously enabled) will also be automatically disabled.

16. By default, the ADVANCED SEARCH page does not refresh automatically. Clicking on the Set Refresh On button allows the page to automatically refresh according to a pre-configured refresh period, and also enables administrators to track how long it would be before the next reload occurs.

17. Once the Set Refresh On button is clicked, the ADVANCED SEARCH page refreshes every 5 minutes (i.e., 300 seconds), by default. You can however, modify the refresh period by editing the eg_ui.ini file in the <EG_INSTALL_DIR>\manager\config directory. The AutoUpgrade parameter in the [REFRESH] section of this file is set to 300 (seconds) by default. If need be, this default setting can be overridden. To disable the automatic refresh capability of this page, click on the Set Refresh Off button.

18. This page can be exported into CSV file using the icon that exists in the right top corner of this page.