Managing the Gateway Server agent list

A Gateway Server agent list is the list of servers or nodes from which you want to collect data for the Capacity Planning. The Gateway Server agent list enables you to:

  • Create and manage a list of servers for a gateway server
  • Automate the creation of policy files and manager runs for a gateway server
  • Create multiple manager runs and multiple policy files for each manager run
  • Manage the manager runs and policy files that are manually or automatically created for a gateway server

When you create a Gateway Server agent list, the new list is automatically scheduled for manager run according to the configuration defined.

Recommendations

  • Use the Gateway Server agent list for managing the Gateway Server.

  • If you were manually creating the Manager runs,  use the Gateway Server agent list after you upgrade to the latest version of the Gateway Server.

This topic contains the following sections:


Before you begin

Ensure that the required Gateway Server is added. For more details, see Adding a gateway server.

Viewing a Gateway Server agent list

  1. Select Administration > GATEWAY MANAGER > Gateway Servers.
    The Gateway Servers page is displayed.
  2. Click the name of the required gateway server.
    The Gateway Server details page is displayed.

    ColumnDescription
    NameName of the gateway server agent list.
    Nodes per manager runNumber of nodes defined per manager run.
    Nodes per policyNumber of nodes defined per policy.
    Creation DateDate of creation of the gateway server agent list.
    Agent ListDisplays the path at which the gateway server agent list is stored.

The following image shows an example of the Gateway servers agent list table.

Gateway Server agent list table


Creating a Gateway Server agent list

Ensure that a text file with the list of servers is available on your system. For multiple servers, you can have comma-separated or line-separated entries in the text file. In addition, ensure that you have created default manager run script. For more details, see  Create New Run. When you create a gateway server agent list, the configuration defined in the default manager run script is used. To modify the configuration, update the manager run script before you create a gateway server agent list.

Note

 If you have not created default manager run script, the new agent list will not get created.

  1. Select Administration > GATEWAY MANAGER > Gateway Servers.
    The Gateway Servers page is displayed.
  2. Click the name of the required gateway server.
    The Gateway Server details page is displayed.
  3. Click Add.
    The BMC TrueSight Capacity optimization Wizard is displayed.
  4. On the WELCOME page, click Next.
  5. On the SELECT FILE page, enter the following details:

    FieldDescription
    NameType the required name for the Gateway Server agent list. This name is displayed in the View Scheduled Runs page.
    Local file

    Click Browse to search and select the file with the details of agent nodes.

    Location on gateway serverClick to select or type in the box the required location on Gateway Server where you want to save the file with the agent details.
    By default, the new sub-directory is set as the folder location. For example, /usr/adm/best1_workspace/automation.


  6.  Click Next.
  7. On the Configuration page, enter the following details:

    FieldDescription
    Target Gateway ServerDisplays the name of the selected gateway server for which you are adding the agent list.
    Agent ListDisplays the name defined for the agent list.
    Nodes per policyType the required number of nodes for per policy for each manager run. By default, it is set to 25. If the number of nodes in the agent list file is more than the number of nodes per policy, automatically multiple policies will be created.
    Nodes per manager runType the required number of nodes per manager run. By default, it is set to 100. If the number of nodes in the agent list file is more than the number of nodes per manager run, automatically multiple manager runs will be created.
    UDR repository

    Click to select or type the required location of the UDR repository.

    By default, the new sub-directory is set as the folder location. For example, /usr/adm/best1_workspace/repository.

    Manager output folderClick to select or type the required location of the output folder for saving the results of the manager run.
    By default, the new sub-directory is set as the folder location. For example, /usr/adm/best1_workspace/results.
    Daily data time zoneSelect the required time zone from the list. You can select the time zone of the gateway server or your current time zone or any region specific time zone.
    Collect based on time zoneSelect this check box to collect data based on the selected time zone.
  8. Click Next.
  9. On the Summary page, click Finish.
    User specified agent list is registered, policy files and manager runs are created and scheduled in the gateway server. Single or multiple manager runs are created based on the size of the agent list and the value specified in the Nodes per manager run option. In the case of multiple manager runs, the first one created is tagged as the master.  You can view the newly created manager runs in Viewing scheduled Manager runs.

Uploading or downloading a gateway server agent list

  1. Select Administration > GATEWAY MANAGER > Gateway Servers.
    The Gateway Servers page is displayed.
  2. Click the name of the required gateway server.
    The Gateway Server agent lists page is displayed.
  3. Click to upload and overwrite the corresponding gateway server agent list.
    OR
    Click to download the corresponding gateway server agent list.

Updating an existing gateway server agent list

You can edit an existing agent list for a gateway server to add or remove nodes from which you want to collect data.

  1. Log in to the TrueSight Capacity Optimization console.
  2. Select Administration > GATEWAY MANAGER > Gateway Servers.
    The Gateway Servers page is displayed.
  3. Click the name of the required gateway server for which you want to update the agent list.
    The Gateway Server agent lists page is displayed.
  4. Click to download the agent list for the gateway server.
  5. Open the downloaded agent list in an editor, add or remove nodes, and save the updates.
  6. Click to upload the updated agent list.

The changes to the agent list does not affect the data that is already being collected. These changes affect the next scheduled runs. It usually takes a day or two before data is collected according to the updated agent list.

Removing a gateway server agent list

  1. Select Administration > GATEWAY MANAGER > Gateway Servers.
    The Gateway Servers page is displayed.
  2. Click the name of the required gateway server.
    The Gateway Server agent lists page is displayed.
  3. Click  corresponding to the required Gateway Server agent list to delete gateway server agent list.
    OR
    Select the check box for the agent required Gateway Server agent list and select Actions > Delete gateway server agent lists.

Related topic

Viewing scheduled Manager runs

Was this page helpful? Yes No Submitting... Thank you

Comments