User Customizable Transfer Script

Quantum provides a default transfer script that uses SCP for the highest level of security. The choice of file-transfer technologies is dependent on local considerations for performance and security.

When the Alternate Store Location feature is configured, the same script is used for the Alternate Retrieval Location feature. Its two modes (store and retrieve) are distinguished by the value of the fourth parameter, which is set to ALTSTORE for the Alternate Store Location feature.

When the transfer script is in ALTSTORE mode, it uses the root user ID at the main site for sending files since it must be able to read all users’ files, and uses the altstore user ID to write files into the remote site’s staging directory. When the transfer script is also used for the Alternate Retrieval Location feature, it must use root privileges on the remote site as well to be able to read any file.

Instructions are provided inside the script for creating the altstore user and setting up Secure Shell (SSH) credentials for running the script. To test the credentials, while running as root on the main site, you should be able to use the scp command to copy a file to the altstore user’s home directory on the remote site.

When both the Alternate Store Location feature and the Alternate Retrieval Location feature are configured, do not create the altstore user on the remote site. Instead, set up SSH credentials for the root user to access the remote site as root, and change the value of ALTSTORE_TXFR_USERNAME to root in the
/usr/adic/TSM/config/fs_sysparm_override file.

If you prefer to use a different script, create a new executable file under a new name so your custom script is not overwritten when StorNext is upgraded. Set the ALTSTORE_TXFR_SCRIPT parameter in
/usr/adic/TSM/config/fs_sysparm_override to the pathname of the executable. The Alternate Store Location parameters for the executable are as follows:

  1. Main-site full pathname of the file to transfer.
  2. Remote site IP address or Host Name (as configured with fsaltnode).
  3. Remote-site full pathname of the file in the staging area.
  4. The word “ALTSTORE”, which indicates that the executable is being invoked for stores. When the parameter is missing, the executable is being invoked for retrieves.