Esri arcgis-datastore-cluster-upgrade.template.json Amazon Web Services (AWS) CloudFormation 模板可升级您通过使用 CloudFormation 在集群模式下部署 ArcGIS Data Store 中所述的模板创建的位于多个 Amazon Elastic Compute Cloud (EC2) 实例上的切片缓存或时空 ArcGIS Data Store 10.9、10.9.1、11.0 或 11.1。
arcgis-datastore-cluster-upgrade.template.json 模板可升级位于多个 EC2 实例上的 ArcGIS Data Store。
先决条件
先决条件可以按照您必须获取的项目(例如文件和帐户)以及在运行 CloudFormation 模板之前必须执行的任务来进行分组。
必需项目
运行此模板之前,您需要以下内容:
- 具有待升级部署的访问权限的 Amazon Web Services 帐户。
- 您使用 Esri Amazon Web Services CloudFormation 模板 arcgis-datastore-cluster.template.json 在集群模式下创建的现有 ArcGIS Data Store 部署。
- 升级 CloudFormation 模板,arcgis-datastore-cluster-upgrade.template.json。
注:
要升级您的部署,请运行此升级 CloudFormation 模板,此操作将创建一个新的 CloudFormation 堆栈。 请勿使用此模板更新现有部署 CloudFormation 堆栈。
必需任务
运行此模板之前,请完成以下任务:
- 您必须先升级数据存储注册到的 ArcGIS GIS Server 站点(托管服务器),然后再升级 ArcGIS Data Store。
- 在 AWS Secrets Manager 中配置密码(此为可选项,但建议选择)。
您可以在 AWS Secrets Manager 中配置帐户的密码,例如站点管理员用户名和 Windows arcgis 用户密码。 将为您提供密钥的 Amazon 资源名称 (ARN)。 启动堆栈时,在模板参数中使用 ARN 代替密码。 如果您不使用 AWS Secrets Manager 存储密码,则必须在启动堆栈时在模板参数中键入纯文本密码。
注:
当您在 AWS Secrets Manager 中创建一个密钥 ARN 以用于与 Esri CloudFormation 模板配合使用的密码时,必须使用其他密钥类型作为密钥类型,然后使用纯文本选项。 有关创建用于密码的 Amazon 资源名称的详细信息,请参阅 AWS CloudFormation 和 ArcGIS。
提示:
默认情况下,如果堆栈创建失败,CloudFormation 将删除部分创建的资源。 这十分有用,因为此操作从帐户中移除了无法使用的部署,但是可能使故障排除变得困难。 要在失败状态下保留堆栈,请在启动堆栈之前禁用失败时回滚 CloudFormation 堆栈创建选项。 有关详细信息,请参阅 AWS 帮助中的设置 AWS CloudFormation 选项。
参数
有关此 CloudFormation 模板中所使用参数的描述,请参阅下表。 已按参数类型对表进行分组。
ArcGIS Data Store Configuration
参数名称 | 是否为必填项 | 参数说明 |
---|---|---|
Platform Type | 必填 | 选择现有 ArcGIS Data Store 部署的平台类型。
|
AutoScaling 组名 | 必填 | 提供配置现有 ArcGIS Data Store 集群的自动伸缩组的名称。 如果您使用 Esri CloudFormation 模板或 Cloud Builder 创建了现有部署,则可以在 AWS Management Console 中现有 CloudFormation 堆栈的资源部分中找到自动伸缩组的名称。 资源的逻辑 ID 为 AutoScalingGroup。 |
Type | 必填 | 选择现有 ArcGIS Data Store 部署的数据存储类型。 有效值为 tileCache 或 spatiotemporal。 |
Windows arcgis user password | 条件分析 | 仅在 Windows 中进行部署时,才需要此密码。 提供现有部署的 arcgis 用户的密码。 您可以输入纯文本密码或 AWS Secrets Manager 中您的密钥 ID 的 ARN。 最佳做法是在 AWS Secrets Manager 中管理您的密码。 有关创建用于密码的 Amazon 资源名称的信息,请参阅 AWS CloudFormation 和 ArcGIS。 |
ArcGIS Server Configuration
参数名称 | 是否为必填项 | 参数说明 |
---|---|---|
Site Administrator User Name | 必填 | 提供现有站点的 ArcGIS Server 主站点管理员的用户名。 |
Site Administrator User Password | 必填 | 提供 ArcGIS Server 主站点管理员的密码。 您可以输入纯文本密码或 AWS Secrets Manager 中您的密钥 ID 的 ARN。 有关创建用于密码的 Amazon 资源名称的详细信息,请参阅 AWS CloudFormation 和 ArcGIS。 您所提供的密码或密钥 ID 必须与现有的主站点管理员匹配。 |
ArcGIS Server EC2 Instance ID | 必填 | 从配置数据存储的 ArcGIS Server 站点选择 EC2 实例 ID。 注:如果已将数据存储注册到多机 ArcGIS Server 站点,则可以从 ArcGIS Server 站点选择任意 EC2 实例 ID。 请勿选择文件服务器 EC2 实例。 |
输出
当您的堆栈成功创建后,可以在 AWS Management Console 中的 CloudFormation 堆栈的输出选项卡看到以下输出参数。
输出名称 | 输出描述 |
---|---|
DeploymentLogsURL | 这是 Amazon CloudWatch 日志的 URL,其中存储了所有部署日志。 如果部署失败,您可以参考这些日志以进行故障排除。 |
注意事项
创建包含 ArcGIS 部署的 CloudFormation 堆栈后,需要考虑以下几项重要内容:
- 成功创建堆栈后(换言之,堆栈状态为 CREATE_COMPLETE),意味着 ArcGIS Data Store 部署已成功升级。 您可以通过登录 ArcGIS Server Manager 并验证数据存储来进行验证。
- 如果 CloudFormation 堆栈未能成功创建(换言之,堆栈状态为 CREATE_FAILED),您可以按照以下“疑难解答”部分链接到的页面中提到的方法进行故障排除。 查明错误的根本原因并采取必要的措施后,您可以删除失败的堆栈并创建一个新堆栈以升级现有 ArcGIS Data Store 部署。
疑难解答
如果您在创建此 CloudFormation 堆栈时发现任何故障,请参阅 AWS 上的 ArcGIS 部署疑难解答。