Unarchive Activity
The Unarchive activity extracts the input files and directories from the passed in archive during run time. At run time, the Unarchive activity determines the archive/compression types and unarchives/decompresses the archive appropriately
About this task
The supported unarchive and decompression formats are
listed in the following table:
Decompression/ Unarchive Formats | Description |
---|---|
tar | During run time, if the Unarchive activity determines that the archive type is tar, the passed in archive is extracted into its component parts (files and directories) and passed back from the activity using the archiveEntries output parameter. The extraction done during run time by the Unarchive activity is equivalent to extraction done on the command line using the UNIX tar -xf command. |
untar and gunzip | During run time, if the Unarchive activity determines that the archive type is tar and the compression type is gzip, the passed in archive is first decompressed from the gzip format and then extracted into its component parts (files and directories) and passed back from the activity using the archiveEntries output parameter. The extraction done during run time by the Unarchive activity is equivalent to extraction done on the command line using the UNIX tar -xf command to files that end in the .tar extension. The decompression done during run time by the Unarchive activity is equivalent to the decompression done on the command line using the GNU gunzip command to files that end in the .gz extension. |
zip | During run time, if the Unarchive activity determines that the archive/compression type is zip, the passed in archive is decompressed and extracted into its component files and directories, and passed back from the activity using the archiveEntries output parameter. The decompression and extraction done during run time by the Unarchive activity is equivalent to the decompression and extraction done using proprietary compression products to files that end in the .zip extension. |
gunzip | During run time, if the Unarchive activity determines that the compression type is gzip, the passed in archive is decompressed from the gzip format and passed back from the activity using the archiveEntries output parameter. The decompression done during run time by the Unarchive activity is equivalent to the decompression done on the command line using the GNU gunzip command to files that end in the .gz extension. |
During run time, if the passed in archive
format is unsupported, the Unarchive activity
produces an ActivityFailedException error and issues the following
message:
Invalid or unsupported archive format
During
run time, if the passed in archive is incorrectly formed, the Unarchive activity
produces an ActivityFailedException error and issues the following
message: Error while reading archive
To add and
configure an Unarchive activity in an orchestration
complete the steps in the following procedures: