| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
noresm:norstoretape [2014-04-25 15:08:08]
ingo.bethke@gmail.com |
noresm:norstoretape [2022-05-31 09:29:32] (current)
|
| A collection of high-level tape tools is available in **/projects/NS2345K/tools**. | A collection of high-level tape tools is available in **/projects/NS2345K/tools**. |
| |
| ==== disk2tape ==== | ==== noresm2tape ==== |
| | |
| disk2tape is a script for copying a folder from NorStore's disk area to NorStore's tape resource. | |
| |
| | noresm2tape copies the output of a NorESM case from NorStore's disk area to NorStore's tape resource. The output folder should be organised in the standard CCSM way (e.g., atmospheric output is expected in 'atm/hist'). If that is not the case, please use the command disk2tape instead. |
| |
| **IMPORTANT:** It is highly recommended to run the script in background using the nohup command, e.g., | **IMPORTANT:** It is highly recommended to run the script in background using the nohup command, e.g., |
| "''nohup /projects/NS2345K/tools/disk2tape <path on disk> <path on tape> &''". Make sure not to forget the "&" at the end of the line. After submitting the script with nohup, it is safe to log out. | "''nohup /projects/NS2345K/tools/noresm2tape <path on disk> <path on tape> &''". Make sure not to forget the "&" at the end of the line. After submitting the script with nohup, it is safe to log out. You will receive a notification email when the transfer to tape is completed. |
| |
| |
| Run ''disk2tape -h'' to print detailed instructions: | Run ''/projects/NS2345K/tools/noresm2tape -h'' to print detailed instructions: |
| <file> | <file> |
| |
| Usage: disk2tape <path on disk> <path on tape> [none|gzip|bzip2] | Usage: noresm2tape <path on disk> <path on tape> <chunk size> <replication flag> |
| | |
| Example: disk2tape /projects/NS2345K/hirlam_nobackup /tape/NS2345K/hirlam | Example: noresm2tape /scratch/ingo/mycase /tape/NS2345K/cases/mycase auto replica |
| | |
| Purpose: Copies a folder from disk to tape. | Purpose: Copies NorESM case output from disk to tape. |
| |
| Description: <path on disk> must be the absolute path to the input folder. | Description: <path on disk> and <path on tape> must be full path names (see example). |
| | |
| | <chunk size> must be one of: auto, all, 1, 10, 100, or 1000 (numbers |
| | indicate simulation years per chunk) |
| | |
| | <replication flag> must be either 'replica' - resulting in two tape copies - |
| | or 'noreplica'. |
| | |
| The output folder <path on tape> will be created - with parent | The output folder <path on tape> will be created - with parent |
| directories if necessary - and must not exist before running this | directories if necessary - and must not exist before running this |
| |
| The input data is staged in form of tar-chuncks in | The input data is staged in form of tar-chuncks in |
| /scratch/ingo/copytotape. The tar-chunks are removed from scratch | /scratch/ingo/noresm2tape. The tar-chunks are removed from |
| after successful transfer to tape. | scratch after successfull transfer to tape. |
| | |
| | Checksums for all input files are computed and stored in a separate |
| | checksum file. The checksums are used to verify the tar-chunks. |
| | </file> |
| | |
| | |
| | ==== disk2tape ==== |
| | |
| | disk2tape copies a folder from NorStore's disk area to NorStore's tape resource. In contrast to noresm2tape, the data folder can have any structure and content. |
| | |
| | **IMPORTANT:** It is highly recommended to run the script in background using the nohup command, e.g., |
| | "''nohup /projects/NS2345K/tools/disk2tape <path on disk> <path on tape> &''". Make sure not to forget the "&" at the end of the line. After submitting the script with nohup, it is safe to log out. You will receive a notification email when the transfer to tape is completed. |
| | |
| | Run ''/projects/NS2345K/tools/disk2tape -h'' to print detailed instructions: |
| | <file> |
| | Usage: disk2tape <path on disk> <path on tape> [none|gzip|bzip2] [replicate] |
| | |
| | Example: disk2tape /projects/NS2345K/hirlam /tape/NS2345K/hirlam |
| | |
| | Purpose: Copies a folder from disk to tape. |
| | |
| | Description: <path on disk> must be the absolute path to the input folder. |
| | |
| | <path on tape> will be created - with parent directories if |
| | necessary - and must not exist before running this script. |
| | |
| | gzip or bzip2 compression will be performed if the third argument is |
| | set to "gzip" or "bzip2", respectively. The default is no compression. |
| | |
| | If the forth argument is set to "replicate" then a second copy of |
| | the data will be stored on another physical tape medium. |
| | The path of the additional copy differs from the path of the first |
| | copy by that /tape is replaced with /replica. |
| | |
| | The input data is staged in form of tar-chuncks in |
| | /scratch/$USER/`basename $0`. The tar-chunks are removed from |
| | scratch after success transfer to tape. |
| |
| The size of a single tar-chunk is about 15Gb if no compression is | The size of a single tar-chunk is about 15Gb if no compression is |
| ==== tape2disk ==== | ==== tape2disk ==== |
| |
| tape2disk is a script for retrieve a folder from NorStore's tape area. All tar-archieves are unpacked. | tape2disk copies a folder that had been put on tape with either noresm2tape or disk2tape. All tar-archieves found in the top-level folder are unpacked while tar-files stored within tar-files are not inflated. |
| |
| Run ''tape2disk -h'' to print detailed instructions: | Run ''/projects/NS2345K/tools/tape2disk -h'' to print detailed instructions: |
| <file> | <file> |
| |
| Usage: tape2disk <path on tape> <path on disk> | Usage: /projects/NS2345K/tools/tape2disk <path on tape> <path on disk> |
| | |
| Example: tape2disk /tape/NS2345K/hirlam /scratch/ingo/hirlam | Example: /projects/NS2345K/tools/tape2disk /tape/NS2345K/hirlam /scratch/ingo/hirlam |
| | |
| Purpose: Retrieves a folder from tape and unpacks all tar-archieves contained in it. | Purpose: Retrieves a folder from tape and unpacks all tar-archieves contained in it. |
| ==== listontape ==== | ==== listontape ==== |
| |
| listontape is a script list all files that are archived in a tape folder. | listontape lists all files that are archived in a tape folder. |
| |
| Run ''listontape -h'' to print detailed instructions: | Run ''/projects/NS2345K/tools/listontape -h'' to print detailed instructions: |
| <file> | <file> |
| |
| Usage: listontape <path to data-directory on tape> | Usage: /projects/NS2345K/tools/listontape <path to data-directory on tape> |
| or | or |
| listontape <path to checksum file on tape> | /projects/NS2345K/tools/listontape <path to checksum file on tape> |
| |
| Example: listontape /tape/NS2345K/hirham_nobackup/BCM | Example: /projects/NS2345K/tools/listontape /tape/NS2345K/hirham_nobackup/BCM |
| or | or |
| listontape /tape/NS2345K/hirham_nobackup/BCM/BCM.md5.tar | /projects/NS2345K/tools/listontape /tape/NS2345K/hirham_nobackup/BCM/BCM.md5.tar |
| | |
| Purpose: Lists the names of files that are archived in a given directory on tape. | Purpose: Lists the names of files that are archived in a given directory on tape. |