8.10. Extracting Archives

The   Extract action can be used to extract the contents of an archive file with extension .zip, .tar, .tgz, or .tar.gz to a folder in the repository. The archive extraction depends upon how the archive was created. If there is not a top-level folder inside the archive, then files will be extracted directly into the selected folder. For example, fluentzip.zip will be expanded and its contents placed in a folder named fluentzip if there is a top-level folder in the archive with name fluentzip.

The archive extraction process is accomplished using a multi-step wizard. The first step involves the selection of the folder where the archive is to be extracted to. When you click Next, the archive is transferred to a staging area that EKM uses to prepare or extract objects before they are copied to the repository. Overwrite preferences are set when files contained in the archive already exist in the repository. Finally, you set the user-defined property values for all files that require it, and then initiate the extraction.

To extract an archive:

  1. Select the archive, then select   Extract. The Extract wizard will open in the Select Folder step. (Figure 8.41: Selecting a Target Folder for Extracted Files)

    Figure 8.41:  Selecting a Target Folder for Extracted Files

    Selecting a Target Folder for Extracted Files

  2. Click Browse to select a target folder for the extracted files. The default folder that is displayed will be the parent folder of the selected archive provided that you have Create permission on the parent folder and the parent folder is not a Remote Folder.

  3. Click Next. The next step in the wizard will depend on the following:

    1. If there are existing files with the same name in the repository in the same location where you want to extract to, then the next step is to set the overwrite options. You can select individual files to overwrite or check Select all. Click Next to set type and properties.

    2. If there are no files left to extract because you chose not to overwrite existing repository files, then the extraction process will be terminated. If you choose to overwrite some files and not others, the files you skip will not be extracted (or overwritten).

    3. If there are any files that do not satisfy EKM file system requirements, the next step will list these files and they will not be extracted. For example, a file named Document[].txt is not a valid file name in EKM. Another example is an archive that has the same name as another file, or has the same top-level root folder name as the selected archive.

Limitations

The extraction process uses a temporary system folder to hold files in the staging area before they are uploaded. If the temporary folder is full or almost full, then the extraction may not work as expected. Contact your IT staff to clean up the temporary folder on the EKM server.


Release 18.2 - © ANSYS, Inc. All rights reserved.