Reopening the Dataset
Reopen a dataset.
If changes are necessary after sealing a dataset or finalizing an import appliance, you must reopen the dataset to modify the contents. Make the required changes and again seal the dataset. Resealing the dataset generates a new manifest.
If an import appliance is rebooted or power cycled, follow the instructions in this topic to reopen the dataset.
Step 1: Unlocking the Appliance
You must unlock the appliance before you can write data to it. Unlocking the appliance requires the strong passphrase that is created by Oracle Cloud Infrastructure for each appliance.
Unlock the appliance using one of the following ways:
-
If you provide the
--job-id
and--appliance-label
when running theunlock
command, the data transfer system retrieves the passphrase from Oracle Cloud Infrastructure and sends it to the appliance during the unlock operation. -
You can query Oracle Cloud Infrastructure for the passphrase and provide that passphrase when prompted during the unlock operation.
Unlocking the appliance and send the passphrase to the appliance
Use the oci dts physical-appliance unlock command and required parameters to unlock the import appliance.
oci dts physical-appliance unlock --job-id job_id --appliance-label appliance_label [OPTIONS]
For a complete list of flags and variable options for CLI commands, see the Command Line Reference.
For example:
oci dts physical-appliance unlock --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T
Retrieving the passphrase from Oracle Cloud Infrastructure
{
"data": {
"availableSpaceInBytes": "64.00GB",
"encryptionConfigured": true,
"finalizeStatus": "NOT_FINALIZED",
"lockStatus": "NOT_LOCKED",
"totalSpaceInBytes": "64.00GB"
}
}
Querying Oracle Cloud Infrastructure for the passphrase to provide to unlock the appliance
Use the oci dts appliance get-passphrase command and required parameters to get the import appliance encryption passphrase.
oci dts appliance get-passphrase --job-id job_id --appliance-label appliance_label [OPTIONS]
For a complete list of flags and variable options for CLI commands, see the Command Line Reference.
For example:
oci dts appliance get-passphrase --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T
{
"data": {
"encryption-passphrase": "passphrase"
}
}
Then, run dts physical-appliance unlock
without
--job-id
and --appliance-label
and supply the
passphrase when prompted.
oci dts physical-appliance unlock
Step 2: Reopening the Appliance
Reopen the dataset to write data to the import appliance again.
Reopening an NFS dataset
Use the oci dts nfs-dataset reopen command and required parameters to reopen the import appliance.
oci dts nfs-dataset reopen --name dataset_name [OPTIONS]
For a complete list of flags and variable options for CLI commands, see the Command Line Reference.
Step 3: Repeat Steps to Write Data to the Appliance
Repeat the same tasks you performed when you originally wrote data to the import appliance beginning with activating the dataset in the Copying Files to the NFS Share section.