Back up a primary storage zones controller configuration
A storage zones controller is installed on your local site and you are responsible for backing it up. To fully protect your deployment, you should take a snapshot of the storage zones controller server, back up your configuration, and Prepare storage zones controller for file recovery.
It is critical that you back up your configuration as described in this topic. For example, if you do not have a backup and someone accidentally deletes a zone, you cannot recover the folders and files in that zone.
The Storage Zone Controller CLI tool can be used to back up and restore a primary storage zones controller configuration settings. Your backup includes configuration information for zones, storage zones for ShareFile Data, storage zone connector for SharePoint, and storage zone connector for Network File Shares.
The backup and restore commands require the user context to be changed to the Network Service account using the PSExec tool, which can be downloaded from https://learn.microsoft.com/en-us/sysinternals/downloads/psexec.
To be able to run commands that require impersonation, you can:
-
Use the ps-exec-location command parameter to specify the location of the
PsExec.exe/PsExec64.exe
executable, or -
Place PsExec.exe/PsExec64.exe next to the Storage Zone Controller CLI tool executable (
C:\inetpub\wwwroot\ShareFile\StorageCenter\6.0.0\Toolbox
), or -
Start CMD or PowerShell using PSExec and run the Storage Zone Controller CLI tool in the impersonated CMD/PowerShell session. To start impersonated Powershell session, in the command window, run one the following commands:
PsExec.exe -i -u "NT AUTHORITY\NetworkService" C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell
Note:
These steps do not apply to a secondary storage zones controller. To recover a secondary storage zones controller, reinstall the storage zone controller on the server and then join the server to the primary storage zones controller.
-
Open Command Prompt as an Administrator.
-
Navigate to the Toolbox folder:
cd C:\inetpub\wwwroot\ShareFile\StorageCenter\6.0.0\Toolbox
-
To see available options run:
.\SzcToolBox.exe config backup -h
-
To create a backup file run config backup command. Example:
.\SzcToolBox.exe config backup --output C:\szcbackup\
Command parameters:
Parameters | Description | Examples |
---|---|---|
–output | Backup file name and/or location. |
C:\szcbackup\ C:\szcbackup\szc-backup.zip
|
–ps-exec-location | PsExec location if differs from current directory.[default: C:\inetpub\wwwroot\ShareFile\StorageCenter\6.0.0\Toolbox]
|
C:\PSTools\PsExec64.exe C:\PSTools\PsExec.exe
|
-?, -h, –help | Show help and usage information | N/A |
The Get-SfConfig command creates the backup file.
To restore a primary storage zones controller configuration, see Recover a primary storage zones controller configuration.