69.2 Creating and Managing Agent Groups

You might find it convenient to group related agents together for monitoring purposes. Initially, all agents are in a single group with the same name as your GroupWise system.

Monitor Agent Console on Initial Startup

Agent groups are displayed on the left side of the Monitor Agent server console. When you select an agent group, the monitored agents in the group and their status information are listed on the right side of the Monitor Agent server console.

Monitor Agent Console with Agent Groups Defined

You can create additional groups and subgroups as needed to make monitoring similar agents easier. You might want to create agent groups based on geographical areas, on administrative responsibilities, or on agent configuration similarities. The number of agents in the group is displayed to the right of the group name in the Agent Groups window.

In addition, by creating agent groups, you can provide configuration settings for monitoring just once for all agents in each group, rather than providing them individually for each agent in your GroupWise system.

NOTE:On Linux, you perform these tasks at the Monitor Agent Web console or Monitor Web console, using steps similar to those provided in this section.

69.2.1 Creating an Agent Group

On Windows, at the Monitor Agent server console:

  1. Right-click the folder where you want to create the agent group, then click Create.

  2. Type a name for the new group, then click OK to create a new folder for the agent group.

    The group name must be unique within its parent group.

  3. Click a folder containing agents that you want to add to the new group.

  4. Drag and drop agents into the new group as needed.

  5. Click the new group to view its contents.

On Linux, at the Monitor Agent Web console:

  1. In the Agent Groups window, click Create.

  2. Type a name for the new group, select the parent group for the new group, then click Create.

  3. In the Agent Status window, select one or more agents to add to the new group, then click Move.

  4. In the list of available groups, select the new group, then click Move.

  5. Click the new group to view its contents.

You can nest groups within groups as needed.

69.2.2 Managing Agent Groups

On Windows, at the Monitor Agent server console:

  • To rename an agent group, right-click the agent group, click Rename, type the new name, then press Enter.

  • To move an agent group, drag and drop it to its new location.

  • To delete an agent group, right-click the agent group, then click Delete. A group must be empty before you can delete it.

On Linux, at the Monitor Agent Web console:

  • To rename an agent group, click Rename, type the new name, select the group to rename, then click Rename.

  • To move an agent group, click Move, select the group to move, select the new location, then click Move.

  • To delete an agent group, click Delete, select the group to delete, then click Delete.

69.2.3 Viewing Your Agent Group Hierarchy

When you create nested groups, you can choose how much of the hierarchy you want displayed.

On Windows, at the Monitor Agent server console:

  • To open and close groups, click the plus or minus icons next to each folder.

  • To expand your entire group hierarchy, click View > Expand Tree.

  • To collapse your entire group hierarchy, click View > Collapse Tree.

  • You can decide whether you want to view just the agents in the currently selected group or the agents in subgroups as well. By default, only the agents in the selected folder are listed in the agent window. Right-click an agent group, then click Show Subgroup Agents to display the contents of nested groups along with the selected group.

Monitor Agent Server Console with Subgroup Agents Displayed

Numbers in brackets next to each group indicate the number of agents in the selected group and the total number displayed.

69.2.4 Configuring an Agent Group

Configuration settings for monitoring can be set individually for each monitored agent, for each agent group, or for all monitored agents collectively.

You can establish default configuration settings for all agents by setting them on the root agent group that is named the same as your GroupWise system. Those default settings can be inherited by each subgroup that you create thereafter if you select Apply Options to Subgroups. Those default settings can be overridden by establishing different settings for an agent group or for an individual agent if you deselect Use Parent Options.