This topic describes the process of restoring data on a source system from a copy stored in the Delphix Engine.
When creating a dSource, the Delphix Engine takes a backup of your data from the source system. To recover this data from the Delphix Engine, you can create a restoration dataset. Creating a restoration dataset will mount the Delphix-copy of this data to the source environment at a specified location. This data can then be copied out of the mount or accessed by a data restoration tool.
Because this data is meant only for restoration purposes, you cannot use the Delphix Engine to snapshot changes made to the mount or to provision from data in the mount.
Prerequisites
Procedure
1. Login to the command line interface (CLI) using Delphix Admin credentials.
2. Navigate to database and select createRestorationDataset.
delphix> database
delphix database> createRestorationDataset
3. View parameter information using list.
delphix database createRestorationDataset> list
Properties
----------
type: AppDataRestorationDatasetCreationParameters
container:
type: AppDataContainer
name: (required)
description: (unset)
group: (required)
sourcingPolicy: (unset)
source:
type: AppDataRestorationSource
name: (unset)
additionalMountPoints: (unset)
config: (unset)
sourceConfig:
type: AppDataDirectSourceConfig
name: (required)
environmentUser: (unset)
linkingEnabled: true
path: (required)
repository: (required)
timeflowPointParameters:
type: TimeflowPointSemantic
container: (required)
location: LATEST_POINT
Operations
----------
defaults
4. Fill in the required parameter fields, or select defaults.
delphix database createRestorationDataset> set name=restoration
delphix database createRestorationDataset> set group=Untitled
delphix database createRestorationDataset> set sourceConfig.name=restoration
delphix database createRestorationDataset> set sourceConfig.path=/home/delphix/restoration
delphix database createRestorationDataset> set sourceConfig.repository=builtin:files
delphix database createRestorationDataset> set timeflowPointParameters.container=source
delphix database createRestorationDataset> defaults
delphix database createRestorationDataset defaults> set container=source
delphix database createRestorationDataset defaults> commit
delphix database createRestorationDataset> set sourceConfig.repository=builtin:files
5. Create a restoration dataset using commit.
delphix database createRestorationDataset> commit
You now have a restored dSource copy on your source machine mounted to the specified path.
7. Use select to select and manage the restoration dataset. Most source and database operations are not supported for restoration datasets.
delphix database> select restoration
8. When it is time to delete, select the restoration dataset and select delete.
delphix database restoration> delete
delphix database restoration delete *> commit
Supported Operations
Because restoration datasets are not fully provisioned like normal virtual datasets, they do not support the full set of management features available through the Delphix Engine. Restoration datasets support the following operations:
- delete
- refresh
- switchTimeflow
- undo
- enable
- disable
All other source and database operations will result in errors when executed against a restoration dataset.
Unstructured Files - Getting Started
Provisioning Unstructured Files as vFiles
Customizing vFiles with Hook Operations