Recover a primary storage zones controller configuration

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

Storage zones controller provides these options for disaster recovery when a primary storage zones controller is deleted or fails:

• If a secondary storage zones controller is available, promote the secondary controller to a primary one.
• If a secondary storage zones controller is not available and you backed up your primary storage zones controller configuration (as described in Back up a primary storage zones controller configuration), recover the primary storage zones controller from the backup file.
• If you do not have a backup of your primary storage zones controller configuration and all of your storage zones controllers are accidentally deleted or become unusable, only partial recovery is possible. You can recover zones and the configuration for storage zones for ShareFile Data, but not storage zones connectors.

To recover a primary storage zones controller from a backup file

Note:

These steps apply only to a primary storage zones controller. To recover a secondary storage zones controller, reinstall the storage zones controller on the server and then join the server to the primary storage zones controller.

1. Open Command Prompt as an Administrator.

2. Navigate to the Toolbox folder: cd C:\inetpub\wwwroot\ShareFile\StorageCenter\6.0.0\Toolbox

3. To see available options run: .\SzcToolBox.exe config restore -h

4. To restore configuration run config restore command.

   Usage:

   .\SzcToolBox config restore <backup-path> <passphrase> [options]

   Arguments:

   Argument	Description	Examples
   <backup-path>	Backup file name and location.	C:\szcbackup\szc-backup.zip
   <passphrase>	Backup file passphrase.	N/A

   Options:

   Options	Description	Examples
   --force	Overwrite existing configuration if any [default: False]	N/A
   --ps-exec-location	PsExec location if differs from current directory. [default: C:\inetpub\wwwroot\ShareFile\StorageCenter.0.0\Toolbox]	C:\PSTools\PsExec64.exe C:\PSTools\PsExec.exe
   -?, -h, --help	Show help and usage information	N/A

   Example:

   .\SzcToolBox.exe config restore C:\szcbackup\backup-6.0.0-2024-12-04-13-06-15.zip SZCPassphrase --force

To recover a primary storage zones controller without a backup file

1. Open Command Prompt as an Administrator.

2. Navigate to the Toolbox folder: cd C:\inetpub\wwwroot\ShareFile\StorageCenter\6.0.0\Toolbox

3. To see available options run: .\SzcToolBox.exe config recovery -h

4. To recover configuration run config recovery command.

5. You may need to restart IIS and StorageZone Controller services.

   Usage:

   .\SzcToolBox config recovery [options]

   Option:

   Option	Description	Examples
   –ps-exec-location	PsExec location if differs from current directory.[default: C:\inetpub\wwwroot\ShareFile\StorageCenter.0.0\Toolbox]	C:\PSTools\PsExec64.exe C:\PSTools\PsExec.exe
   –account-url	Account’s URL	https://%subdomain%.sharefile.com
   –zone-id	Zone ID (right-click your zone from ShareFileaccount Admin -> Storage Zones and copy the zoneid from the link address. eg zae4fb8c-8520-478f-8f87-aa589a8fd181)	zae4fb8c-8520-478f-8f87-aa589a8fd181
   –sf-user	ShareFile User Name
   –sf-password	ShareFile Password
   –storage-zone-location	Storage location (only needed if your zone has StorageZone for ShareFile Data enabled)
   –passphrase	Config Passphrase
   –storage-user	Username to access storage location (only needed if your zone has StorageZone for ShareFile Data enabled and your storage location requires authentication)
   –storage-password	Password to access storage location (only needed if your zone has StorageZone for ShareFile Data enabled and your storage location requires authentication)
   –azure-account	Azure account name (only needed if your zone data is stored in a Windows Azure storage container)
   –azure-secret-key	Azure secret key (only needed if your zone data is stored in a Windows Azure storage container)
   –azure-container	Azure container name (only needed if your zone data is stored in a Windows Azure storage container)
   –s3-access-key	S3 access key ID (only needed if your zone data is stored in a Amazon S3 storage container)
   –s3-secret-key	S3 secret key ID (only needed if your zone data is stored in a Amazon S3 storage container)
   –s3-container	S3 container/bucket name (only needed if your zone data is stored in a Amazon S3 storage container)
   –s3-endpoint	S3-compatible storage endpoint address (only needed if your zone data is stored in a S3-compatible storage container)
   –s3-force-path-style	Indicates whether S3-compatible storage should use path style for container addresses (only needed if your zone data is stored in a S3-compatible storage container)
   –storage-center-id	StorageCenter ID (right-click your StorageCenter from Admin -> Storage Zones -> Your Zone -> Your StorageCenter and copy the id from the link address. e.g. scd344cf-8043-4ce2-974b-8f9cd83e2978)	scd344cf-8043-4ce2-974b-8f9cd83e2978

Example:

.\SzcToolBox config recovery --ps-exec-location "%PsExec path%" --account-url "https://%subdomain%.sharefile.com" --zone-id %zone id% --sf-user %ShareFile user email% --sf-password %ShareFile user password% --passphrase %passphrase% --storage-center-id %storage center id% --storage-zone-location "%storage location path%" --storage-user %domain username% --storage-password %domain user password%
<!--NeedCopy-->

.\SzcToolBox config recovery --ps-exec-location "%PsExec path%" --account-url "https://%subdomain%.sharefile.com" --zone-id %zone id% --sf-user %ShareFile user email% --sf-password %ShareFile user password% --passphrase %passphrase% --storage-center-id %storage center id% --azure-account %Azure account% --azure-secret-key %Azure secret key% --azure-container %Azure blob container%
<!--NeedCopy-->

.\SzcToolBox config recovery --ps-exec-location "%PsExec path%" --account-url "https://%subdomain%.sharefile.com" --zone-id %zone id% --sf-user %ShareFile user email% --sf-password %ShareFile user password% --passphrase %passphrase% --storage-center-id %storage center id% --s3-access-key %Amazon access key% --s3-secret-key %Amazon secret key% --s3-container %Amazon S3 bucket%
<!--NeedCopy-->