The db2iprune command
can reduce the size of your DB2® product
installation image prior to installation.
This tool is useful for large-scale
deployments of DB2, 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
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.
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
- Enables error logging. On Linux and UNIX operating
systems, if the -l option 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,
the DB2 source files are located
on
/mnt/cdrom, 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/mnt/cdrom
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
.