IBM Tivoli Monitoring, Version 6.3

tacmd exportBundles

Description

Use the tacmd exportBundles command to export one or more deployment bundles to the specified export directory for use with software distribution products. You must run the exportBundles command locally on a server containing a depot or agent installation image as input. A bundle is the combination of an agent silent installation image as well as any necessary prerequisites and configuration information required to silently install an agent on a remote system. An agent deposits a directory on the monitoring server from which you can deploy agents and maintenance packages to remote systems across your environment. If the current OS user has the correct permissions, it is not necessary to have previously run the login command to run the exportBundles command.

CLI syntax

ExportBundles command:

tacmd exportBundles
                       [{-i|--imagePath}IMAGEPATH]
                       {-e|--exportDir} DIRECTORY
                       {-o|--outputFormat} {LOCAL|SPD|SPB}
                       {-t|--product} PRODUCT
                       [{-p|--platform} PLATFORM]
                       [{-v|--version} VERSION ]
                       [{-f|--force}]

ExportBundles command by operating system:

tacmd exportBundles
                       {-i|--imagePath}IMAGEPATH
                       {-e|--exportDir} DIRECTORY
                       {-o|--outputFormat} {LOCAL|SPD|SPB}
                       {-t|--product} PRODUCT
                       {-os|--operatingSystem} OPERATING_SYSTEM]
                       [{-v|--version} VERSION ]
                       [{-f|--force}]

where:

-i |--imagePath

Specifies a directory that contains bundles to be added. The directory you specify should contain files with dsc as the file extension. On UNIX and Linux systems, this is in the UNIX directory of the agent media, and on Windows systems, this is in the Windows\Deploy directory of the agent media. The command uses the depot as the imagePath if no imagePath is specified. This option is required when specifying with -os option.

-e|--exportDir

Specifies the destination directory for the export operation.

-o|--outputFormat

Specifies whether the command creates a local silent installation bundle, creates a Software Package Definition file, or creates a Software Package Block as output. Specifying LOCAL copies a silent installation bundle out to the destination directory for general use with software distribution technologies. The silentInstall.sh or silentInstall.bat script that is available in the destination directory can then be run to install the agent.

Note: You cannot interactively install the exported agent bundle by using the install.sh script because many interactive elements have been removed to optimize the bundle for remote transmission and silent execution using software distribution technologies.

Specifying SPD exports a Software Package Definition (SPD) file and other accompanying agent files so that Tivoli® Configuration Manager (TCM) or Tivoli Provisioning Manager (TPM) can be used to remotely install the agent. When moving the SPD and associated files to another system, the SOURCE_DIR in the default_variable section of the SPD file needs to be updated to reflect the new directory where the agent files are located.

Specifying SPB creates a Software Package Block so that Tivoli Provisioning Manager (TPM) can be used to remotely install the agent.

-t|--product

Specifies the product code of the product to add. The product value corresponds to the value that is displayed in the Product Code field as a result of running the viewDepot or listBundles command.

-p|--platform

Specifies the platform code of the products to add. The platform value corresponds to the value that is displayed in the Host Type field as a result of running the viewDepot or listBundles command.

-v|--version

Specifies the version of the products to add. The version value corresponds to the value that is displayed in the Version field as a result of running the viewDepot or listBundles command. The command exports the latest version if a version is not specified.

-os|--operatingSystem

Specifies the operating system of the products to add. All binaries available for the operating system and corresponding product code will be added to the bundle. The supported operating system values are: LINUX, LINUX_Z, HP, WINDOWS, SOLARIS or AIX.

-f|--force

Performs actions without asking confirmation.

CLI example

This example creates a Software Package Definition file for the Monitoring Agent for Linux OS with the destination directory of \bundle for the export operation and also specifies the directory that contains the bundles to be added:

  tacmd exportBundles -o SPD -t lz -e \bundle -i 
\CAT\itm62a\tmv620-d7310a-200711132133.xlin
ux1\unix -p li6263

This example shows using this command for product code ul, using a -p li6263 option. The exported bundles can be installed on a Linux li6263 machine.

  tacmd exportBundles -t ul -p li6263 -i 
d:\tms623dev_pkg\tmv623dev-d0280a-201010080653.agents\unix  
-o LOCAL -e d:\IBM\exportBundles_dir -f

This example shows using this command for product code ul, using a -os LINUX option. The exported bundles can be installed on a supported Linux interp machine.

  tacmd exportBundles -t ul -os LINUX  -i 
d:\tms623dev_pkg\tmv623dev-d0280a-201010080653.agents\unix  
-o LOCAL -e d:\IBM\exportBundles_dir -f

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback