Actualizar ArcGIS Notebook Server en Windows Server 2019 (contenedores Linux)

La actualización de ArcGIS Notebook Server proporciona a su organización las características y mejoras más recientes del software, conservando al mismo tiempo los notebooks existentes del usuario. Si va a actualizar su implementación de ArcGIS Enterprise a 11.2, también debe actualizar ArcGIS Notebook Server.

El paquete de instalación de ArcGIS Notebook Server 11.2 detecta si existe una instalación de una versión anterior de ArcGIS Notebook Server en su equipo. Si es así, puede actualizar el software a la versión 11.2.

Durante el proceso de actualización, debe volver a autorizar el software de ArcGIS Notebook Server para 11.2 si ha actualizado desde 10.8.1 o versiones anteriores.

También debe instalar nuevas imágenes de contenedor de Esri, proporcionando a sus usuarios los tiempos de ejecución del notebook de 11.2. Los tiempos de ejecución del notebook de la versión anterior permanecerán en el sitio; los usuarios pueden seguir ejecutando notebooks con esos tiempos de ejecución. Sin embargo, si sus usuarios desean usar una funcionalidad nueva en 11.2, deben actualizar el tiempo de ejecución de sus notebooks. Los tiempos de ejecución de notebooks correspondientes a la 11.2 se encuentran en la versión 9.0 (ArcGIS Notebook Server Standard 9.0 y ArcGIS Notebook Server Advanced 9.0).

Nota:

Si alguno de los notebooks estaba usando tiempos de ejecución personalizados, debe reconstruir y volver a registrar los tiempos de ejecución personalizados en el Notebook Server de Windows y actualizar la configuración del tiempo de ejecución para los elementos del notebook asociados.

Nota:

Los tiempos de ejecución de los notebooks quedarán obsoletos después del ciclo de vida de ArcGIS Enterprise. Los notebooks no deberían emplear tiempos de ejecución obsoletos y deberían actualizarse a un tiempo de ejecución admitido.

La actualización del portal de ArcGIS Enterprise también actualizará los notebooks de muestra disponibles en la galería del sitio.

En 10.7.1 y versiones posteriores se admiten sitios de ArcGIS Notebook Server de varios equipos. Si tiene un sitio con un solo equipo y desea expandir su sitio de ArcGIS Notebook Server a varios equipos después de la actualización, siga los pasos para unir equipos adicionales al sitio después de que haya finalizado la actualización a 11.2.

El proceso de actualización de ArcGIS Notebook Server es una actualización local, que no requiere desinstalar ni volver a instalar el software. El sitio se desactivará durante el proceso de actualización y los usuarios no podrán acceder a notebooks ni ejecutarlos hasta que se complete la actualización.

Siga estos pasos para actualizar ArcGIS Notebook Server a la versión 11.2.

Prepararse para la actualización

Antes de actualizar, repase con detenimiento la siguiente información:

• Puede acceder a todos los archivos necesarios en My Esri antes de la actualización, incluidas las imágenes de contenedor de 11.2.
• Para que ArcGIS Notebook Server funcione correctamente, su versión debe coincidir con la versión del portal con el que está federado.
• Si su Notebook Server está actualmente en modo de solo lectura, desactive el modo antes de comenzar el proceso de actualización.
• Actualice Docker Desktop para Windows a la versión 4.19.0 o posterior.
• Para actualizar su implementación de ArcGIS Enterprise, realice lo siguiente:
  1. Actualice Portal for ArcGIS.
  2. Actualice ArcGIS Web Adaptor (para Portal).
  3. Actualice el sitio de ArcGIS Server que actúa como servidor de alojamiento del portal.
  4. Actualice ArcGIS Web Adaptor (para Server).
  5. Actualice ArcGIS Data Store (actualice primero el equipo principal y luego el de respaldo).
  6. Actualice cualquier otro servidor, incluido ArcGIS Notebook Server.
  7. Instalar los datos de ejemplo de ArcGIS Notebook Server
• No desinstale su ArcGIS Notebook Server existente. El programa de instalación de ArcGIS Notebook Server y los instaladores de línea de comandos están diseñados para detectar y actualizar una instalación existente de componentes de ArcGIS Notebook Server.
• No anule la federación del sitio de ArcGIS Notebook Server del portal ni elimine su designación como Notebook Server del portal en cualquier momento durante el proceso de actualización. Esto afecta negativamente a los notebooks existentes que están alojados por el portal.
• Puede actualizar ArcGIS Notebook Server utilizando el instalador del programa de instalación o de línea de comandos. Elija uno de estos métodos para actualizar.
• Antes de actualizar, borre las cachés de todos los navegadores web utilizados en el equipo de ArcGIS Notebook Server.
• La cuenta del servicio Windows para su sitio ArcGIS Notebook Server (su cuenta Ejecutar como) debe permanecer igual al actualizar.

Hacer una copia de seguridad de su implementación

Antes de la actualización, se recomienda realizar copias de seguridad de su implementación.

Los notebooks se incluirán en las copias de seguridad del portal con la utilidad webgisdr.

Puede usar la operación exportSite en el Directorio de administrador de ArcGIS Notebook Server para realizar la copia de seguridad del almacén de configuración de un sitio, según se describe a continuación. Además de la copia de seguridad de la configuración de este sitio, considere realizar copias de seguridad manuales de su sistema de archivos.

Siga estos pasos para ejecutar la operación de copia de seguridad:

1. Abra el Directorio de administrador de ArcGIS Notebook Server e inicie sesión como usuario con privilegios administrativos.

   Normalmente, la URL es https://notebookserver.domain.com:11443/arcgis/admin.

2. Vaya a sitio > Exportar sitio.
3. Introduzca la ruta completa de la ubicación de su equipo a la que desea exportar el archivo.

   El sitio debe tener acceso a este directorio.

4. Haga clic en Exportar.

   Una vez completada la operación de exportación, el directorio proporciona un vínculo a la ubicación del archivo de copia de seguridad en el servidor.

5. Descargue el archivo, que tendrá una extensión de archivo .agssite, lo antes posible.

Actualizar mediante el programa de instalación

Nota:

Use el archivo de instalación para actualizar ArcGIS Notebook Server a 11.2. Tras actualizar la instalación, debe actualizar el sitio de ArcGIS Notebook Server mediante el uso del asistente de configuración o la utilidad de actualización del sitio.

Si tiene un sitio de varios equipos, siga los pasos del 1 al 3 para un equipo y repita estos pasos para cada equipo del sitio.

ArcGIS Notebook Server se ha diseñado para detectar y actualizar una instalación existente de componentes de ArcGIS Notebook Server.

1. Para iniciar la actualización, ejecute ./Setup desde la ubicación de la que se extrajo ArcGIS Notebook Server y siga las instrucciones para completar la actualización.

   El programa de instalación debe ejecutarse con la cuenta de usuario que instaló la ArcGIS Notebook Server existente. Durante la instalación, el programa de instalación identifica la instalación existente y se le pide que confirme la actualización. Introduzca la opción y para continuar con la instalación.

   De esta forma se desinstalará la versión anterior de ArcGIS Notebook Server y se instalará la versión actualizada de ArcGIS Notebook Server.

2. Cuando la utilidad de actualización haya finalizado, vuelva a autorizar el software de ArcGIS Notebook Server para 11.2. Utilice el asistente de autorización de software para completar la autorización.
3. Abra el asistente de configuración mediante la URL que figura al final de la actualización que instala y siga las instrucciones de la pantalla para actualizar el sitio.
4. Si el sitio tiene varios equipos, siga los pasos del 1 al 3 con cada equipo del sitio.

Actualizar desde la línea de comandos

Para actualizar desde la línea de comando, siga estos pasos:

1. Para iniciar la actualización, ejecute el comando de configuración de ArcGIS Notebook Server con el argumento mostrado en el ejemplo siguiente. Asegúrese de utilizar la misma cuenta de ArcGIS Notebook Server que la instalación existente.

   De esta forma se desinstala la versión anterior de ArcGIS Notebook Server y se instala la versión actualizada de ArcGIS Notebook Server.

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. Use la utilidad upgradesite y complete la actualización ejecutando el comando siguiente. De forma predeterminada, la utilidad upgradesite se puede encontrar en C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat.

   upgradesite.bat -s

   La utilidad muestra informes de progreso y se detiene cuando se complete la actualización. La utilidad tiene dos parámetros:

   • -s: cuando se incluye en el comando, esto solicita a la utilidad que ejecute la actualización. La actualización no se ejecutará sin -s. Esto está pensado para garantizar que solo ejecute la actualización cuando tenga todo listo.
   • -h: muestra la ayuda de la herramienta. Cuando el comando se ejecuta sin -s, también se muestra la ayuda.

3. Si el sitio tiene varios equipos, repita los pasos 1 y 2 con cada equipo del sitio y continúe con los pasos de la sección siguiente.

Autorizar de forma automática

Cuando la utilidad de actualización haya finalizado, debe volver a autorizar el software de ArcGIS Notebook Server para 11.2.

Ejecute SoftwareAuthorization.exe con la siguiente sintaxis para autorizar ArcGIS Notebook Server de manera automática. El archivo de autorización o aprovisionamiento debe tener completa toda la información del usuario antes de ejecutarlo.

Si tiene un archivo de autorización y su equipo está conectado a Internet, ejecute lo siguiente:

<System disk drive>\Program Files\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /LIF <full path and name of authorization file>

Autorizar con un entorno sin conexión

Puede autorizar ArcGIS Notebook Server en un entorno desconectado utilizando un archivo de aprovisionamiento (.prvc). Durante el proceso, se genera un archivo para que lo envíe a Esri y complete el proceso.

1. En la ventana de comandos, ejecute el comando que se indica a continuación, una vez completada la actualización de ArcGIS Notebook Server:

   <ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. Una vez creado el archivo de información de salida, realice una de las siguientes acciones:
   • Vaya al sitio de autoservicio de Esri. Siga las instrucciones de la pantalla para cargar el archivo de información de autorización y descargue su archivo de autorización .ecp.
   • Envíe el archivo de información de autorización por correo electrónico a la dirección [e-mail]. Esri le devolverá el archivo de autorización .ecp en un mensaje de correo electrónico.
3. Una vez que haya recibido el archivo de autorización .ecp por uno de los métodos indicados, ejecute de nuevo el script authorizeSoftware para procesarlo y completar el proceso de autorización del servidor:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .ecp file>

Repita este flujo de trabajo para cada equipo que esté ejecutando ArcGIS Notebook Server.

Pasos después de actualizar

Antes de poder utilizar el sitio de ArcGIS Notebook Server actualizado y autorizado, debe ejecutar la utilidad de postinstalación para agregar las nuevas imágenes de contenedor Docker al sitio. También debe reemplazar las instancias de ArcGIS Web Adaptor registradas con su sitio para que coincidan con la nueva versión.

Ejecute la utilidad de postinstalación

Para ejecutar la utilidad de postinstalación, siga estos pasos:

1. Abra la ventana de comando como administrador.
2. Cambie los directorios a la carpeta de herramientas de ArcGIS Notebook Server. De forma predeterminada, esta ruta es C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.
3. Si lo desea, consulte la ayuda de la utilidad ejecutando el siguiente comando: PostInstallUtility.bat -h
4. ArcGIS Notebook Server requiere que Edición de comunidad del Motor de Docker esté instalado en su equipo. Determine si Docker está activo en su equipo ejecutando el siguiente comando: PostInstallUtility.bat -d
5. Si Docker Desktop no está instalado, instálelo ahora.

   ArcGIS Notebook Server utiliza contenedores Linux en Docker Desktop. Al instalar Docker Desktop, asegúrese de especificar contenedores Linux y no haga clic en la opción Cambiar a contenedores Windows.

6. Cuando utilice Docker Desktop, modifique cada uno de los siguientes ajustes:
   1. Haga clic con el botón derecho en el botón Docker de la bandeja del sistema y haga clic en Configuración. En General, active Exponer daemon en tcp://localhost:2375 sin TLS.

      Utilizará la API remota de Docker, que requiere el uso del puerto 2375.

   2. Haga clic con el botón derecho en el botón Docker de la bandeja del sistema y haga clic en Configuración. En el menú Configuración, haga clic en Recursos > Uso compartido de archivos y agregue el directorio de la unidad que se utilizará para su almacén de configuración de ArcGIS Notebook Server.

      Nota:

      Docker para Windows solo admite directorios locales en Windows que se comparten con contenedores de Linux.

7. Instale la imagen de Notebooks especificando su ruta de archivo. La imagen se debe comprimir con el formato .tar.gz. Si tiene una licencia Advanced y Docker Desktop, ejecute dos veces el comando para instalar las imágenes de contenedor Standard y Advanced que descargó de My Esri.

   Nota:

   Asegúrese de que su equipo tenga al menos 75 GB de espacio en disco disponible.

   Ejecute el siguiente comando: PostInstallUtility.bat -l <path of .tar.gz Docker image>

   Nota:

   Asegúrese de instalar ambas imágenes de contenedor. Aunque tenga la licencia Advanced, es posible que los usuarios sigan necesitando utilizar el tiempo de ejecución Standard.

Instalar y configurar datos de ejemplo de ArcGIS Notebook Server

Al configurar un sitio de ArcGIS Notebook Server con varios equipos, debe instalar y configurar los datos de ejemplos solamente en el primer equipo en el que haya instalado Notebook Server y creado el sitio.

Para instalar y configurar los datos de ejemplo, realice estos pasos:

1. Ejecute el asistente de instalación de los datos de ejemplo de ArcGIS Notebook Server que descargó de My Esri.

   Los datos de ejemplo se instalan en el directorio en el que ha instalado ArcGIS Notebook Server.

2. Abra la ventana de comando como administrador.
3. Cambie los directorios a la carpeta de herramientas de ArcGIS Notebook Server.

   Esta ruta es C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility de forma predeterminada.

4. Si lo desea, consulte la ayuda de la utilidad ejecutando el siguiente comando:

    > PostInstallUtility.bat -h

5. Ejecute la utilidad de postinstalación para extraer los datos de ejemplo en el directorio arcgisworkspace del sitio de Notebook Server.

    PostInstallUtility.bat -x

Sustituir las instancias de ArcGIS Web Adaptor

Para reemplazar instancias de ArcGIS Web Adaptor, siga estos pasos:

1. Dé de baja la instancia anterior de ArcGIS Web Adaptor del sitio y desinstale.
   1. Inicie sesión en su directorio de administrador de ArcGIS Notebook Server.
   2. Vaya a Sistema > Web Adaptors > Equipo registrado.
   3. Haga clic en Anular registro de Web Adaptor.
2. Instale una nueva instancia de ArcGIS Web Adaptor 11.2 y configúrela con ArcGIS Notebook Server.
Una vez completada la actualización de la implementación, puede aprovechar las funciones de 11.2.
3. Si es actualizada desde la versión 10.8 u otra anterior, para habilitar la programación de notebooks en su portal, realice lo siguiente:
   1. Si lo desea, puede actualizar los roles personalizados que incluyan privilegios de notebook para agregar el nuevo privilegio Programar notebooks.
   2. Indique a los autores de notebooks que actualicen el tiempo de ejecución de cada uno de sus notebooks si desean utilizar la función de programación.

      Solo se pueden programar notebooks que utilicen el tiempo de ejecución de la versión 10.8.1 o posterior (versión 4.0).

El sitio ArcGIS Notebook Server 11.2 ya está preparado para alojar ArcGIS Notebooks.