Configurar directorios de ArcGIS Notebook Server

ArcGIS Notebook Server almacena las configuraciones basadas en archivos y el contenido necesario para sus operaciones en los directorios del servidor. Estos directorios se pueden agregar durante la instalación y configuración de ArcGIS Notebook Server, o posteriormente mediante ArcGIS Notebook Server Manager.

Hay cuatro tipos de directorios, y cada uno de ellos desempeña una función específica en las operaciones del servidor: el directorio del espacio de trabajo, el directorio de datos, el directorio de salida y el directorio del sistema. A continuación, se describen los directorios de datos y espacio de trabajo; los directorios de sistema y salida se utilizan solo para fines internos de ArcGIS Notebook Server.

Directorio del espacio de trabajo

El directorio de espacio de trabajo permite que los autores de notebooks guarden y lean los archivos utilizados en sus notebooks. Cada autor de notebook del portal de ArcGIS Enterprise tiene una carpeta exclusiva dentro del directorio del espacio de trabajo. Su carpeta exclusiva se monta en cada uno de sus notebooks, de forma que el notebook pueda leer y escribir en el directorio del espacio de trabajo. Un notebook solo puede leer y escribir información en la carpeta del directorio del espacio de trabajo del usuario correspondiente; no se puede acceder a esa carpeta desde los notebooks de otros usuarios.

De forma predeterminada, los directorios de los espacios de trabajo privados de los usuarios se crean en las carpetas de /directories/arcgisworkspace/<userid>, con permisos establecidos como -rwxrwxrwx. Dicho nivel de permiso se necesita porque, de forma predeterminada, la cuenta de usuario de Linux que se ejecuta dentro del contenedor tendrá un UID o GID (Id. de grupo) distintos de los de la cuenta de usuario del SO que ejecuta el daemon de ArcGIS Notebook Server.

Si no desea utilizar el modelo de permiso abierto por motivos de seguridad, puede cambiar el modelo con una propiedad de sistema denominada applyDefaultUserWorkspacePermissions. Cuando esta propiedad se establece en true, los directorios del espacio de trabajo se crearán con la configuración predeterminada del sistema, como -rwx------, en lugar de la configuración de -rwxrwxrwx abierta.

Para usar esta característica, el usuario del SO que ejecuta el daemon de ArcGIS Notebook Server debe tener un UID de 1050 y un GID de 100 (para hacer coincidir el UID y el GID del usuario del contenedor).

Inicie sesión en el Directorio de administrador.

La dirección URL tiene el formato https://notebookserver.domain.com:11443/arcgis/admin.
Vaya a Sistema > Propiedades y haga clic en Editar.
Agregue la siguiente cadena JSON al cuadro de propiedades y guarde la edición:
```
{
   "applyDefaultUserWorkspacePermissions":"true"
}
```

Directorio de datos

Los datos son esenciales para ArcGIS Notebooks. Al crear notebooks, puede agregar capas de datos desde elementos del portal de ArcGIS Enterprise, desde servidores SIG externos o desde directorios de archivos locales.

Un directorio local que contenga datos se puede poner a disposición de los notebooks en forma de una ruta de archivos registrándolo en su sitio de ArcGIS Notebook Server. Una vez que se registra un directorio de datos en el sitio de ArcGIS Notebook Server, se puede acceder a él y todos los notebooks que se ejecutan en ese sitio pueden utilizarlo. A los directorios de datos se puede acceder desde la pestaña Archivos del editor de notebook. Se pueden registrar varios directorios de datos en un sitio del servidor.

Los notebooks que utilizan flujos de trabajo de análisis de ráster se utilizan particularmente en los directorios de datos. Puede registrar un almacén de rásteres basado en archivos como directorio de datos, lo que hace que la salida de las herramientas de análisis de ráster esté disponible inmediatamente en los notebooks.

Consideraciones acerca de los directorios de datos

Para que los notebooks puedan acceder a un directorio de datos registrado, el directorio debe conceder permisos de lectura y ejecución a todos los usuarios.

Para que los notebooks puedan acceder a un directorio de datos registrado, establezca permisos en modo 755 para dicho directorio.

Todos los autores de notebooks de su organización pueden agregar datos desde todos los directorios de datos registrados a sus notebooks. No puede limitar el acceso a los directorios de datos a determinados usuarios o grupos del portal.

En los flujos de trabajo de aprendizaje profundo que implican la generación de fragmentos de imagen para entrenar un modelo, en lugar de registrar el almacén de rásteres, se recomienda utilizar su propio almacén de rásteres para generar los fragmentos y, a continuación, cargar los fragmentos generados en su espacio de trabajo de Notebook Server. Una vez que se hayan cargado los fragmentos, podrá procesar los datos y entrenar su modelo desde su notebook.

Los datos de un directorio de datos registrado no forman parte del portal de ArcGIS Enterprise. Así pues, asegúrese al compartir un notebook de que todos los usuarios que vayan a ver el notebook compartido puedan acceder a todos los directorios de datos registrados a los que haga referencia el notebook.

Registrar un directorio de datos

Puede registrar un directorio de datos en ArcGIS Notebook Server Manager para que un directorio local esté disponible para el sitio del servidor.

Nota:

Para cargar o escribir archivos en esta ubicación del directorio de datos personalizado, el directorio debe tener permisos de lectura y escritura para el usuario "arcgis" (grupo "usuarios") que esté dentro del contenedor del notebook.

Inicie sesión en su portal de ArcGIS Enterprise como administrador y abra ArcGIS Notebook Server Manager.
Abra la página Configuración y haga clic en Directorios.
Haga clic en Registrar directorio de datos para abrir el cuadro de diálogo de registro.
Indique el nombre del directorio y su ruta completa en el equipo.
Indique que el directorio funcionará como directorio de DATA.
Haga clic en Guardar para confirmar.

No puede editar ni actualizar el nombre ni la ruta para un directorio registrado con ArcGIS Notebook Server. Para realizar cambios, debe dar de baja el directorio existente y volver a registrarlo luego.

Especificar una nueva ubicación para un directorio del servidor

A partir de la versión 10.8, puede editar un directorio existente en Manager para cambiar su ubicación. Debería seguir este método al ampliar a un sitio de varios equipos para ubicar sus directorios en rutas de archivo compartidas.

Nota:

Utilice una ruta de directorio local para el directorio arcgisworkspace y cualquier directorio de datos personalizado que sus usuarios registren con el sitio. En un sitio de varios equipos, debe existir la misma ruta de directorio en cada equipo.

Inicie sesión en su portal de ArcGIS Enterprise como administrador y abra ArcGIS Notebook Server Manager.
Abra la página Configuración y haga clic en Directorios.
Elija el directorio que desee modificar y haga clic en el botón Editar.
Sustituya el valor existente de Ruta de directorio por la nueva ruta del directorio. Haga clic en Guardar para confirmar.

Una vez reiniciado el sitio, este utiliza la nueva ruta para acceder al directorio.
Copie y pegue el contenido del directorio existente en su nueva ubicación.

Agregar una ruta de acceso UNC o carpeta compartida como directorio de datos en contenedores de Windows

Para agregar una ruta de acceso UNC o carpeta compartida como directorio de datos en contenedores de Windows, siga estos pasos:

Siga los pasos del 1 al 5 de la sección Configurar una unidad de red asignada para el directorio del espacio de trabajo para crear una unidad asignada con la ruta de acceso UNC.
Siga los pasos de la sección Registrar un directorio de datos anterior para registrar la nueva unidad asignada.

Repita estos pasos para cada directorio que desee actualizar.

Nota:

Si se actualiza la ubicación del directorio arcgisworkspace, debe volver a ejecutar la utilidad de instalación para extraer los datos de muestra en la ubicación del nuevo directorio del espacio de trabajo.