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
-
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.
- 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.