dm_register_directory |
If your user account has the Write or Own permission level on an existing collection in DME, and if that existing collection has been configured to contain another collection, you can recursively register data (copy files within folders) from your local system into that existing collection. By default, the dm_register_directory command registers all files and directories in the source directory.
The character limit for each metadata value is 2700.
|
Run the following command:
|
The following table describes each option:
Option | Description | ||
---|---|---|---|
-c | If you want to turn on checksum calculation for validation of data transfer, specify this option.
| ||
-d | |||
-e <path-to-exclude-file> | If you want to exclude files, specify this option. The system excludes the files that match the patterns specified in the file <path-to-exclude-file>. | ||
-h | If you want to print a usage (help) message for this command, specify this option. | ||
-i <path-to-include-file> | If you want to include files, specify this option. The system includes the files that match at least one of the patterns specified in <path-to-include-file>. | ||
-l <files-list> | If you want to register specific files and exclude all others, specify this option. The system registers the files mentioned in the <files-list> only. In each line of the <files-list> file, specify a relative path to the <source-path>. | ||
-m | If you want to register metadata only (for files that already exist), specify this option. The system does not register files. | ||
-s | If you want to skip the default confirmation prompt and register directly, use this option. | ||
-t <num-threads> | If you want to use this parameter, contact NCIDataVault@mail.nih.gov for guidance.
| ||
-x | If you want to extract metadata from the header of TIFF or BMP image files, use this option. |
The following table describes each parameter:
Parameter | Description |
---|---|
<source-path> | A path in your local system, specifying the data that you want to register. The system registers the contents of the folder you specify. |
<destination-path> | A path within DME, specifying where you want the system to create the data. |
If the system prompts you to confirm the registration, type Y and press Enter. The command recursively registers files and directories from the directory specified in the <source-path> to the <destination-path>.
To verify uploaded files, use the dm_get_dataobject command. The system-generated metadata data_transfer_status displays ARCHIVED for files successfully uploaded to DME. For details, refer to Retrieving the Metadata of a Data File via the CLU.
To view an example, click the following link:
|