备份和恢复您的安装
Parent page: 安装 Altium Infrastructure Server
Altium Infrastructure Server 可以保存有价值的数据，包括已定义的用户、角色、LDAP Sync 任务，以及 PLS 和 NIS 服务的配置（通常还包括一系列已获取的产品与扩展，以及为后者定义的部署包）。确保这些数据长期完整性的一个关键要求，就是对其进行备份。标准的 Altium Infrastructure Server 安装包含一个备份与还原工具，可通过命令提示符访问。
备份工具的默认位置在文件夹 \Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\ 中。
备份工具的名称是 avbackup.exe。
访问备份工具
使用该工具：
- 启动 Windows 命令提示符。
-
导航到正确的文件夹。对于主机计算机 C 盘上的默认安装，其路径为：
cd C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\ -
要运行该工具并列出可用选项，请在提示符下输入：
avbackup ?
通过命令提示符（以管理员身份运行）访问备份工具。
注意 ?，包含它会显示备份工具中可用功能的帮助信息：
-
backup- 将数据备份到 ZIP 归档。 -
restore- 从 ZIP 归档还原数据。将自动创建还原点。 -
help- 显示帮助屏幕（也可以使用 ? 来替代字符串 help）。
Zip 归档的内容
该工具会备份整个 Infrastructure Server 及用户数据，包括：
- 完整的数据库备份，包括通过 Network Installation Service 获取的安装内容以及 LDAP Synch 设置。
- 所有修订版本。
- 搜索索引。
- 用户定义（自定义）设置。
备份语法与开关
使用该工具的备份功能时，可用的开关如下：
avbackup backup -z [-i] [-m]
-
-z- 要创建的目标 zip 文件的路径和文件名。如果字符串中包含空格，请用引号括起来。此开关为必填。 -
-i- LocalVault.ini 文件的路径与位置，该文件描述要备份的 Altium Infrastructure Server 的当前位置。该文件的默认位置为C:\Program Files (x86)\Altium\Altium Infrastructure Server\。如果未指定此开关，工具将基于该默认安装位置尝试自动查找该文件。如果字符串中包含空格，请用引号括起来。 -
-m- 用于确定备份操作是否应以静默方式运行（-m silent)），或在失败时弹出对话框询问是否重试（-m dialog）。如果未指定此开关，将使用静默模式。
只需输入 avbackup backup，即可列出这些开关作为帮助提示。
在备份模式下使用该工具时可用的开关。
Backup Example
以下条目将以静默方式把 Altium Infrastructure Server 备份到名为 201704_Backup.zip 的文件中，并将该文件写入文件夹 C:\Backups\Altium Infrastructure Server\：
avbackup backup -z "C:\Backups\Altium Infrastructure Server\201704_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Infrastructure Server\LocalVault.ini"
运行示例备份命令的结果。
还原语法与开关
使用该工具的还原功能时，可用的开关如下：
avbackup restore -z [-i] [-m]
-
-z- 用于还原的备份 zip 文件的路径和文件名。如果字符串中包含空格，请用引号括起来。此开关为必填。 -
-i- LocalVault.ini 文件的路径与位置，该文件描述要将 Altium Infrastructure Server 还原到的位置。该文件的默认位置为C:\Program Files (x86)\Altium\Altium Infrastructure Server\。如果未指定此开关，工具将基于该默认安装位置尝试自动查找该文件。如果字符串中包含空格，请用引号括起来。 -
-m- 用于确定还原操作是否应以静默方式运行（-m silent，为默认模式），或在失败时弹出对话框询问是否重试（-m dialog）。如果未指定此开关，将使用静默模式。
只需输入 avbackup restore，即可列出这些开关作为帮助提示。
在还原模式下使用该工具时可用的开关。
Restore Example
以下条目将以静默方式使用名为 201704_Backup.zip 的备份 zip 文件还原 Altium Infrastructure Server，并将文件写入文件夹 C:\Backups\Altium Infrastructure Server\：
avbackup restore -z "C:\Backups\Altium Infrastructure Server\201704_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium Infrastructure Server\LocalVault.ini"
运行示例还原命令的结果。请注意，该工具会先创建一个还原点（对当前 Altium Infrastructure Server 安装进行备份），然后再执行还原。
还原点
备份工具在开始还原 Infrastructure Server 之前会自动创建还原点。为此，备份工具会对现有 Infrastructure Server 执行一次备份，并将还原 ZIP 复制到以下位置：
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\Backups\
ZIP 的命名格式为：Backup_<Date>_<Time>.zip。
备份或还原期间的错误
备份或还原过程中发生的错误会直接在 CMD 窗口中显示，并附带错误日志的完整路径信息：
C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\errors.log
在备份或还原 Infrastructure Server 时，任何错误的详细信息，以及 errors.log 文件的完整路径，都会直接在 CMD 窗口中显示。
AI 翻译