dsssnapshotrestore - DSS 6 | Data Source Solutions Documentation

Documentation: dsssnapshotrestore - DSS 6 | Data Source Solutions Documentation

dsssnapshotrestore

Usage

dsssnapshotrestore [-Rurl] [-ddescr] [-Vaccessmeth] newhub snapshot_pathRestore a newhub from the snapshot_path.

Description

Command dsssnapshotrestore restores a hub from a hub snapshot created by command dsssnapshotsave.

Argument newhub indicates the name of the hub to be restored from the snapshot. This should be a new name that does not exist in the repository, i.e. it must be unique within one repository.

Argument snapshot_path is a path (relative or absolute) to a snapshot zip file generated by the dsssnapshotsave command. The restored hub is created in the frozen state.

Options

This section describes the options available for command dsssnapshotrestore.

Parameter Description

Parameter	Description
`-ddescr`	Replace the hub description with new description `descr`. For example, the following command replaces the hub (e.g., myhub) description with "Test hub". `dsssnapshotrestore -d "Test hub" mynewhub my_hub_snapshot`
`-Rurl`	Remote hub server. Access the hub server running on a remote machine, via the REST interface. This option is required for remote CLI access. When using this option, command dsslogin should be run first, for authentication. For example, the following command restores a new hub (e.g., mynewhub) from a hub snapshot file (e.g., my_hub_snapshot) on a remote hub server: `dsssnapshotrestore -R http://node:port mynewhub my_hub_snapshot`
`-Vaccessmeth`	Supply transport encryption key for decoding secret and confidential data. Valid values for `accessmeth` are: @inputfile: Apply transport encryption key stored in a inputfile. This can also be a path (relative or absolute) to this file. @prompt: Prompt a user to enter the transport key via keyboard.

-ddescr

Replace the hub description with new description descr.

For example, the following command replaces the hub (e.g., myhub) description with "Test hub".

dsssnapshotrestore -d "Test hub" mynewhub my_hub_snapshot

-Rurl

Remote hub server. Access the hub server running on a remote machine, via the REST interface.

This option is required for remote CLI access. When using this option, command dsslogin should be run first, for authentication.

For example, the following command restores a new hub (e.g., mynewhub) from a hub snapshot file (e.g., my_hub_snapshot) on a remote hub server:

dsssnapshotrestore -R http://node:port mynewhub my_hub_snapshot

-Vaccessmeth

Supply transport encryption key for decoding secret and confidential data.

Valid values for accessmeth are:

@inputfile: Apply transport encryption key stored in a inputfile. This can also be a path (relative or absolute) to this file.
@prompt: Prompt a user to enter the transport key via keyboard.

Examples

This section provides examples of using the dsssnapshotrestore command.

Example 1. Restore a hub from hub snapshot

The following command restores a new hub (e.g., myhub) from a hub snapshot file (e.g., my_hub_snapshot).

dsssnapshotrestore myhub my_hub_snapshot

Example 2. Restore a hub from hub snapshot using transport encryption key

The following command restores a new hub (e.g., myhub) from a hub snapshot file (e.g., my_hub_snapshot) using a transport encryption key from a file enc_key.zip.

dsssnapshotrestore -V @enc_key myhub my_hub_snapshot