Adding/Deleting External Agents in Bulk

Using the eG admin interface, you can also add/delete two/more external agents in bulk in the eG Enterprise system. This is very useful, particularly in large IT environments, where massive server farms are managed and needs to be monitored. In such environments, manually adding every external agent to the eG Enterprise system would require a lot of administrative time and effort. Bulk addition/deletion of external agents significantly reduces administrator workload in large IT infrastructures by simplifying agent management and maintenance.

For adding external agents in bulk, do the following:

  1. Login to the eG admin interface.
  2. Follow the Agents -> External Agents menu sequence.
  3. In Figure 1 that then appears, click the Bulk Agents Add/Delete button.

    Choosing to Add External Agents in Bulk

    Figure 1 : Choosing to add/delete external agents in bulk

  4. Figure 2 will then appear. To add external agents in bulk, select the Add option from Figure 2.

    Clicking on Add for Bulk Addition of External Agents

    Figure 2 : Choosing to Add external agents in bulk

  5. Typically, you need to enter the details of all the external agents you want to add in a CSV file. This file should then be uploaded to the eG manager, so that all the external agents configured in the CSV file are added to the eG Enterprise system at one shot. To help you build this CSV file quickly, eG Enterprise provides you with a ready-to-use template. Click on the Download sample CSV link in Figure 2 to download this CSV sample/template to the local host.
  6. Next, proceed to edit the downloaded CSV sample/template. The template is pre-configured with columns to capture information pertaining to an external agent - e.g.,name of the agent, Host IP, client emulations, etc. When editing the template, make sure you fill each column with the information related to the external agent you want to add. A single row in the CSV file will contain all the details required for adding an external agent to the eG Enterprise system. For adding multiple external agents therefore, multiple rows of data need to be provided, as depicted by Figure 3.

    Editing Sample CSV File for Bulk External Agent Addition

    Figure 3 : Editing the sample CSV file to include the details of all external agents to be added in bulk

    Note:

    You can add rows of external agent information to the CSV file, but you should not add new columns to it. Nor can you change the labels of the existing columns.

  7. Once the CSV file is filled in and is ready to be uploaded, save the file. When saving, you can change the name and/or location of the file, if you so want.

    Note:

    Make sure that you do not change the file type (.csv) when saving the file.

  8. Then, using the Browse button in Figure 2, browse for the location of the CSV file. Once the location is specified (see Figure 4), click the Upload button to upload the file to the eG manager.

    Uploading CSV File for Bulk External Agent Addition

    Figure 4 : Uploading the CSV file containing the details of external agents to be added in bulk

  9. Once the CSV file is successfully uploaded to the eG manager, the manager will use the eG CLI to execute commands for adding all the external agents configured in the CSV file. 
  10. If the bulk addition succeeds/fails, a message to the corresponding effect will appear. To troubleshoot failures, use the egCLI.log file in the <EG_MANAGER_INSTALL_DIR>\manager\logs directory (in Windows; in Unix, this will be /opt/egurkha/manager/logs directory).

For deleting external agents in bulk, do the following:

  1. Login to the eG admin interface.
  2. Follow the Agents -> External agents menu sequence.
  3. In Figure 5 that then appears, click the Bulk Agents Add/Delete button.

    Choosing to Delete External Agents in Bulk

    Figure 5 : Choosing to add/delete external agents in bulk

  4. Figure 6 will then appear. To delete external agents in bulk, select the Delete option from Figure 6.

    Clicking Delete for Bulk Deletion of External Agents

    Figure 6 : Choosing to Delete external agents in bulk

  5. Typically, you need to enter the details of all the external agents you want to modify in a CSV file. This file should then be uploaded to the eG manager, so that the configuration of all the components specified in the CSV file are modified at one shot. To help you build this CSV file quickly, eG Enterprise provides you with a ready-to-use template. Click on the Download sample csv link in Figure 6 to download this CSV sample/template to the local host.
  6. Next, proceed to edit the downloaded CSV sample/template. The template is pre-configured with the column for capturing the external agents that need to be deleted - e.g., name of the agent.

    Editing Sample CSV File for Bulk Deletion of External Agents

    Figure 7 : Editing the CSV sample/template to record the changes to be made to the component details

    Note:

    You should not add new columns to the CSV file. Nor can you change the labels of the existing column.

  7. Once the CSV file is filled in and is ready to be uploaded, save the file. When saving, you can change the name and/or location of the file, if you so want.

    Note:

    Make sure that you do not change the file type (.csv) when saving the file.

  8. Then, using the Browse button in Figure 6, browse for the location of the CSV file. Once the location is specified (see Figure 7), click the Upload button to upload the file to the eG manager.

    Uploading CSV File for Bulk Deletion of External Agents

    Figure 8 : Uploading the CSV file containing the details of external agents to be deleted in bulk

  9. Once the CSV file is successfully uploaded to the eG manager, the manager will use the eG CLI to execute commands for deleting all the external agents mentioned in the CSV file. 
  10. If the bulk deletion succeeds/fails, a message to the corresponding effect will appear. To troubleshoot failures, use the egCLI.log file in the <EG_MANAGER_INSTALL_DIR>\manager\logs directory (in Windows; in Unix, this will be /opt/egurkha/manager/logs directory).