Original Publication Date: 03/09/2008
Updated Date: 06/10/2016
To view or extract the contents of an encrypted user configuration set (UCS) archive file, you must first decrypt the encrypted UCS archive file into a new decrypted archive file by performing the following procedure:
After performing the Decrypt an encrypted UCS archive file into a decrypted archive file procedure, you can view or extract the contents of the encrypted UCS archive file by performing one of the following procedures:
mkdir /var/tmp/<directory>Replace <directory> with a name of your choice.
cp <filename> /var/tmp/<directory>/Replace <filename> with the name of the encrypted UCS archive from which you want to view files, and replace <directory> with the name of the directory that you created in step 2.
cd /var/tmp/<directory>Replace <directory> with the name of the directory that you created in step 2.
/usr/bin/gpg <UCS_filename>Replace <UCS_filename> with the name of the encrypted UCS archive file.
gpg: AES encrypted data:
gpg: /var/local/ucs/filename.ucs: unknown suffix
Enter new filename [configsync-2.0-1-Linux-188.8.131.52.0.178.0.im]:
Important: Do not give this file a .ucs file extension, as this file is not a decrypted UCS archive file, and cannot be installed as a UCS archive file.
tar -ztf <filename>This command provides a list of all the files included in the decrypted archive file.
You can extract the files from the decrypted archive without overwriting your existing configuration, by performing one of the following procedures:
Important: Extracted files will be placed in the current directory. To avoid overwriting your existing configuration, your current directory should be the /var/tmp/ that you created in Step 2 of the Decrypt an encrypted UCS archive file into a new decrypted archive file procedure.
Extracting all files
tar -zxf <filename>This command extracts the files and places them into the current directory. Additionally, this command creates subdirectories to match the directories in which the configuration files are normally stored. For example, this command creates a config directory for the files that are normally contained in the /config directory.
Extracting a single file
tar -zxf <filename> <file-to-extract>For example, to retrieve the bigip.conf file, you must specify the config directory, but not the root directory, so you would type the following command:
tar -zxf decrypted_archive config/bigip.confThis command extracts the file and places it in the current directory. It creates a subdirectory to match the directory in which the configuration file is normally stored. For example, if you extract config/bigip.conf, it creates a config directory.
Note: The third character in the flags list is a capital letter O.
tar -zxOf <filename> <file-to-view>For example, you would type the following command to view the bigip.conf file:
tar -zxOf decrypted_archive config/bigip.conf
Note: You can use wildcards to display multiple files from an archive. For example, config/bigip.*.
Important: Some files contained in a UCS archive are binary files, which do not display correctly.