Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
SQL Safe provides you with CLI commands to help you manually
set
perform an instant restore
operations
to a database.

 

To perform
an instant restore operation
InstantRestore operations use the following commands:
  • SQLsafeCmd RestoreLast InstantRestore <db_name> <backup_archive> [options]

including the required options:

OptionDescription

-BackupLocation <filename>

<filename> - the filename pattern to restore.

The most recent backup file matching this pattern will
be restored.

 Set this to TSM for Tivoli Storage Manager.

-DatabaseName <db_name><db_name> - the database to restore.

Common Options

  • SQLsafeCmd InstantRestore <db_name> <point_in_time> [options]

 

Where: 
Action
Description
<db_name>Name of the database.
<backup_archive>Path to the backup archive.

<point_in_time>

Date/Time {"MM/dd/yyyy hh:mm:ss"} to restore to.

Common Options

The following options help you perform InstantRestore There are common options to perform restore operations:

Options
Descriptions
-BackupSet <index><index> - the index of the backup set within the backup archive. (1-based).
-DisconnectUsersDisconnects all users from the target database before the restore operation begins.
-EncryptedRestorePassword <pwd><pwd> - the encrypted password used to decrypt the backup.
-InstanceName <name>

<name> - SQL server instance name.

Note: it is not required if instance is the instance is set as a default instance on the target server.

-Move <logical_filename> <target_filename>

Move To move the database logical database file to the physical target file.

<logical_filename> - the database logical database file.

<target_filename> - the physical target file.

Corresponds to the WITH MOVE option in the RESTORE DATABASE T/SQL command.

-Password <pwd><pwd> - the non-encrypted password used to encrypt the backup.

Security Options

-Server <hostname>

<hostname> - the hostname of server hosting the SQL Server where the operation should be performed.

Note: this option is required for accessing remote or clustered SQL Servers (where applicable).

-ReplaceOverride database if exists.

Security Options

Secure your InstantRestore operations with the following optionsThere are different options to provide security to your restore last operations:

Options
Description
-NoPrompt  Never prompt for credentials even if necessary.
-SecurityModel <model>

The security model used to log into SQL Server.

<model> - Integrated or SQL {Integrated, SQL}.

Note: Integrated (Windows authentication) is the default.

-SqlUsername <username><username> - the SQL Server username. (SQL SecurityModel).
-SqlPassword <pwd><pwd> - the SQL Server password. (SQL SecurityModel).
-EncryptedSqlPassword <pwd><pwd> - the encrypted SQL Server password generated by EncryptSqlPassword action. (SQL
SecurityModel).
-WindowsUsername <domain\user><domain\user> - the Windows user that will be used to read/write the backup archive.
-WindowsPassword <pwd><pwd> - the password for the Windows user.
-EncryptedWindowsPassword <pwd><pwd> - the encrypted password for the Windows user generated by EncryptWindowsPassword action. 

Advanced Options

The following table illustrates advanced restore last options help you perform InstantRestore operations:

Instructs SQL Server to continue the operation despite encountering errors such as invalid checksums.

Note: SQL 2005 and later onlyRetryReads <interval> <retry_time> <total_time>
Options
Description
-ArgsFile <filename>

The path to a file containing command-line arguments.

<filename> - specifies the file that contains the command line arguments.

-Diff <filename>

The differential backup.

-ContinueAfterError

<filename> - the file path to the differential backup.

This can be followed by -BackupFile, -BackupSet, or -Password to set individual options for this backup set.

-Log <filename>

The log backup.

<filename> the file path to the log backup.

This can be followed by -BackupFile, -BackupSet, or -Password to set individual options for this backup set.

-BackupFile <filename>

Specifies additional backup archive files to be used for striping backups.

<filename> - specifies the backup archive files.

 Note: use once for each additional stripe

.

-IncludeLogins

For backup, includes the database logins in the backup file.

For restore, creates the logins from the backup file on the destination server.

-KeepReplication

Preserves replication settings when restoring a published database to a server other than that on which it was created.

-NoChecksum

Disables the validation of any checksums by the restore operation.

Note: for SQL 2005 and later only.

-MailTo <email_address>

<email_address> - an e-mail email address(es) to send a the notification via SMTP.

Note: multiple addresses may be separated by spaces, semicolons, or commas.

-NoStatus

Prevents status messages from being cached or sent to the Repository.

-RecoveryMode <mode> [-UndoFile <filename>]

Specifies the mode in which to leave the database after the operation is completed.

 <mode> <mode> -  {NoRecovery or , Standby}.

Note: for Standby mode an undo file may be specified with the -UndoFile option.

-

On a network file error, retry every certain amount of time.

<interval> - retry from every certain amount of time in seconds.

<retry_time> - retry up to certain amount of time in seconds.

<total_time> - total retry time allowed in minutes.

-UndoFile <filename>

<filename> - specifies the ABSOLUTE path to the undo filename.

Note: for Standby recovery mode only.

Tivoli Storage Manager Options

The following table illustrates the TSM options:

<port> - the TCP/IP port address for the TSM server
StopAt <datetime>

Specifies the database to be restored to the state it was in as of the specified date and time.

<datetime> - {"mm/dd/yyyy hh:mm:ss"}.

 Note: for Log BackupType only.

-StopAtMark <mark> [-After <datetime>]

Specifies recovery to the specified <mark>, including the transaction that contains the <mark>.

Note: for Log BackupType only.

-StopBeforeMark <mark> [-After <datetime>]

Specifies recovery to the specified <mark> but does not include the transaction that contains the <mark>.

Note: for Log BackupType only.

-After <datetime>

Recovery stops at the first <mark> having the specified name exactly at or after <datetime>.

Note: only valid with -StopAtMark/-StopBeforeMark options.

For Log BackupType only.

-Wait

Wait for hydration to complete before returning result of operation.

Note: by default, it is set to return result of bringing database online

Options
 Description
-TsmClientOwnerName <name><name> - the client owner name.
-TsmClientOwnerPassword <pwd><pwd> - the client owner password.
-EncryptedTsmClientOwnerPassword <pwd><pwd> - the encrypted TSM client owner password.
-TsmConfigFile <filename><filename> - the configuration file location.
-TsmHighLevel <name><name> - the high level file specification (path).
-TsmLowLevel <name><name> - the low level file specification (file name).
-TsmTcpServerAddress <address><address> - the TCP/IP address for the TSM server.
-TsmTcpPort <port>

.

For detailed descriptions and available options, see the CLI Help (SQLsafecmd help restoreinstantrestore).

SQL Safe is a high-performance backup and recovery solution for your SQL Servers. Learn more > >

...