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 ArcGIS Notebooks existentes del usuario. Si va a actualizar su implementación de ArcGIS Enterprise a 10.8.1, también debe actualizar ArcGIS Notebook Server.
El paquete de instalación de ArcGIS Notebook Server 10.8.1 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 10.8.1.
Durante el proceso de actualización, debe volver a autorizar el software de ArcGIS Notebook Server para 10.8.1 si ha actualizado desde 10.7.1 o versiones anteriores. No es necesario repetir la autorización de su software si la actualización es de 10.8 a 10.8.1.
También debe instalar nuevas imágenes de contenedor de Esri, proporcionando a sus usuarios los tiempos de ejecución del notebook de 10.8.1. Los tiempos de ejecución del notebook de la versión anterior permanecerán en el sitio; los usuarios podrán seguir ejecutando notebooks con esos tiempos de ejecución. Sin embargo, si sus usuarios desean usar una funcionalidad nueva en 10.8.1, deben actualizar el tiempo de ejecución de sus notebooks. Los tiempos de ejecución de notebooks correspondientes a la versión 10.8.1 se encuentran en la versión 4.0 (ArcGIS Notebook Server Standard 4.0 y ArcGIS Notebook Server Advanced 4.0).
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 10.8.1.
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 10.8.1.
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 10.8.1.
- Para que ArcGIS Notebook Server funcione correctamente, su versión debe coincidir con la versión del portal con el que está federado.
- 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 (actualizar primero el equipo principal y luego el de respaldo).
- Actualice cualquier otro servidor, incluido ArcGIS Notebook Server.
- No desinstale el 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 ArcGIS 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 los métodos para actualizar.
- Antes de actualizar, borre las cachés de todos los navegadores web utilizados en el equipo de ArcGIS Notebook Server.
Hacer una copia de seguridad de su implementación
Antes de la actualización, se recomienda realizar copias de seguridad de su implementación.
Heredado:
En la versión 10.7, debe hacer una copia de seguridad manual de los directorios del servidor y del almacén de configuración del sitio.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 proporcionará 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:
Le recomendamos que use el archivo de instalación para actualizar ArcGIS Notebook Server a 10.8.1. Si la organización le impide utilizar el archivo de instalación, puede llamar a la operación Actualizar sitio desde el Directorio de administrador de ArcGIS Notebook Server con un script.
Si tiene un sitio de varios equipos, siga los pasos del 1 al 5 para un equipo y, a continuación, repita estos pasos para cada equipo del sitio.
- Durante la instalación, lea el acuerdo maestro y acéptelo, o salga de la instalación si no está de acuerdo con los términos.
El programa de instalación muestra el componente que se instalará y el espacio libre en disco que se necesita en el disco duro.
- En el siguiente cuadro de diálogo, especifique las credenciales de inicio de sesión de la cuenta o proporcione un archivo de configuración.
La cuenta de ArcGIS Notebook Server utilizada por la instalación existente se rellena en el cuadro de Cuenta de ArcGIS Server. Indique la contraseña de la cuenta de ArcGIS Notebook Server. Normalmente, es la contraseña definida al instalar el software.
Si la contraseña no se valida correctamente, aparece un mensaje de error indicando que la contraseña no es válida. Si no está seguro de la contraseña que corresponde a la cuenta de ArcGIS Notebook Server, póngase en contacto con el administrador del sistema o restablezca la contraseña utilizando el Directorio de administrador de ArcGIS Notebook Server.
Si proporciona un archivo de configuración, las credenciales del archivo de configuración del servidor deben ser las mismas credenciales utilizadas por el sitio de ArcGIS Notebook Server existente.
- Si ha seleccionado Especificar el nombre de cuenta y la contraseña y ha introducido manualmente la información de la cuenta de ArcGIS Notebook Server, puede exportar un archivo de configuración del servidor en el cuadro de diálogo que aparece. Si no desea exportar un archivo de configuración, haga clic en Siguiente y acepte la opción predeterminada No exportar el archivo de configuración. Si desea exportar un archivo de configuración del servidor para futuras instalaciones, haga clic en Exportar archivo de configuración, vaya a una carpeta segura y proporcione un nombre para el archivo de configuración.
Nota:
Es posible que desee exportar un archivo de configuración del servidor si necesita realizar alguna de las siguientes acciones:
- Crear la misma cuenta de ArcGIS Notebook Server cuando se instala en varios equipos.
- Almacenar la cuenta y utilizarla cuando realice una actualización a una versión más reciente.
- Realice una instalación automática en la que el nombre de usuario y la contraseña estén cifrados.
Precaución:
Al exportar un archivo de configuración del servidor a un recurso compartido en red, la cuenta del Sistema local del equipo donde se instala ArcGIS Notebook Server debe disponer de permiso de escritura en el recurso compartido en red. Si los permisos no están definidos, es posible que el archivo de configuración del servidor no se exporte correctamente. Si no está seguro de cómo se establecen los permisos del recurso compartido en red, póngase en contacto con el administrador del sistema o exporte el archivo de configuración del servidor localmente y cópielo después en el recurso compartido en red.
- Para terminar la instalación, siga las instrucciones en pantalla.
- Una vez completada la instalación, el asistente de configuración se abre en un navegador. Siga las instrucciones proporcionadas en el asistente de configuración para completar el proceso de actualización.
- Si tiene un sitio de varios equipos, siga los pasos del 1 al 5 para el resto de equipos de su sitio. Si tiene un sitio de un solo equipo y tiene previsto actualizar a un sitio de varios equipos, puede unir los equipos adicionales al sitio. También debe modificar las rutas de los directorios del servidor y del almacén de configuración para utilizar las ubicaciones compartidas accesibles para cada equipo.
Actualizar desde la línea de comandos
También puede actualizar ArcGIS Notebook Server desde la línea de comandos utilizando la utilidad upgradesite a partir de la versión 10.8.
Esta utilidad solo 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 mostrará informes de progreso y se detendrá cuando se complete la actualización. Si tiene varios equipos en su sitio, repita este comando en cada uno y, a continuación, continúe con los pasos de la siguiente sección.
Autorizar de forma automática
Cuando la utilidad de actualización haya finalizado, debe volver a autorizar el software de ArcGIS Notebook Server para 10.8.1 si ha actualizado desde 10.7.1 o versiones anteriores. No es necesario repetir la autorización de su software si la actualización es de 10.8 a 10.8.1.
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 generará 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 web del Servicio de atención al cliente de Esri (https://service.esri.com/drm). 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.
- Instale la imagen de Docker especificando su ruta de archivo. La imagen se debe comprimir con el formato .tar.gz. Si tiene una licencia Advanced, ejecute dos veces el comando para instalar las imágenes de contenedor Standard y Advanced que descargó de My Esri. > ./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. - Dé de baja la instancia anterior de ArcGIS Web Adaptor del sitio y desinstale.
- Inicie sesión en el 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 10.8.1 y regístrela con ArcGIS Notebook Server.
- Una vez completada la actualización de la implementación, puede aprovechar las funciones de 10.8.1. 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 (versión 4.0).
Su sitio de ArcGIS Notebook Server 10.8.1 ya está listo para alojar ArcGIS Notebooks.