Unir equipos adicionales a un sitio de ArcGIS Notebook Server (contenedores de Linux)

ArcGIS Notebook Server admite sitios de varios equipos a partir de la versión 10.7.1. En un sitio de varios equipos, todos los equipos se configuran del mismo modo, con idénticas configuraciones de Docker, y cada uno puede ejecutar ArcGIS Notebooks.

A partir de la versión 10.9, ArcGIS Notebook Server admite sitios con varias licencias, de modo que ya no es necesario que todos los equipos que participan en un sitio tengan el mismo nivel de licencia. Por ejemplo, puede configurar un sitio de tres equipos con un equipo configurado con una licencia avanzada y dos equipos configurados con licencias estándar. En las versiones anteriores a la 10.9, todos los equipos debían tener el mismo nivel de licencia (avanzada o estándar). Esta función multilicencia introducida en la versión 10.9 permitirá el escalado con un número variable de equipos que tengan una licencia avanzada o estándar.

Heredado:

En la versión 10.7, solo se admitían sitios de un solo equipo.

Los sitios de ArcGIS Notebook Server de varios equipos permiten la admisión de más usuarios de notebook simultáneos. Si tiene muchos usuarios activos, o si los recursos de su único equipo son inadecuados para las necesidades de sus usuarios, ampliar a un sitio de varios equipos podría ser beneficioso.

Nota:

Si tiene usuarios de notebook que necesitan más recursos del equipo, podría modificar los límites de recursos de su sitio como alternativa limitada a agregar equipos.

Todos los equipos de un sitio de ArcGIS Notebook Server tienen el mismo software instalado, con la misma versión. En el primer equipo que configure deberá crear el sitio de ArcGIS Notebook Server. A continuación, puede unir equipos de ArcGIS Notebook Server adicionales al sitio.

Nota:

A diferencia de otros roles de ArcGIS Server, ArcGIS Notebook Server no permite agregar equipos adicionales a un sitio desde el primer equipo. Debe acceder a cada equipo uno por uno y unirlos al sitio mediante el asistente de configuración de ArcGIS Notebook Server o la utilidad joinsite.

Antes de instalar

Cuando crea un sitio, determina el lugar donde se almacenará el almacén de configuración, un directorio que aloja los archivos fundamentales y la información de configuración de su sitio. Su sitio también tiene los directorios de servidor system y workspace.

Al crear un sitio de ArcGIS Notebook Server, especifique ubicaciones para el almacén de configuración y los directorios de servidor. En un sitio de varios equipos, debe compartir el almacén de configuración y los directorios de servidor para que los demás equipos puedan acceder a ellos. A cada equipo que se une al sitio se le deben otorgar permisos de lectura y escritura para esas ubicaciones compartidas.

Instalar y configurar un sitio de varios equipos

Si tiene pensado configurar un sitio de ArcGIS Notebook Server de varios equipos, en esta guía de instalación hay algunos pasos adicionales que hay que seguir.

1. Revise los requisitos del sistema para ArcGIS Notebook Server para verificar que todos los equipos los reúnen. En cada uno de los equipos, ajuste los firewalls para abrir el puerto 11443 para la comunicación desde cada equipo de su implementación de ArcGIS Enterprise.

   Asegúrese de instalar utilizando el mismo usuario del sistema operativo en ambos equipos. La cuenta de usuario utilizada para instalar ArcGIS Notebook Server será la cuenta utilizada para ejecutar el software. Los usuarios de grupo y todos los demás deben tener al menos permisos de ejecución en el directorio de instalación de ArcGIS Notebook Server. Tenga en cuenta que no se permite instalar ArcGIS Notebook Server con la cuenta raíz. La cuenta de usuario utilizada para realizar la instalación en dos equipos, por ejemplo, podría ser la siguiente:

   1. Instale ArcGIS Notebook Server en el primer equipo en /data/ags como usuario ags, con un Id. de usuario de 58103.
   2. Instale ArcGIS Notebook Server en un segundo equipo en /data/ags con el mismo nombre de usuario e Id. (ags, Id. de usuario 58103).
2. Asegúrese de que haber hecho lo siguiente durante el proceso de instalación llegado este punto:
   1. Instale Docker en todos los equipos. En cada equipo, descargue las imágenes de Docker proporcionadas por Esri y guárdelas en una ubicación a la que pueda acceder el sistema.
   2. Instale y autorice ArcGIS Notebook Server en todos los equipos. También puede instalar el software de forma automática.
   3. Ejecute la utilidad postinstaller de línea de comandos (ubicada en <ArcGIS Notebook Server installation directory>/tools/postInstallUtility) para cargar las imágenes de Docker en el repositorio local de cada equipo.
   4. Siga los pasos para configurar ArcGIS Notebook Server después de la instalación.
3. Cree y comparta dos directorios en la red, especificando el usuario de instalación como propietario. Uno debe ser para el almacén de configuración y el otro para los directorios del servidor. Debe otorgar al menos 700 permisos para las carpetas.

   Nota:

   Los directorios de red compartidos ocultos o que usan caracteres especiales (por ejemplo, $) no son compatibles con ArcGIS Notebook Server.

   Por ejemplo:
   1. Cree un directorio llamado config-store. Especifique el propietario como ags, con un Id. de usuario 58103. Otorgue por lo menos 700 permisos para el directorio.
   2. Comparta la carpeta config-store para que ambos equipos puedan acceder al directorio utilizando la misma ruta, por ejemplo, /net/myserver/config-store.
   3. Cree un directorio llamado arcgisnotebookserver. Especifique el propietario como ags, con un Id. de usuario 58103. Otorgue por lo menos 700 permisos para el directorio.
   4. Comparta la carpeta arcgisnotebookserver para que ambos equipos puedan acceder al directorio utilizando la misma ruta, por ejemplo, /net/myserver/arcgisnotebookserver.

      Incluso si los directorios residen en el mismo equipo que utilizará al crear el sitio, aún debe crear y compartir los directorios manualmente y hacer referencia a ellos a través de una ruta de red.

4. Desde uno de los equipos, cree un sitio de ArcGIS Notebook Server. Asegúrese de utilizar las rutas de los directorios del servidor y el almacén de configuración que definió anteriormente.
5. Una vez completados los pasos anteriores, puede unir cada equipo adicional al sitio que ha creado con el asistente de configuración. Si prefiere unir el sitio desde la línea de comandos, consulte el paso 6.
   1. En el primer equipo adicional, abra el Asistente de configuración de ArcGIS Notebook Server.
   2. Revise y siga las instrucciones indicadas en el asistente y, a continuación, haga clic en Continuar.
   3. Haga clic en Unirse a sitio existente.
   4. Introduzca la URL del sitio y las credenciales de su sitio de ArcGIS Notebook Server creado en el paso 4.
   5. Repita los subpasos del a al d para cada equipo adicional que desee unir al sitio.
6. Como alternativa al uso del asistente de configuración, puede unir el equipo al sitio mediante una utilidad de línea de comandos como se describe a continuación:
   1. Asegúrese de que tiene la sesión iniciada en el equipo con la cuenta de ArcGIS Notebook Server.
   2. Abra una ventana de comando y ejecute la utilidad, que se encuentra en <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh. A continuación, se muestran los parámetros de línea de comandos para la utilidad:

      Parámetro	Descripción
      -u o --username	El nombre de usuario del administrador principal del sitio. El nombre de usuario no puede contener estos caracteres: \/:*?|<>
      -p o --password	La contraseña del administrador principal del sitio. La contraseña no puede contener estos caracteres: \/:*?|<>
      -f o --file	El archivo de conexión del almacén de configuración de la utilidad joinsite.
      -s o --siteUrl	La URL del sitio de ArcGIS Notebook Server existente al que unirse, en el formato https://notebookserver.domain.com:11443.
      -h o --help	Muestra la ayuda de línea de comandos y se cierra.

      Comando de ejemplo de la utilidad:

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

      Si las credenciales de la cuenta y la URL del sitio se introducen correctamente, la utilidad unirá el equipo al sitio de ArcGIS Notebook Server. Repita este paso para cada equipo adicional.

Una vez que todos los equipos se hayan unido al sitio, el resto del proceso de configuración es el mismo que para sitios de un solo equipo. Continúe con la instalación y configuración de ArcGIS Web Adaptor con su sitio. Después, configurará su sitio con su portal de ArcGIS Enterprise.

Unirse a un sitio desde la línea de comandos

También puede usar la utilidad de línea de comandos joinSite para unir el equipo a un sitio de ArcGIS Notebook Server. Esta utilidad requiere que especifique la ubicación del almacén de configuración del sitio existente en lugar de su URL. Debido a esto, la utilidad resulta ventajosa en determinados casos en los que utilizar la URL saturaría las solicitudes de red en cola del sitio. Plantéese utilizar esta utilidad si los equipos del sitio de ArcGIS Notebook Server ya están sobrecargados con solicitudes de red o si desea unir una gran cantidad de equipos al sitio a la vez.

La utilidad join-site está instalada en \tools\JoinSiteUtility, en el directorio de instalación de ArcGIS Notebook Server. Ejecute la utilidad join-site desde el equipo de ArcGIS Notebook Server que desea agregar a un sitio existente utilizando la cuenta Run As correspondiente a ArcGIS Notebook Server.

1. Conceda acceso de escritura y lectura a la carpeta del almacén de configuración del sitio existente a la cuenta de red usada para ejecutar el servicio de ArcGIS Notebook Server en el equipo o equipos que desee unir al sitio.
2. Cree un archivo de notación de objetos JavaScript (JSON) denominado connection.json.
3. Agregue la siguiente línea al archivo y reemplace <path to the configuration store> con la ubicación del almacén de configuración del sitio de ArcGIS Server:

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

   En este ejemplo, la ruta del almacén de configuración del sitio existente es /net/mymachine/data/arcgisnotebookserver/usr/config-store:

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

4. Guarde y cierre el archivo connection.json.
5. Coloque el archivo connection.json en el equipo que se unirá al sitio o en un directorio compartido al que pueda acceder desde el equipo que se unirá al sitio.
6. Abra una ventana de comando y ejecute join-site.
La sintaxis es la siguiente:
joinSite -f <The file path to the configuration store JSON file>
En este ejemplo, se supone que el archivo JSON del almacén de configuración (connection.json) está situado en el mismo directorio que la herramienta join-site (\tools\JoinSiteUtility).
joinsite.bat -f connection.json

El equipo se une al sitio de ArcGIS Notebook Server.