db2iprune - Reduce installation image size command
The db2iprune command can reduce the size of your Db2® product installation image before installation.
This tool is useful for large-scale deployments of Db2 database
products, as well as for embedding Db2 within an
application. Using the input file, or .prn
file, which contains a full list of
removable products, components, and languages, you can specify what you would like to remove from
the installation image. The db2iprune command calls the input file and removes
the files associated with those components and languages. The result is a new, smaller Db2
installation image that can be installed by using the regular Db2
installation methods.
You cannot prune all products. At a minimum, one product must be still part of the resulting image.
Authorization
None
Required connection
None
Command syntax
Command parameters
- -r input_file_path
- Specifies the full path to the input file that is to be used.
The input file, or
.prn
file, contains a full list of removable components and is used to indicate which products, components, and languages you would like to remove from the installation image. - -p root_directory_path
- (On Windows operating systems only.) Specifies the full path to the root directory of the source installation image. This directory contains setup and is the root directory of the Db2 installation DVD.
- -o destination_directory_path
- Specifies the full path to where the new Db2 pruned image is copied. Make sure that you have write access to this directory.
- -c
- Specifies that you want to prune the source installation image directly. Ensure that the source installation image directory is writable.
- -l log_filename
- Enables error logging. On Linux® and UNIX operating systems, if the -l parameter is not specified, the default log file name is tmpdir/db2iprune_username.log. On Windows operating systems, the log file db2iprune.log is written to the destination directory.
- -t trace_file
- (On Linux and UNIX operating systems only.) Turns on the debug mode. The debug information is written to the file name specified.
- -? | -h
- Displays the usage information.
Examples
c:\db2client.prn
, the Db2
setup.exe file is located in d:\, and you want your pruned
IBM Data Server
Client
image to be copied to the e:\compact_client directory, you would enter the
following command at the command prompt:
db2iprune.exe -r c:\db2client.prn -p d:\ -o e:\compact_client
db2iprune -r /tmp/db2client.prn -o /compact_client
Usage notes
- On Windows operating systems
dvd_drive:\db2\Windows\utilities\db2iprune
- On Linux and UNIX operating systems
product image/db2/platform/utilities/db2iprune