Removing unused GIM bundles

You can remove GIM bundles from your GIM server if they are no longer used on any database server.

About this task

This function enables you to maintain your inventory of GIM bundles and prevent it from using disk space unnecessarily.

You can use two new Guardium API commands to identify and remove unused GIM bundles. Perform this procedure on each Guardium system that acts as a GIM server.

Procedure

  1. Run the gim_list_unused_bundles command to identify unused bundles for FAM install. Use the includeLatest parameter to indicate whether you want the list that is returned by the command to include the latest version of each GIM bundle. You might have some bundles that you have not yet distributed, or you might want to keep one older version so that you can reinstall it if needed. Set includeLatest to 0 to exclude the latest unused version of each bundle from the command results. Set it to 1 to include all unused versions. This parameter is required and no default value is provided. For example:
    gim_list_unused_bundles includeLatest=0
    The command returns a list of GIM bundles that are found on the GIM server but are not installed on any database server whose GIM client works with this GIM server.
  2. If step 1 identifies some unused bundles, use the gim_remove_bundle command to remove each unwanted bundle. This command takes a single parameter, bundlePackageName, which identifies the bundle to be removed. This parameter is required and no default value is provided. Use names that are returned by the gim_list_unused_bundles command.
    The named bundle is removed only if:
    • The name specified in bundlePackageName matches the name of one and only one specific GIM bundle.
    • There is no GIM bundle whose name matches bundlePackageName installed on any database server whose GIM client works with this GIM server.
    For example:
    gim_remove_bundle bundlePackageName=name
    where name is a bundle name that was returned by the gim_list_unused_bundles command.

Results

GIM bundles that are not needed are removed from your GIM server.