Unir equipos adicionales a un sitio de ArcGIS Notebook Server

ArcGIS Notebook Server admite sitios de varios equipos. 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 notebooks de ArcGIS.

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. Esta función multilicencia permite el escalado con un número variable de equipos que tengan una licencia Advanced o Standard.

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 varios usuarios de notebook que necesitan más recursos del equipo, considere 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 adicionales de ArcGIS Notebook Server 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.

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 admite la instalación de 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).
Asegúrese de que haber hecho lo siguiente durante el proceso de instalación llegado este punto:
1. Instale un motor de contenedor para ArcGIS Notebook Server. 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 tras la instalación.
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 ID de usuario 58103. Otorgue a la cuenta por lo menos permisos 700 en 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 ID de usuario 58103. Otorgue a la cuenta por lo menos permisos 700 en 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.
Desde uno de sus 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.
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. Desde 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, tal y como se crearon en el paso 4.
5. Repita los subpasos del a al d para cada equipo adicional que desee unir al sitio.

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:

Asegúrese de que ha iniciado sesión en el equipo con la cuenta de ArcGIS Notebook Server.

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:


El parámetro	Descripción
`-u` o `--username`	El nombre de usuario del administrador principal del sitio. El nombrede 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 existente de ArcGIS Notebook Server que se va a unir, 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. Proceda a instalar y configurar ArcGIS Web Adaptor en su sitio. A continuación, 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 desee agregar a un sitio existente, utilizando la cuenta Run As de ArcGIS Notebook Server.

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.
Cree un archivo de notación de objetos JavaScript (JSON) denominado connection.json.
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 existente 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" }
Guarde y cierre el archivo connection.json.
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.
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.

ArcGIS Notebook Server admite sitios de varios equipos. En un sitio de varios equipos, cada equipo debe tener la misma configuración, con el mismo SO, la misma configuración de motor de contenedor y la unidad de red asignada con la misma letra de unidad para el directorio del espacio de trabajo.

Instalar y configurar un sitio de varios equipos (contenedores de Windows)

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.

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 43 para la comunicación desde cada equipo de su implementación de ArcGIS Enterprise.

La versión instalada de ArcGIS Notebook Server y su archivo de licencia deben ser los mismos en cada equipo. Introduzca la misma cuenta de ArcGIS Notebook Server durante cada instalación. Se recomienda utilizar una cuenta de dominio o Active Directory, pero si elige una cuenta local, debe existir en todos los equipos con la misma combinación de nombre y contraseña. Tenga en cuenta que la cuenta que especifique no tiene que formar parte del grupo de administradores.
Asegúrese de que haber hecho lo siguiente durante el proceso de instalación:
1. Instale un motor de contenedor para ArcGIS Notebook Server 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. ArcGIS Notebook Server en Windows solo es compatible con contenedores de Windows. Descargue las imágenes de contenedor que corresponden a su instalación desde My Esri y ejecute la utilidad de línea de comandos PostInstaller (ubicada en <ArcGIS Notebook Server installation directory>\tools\postInstallUtility) para instalar las imágenes de contenedor para ArcGIS Notebook Server. Repita este paso para todos los equipos de ArcGIS Notebook Server. Siga los pasos para configurar ArcGIS Notebook Server tras la instalación.
Cree y comparta dos directorios en la red. Uno debe ser para el almacén de configuración y el otro para algunos de los directorios de servidor. El directorio workspace debe permanecer en un recurso compartido de UNC asignado como una unidad de red. Otorgue permisos de lectura y escritura para estos dos directorios a la cuenta de ArcGIS Notebook Server en cada equipo (asegúrese de hacerlo tanto en la pestaña Uso compartido como en la pestaña Seguridad del Explorador de archivos de Microsoft).

Nota:

Los directorios de red compartidos ocultos o que usan caracteres especiales (por ejemplo, $) no son compatibles con ArcGIS Notebook Server.
- 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 (UNC).
- Si la cuenta de ArcGIS Notebook Server no existe en el equipo (como en el caso de que el almacén de configuración y los directorios del servidor se encuentren en un servidor de archivos), debe crear la cuenta de ArcGIS Notebook Server utilizando el mismo nombre y la misma contraseña que utiliza en los demás equipos de su implementación.
- Si utiliza una cuenta de servicio administrada por un grupo (gMSA) para la cuenta de ArcGIS Notebook Server, debe permitir que las cuentas de servicio tengan permisos de control completo en las pestañas Uso compartido y Seguridad. Desde el editor Permisos, haga clic en Agregar y abra el cuadro de diálogo Tipos de objetos. Active la casilla Cuentas de servicio.
Desde uno de sus 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.
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. Desde 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, tal y como se crearon en el paso 4.
5. Repita los subpasos del a al d para cada equipo adicional que desee unir al sitio.
Cuando se agregan equipos adicionales al sitio, se consideran iguales en el sitio; no hay ningún equipo principal.

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:

Asegúrese de que ha iniciado sesión en el equipo con la cuenta de ArcGIS Notebook Server.

Abra una ventana de comando y ejecute la utilidad, que se encuentra en <ArcGIS Notebook Server install directory>\tools\JoinSiteUtility\joinsite.bat. A continuación, se muestran los parámetros de línea de comandos para la utilidad:


El parámetro	Descripción
`-u` o `--username`	El nombre de usuario del administrador principal del sitio. El nombrede 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 existente de ArcGIS Notebook Server que se va a unir, 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.bat -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.

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.
Cree un archivo de notación de objetos JavaScript (JSON) denominado connection.json.
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 existente 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 \\\\myshare\\arcgisserver\\config-store

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

Configurar una unidad de red asignada para el directorio del espacio de trabajo

Este es un proceso opcional que solo es necesario si planea configurar un sitio de Notebook Server de varios equipos.

Cree un recurso compartido de UNC para el directorio del espacio de trabajo de ArcGIS Notebook Server en un equipo separado al que pueda acceder Notebook Server.

Nota:

Este directorio debe tener acceso de lectura y escritura a la cuenta de ejecución de ArcGIS Notebook Server de Windows. Se recomienda crear un recurso compartido de UNC para el directorio del espacio de trabajo de ArcGIS Notebook Server en un equipo distinto al que forma parte del sitio de ArcGIS Notebook Server. Hay un problema conocido en el que los recursos compartidos de SMB creados en el mismo equipo que Notebook Server se desconectan al reiniciar el equipo.
En el equipo de Notebook Server, abra una ventana de PowerShell como administrador.
Guarde la contraseña de su cuenta de usuario de ArcGIS Notebook Server como una cadena de caracteres segura para usar el siguiente comando a continuación:

$password = ConvertTo-SecureString '<password>' -AsPlainText -Force
Agregue soporte de credenciales a las funciones de PowerShell:

$credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)
Monte la carpeta con el conjunto de indicadores persistentes:

New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:
Repita los pasos del 2 al 5 en todos los equipos que participan en el sitio de ArcGIS Notebook Server y asigne la misma letra de unidad para la unidad asignada en todos los equipos.
Utilice la unidad de red compartida creada en el paso anterior para configurar el directorio del espacio de trabajo al crear el sitio de ArcGIS Notebook Server.