- 入门指南
- 要求
- 最佳实践
- 安装
- 正在更新
- 身份服务器
- 对启动错误进行故障排除
Orchestrator 安装指南
此页提供了用于创建 Orchestrator SQL 数据库的计划备份的示例解决方案。请参阅此处,了解如何备份相关的web.config和UiPath.Orchestrator.dll.config文件以及 NuGet 包(如适用)。
备份 Orchestrator 数据库
有多种选项可用于执行此备份,包括您可以在需要时许可和安装的诸多第三方解决方案,但此示例将指导您使用 SQL Server 管理 Studio 已经提供的集成维护计划功能完成此过程。
创建维护计划
- 从 SQL Server 管理 Studio 连接到 Orchestrator 数据库的 SQL Server。
备注:
需要管理员访问权限。
- Expand the Management folder.
图 1. “管理”文件夹
- Right-click Maintenance Plans and select Maintenance Plan Wizard. The Maintenance Plan Wizard is displayed.
图 2. 选择“计划属性”
- 在“选择计划属性” 页上:
- 在名称字段中,输入此维护计划的描述性名称。
- 如果需要,请使用描述字段提供计划的详细描述。
- 从运行方式下拉菜单中,选择 SQL Server 代理服务帐户。
- 使用单选按钮和“计划”字段选择此维护计划的所需时间和频率。
- Click Next. The Select Maintenance Tasks page is displayed.
图 3. 选择维护任务
-
Select Back Up Database (Full) and click Next. The Define Back Up Database (Full) Task page is displayed.
备注:要备份 Test Manager 数据库,请参阅 Test Manager 备份和还原。
备注:This guide only details the setup of a maintenance plan for the creation of a full database backup. In your production environment, it is also recommended to set up a Differential backup plan scheduled to run daily.
图 4. “定义备份数据库(完整)”任务
- 从“常规”选项卡执行以下操作:
- 使用数据库下拉列表选择特定数据库。
- 选择数据库作为备份组件。在弹出窗口中,选择 Orchestrator 数据库(在上面的示例中为 UiPath)。
- From the Destination tab, enter the location where all future backups are saved.
- “选项”选项卡允许您选择:
- 压缩备份文件。如果启用,则执行备份所需的时间将增加。
- 备份到期日期。
- 备份完整性验证。如果启用,则执行备份所需的时间将增加。
- Click Finish to create the maintenance plan and Close to close the wizard.
执行维护计划
您创建的维护计划中定义的备份也可以在定义的计划之外执行,如下所示:
- 从 SQL Server 管理 Studio 连接到 Orchestrator 数据库的 SQL Server。
备注:
需要管理员访问权限。
- Expand the Management folder.
- Expand the Maintenance Plans folder.
- Right-click the desired maintenance plan and select Execute. The Execute Maintenance Plan window is displayed.
图 5. 执行维护计划
- Once completed Success is displayed. You can click Close to exit or select Report to view the execution report.
还原 Orchestrator 数据库
- 从 SQL Server Management Studio 连接到所需的 SQL Server。
备注:
需要管理员访问权限。
- Right-click the Databases folder and select Restore Database.
- 按照还原向导选择备份源和还原备份的目标。
备注:
可以将数据库还原到较早的时间点。您还可以为数据库选择新名称。
- Click OK to begin the restore procedure. Note that this may take some time depending the on size of the database.
- Once completed, the new database appears in the Databases tab of SQL Server Management Studio.
备份配置文件和 NuGet 包
备份 Orchestrator 配置和 NuGet 包需要将相关文件和文件夹复制到指定的备份位置。 此页面提供了识别和查找必须复制的文件和文件夹所需的详细信息。
Orchestrator Web.config 和 UiPath.Orchestrator.dll.config 文件
备份
备份 Orchestrator 配置所需的步骤因部署模型而异(例如 内部部署和 IaaS(基础架构即服务)或 PaaS(平台即服务))。
内部部署和 IaaS 部署
- 打开 Orchestrator 安装目录。 默认情况下,这是
C:\Program Files (x86)\UiPath\Orchestrator。 - 将位于此处的
web.config和UiPath.Orchestrator.dll.config文件复制到指定的备份位置。
Azure PaaS 部署
- Select your Orchestrator App Service.
- 从“开发工具”菜单导航到“高级工具”>“Go”>“调试控制台”>“CMD”。
- Open the Site folder and navigate to wwwroot.
- Select
Web.configand click Download. - 将下载的文件复制到指定的备份位置。
- Select
UiPath.Orchestrator.dll.configand click Download. - 将下载的文件复制到指定的备份位置。
除 web.config 和 UiPath.Orchestrator.dll.config 文件之外,还必须复制应用程序设置和连接字符串,如下所示:
- Select your Orchestrator App Service.
- From the Settings menu, select Configuration.
- From the Application Settings section, select Advanced Edit and copy the displayed value.
- From the Connection strings section, select Advanced Edit and copy the displayed value.
- 将这些值保存到指定的备份位置。
还原
还原 web.config 和 UiPath.Orchestrator.dll.config 文件时,必须在部署中的 Orchestrator 节点上全部还原。
内部部署和 IaaS 部署
要还原以前的 Orchestrator 配置,无论是还原到新环境还是发生故障,请执行以下操作:
- 从所需备份中复制
web.config和UiPath.Orchestrator.dll.config文件。 - 打开 Orchestrator 安装目录。 默认情况下,这是
C:\Program Files (x86)\UiPath\Orchestrator。 - 将位于此处的
web.config和UiPath.Orchestrator.dll.config文件替换为您指定的备份文件。
Azure PaaS 部署
检索到所需的 web.config 和 UiPath.Orchestrator.dll.config 备份文件后:
- Select your Orchestrator App Service.
- 从“开发工具”菜单导航到“高级工具”>“Go”>“调试控制台”>“CMD”。
- Open the Site folder and navigate to wwwroot.
- 将位于此处的
web.config和UiPath.Orchestrator.dll.config文件替换为您指定的备份文件。
除替换 web.config 和 UiPath.Orchestrator.dll.config 文件之外,还必须使用其先前的值还原应用程序设置和连接字符串,如下所示:
- Select your Orchestrator App Service.
- From the Settings menu, select Configuration.
- From the Application Settings section, select Advanced Edit and replace the value there with your previously saved backup.
- From the Connection strings section, select Advanced Edit and replace the value there with your previously saved backup.
NuGet 包
备份
UiPath.Orchestrator.dll.config文件的部署部分指明了 NuGet 包目录的位置。
- 检查
NuGet.Repository.Type键的值。 可能的值如下:- Legacy - packages are stored in the locations specified in the
NuGet.Packages.PathandNuGet.Activities.Pathkeys. - Composite - packages are stored in the locations specified in the
Storage.TypeandStorage.Locationkeys.
- Legacy - packages are stored in the locations specified in the
- For Legacy repository types, copy the folders identified by the
NuGet.Packages.PathandNuGet.Activities.Pathkeys to your designated backup location. - 对于组合式存储库类型,其中 Storage.Type 键为:
还原
还原之前的 NuGet 包目录的操作与上述备份过程相反,如下所示:
- 对于旧版存储库,请将 NuGet 包和活动文件夹的备份复制到
NuGet.Packages.Path和NuGet.Activities.Path键所标识的目录中(已在UiPath.Orchestrator.dll.config文件的部署部分中指明)。 - 对于组合式存储库类型,其中 Storage.Type 键为:
FileSystem- 将备份文件夹复制到RootPath参数的Storage.Location键中标识的目录,该目录位于UiPath.Orchestrator.dll.config文件的部署部分。Azure- 在Storage.Type键中输入先前保存的连接字符串。Amazon- 在Storage.Type键中输入先前保存的连接字符串。