Expanding Archive Files on the Target System

InstallAnywhere 2020 SP1

To expand an archive file on target systems, use one of the Expand Archive actions. The following archive file types are supported:

ZIP files (.zip)
Java archives (.jar)
MacBinary files (.bin)
StuffIt files (.sit)
WAR files (.war)
Enterprise archives (.ear)
7-Zip archives (.7z or .xz) with LZMA compression
TAR files (.tar, .gz, and .Z)

The archive files can be installed as part of your installer, or they can be present on target systems.

To expand an archive file on target systems:

1. In the Advanced Designer, on the Sequence page, click Install. The Install view opens.
2. In the Visual Tree, select the destination folder for the archive that you are expanding.
3. Click the Add Action button. The Choose an Action dialog box opens.
4. On the Install tab, click one of the following actions:
Expand Archive—This action lets you expand any of the following types of archives: .zip, .jar, .bin, .sit, .war, or .ear.
Expand Archive (7-zip)—This action lets you expand 7-Zip archives (.7z or .xz) with LZMA compression.
Expand Archive (TAR)—This action lets you expand .tar, .gz, and .Z archives.
5. Click the Add button. InstallAnywhere adds the action to the Visual Tree. The Choose an Action dialog box remains open, enabling you to add additional actions as needed.
6. To move the action up or down in the sequence, use the up or down arrow keys.

To move the archive file to be in a parent folder or a subfolder, use the left or right arrow keys.

To configure the archive’s settings, select the action and use its customizer at the bottom of the view.

About File Permissions of the Extracted Files

The permissions that the installer assigns to files that are extracted from an archive file at run time vary, depending on the type of expand archive action. In some cases, the original permissions of the file are retained. In others, the settings that are made in the Default Permissions setting (Project page > Platforms view > UNIX or Mac OS X areas) are applied to the extracted files. The following table indicates how permissions are applied for these three expand archive actions.

Expand Archive Actions and Extracted File Permissions Comparison

Action

Are Original File Permissions Preserved?

Apply Permissions that Are Set in the Platforms View?

Expand Archive Action

Not guaranteed to be preserved

Yes

Expand Archive (7-zip) Action

No

Not guaranteed to be applied

Expand Archive (TAR) Action

Yes

No

See Also