升级方法取决于您以何种方式以及何时在 Amazon Web Services (AWS) 上创建 ArcGIS Notebook Server 站点。
- AWS 上的任何 ArcGIS Notebook Server 站点都可以使用手动升级过程升级。 如果您在 10.8 版本之前创建了站点,则必须使用手动过程进行升级。
- 如果您使用 10.8 或 10.8.1 版本 Esri Amazon Web Services CloudFormation 模板创建了 ArcGIS Notebook Server 站点,则可以使用 Chef 脚本进行升级。
- 如果您使用 10.9、10.9.1 或 11.0 版本的 Esri CloudFormation 模板创建了 ArcGIS Notebook Server 站点,则可以使用相应的 11.1 CloudFormation 模板对其进行升级。
- 如果使用 10.9、10.9.1 或 11.0 版本的 ArcGIS Enterprise Cloud Builder for Amazon Web Services 创建了 ArcGIS Notebook Server 站点,则可以使用 11.1 ArcGIS Enterprise Cloud Builder for AWS 对其进行升级。
在升级之前
无论您使用哪种升级方法,请在升级部署之前查看以下信息:
- 要升级到 11.1,您必须获取新的许可文件。
- 升级 ArcGIS Notebook Server 站点前,为其创建备份。
- 在升级 ArcGIS Notebook Server 站点之前,必须先升级 ArcGIS Notebook Server 与之联合的 ArcGIS Enterprise 门户。
- 如果您使用手动升级过程或 Chef 脚本进行升级,必须先从 AWS 自动伸缩组中移除 ArcGIS Notebook Server 站点中的 Amazon Elastic Compute Cloud (EC2) 实例(如果其位于一个实例中),然后才能升级站点。 升级后,无法将实例放回自动伸缩组。 因此,您必须在需要时手动将实例添加到 ArcGIS Notebook Server 站点中或从该站点删除实例,并且不能使用通过 Esri 提供的 Amazon Web Services CloudFormation 模板创建的 Lambda 函数来停止和启动这些实例。
如果不移除实例,或者在升级后将实例放回自动伸缩组中,则由自动伸缩组添加到 ArcGIS Notebook Server 站点的实例将正在运行该软件的旧版本。 您不能在站点中混合使用 ArcGIS Server 版本,因此这可能会破坏您的部署。
使用手动升级过程进行升级
AWS 上的 ArcGIS Notebook Server 站点的手动升级过程与在本地升级一个站点的过程类似。 AWS 上的差异在于,如果在 AWS 自动伸缩组中部署 ArcGIS Notebook Server 站点 Amazon Elastic Compute Cloud 实例,则必须在升级之前将其从自动伸缩组中移除。
请按照以下步骤从自动伸缩组中移除所有 EC2 实例。
- 登录 AWS Management Console 并查找与您的 ArcGIS Notebook Server 站点相关联的自动伸缩组。
自动伸缩组包含 CloudFormation 堆栈的名称。 您还可以打开该组的实例管理,并确认该组中的 EC2 实例参与您的站点。
- 将堆栈的自动伸缩组的最小容量和最大容量属性更改为 0。
- 从自动伸缩组中移除所有 EC2 实例。
- 将自动伸缩组的所需容量属性更改为 0。
移除所有 EC2 实例后,删除自动伸缩组,以防止任何人在升级 ArcGIS Notebook Server 站点后重新添加实例。
现在,您可以按照 ArcGIS Notebook Server 安装指南中的说明升级 ArcGIS Notebook Server 站点。 阅读您的 EC2 实例上特定于操作系统的说明:
使用 Chef 脚本升级
如果您使用 10.8 或 10.8.1 版本 Esri Amazon Web Services CloudFormation 模板创建了 ArcGIS Notebook Server 站点,则可以使用 Chef 脚本进行升级。
从 AWS 自动伸缩组中移除 ArcGIS Notebook Server EC2 实例。 接下来,升级 ArcGIS Notebook Server 站点,然后升级该站点的 ArcGIS Web Adaptor。
调整自动伸缩组设置
请按照以下步骤从自动伸缩组中移除所有 EC2 实例。
- 登录 AWS Management Console 并查找与您的 ArcGIS Notebook Server 站点相关联的自动伸缩组。
自动伸缩组包含 CloudFormation 堆栈的名称。 您还可以打开该组的实例管理,并确认该组中的 EC2 实例参与您的站点。
- 将堆栈的自动伸缩组的最小容量和最大容量属性更改为 0。
- 从自动伸缩组中移除所有 EC2 实例。
- 将自动伸缩组的所需容量属性更改为 0。
移除所有 EC2 实例后,删除自动伸缩组,以防止任何人在升级 ArcGIS Notebook Server 站点后重新添加实例。
升级 ArcGIS Notebook Server
- 以 ubuntu 用户身份建立与 ArcGIS Notebook Server 站点中的第一个 EC2 实例的 SSH 连接。
- 使用以下命令之一下载并安装 Chef 或 Cinc 客户端 16.16.13。 如果您安装的是 Chef 的旧版本,请将其更新到版本 16.16.13。
- Chef 客户端:sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v 16.16.13
- Cinc 客户端:sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v 16.16.13
- 从 My Esri 内的您的帐户中下载以下安装文件的 11.1 版本,并将其上传到 EC2 实例上的 /opt/software/archives 目录中。
- ArcGIS_Notebook_Server_Linux_111_185323.tar.gz
- ArcGIS_Notebook_Server_Samples_Data_Linux_111_185328.tar.gz
- ArcGIS_Notebook_Docker_Advanced_111_185263.tar.gz
- ArcGIS_Notebook_Docker_Standard_111_185262.tar.gz
- ArcGIS_Web_Adaptor_Java_Linux_111_185233.tar.gz
- 获取 ArcGIS Notebook Server 11.1 授权文件,并将其放置在 EC2 实例上的本地文件夹中或可从 EC2 实例访问的文件共享中。
- 将 ArcGIS Cookbook 版本 4.1.0 (arcgis-4.1.0-cookbooks.tar.gz) 下载到 EC2 实例中,解包并解压缩文件,然后将文件内容放置在 /opt/chef 目录中。
- 将目录更改为 /opt/chef/templates/arcgis-notebooks/11.1/linux、在文本编辑器中打开 notebook-server.json 文件并修改以下参数:
- 将安装目录设置为 /home。
"arcgis" : { "notebook_server": { "install_dir": "/home"
- 指定放置 ArcGIS Notebook Server 授权文件的位置。
"arcgis" : { "notebook_server": { "authorization_file": "/<folder>/<subfolder>",
- 为 ArcGIS Notebook Server 站点管理员设置用户名和密码。
"arcgis" : { "notebook_server": { "admin_username": "<username>", "admin_password": "<password>",
- 将根服务器目录位置设置为 /net/primary/gisdata/notebookserver/directories。 您必须在默认文本中将 FILESERVER 替换为 primary。
"arcgis" : { "notebook_server": { "directories_root": "/net/primary/gisdata/notebookserver/directories",
- 将 ArcGIS Notebook Server工作空间目录位置设置为 /net/primary/gisdata/notebookserver/directories/arcgisworkspace。 您必须在默认文本中将 FILESERVER 替换为 primary。
"arcgis" : { "notebook_server": { "workspace": "/net/primary/gisdata/notebookserver/directories/arcgisworkspace",
- 将 ArcGIS Notebook Server 配置目录位置的连接字符串设置为 /net/primary/gisdata/notebookserver/config-store。 请注意,您必须在默认文本中将 FILESERVER 替换为 primary。
"arcgis" : { "notebook_server": { "config_store_connection_string": "/net/primary/gisdata/notebookserver/config-store",
- 将日志目录设置为 /home/arcgis/notebookserver/usr/logs。
"arcgis" : { "notebook_server": { "log_dir": "/home/arcgis/notebookserver/usr/logs",
- 将安装目录设置为 /home。
- 保存并关闭 notebook-server.json 文件。
- 以 ubuntu 用户身份将目录更改为 /opt/chef,并运行以下命令:sudo chef-client -z -j /opt/chef/templates/arcgis-notebooks/11.1/linux/notebook-server.json。
- 如果 ArcGIS Notebook Server 站点中有多个 EC2 实例,请与下一个 EC2 实例建立 SSH 连接,然后重复步骤 2 至 8,直到所有实例都升级为止。
在站点中的所有 ArcGIS Notebook Server 实例上完成升级 EC2 后,请升级 ArcGIS Web Adaptor。
升级 ArcGIS Web Adaptor
使用 notebook-server-webadaptor.json 文件(该文件也包含在您在先前部分的步骤 5 中下载的 Cookbook 中)来升级 ArcGIS Notebook Server 站点的 ArcGIS Web Adaptor。
- 在文本编辑器中打开 notebook-server-webadaptor.json 文件并修改以下参数:
- 使用 SSL 证书为 .pfx 设置 PKSC12 keystore 文件 (Apache Tomcat) 的位置。
"arcgis" : { "tomcat": { "keystore_file": "/<folder>/<subfolder>/<file name>.pfx",
- 使用 SSL 证书为 Tomcat 设置 keystore 文件的密码。
"arcgis" : { "tomcat": { "keystore_password": "<password>"
- 为 ArcGIS Notebook Server 站点管理员设置用户名和密码。
"arcgis" : { "mission_server": { "admin_username": "<username>", "admin_password": "<password>",
- 使用 SSL 证书为 .pfx 设置 PKSC12 keystore 文件 (Apache Tomcat) 的位置。
- 保存并关闭 notebook-server-webadaptor.json 文件。
- 以 ubuntu 用户身份将目录更改为 /opt/chef,并运行以下命令:chef-client -z -j /opt/chef/templates/arcgis-notebooks/11.1/linux/notebook-server-webadaptor.json。
使用 CloudFormation 模板升级
如果您使用 Esri 提供的 10.9、10.9.1 或 11.0 版本部署 CloudFormation 模板创建了 ArcGIS Notebook Server 站点,则可以使用对应的 11.1 升级模板对其进行升级。
下表列出了对应的部署和升级模板,并提供了升级模板使用说明的链接。
10.9、10.9.1 或 11.0 版本部署模板 | 11.1 升级模板 | 升级模板使用说明 |
---|---|---|
arcgis-notebook-server-singlemachine.template.json | arcgis-notebook-server-singlemachine-upgrade.template.json | |
arcgis-notebook-server-ha.template.json | arcgis-notebook-server-ha-upgrade.template.json |