Restoring Data from Unstructured Files

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

• You will need an unstructured files dSource, as described in Linking Unstructured Files, or an existing vFiles from which you want to provision another.
• The target environment must meet the requirements outlined in Unstructured Files Environment Requirements.

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.

Related Links

Unstructured Files - Getting Started

Provisioning Unstructured Files as vFiles

Customizing vFiles with Hook Operations