ArcGIS Notebook Server 将其操作所需的基于文件的配置和内容存储在服务器目录中。 可以在安装和配置 ArcGIS Notebook Server 期间添加这些目录,或之后使用 ArcGIS Notebook Server Manager。
有四种目录类型,每种目录在服务器操作中都具有明确的分工:工作空间目录、数据目录、输出目录和系统目录。 下面介绍了工作空间和数据目录;输出和系统目录用于 ArcGIS Notebook Server 内部用途。
工作空间目录
工作空间目录允许 Notebook 创作者存储和读取在其 Notebook 中使用的文件。 ArcGIS Enterprise 门户中的每个 Notebook 创作者在工作空间目录中都有一个唯一的文件夹。 您的唯一文件夹安装在您的每个 Notebook 中,因此 Notebook 可以读取和写入工作空间目录。 Notebook 只能在用户各自的工作空间目录文件夹中读取和写入信息;无法从其他用户的 Notebook 访问该文件夹。
默认情况下,将在 /directories/arcgisworkspace/<userid> 文件夹中创建用户的私人工作空间目录,并将权限设置为 -rwxrwxrwx。 该权限级别是必要的,因为在默认情况下,运行在容器内的 Linux 用户帐户将与运行 ArcGIS Notebook Server 后台程序的 OS 用户帐户具有不同的 UID 和 GID(组 ID)。
如果出于安全方面的原因,您不希望使用开放权限模型,则可以使用名为 applyDefaultUserWorkspacePermissions 的系统属性来更改模型。 如果此属性设置为 true,则将使用系统的默认设置(例如 -rwx------,而非开放 -rwxrwxrwx 设置)来创建工作空间目录。
要使用此功能,运行 ArcGIS Notebook Server 后台程序的 OS 用户的 UID 必须为 1050 并且 GID 为 100(以匹配容器用户的 UID 和 GID)。
- 登录到 Administrator Directory。
URL 地址格式为 https://notebookserver.domain.com:11443/arcgis/admin。
- 浏览至系统 > 属性,然后单击编辑。
- 将以下 JSON 字符串添加到属性框并保存编辑:
{ "applyDefaultUserWorkspacePermissions":"true" }
数据目录
数据对 ArcGIS Notebooks 至关重要。 在创建 Notebook 时,您可以从 ArcGIS Enterprise 门户的项目、外部 GIS 服务器或本地文件目录中添加数据图层。
包含数据的本地目录可以通过注册至 ArcGIS Notebook Server 站点来作为文件路径提供给笔记本。 可以向服务器站点注册多个数据目录。 每个注册的数据目录均可供该站点中运行的每个 Notebook 使用。
使用栅格分析工作流的 Notebook 针对数据目录具有特殊用法。 您可以将基于文件的栅格存储注册为数据目录,从而使栅格分析工具的输出在 Notebook 中立即可用。
数据目录的注意事项
为了使 Notebook 能够访问已注册的数据目录,请为目录设置 755 模式权限。
组织中的所有 Notebook 创建者都可以从所有已注册数据目录中将数据添加到其笔记本中。 无法将数据目录限制为仅门户中的某些用户或群组可用。
在涉及生成影像芯片以训练模型的深度学习工作流中,芯片托管在基于文件的栅格存储中。 执行此工作流时,请将栅格存储通过 ArcGIS Notebook Server 注册为数据目录,使影像芯片可用于您的笔记本。
注册数据目录中的数据不属于 ArcGIS Enterprise 门户。 因此,共享笔记本时,确保查看共享笔记本的所有用户都可以访问该笔记本引用的任何注册数据目录。
注册数据目录
可以在 ArcGIS Notebook Server Manager 中注册数据目录,以使本地目录可用于服务器站点。
注:
要将文件上传或写入此自定义数据目录位置,该目录必须对 Notebook 容器内的用户“arcgis”(组“users”)具有读写权限。
- 以管理员身份登录到您的 ArcGIS Enterprise 门户,然后打开 ArcGIS Notebook Server Manager。
- 打开设置页面并单击目录。
- 单击“注册数据目录”以打开注册对话框。
- 输入目录名称及其在您的计算机上的完整路径。
- 指示该目录将用作 DATA 目录。
- 单击保存确认。
您无法编辑或更新在 ArcGIS Notebook Server 注册的目录的名称或路径。 要进行更改,必须取消注册现有目录,然后重新注册。
为服务器目录指定新位置
自 10.8 版本起,可以在 Manager 中编辑现有目录以更改其位置。 扩展到多机站点时,可以使用此方法将目录放置在共享文件路径中。
- 以管理员身份登录到您的 ArcGIS Enterprise 门户,然后打开 ArcGIS Notebook Server Manager。
- 打开设置页面并单击目录。
- 选择要修改的目录,然后单击编辑按钮。
- 将现有“目录路径”值替换为目录的新路径。 单击保存确认。
站点重启后,将使用新路径来访问目录。
- 将现有目录的内容复制粘贴到其新位置。
针对每个要更新的目录重复上述步骤。
注:
如果 arcgisworkspace 目录位置已更新,则必须重新运行安装实用程序以将示例数据提取到新的工作空间目录位置。