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 a la versión 23.0 o posterior.
- Para actualizar su implementación de ArcGIS Enterprise, realice lo siguiente:
- Actualice Portal for ArcGIS.
- Actualice ArcGIS Web Adaptor (para Portal).
- Actualice el sitio de ArcGIS Server que actúa como servidor de alojamiento del portal.
- Actualice ArcGIS Web Adaptor (para Server).
- Actualice ArcGIS Data Store (actualice primero el equipo principal y luego el de respaldo).
- Actualice cualquier otro servidor, incluido ArcGIS Notebook Server.
- 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.
Mover el directorio del espacio de trabajo
Este proceso es necesario en el caso de implementaciones de ArcGIS Notebook Server en un solo equipo en Linux que tienen un directorio del espacio de trabajo dentro del directorio de instalación de Notebook Server.
- Inicie sesión en su portal de ArcGIS Enterprise como administrador y abra ArcGIS Notebook Server Manager.
- Haga clic en la pestaña Configuración.
- Haga clic en Directorios.
- Compruebe si la ruta actual al directorio arcgisworkspace están dentro del directorio de instalación de ArcGIS Notebook Server.
<installdir>/arcgis/notebook/directories/arcgisworkspace
Si el directorio arcgisworkspace está dentro del directorio de instalación de ArcGIS Notebook Server, debe mover el directorio del espacio de trabajo a una ubicación que se encuentre fuera del directorio de instalación antes de que pueda actualizar.
Si el directorio arcgisworkspace no está dentro del directorio de instalación de ArcGIS Notebook Server, no necesita realizar los pasos restantes de esta sección.
- Haga clic en Editar correspondiente al directorio arcgisworkspace.
- Sustituya el valor existente de la ruta de directorio por la nueva ruta del directorio arcgisworkspace que está fuera del directorio de instalación.
<installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace
- Haga clic en Guardar.
- Copie manualmente todo el contenido que está dentro del directorio arcgisworkspace anterior en el nuevo directorio arcgisworkspace.
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:
- 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.
- Vaya a sitio > Exportar sitio.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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:
- Para iniciar la actualización, ejecute ./Setup desde la ubicación de la que se extrajo ArcGIS Notebook Server con el argumento mostrado en el ejemplo siguiente y siga las instrucciones para completar la actualización.
De esta forma se desinstala la versión anterior de ArcGIS Notebook Server y se instala la versión actualizada de ArcGIS Notebook Server.
<untar directory>/Setup -l yes -m silent - Cuando la utilidad de actualización haya finalizado, vuelva a autorizar el software de ArcGIS Notebook Server para 11.2. Ejecute la autorización de software con la siguiente sintaxis para autorizar ArcGIS Notebook Server de manera automática:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftwareEjecute el siguiente comando para ver todas las opciones de autorización:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --helpNota:
Consulte la sección Autorizar con un entorno sin conexión para obtener información sobre la autorización de instalaciones de ArcGIS Notebook Server en un entorno desconectado. - Actualice el sitio mediante el uso de la utilidad de línea de comandos upgradesite.
Esta 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.
De forma predeterminada, la utilidad upgradesite se puede encontrar en ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.
Antes de actualizar, revise la información de preparación al principio de este tema. Cuando tenga todo listo para actualizar, abra un terminal de comandos en el equipo que va a actualizar. Vaya al directorio donde se encuentra la utilidad y ejecute el siguiente comando:
> ./upgradesite.sh -sLa utilidad muestra informes de progreso y se detiene cuando se complete la actualización.
- Si el sitio tiene varios equipos, siga los pasos del 1 al 3 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 la autorización de software con la siguiente sintaxis para autorizar ArcGIS Notebook Server de manera automática:<ArcGIS Notebook Server install directory>/tools/authorizeSoftware<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help
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.
- 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 installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output> - 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 authorize@esri.com. Esri le devolverá el archivo de autorización .ecp en un mensaje de correo electrónico.
- 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:
<ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -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:
- Abra un terminal con la cuenta de instalación de ArcGIS Notebook Server.
- Cambie los directorios a la carpeta de herramientas de ArcGIS Notebook Server. De forma predeterminada, esta ruta es ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- Si lo desea, consulte la ayuda de la utilidad ejecutando el siguiente comando: ./PostInstallUtility.sh -h
- ArcGIS Notebook Server requiere que el Motor de Docker esté instalado en su equipo. Determine si Docker está activo en su equipo ejecutando el siguiente comando: ./PostInstallUtility.sh -d
- Si Docker Desktop no está instalado, instálelo ahora.
- 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.sh -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.
Siga estos pasos para instalar los datos de ejemplo de ArcGIS Notebook Server:
- Abra un shell de comandos como el usuario que ejecutará ArcGIS Notebook Server. Vaya al directorio donde descargó el archivo tar.gz de datos de ejemplo de ArcGIS Notebook Server desde My Esri.
- Descomprima el archivo tar.gz con el siguiente comando:
tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz - Vaya a <install directory>/notebookserver/License para leer el acuerdo de licencia.
- Ejecute el script desde el directorio.
./ArcGISNotebookServerSamplesData-Setup.sh - Cambie los directorios a la carpeta de herramientas de ArcGIS Notebook Server.
Esta ruta es ${HOME}/arcgis/notebookserver/tools/postInstallUtility de forma predeterminada.
- Si lo desea, consulte la ayuda de la utilidad ejecutando el siguiente comando:
> ./PostInstallUtility.sh -h - Ejecute la utilidad de postinstalación para extraer los datos de ejemplo en el directorio arcgisworkspace del sitio de Notebook Server.
> ./PostInstallUtility.sh -x
Sustituir las instancias de ArcGIS Web Adaptor
Para reemplazar instancias de ArcGIS Web Adaptor, siga estos pasos:
- Dé de baja la instancia anterior de ArcGIS Web Adaptor del sitio y desinstale.
- Inicie sesión en su directorio de administrador de ArcGIS Notebook Server.
- Vaya a Sistema > Web Adaptors > Equipo registrado.
- Haga clic en Anular registro de Web Adaptor.
- Instale una nueva instancia de ArcGIS Web Adaptor 11.2 y configúrela con ArcGIS Notebook Server.
- 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:
- Si lo desea, puede actualizar los roles personalizados que incluyan privilegios de notebook para agregar el nuevo privilegio Programar notebooks.
- 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.