Instalar automáticamente ArcGIS Notebook Server

Puede instalar y autorizar ArcGIS Notebook Server utilizando parámetros de línea de comandos, en lugar de utilizar el asistente de instalación.

Sugerencia:

El modo de instalación que elija determina el modo de desinstalación predeterminado. Por ejemplo, si opta por instalar automáticamente desde la línea de comandos, la opción de desinstalación predeterminada es la desinstalación automática desde la línea de comandos.

Antes de instalar ArcGIS Notebook Server, revise los requisitos del sistema.

Nota:

Los parámetros de línea de comandos distinguen entre mayúsculas y minúsculas. Si tiene problemas para hacer que funcione la instalación, compruebe que las mayúsculas/minúsculas coincidan con cada propiedad como se muestra en los ejemplos de código siguientes.

Prepararse para instalar ArcGIS Notebook Server

Antes de continuar con la instalación, siga estos pasos.

1. Inicie sesión en My Esri y obtenga los archivos necesarios. Necesita lo siguiente:
   • Su descarga del software de ArcGIS Notebook Server.
   • Su archivo de autorización.
   • Una imagen de contenedor Docker, o ambas, en función de su licencia. Estas imágenes de contenedor contienen todos los componentes necesarios para la ejecución de ArcGIS Notebooks. Para obtener más información, consulte Docker y ArcGIS Notebook Server.
2. Verifique que cada equipo en el que instalará ArcGIS Notebook Server cumpla los requisitos del sistema.
3. Modifique el firewall de cada equipo para permitir la comunicación en el puerto 11443, que utiliza ArcGIS Notebook Server.
4. Agregue su cuenta de usuario del SO (la cuenta que instalará ArcGIS Notebook Server) a un grupo Unix denominado docker. Este flujo de trabajo está documentado en el sitio web de Docker.

   Nota:

   No se permite instalar ArcGIS Notebook Server con la cuenta raíz.

Instalar ArcGIS Notebook Server de forma automática

Siga estos pasos para instalar ArcGIS Notebook Server de manera automática desde la línea de comandos.

De manera predeterminada, ArcGIS Notebook Server se instalará en ${HOME}/arcgis/notebookserver.

1. Abra un shell de comandos como el usuario que ejecutará ArcGIS Notebook Server. Vaya al directorio donde descargó el archivo tar.gz de ArcGIS Notebook Server desde My Esri.
2. Descomprima el archivo tar.gz con el siguiente comando:

   tar -xvzf ArcGIS_Notebook_Server_Linux_<version>.tar.gz

3. Vaya al directorio donde descomprimió el archivo y a <untar directory>/Documentation/EULA.pdf. Lea el acuerdo de licencia.
4. Desde el directorio, ejecute el programa de instalación de manera automática y autorícelo con un archivo .prvc. La sintaxis es la siguiente:

   <untar directory>/Setup -m silent -l yes -a <full path to .prvc file>

   Estos son los parámetros de la herramienta de línea de comandos:

   Parámetro	Descripción
   -m; --mode MODE	(Opcional) El modo de instalación: silent o GUI. La opción predeterminada es GUI.
   -l; --license-agreement CHOICE	Es necesario para el modo automático; o yes o nada. Sí indica que ha leído y está de acuerdo con el Contrato marco de Esri (E204, E300). Puede revisar el acuerdo en cualquier momento.
   -a; --authorization-file PATH_TO_FILE	(Opcional) La ruta de archivo absoluta al archivo de autorización o aprovisionamiento proporcionado por Esri. Si no se utiliza esta opción, debe autorizar el software después de la instalación, como se detalla en la siguiente sección.
   -d; --directory DIRECTORY	(Opcional) De forma predeterminada, ArcGIS Notebook Server se instala en su directorio ${HOME}. DIRECTORY especifica otro directorio de instalación. La ruta /arcgis/notebookserver/ se añade al directorio de instalación. Se debe escribir el nombre del directorio de instalación en minúsculas. Las muestras y los datos incluidos en la instalación requieren que la ruta de los datos esté en minúsculas.
   -v; --verbose	(Opcional) Ejecute el instalador en modo detallado.
   -h; --help	Muestra la ayuda de la línea de comandos y se cierra.
   -e; --examples	Muestra ejemplos de uso de cada opción y se cierra.

5. Modifique los privilegios de su SO para permitir a systemd arrancar y administrar procesos en ArcGIS Notebook Server. Esto permite que el servicio se inicie inmediatamente cuando se inicia el equipo.
   1. En un terminal, cambie al usuario raíz.
   2. Copie el archivo de unidades <ArcGIS Notebook Server install directory>/framework/etc/scripts/agsnotebook.service en /etc/systemd/system. Cambie los permisos de archivo de este archivo reubicado de 700 a 600.
   3. Aún como usuario raíz, ejecute el siguiente comando:

      # systemctl enable agsnotebook.service

   4. Reinicie el servicio de systemd y compruebe su estado para verificar que se haya configurado correctamente.

      # systemctl stop agsnotebook.service
      # systemctl start agsnotebook.service
      # systemctl status agsnotebook.service

   5. Termine la sesión del usuario raíz.
   6. Reinicie el sistema operativo y verifique que ArcGIS Notebook Server se inicie correctamente.

Autorizar el software de manera automática

Si no autorizó el software durante la instalación, ejecute la autorización de software con la siguiente sintaxis para autorizar ArcGIS Notebook Server de manera automática. Ejecute el siguiente comando para ver todas las opciones de autorización:

<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.

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

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware -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 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 [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:

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware -f <full path to the .ecp file>

Repita este flujo de trabajo con cada equipo en el que desee instalar ArcGIS Notebook Server.

Cuando haya instalado todo el software, configure ArcGIS Notebook Server y cree el sitio del servidor. Existe una opción para crear el sitio mediante la utilidad de línea de comandos createsite.

Desinstalar el software de forma automática

Para desinstalar ArcGIS Notebook Server automáticamente desde la línea de comandos, ejecute el siguiente comando:

<ArcGIS Notebook Server install directory>/uninstall_ArcGISNotebookServer