Skip to main content

将其他计算机加入 ArcGIS Notebook Server 站点

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

ArcGIS Notebook Server 支持多许可站点，从而使参与站点的所有计算机不再需要相同级别的许可。 例如，您可以设置一个三机站点，为其中一台计算机配置 Advanced 许可，并为两台计算机配置 Standard 许可。 这种多许可功能支持通过不同数量的计算机（具有 Advanced 或 Standard 许可）进行扩展。

多机 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. 以相同的用户名 (ags) 和 ID (58103) 将 ArcGIS Notebook Server 安装在第二台计算机的 /data/ags 目录下。

  2. 至此，请确保您在安装过程中已完成以下操作：

    1. 安装 ArcGIS Notebook Server 的容器引擎。 在每台计算机上，下载 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。

      -h 或 --help

      显示命令行帮助并退出。

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

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

      如果输入的账户凭据和站点 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 站点。

ArcGIS Notebook Server 支持多机站点。 在多机站点中，每台计算机都必须具有相同的配置，即相同的操作系统、相同的容器引擎设置、以及工作空间目录驱动器盘符相同的映射网络驱动器。

安装并配置多机站点（Windows 容器）

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

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

    每台计算机上已安装的 ArcGIS Notebook Server 版本及其许可文件必须相同。 在每次安装期间输入相同的 ArcGIS Notebook Server 账户。 建议使用域或活动目录账户，但是，如果选择本地账户，该账户必须存在于每台计算机上并且使用相同的用户名和密码组合。 请记住，您指定的账户不必是管理员组的一部分。

  2. 请确保您在安装过程中已完成以下操作：

    1. 在每台计算机上安装 ArcGIS Notebook Server 的容器引擎。 在每台计算机上，下载 Esri 提供的 Docker 镜像并将其保存到系统可以访问的位置。

    2. 在每台计算机上安装并授权 ArcGIS Notebook Server。 您也可以静默安装软件。

    3. Windows 上的 ArcGIS Notebook Server 仅支持 Windows 容器。 从 My Esri 下载与安装对应的容器镜像，然后运行命令行 PostInstaller 实用程序（位于 <ArcGIS Notebook Server installation directory>\tools\postInstallUtility）为 ArcGIS Notebook Server 安装容器镜像。 在所有 ArcGIS Notebook Server 计算机上重复此步骤。 按照以下步骤在安装后配置 ArcGIS Notebook Server。

  3. 在网络上创建并共享两个目录。 一个目录用于配置存储，另一个目录用于一些服务器目录。 在映射为网络驱动器的 UNC 共享中应保留 workspace 目录。 将这两个目录的读写权限授予每台计算机上的 ArcGIS Notebook Server 账户（请确保同时在 Microsoft 文件资源管理器的共享选项卡和安全性选项卡上执行此操作）。

    注:

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

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

    • 如果该计算机上不存在 ArcGIS Notebook Server 账户（例如当您将配置存储和服务器目录都放置在一台文件服务器上时），则需要创建与部署中的所有其他计算机具有相同用户名和密码的 ArcGIS Notebook Server 账户。

    • 如果您的 ArcGIS Notebook Server 账户使用的是组托管服务账户 (gMSA)，则必须允许服务账户具有共享和安全性选项卡中的完全控制权限。 在权限编辑器中，单击添加，然后打开对象类型对话框。 选中服务账户的复选框。

  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.bat 的实用程序。 该实用程序的命令行参数如下：

      参数

      描述

      -u 或 --username

      主站点管理员的用户名。

      用户名不能包含这些字符：\/:*?|<>

      -p 或 --password

      主站点管理员的密码。

      密码不能包含以下字符：\/:*?|<>

      -f 或 --file

      joinsite 实用程序的配置存储连接文件。

      -s 或 --siteUrl

      要加入的现有 ArcGIS Notebook Server 站点的 URL，格式为 https://notebookserver.domain.com:11443。

      -h 或 --help

      显示命令行帮助并退出。

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

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

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

  7. 将现有站点的配置存储文件夹的读写权限授予给用于在要加入站点的计算机上运行 ArcGIS Notebook Server 服务的网络账户。

  8. 创建一个名为 connection.json 的 JavaScript 对象标记法 (JSON) 文件。

  9. 将以下行添加到该文件，同时将 <path to the configuration store> 替换为现有 ArcGIS Server 站点的配置存储位置：

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

    在此示例中，现有站点的配置存储路径为 \\\\myshare\\arcgisserver\\config-store

    {" configPersistenceType": "FILESYSTEM", "connectionString": "\\\\myshare\\arcgisserver\\config-store"}

为工作空间目录设置映射网络驱动器

这是一个可选过程，仅当您计划设置多机 Notebook Server 站点时才必须用到。

  1. 在可供 Notebook Server 访问的独立计算机上为 ArcGIS Notebook Server 工作空间目录创建 UNC 共享。

    注:

    ArcGIS Notebook Server Windows 运行方式账户必须对此目录具有读写权限。 建议在未加入 ArcGIS Notebook Server 站点的独立计算机上为 ArcGIS Notebook Server 工作空间目录创建 UNC 共享。 存在一个已知问题，即在与 Notebook Server 相同的计算机上创建的 SMB 共享将在重新启动该计算机时断开连接。

  2. 在 Notebook Server 计算机上，以管理员身份打开一个 PowerShell 窗口。

  3. 使用以下命令将您的 ArcGIS Notebook Server 用户账户密码另存为受保护字符串，以供稍后使用：

    $password = ConvertTo-SecureString '<password>' -AsPlainText -Force

  4. 为 PowerShell 函数添加凭据支持：

    $credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)

  5. 装载设置了“持续”标记的文件夹：

    New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:

  6. 在加入 ArcGIS Notebook Server 站点的所有计算机上重复步骤 2 到 5，并为所有计算机上的映射驱动器分配相同的驱动器盘符。

  7. 创建 ArcGIS Notebook Server 站点时，使用上一步中创建的共享网络驱动器来配置工作空间目录。