Storix Software SBAdmin Commands Reference - Manual (Page 28)

Storix System Backup Administrator - 28 - Version 8.2 Commands Reference
stkeys
Purpose:
Create encryption keys on a client for use in encrypting and decrypting backup data.
Use on:
Network or TSM Edition Client or Workstation Edition Administrator
Syntax:
stkeys <operation> [options] –k Keyid
Operations:
-a, --add “description” Add a new encryption key
-r, --remove “string” Remove specified keyed
-l, --list keyID List configured keys
Options:
-b, --bits numbits Number of encryption bits (128, 192, 256)
-f, --force Force keys to be removed without prompting (use with -r)
-h, --hex Encryption key in Hex (length must be at least bits/4)
-k, --key KeyID Encryption Key ID (up to 20 chars)
-t, --text textkey Encryption key in ASCII text (length must be at least bits/8)
Details:
This command is available on every client, and is used to configure the encryption keys used
in encrypting and decrypting backup data. The encryption keys are 128, 192 or 256 bits.
NOTE: This command is always used on the client to configure the keys in place of doing so
from the administrator application. For security reasons, this prevents any network traffic that
might contain the encryption key itself.
Once an encryption key is created and used for a backup, the same key MUST be used to
decrypt the data! If they key is changed or lost, there is no way to restore the backup data
again (and please don’t call Storix, because even they won’t be able to help you)!
The configured keys are stored in a local file on the client, and are referenced using only the
Encryption Key ID you assign to it. This prevents the need to remember the entire encryption
key, and also prevent the need to send the encryption key from one system to another when
using a Network or TSM Edition Administrator.
Encryption keys may be specified either as a hexadecimal number or as a text string that the
command will convert to a hexadecimal number for you. A text string may contain any alpha or
numeric characters, as well as any punctuation characters except for quote (“), colon (:) or