DB2 10.5 for Linux, UNIX, and Windows

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

Note: To prune Tivoli® System Automation for Multiplatforms (SA MP) from the install image, you must run the db2iprune command as user root.

Required connection

None

Command syntax


>>-db2iprune-- -r--input_file_path-- -p--root_directory_path---->

>--+- -o--destination_directory_path-+--+-----------------+----->
   '- -c-----------------------------'  '- -t--trace_file-'   

>--+-------------------+--+-----+------------------------------><
   '- -l--log_filename-'  +- -h-+   
                          '- -?-'

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

On Windows operating systems, to prune an IBM® Data Server Client image where the input file is located in 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

On Linux and UNIX operating systems, to prune a IBM Data Server Client image where the input file is located in /tmp/db2client.prn, and you want your pruned IBM Data Server Client image to be copied to the /compact_client directory, you would enter the following command at the command prompt:

db2iprune -r /tmp/db2client.prn -o /compact_client

Usage notes

The db2iprune command and sample input files are provided on the installation DVD:

On Windows operating systems

dvd_drive:\db2\Windows\utilities\db2iprune

On Linux and UNIX operating systems

product image/db2/platform/utilities/db2iprune