将附加计算机加入 ArcGIS Notebook Server 站点

ArcGIS Notebook Server 从 10.7.1 开始支持多机站点。 在多机站点中，每台计算机的配置都相同，均具有相同的 Docker 设置，并且都可以运行 ArcGIS Notebooks。

旧版本：

在版本 10.7 中，仅支持单机站点。

多机 ArcGIS Notebook Server 站点允许您同时支持更多 notebook 用户。 如果具有许多活动用户，或者单机资源不足以满足用户的需求，那么，扩展到多机站点可能更有益。

注：

如果有几个 notebook 用户需要更多计算机资源，您可以评估修改站点的资源限制，将其作为添加计算机的有限替代。

ArcGIS Notebook Server 站点中的所有计算机都安装了相同的软件，版本和许可文件均相同。 您需要在您设置的第一台计算机上创建 ArcGIS Notebook Server 站点。 随后即可将其他 ArcGIS Notebook Server 计算机加入到该站点。

注：

与其他 ArcGIS Server 角色不同，ArcGIS Notebook Server 不支持从第一台计算机向站点添加附加计算机。 您必须依次访问每台计算机并使用 ArcGIS Notebook Server 配置向导或 joinsite 实用程序将其加入到站点。

安装之前

创建站点时，您需要确定存储配置存储（托管对站点至关重要的文件和配置信息的目录）的位置。 您的站点也具有 system 和 workspace 服务器目录。

当您第一次创建 ArcGIS Notebook Server 站点时，您需要指定配置存储和服务器目录的位置。 在多机站点中，您必须共享配置存储和服务器目录，以供其他计算机访问。 必须为加入站点的每台计算机授予对这些共享位置的读写权限。

安装并配置多机站点

当您打算设置多机 ArcGIS Notebook Server 站点时，还需遵循本安装指南中提供的一些其他步骤。

1. 查看 ArcGIS Notebook Server 系统要求以验证每台计算机是否符合条件。 在每台计算机上，调整防火墙以打开端口 11443，以供 ArcGIS Enterprise 部署中的每台计算机进行通信。

   确保使用同一操作系统用户在两台计算机上进行安装。 用于安装 ArcGIS Notebook Server 的用户帐户将用来运行软件。 组用户和所有其他用户必须至少具有对 ArcGIS Notebook Server 安装目录的执行权限。 请注意，不支持使用根帐户安装 ArcGIS Notebook Server。 例如，用于在两台不同计算机上进行安装的用户帐户可能如下所示：

   1. 在第一台计算机上以用户 ags 的身份（用户 ID 58103）将 ArcGIS Notebook Server 安装到 /data/ags 下。
   2. 在第二台计算机上以相同用户名和 ID（ags，用户 ID 58103）将 ArcGIS Notebook Server 安装到 /data/ags 下。
2. 至此，请确保您在安装过程中已完成以下操作：
   1. 在每台计算机上安装 Docker。 在每台计算机上，下载 Esri 提供的 Docker 映像并将其保存到系统可以访问的位置。
   2. 在每台计算机上安装并授权 ArcGIS Notebook Server。 您也可以静默安装软件。
   3. 运行命令行 PostInstaller 实用程序（位于 <ArcGIS Notebook Server installation directory>/tools/postInstallUtility），将 Docker 映像加载到每台计算机的本地资料档案库中。
   4. 安装完成后，按照步骤配置 ArcGIS Notebook Server。
3. 在网络上创建并共享两个目录，同时为安装用户指定所有者身份。 一个目录用于配置存储，另一个目录用于服务器目录。 至少需要为文件夹授予 700 权限。

   注：

   ArcGIS Notebook Server 不支持隐藏或使用特殊字符（例如，$）的共享网络目录。

   例如：
   1. 创建名为 config-store 的目录。 将所有者指定为 ags，用户为 ID 58103。至少授予对目录的 700 权限。
   2. 共享 config-store 文件夹，以使两台计算机都能使用相同路径（如 /net/myserver/config-store）访问该目录。
   3. 创建名为 arcgisnotebookserver 的目录。 将所有者指定为 ags，用户为 ID 58103。至少授予对目录的 700 权限。
   4. 共享 arcgisnotebookserver 文件夹，以使两台计算机都能使用相同路径（如 /net/myserver/arcgisnotebookserver）访问该目录。

      即使这些目录都位于您在创建站点时所使用的同一台计算机上，也必须手动创建和共享这些目录，然后通过网络路径引用它们。

4. 在您的一台计算机中，创建 ArcGIS Notebook Server 站点。 确保使用您先前设置的服务器目录和配置存储的路径。
5. 完成上述步骤后，您可以使用配置向导将每台附加计算机加入到您创建的站点。 如果您希望从命令行加入站点，请参阅步骤 6。
   1. 在第一台附加计算机中，打开 ArcGIS Notebook Server 配置向导。
   2. 查看并按照向导中提供的说明进行操作，然后单击继续。
   3. 单击加入现有站点。
   4. 输入在步骤 4 中创建的 ArcGIS Notebook Server 站点的站点 URL 和凭据。
   5. 针对您要加入站点的每台附加计算机，重复步骤 a 到 d。
6. 作为使用配置向导的替代方法，您还可以使用命令行实用程序将计算机加入到站点，如下所示。
   1. 确保您已使用 ArcGIS Notebook Server 帐户登录到计算机。
   2. 打开命令提示符并运行位于 <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh 的实用程序。 该实用程序的命令行参数如下：

      参数	描述
      -u 或 --username	主站点管理员的用户名。 用户名不能包含以下字符：\/:*?|<>
      -p 或 --password	主站点管理员的密码。 密码不能包含以下字符：\/:*?|<>
      -f 或 --file	joinsite 实用程序的配置存储连接文件。
      -s 或 --siteUrl	要加入的现有 ArcGIS Notebook Server 站点的 URL，格式为 https://notebookserver.domain.com:11443/arcgis/admin。
      -h 或 --help	显示命令行帮助并退出。

      该实用程序命令的示例如下：

      <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443/arcgis/admin

      如果输入的帐户凭据和站点 URL 均正确，则该实用程序会将计算机加入到 ArcGIS Notebook Server 站点。 对每台附加计算机重复此步骤。

将所有计算机加入到站点后，余下的设置过程与单机站点相同。 继续通过站点安装并配置 ArcGIS Web Adaptor。 然后，通过您的 ArcGIS Enterprise 门户配置您的站点。

从命令行加入站点

也可以使用 joinSite 命令行实用程序将计算机加入 ArcGIS Notebook Server 站点。 此实用程序要求您指定现有站点配置存储的位置，而不是其 URL。 因此，该实用程序对于使用 URL 会阻塞站点的网络请求队列的某些情况十分有利。 如果 ArcGIS Notebook Server 站点计算机的网络请求已超载，或者您想要一次将大量计算机加入站点，请考虑使用此实用程序。

join-site 实用程序安装于 ArcGIS Notebook Server 安装目录下的 \tools\JoinSiteUtility 中。 使用 ArcGIS Notebook Server 的 Run As 帐户，从要添加到现有站点的 ArcGIS Notebook Server 计算机中运行 join-site 实用程序。

1. 将现有站点的配置存储文件夹的读写权限授予给用于在要加入站点的一台或多台计算机上运行 ArcGIS Notebook Server 服务的网络帐户。
2. 创建一个名为 connection.json 的 JavaScript 对象标记法 (JSON) 文件。
3. 将以下行添加到该文件，同时将 <path to the configuration store> 替换为现有 ArcGIS Server 站点的配置存储位置：

   {"configPersistenceType": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

   在此示例中，现有站点的配置存储路径为 /net/mymachine/data/arcgisnotebookserver/usr/config-store：

   {"connectionString": "/net/mymachine/data/arcgisnotebookserver/usr/config-store", " configPersistenceType": "FILESYSTEM" }

4. 保存并关闭 connection.json 文件。
5. 将 connection.json 文件放在将要加入站点的计算机上，或者将其放在可以从将要加入站点的计算机中访问的共享目录下。
6. 打开命令提示符并运行 join-site。
语法如下：
joinSite -f <The file path to the configuration store JSON file>
在此示例中，配置存储 JSON 文件（connection.json）假定与 join-site 工具位于同一目录（\tools\JoinSiteUtility）下。
joinsite.bat -f connection.json

该计算机已加入 ArcGIS Notebook Server 站点。