Bug: SA Backup Tool Restore Fails With "The Syntax of the Command Is Incorrect"

Version Affected: All
Bug Number: EE-558
Bug Status: Open - No Permanent Fix
Fixed in Version(s): Not yet fixed as of this article's last review — check current release notes for status.

 

Overview

When restoring from a backup with the SA Backup Tool, the restore fails and the window closes without a message. Running the tool from an admin command prompt instead shows the error: "The syntax of the command is incorrect."

 

Cause

The password used with the SA Backup Tool contains an unsupported character.

Resolution / Workaround

When creating a backup with the SA Backup Tool, only use special characters from this supported list: [@#$%*()+?]. Note that ! is not in this list.

1. Start the SA Backup Tool as Administrator.
2. Set a new password that does not use !.
3. Use this password to perform the restore.

Special Considerations

The backup and restore tool is most often used for migrations, when both servers are available. If you cannot create a new backup because the original server is down, raise a case with SecureAuth Support.

SecureAuth Knowledge Base Articles provide information based on specific use cases and may not apply to all appliances or configurations. Be advised that these instructions could cause harm to the environment if not followed correctly or if they do not apply to the current use case.

Customers are responsible for their own due diligence prior to utilizing this information and agree that SecureAuth is not liable for any issues caused by misconfiguration directly or indirectly related to SecureAuth products.