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 命令提示符。
你必须以管理员模式运行 Command Prompt，才能使用备份与还原工具。如果你未以 Windows 管理员身份运行 CMD 提示符，尝试执行与备份或还原 Infrastructure Server 相关的命令时，将会出现清晰的提示信息：Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks。
-
导航到正确的文件夹。对于主机计算机 C 盘上的默认安装，其路径为：
cd C:\Program Files (x86)\Altium\Altium Infrastructure Server\Tools\BackupTool\
-
要运行该工具并列出可用选项，请在提示符下输入：
avbackup ?
虽然无法使用 Ctrl+V 在命令提示符中进行粘贴，但你可以通过右键菜单进行粘贴。先复制所需字符串，然后用这种方式粘贴，以节省时间并避免错误。
通过命令提示符（以管理员身份运行）访问备份工具。
注意 ?，包含它会显示备份工具中可用功能的帮助信息：
-
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 翻译