Instalar ArcGIS Web Adaptor

Es posible instalar ArcGIS Web Adaptor mediante el programa de instalación proporcionado, que se puede ejecutar a través de una utilidad denominada Setup.exe o de forma automática utilizando los parámetros de línea de comandos de Windows Installer.

Es posible instalar ArcGIS Web Adaptor mediante el programa de instalación proporcionado, que se puede ejecutar a través de una utilidad denominada Setup.sh o de forma automática utilizando los parámetros de línea de comandos.

Requisitos de instalación

La versión de ArcGIS Web Adaptor debe coincidir con la de su sitio de servidor o portal.
ArcGIS Web Adaptor se puede instalar en paralelo con otras versiones. No es necesario desinstalar ArcGIS Web Adaptor a menos que esté actualizando a una versión más reciente.
Cada ArcGIS Web Adaptor debe tener su propio nombre único; no puede tener dos Web Adaptors con el mismo nombre en un único servidor web. Si se detecta un conflicto de nombres durante la instalación, aparece un mensaje de advertencia. Debe desinstalar la versión anterior con el mismo nombre para resolver el conflicto. También puede cambiar el nombre de uno de los Web Adaptor para continuar con la instalación.
No es necesario instalar ArcGIS Web Adaptor y Tomcat en el mismo equipo si va a configurar Web Adaptor con un sitio de servidor o portal mediante su navegador. No obstante, si va a configurar Web Adaptor utilizando la herramienta configurewebadaptor.exe, deberá instalar Web Adaptor y Tomcat en el mismo equipo.

Nota:

Asegúrese de iniciar Tomcat o cualquier otro servidor de aplicaciones donde se vaya a implementar una instancia de ArcGIS Web Adaptor, con permisos administrativos. De no ser así, la operación para registrar ArcGIS Web Adaptor en ArcGIS Server fallará.

No es necesario instalar ArcGIS Web Adaptor y Tomcat en el mismo equipo si va a configurar Web Adaptor con un sitio de servidor o portal mediante su navegador. No obstante, si va a configurar Web Adaptor utilizando la herramienta configurewebadaptor.exe, deberá instalar Web Adaptor y Tomcat en el mismo equipo.

Nota:

Asegúrese de iniciar Tomcat o cualquier otro servidor de aplicaciones donde se vaya a implementar una instancia de ArcGIS Web Adaptor, con permisos administrativos. De no ser así, la operación para registrar ArcGIS Web Adaptor en ArcGIS Server fallará.
Al implementar ArcGIS Web Adaptor en un servidor de aplicaciones, la configuración del Web Adaptor se escribe en el directorio de inicio del usuario. Asegúrese de que el usuario tenga asignado un directorio de inicio y acceso de lectura y escritura antes de continuar.

Antes de instalar ArcGIS Web Adaptor

Antes de instalar ArcGIS Web Adaptor, haga lo siguiente:

Verifique que el sistema cumpla todos los requisitos del sistema. Solo puede configurar un Web Adaptor con un sitio de servidor o portal.
Habilite IIS y los componentes necesarios.

Precaución:

Para instalar y configurar ArcGIS Web Adaptor correctamente, debe habilitar IIS y los componentes necesarios antes de instalar los requisitos previos especificados en el siguiente paso.
Asegúrese de que los siguientes requisitos previos estén instalados en el equipo donde se instalará ArcGIS Web Adaptor:
- Microsoft Web Deploy 4.0
- ASP.NET Core Runtime - Windows Hosting Bundle 10.x
Nota:

Debe instalar ASP.NET Core Runtime - Windows Hosting Bundle, que incluye .NET Runtime y soporte para IIS.

Precaución:

Si instaló ASP.NET Core Runtime - Windows Hosting Bundle antes de habilitar IIS y los componentes necesarios, debe reparar la instalación del paquete con el instalador de paquetes.
Inicie sesión en el equipo en el que va a instalar ArcGIS Web Adaptor.

Nota:

Debe iniciar sesión como usuario con privilegios de administrador.
Compruebe que tenga un sitio web funcionando en el puerto 80 y HTTPS habilitado en el puerto 443. El objetivo es dar cabida a la variedad de llamadas cifradas y sin cifrar que se realizan a ArcGIS Enterprise. Para obtener instrucciones sobre cómo crear un sitio web, consulte la documentación del producto IIS. Para obtener más información sobre la configuración y el uso de HTTPS, consulte Activar HTTPS en su servidor web.

Nota:

Es adecuado usar el puerto 443 HTTPS predeterminado para la gran mayoría de usuarios. En raras ocasiones, una instancia de ArcGIS Web Adaptor no puede usar el puerto 443 en su servidor web por razones específicas de la organización. Si este es el caso de su organización, consulte Usar puertos no predeterminados para ArcGIS Web Adaptor del portal, que detalla pasos adicionales para configurar una alternativa.
Cierre todas las aplicaciones.
Vaya hasta la carpeta descargada que contiene el archivo de instalación de ArcGIS Web Adaptor. También puede insertar el soporte de ArcGIS Server o Portal for ArcGIS en la unidad correspondiente para iniciar automáticamente el programa de instalación.

Ahora está listo para proceder con la instalación de ArcGIS Web Adaptor.

Precaución:

No se admite intentar configurar ArcGIS Web Adaptor de modo que la URL incluya niveles adicionales, ya que esto podría provocar problemas con las aplicaciones cliente.

Verifique que el sistema cumpla todos los requisitos del sistema. Solo puede configurar un Web Adaptor con un sitio de servidor o portal.
Inicie sesión en el equipo en el que va a instalar ArcGIS Web Adaptor.

Nota:

Debe iniciar sesión como usuario con privilegios de administrador.
Compruebe que tenga un sitio web funcionando en el puerto 80 y HTTPS habilitado en el puerto 443. El objetivo es dar cabida a la variedad de llamadas cifradas y sin cifrar que se realizan a ArcGIS Enterprise. Para obtener instrucciones sobre cómo crear un sitio web, consulte la documentación específica del producto correspondiente a su servidor de aplicaciones Java. Para obtener más información sobre la configuración y el uso de HTTPS, consulte Activar HTTPS en su servidor web.

Nota:

Es adecuado usar el puerto 443 HTTPS predeterminado para la gran mayoría de usuarios. En raras ocasiones, una instancia de ArcGIS Web Adaptor no puede usar el puerto 443 en su servidor web por razones específicas de la organización. Si este es el caso de su organización, consulte Usar puertos no predeterminados para ArcGIS Web Adaptor del portal, que detalla pasos adicionales para configurar una alternativa.
Cierre todas las aplicaciones.
Vaya hasta la carpeta descargada que contiene el archivo de instalación de ArcGIS Web Adaptor. También puede insertar el soporte de ArcGIS Server o Portal for ArcGIS en la unidad correspondiente para iniciar automáticamente el programa de instalación.

Ahora está listo para proceder con la instalación de ArcGIS Web Adaptor.

Verifique que el sistema cumpla todos los requisitos del sistema. Solo puede configurar un Web Adaptor con un sitio de servidor o portal.
Inicie sesión en el equipo en el que va a instalar ArcGIS Web Adaptor.

Nota:

Debe iniciar sesión como usuario con privilegios de administrador.
Compruebe que tenga un sitio web funcionando en el puerto 80 y HTTPS habilitado en el puerto 443. El objetivo es dar cabida a la variedad de llamadas cifradas y sin cifrar que se realizan a ArcGIS Enterprise. Para obtener instrucciones sobre cómo crear un sitio web, consulte la documentación específica del producto correspondiente a su servidor de aplicaciones Java. Para obtener más información sobre la configuración y el uso de HTTPS, consulte Activar HTTPS en su servidor web.

Nota:

Es adecuado usar el puerto 443 HTTPS predeterminado para la gran mayoría de usuarios. En raras ocasiones, una instancia de ArcGIS Web Adaptor no puede usar el puerto 443 en su servidor web por razones específicas de la organización. Si este es el caso de su organización, consulte Usar puertos no predeterminados para ArcGIS Web Adaptor del portal, que detalla pasos adicionales para configurar una alternativa.
Vaya hasta la carpeta descargada que contiene el archivo de instalación de ArcGIS Web Adaptor. También puede insertar el soporte de ArcGIS Server o Portal for ArcGIS en la unidad correspondiente para iniciar automáticamente el programa de instalación.

Ahora está listo para proceder con la instalación de ArcGIS Web Adaptor.

Instalar ArcGIS Web Adaptor mediante el programa de instalación

Para instalar ArcGIS Web Adaptor mediante el programa de instalación, siga estos pasos:

El programa de instalación de ArcGIS Web Adaptor debería iniciarse automáticamente después de completar la descarga. Si el programa de instalación no se inicia automáticamente, vaya a la ubicación de descarga de los archivos de instalación y haga doble clic en Setup.exe.
Revise el acuerdo maestro y acéptelo si está de acuerdo. Haga clic en Siguiente para continuar con la instalación.
Elija un sitio web que se ejecute en el puerto 80 para ArcGIS Web Adaptor. Los sitios Web disponibles se enumeran como <nombre del sitio web (puerto)>. Si no puede ver el cuadro de diálogo Seleccionar sitio web, significa que solo tiene un sitio web. Si solo hay un sitio web en el equipo, ArcGIS Web Adaptor se coloca automáticamente en el sitio web sin mostrar el cuadro de diálogo Seleccionar sitio web.
Proporcione un nombre para Web Adaptor. El valor predeterminado es arcgis. El nombre de instancia no puede contener espacios.

Nota:

Aparecerá un mensaje si existe un directorio virtual con el mismo nombre que el Web Adaptor existente en el sitio web seleccionado. Haga clic en Aceptar para cerrar el mensaje y proporcione un nombre diferente para Web Adaptor.
Para terminar la instalación, siga las instrucciones en pantalla.

Nota:

Cada instalación de Web Adaptor crea un grupo de aplicaciones con la convención de nomenclatura predeterminada de ArcGISWebAdaptorAppPool<web adaptor name>.

Inicie el programa de instalación de ArcGIS Web Adaptor, Setup.exe, y lea la pantalla de bienvenida y las condiciones de uso. Haga clic en Siguiente cuando esté listo para proceder.
Revise el acuerdo maestro y acéptelo si está de acuerdo. Haga clic en Siguiente para continuar con la instalación.
Haga clic en Cambiar para especificar la carpeta de instalación o en Siguiente para aceptar la ubicación predeterminada.
Haga clic en Instalar para comenzar la instalación.
Haga clic en Finalizar para cerrar el asistente.
Vaya hasta la carpeta de instalación de ArcGIS Web Adaptor. Implemente el archivo arcgis.war en su servidor de aplicaciones Java en un sitio web que se ejecute en el puerto 80. Para obtener instrucciones sobre cómo implementar un archivo .war, consulte la documentación de su servidor de aplicaciones Java.
Opcionalmente, para implementar varios Web Adaptor en el equipo host, vuelva a implementar el archivo arcgis.war según sea necesario. Tenga en cuenta que, si va a implementar varios Web Adaptor en el mismo sitio web (puerto), deben tener nombres distintos. Por ejemplo, en un mismo sitio web no puede haber dos Web Adaptor llamados arcgis. Si desea contar con varios Web Adaptor con el mismo nombre, debe instalarlos en sitios web distintos (puertos).
Conecte ArcGIS Web Adaptor con un sitio de servidor o portal.

Después de la instalación, ArcGIS Web Adaptor se mostrará en el idioma especificado por el servidor de aplicaciones Java. Para cambiar el idioma, consulte la documentación del producto correspondiente a su servidor de aplicaciones Java.

Inicie el programa de instalación de ArcGIS Web Adaptor y evalúe el cuadro de diálogo Introducción. Haga clic en Siguiente cuando esté listo para proceder.
Revise el acuerdo maestro y acéptelo si está de acuerdo. Haga clic en Siguiente para continuar con la instalación.
Haga clic en Siguiente para aceptar la ubicación predeterminada o haga clic en Elegir para especificar la carpeta de instalación.

Nota:

Se recomienda que no instale ArcGIS Web Adaptor en una unidad de red remota. Si la unidad remota no está accesible en el momento de la desinstalación, la desinstalación podría fracasar y dejar atrás los archivos.
Haga clic en Instalar para comenzar la instalación.
Cuando termine, haga clic en Hecho para cerrar el asistente.
Vaya hasta la carpeta de instalación de ArcGIS Web Adaptor. Implemente el archivo arcgis.war en su servidor de aplicaciones Java en un sitio web que se ejecute en el puerto 80. Para obtener instrucciones sobre cómo implementar un archivo .war, consulte la documentación de su servidor de aplicaciones Java.
Opcionalmente, para implementar varios Web Adaptor en el equipo host, vuelva a implementar el archivo arcgis.war según sea necesario. Tenga en cuenta que, si va a implementar varios Web Adaptor en el mismo sitio web (puerto), deben tener nombres distintos. Por ejemplo, en un mismo sitio web no puede haber dos Web Adaptor llamados arcgis. Si desea contar con varios Web Adaptor con el mismo nombre, debe instalarlos en sitios web distintos (puertos).
Conecte ArcGIS Web Adaptor con un sitio de servidor o portal.

Repita los mismos pasos para instalar varias instancias de ArcGIS Web Adaptor en el mismo equipo al mismo tiempo o en equipos distintos. Para instalar varios Web Adaptors en el mismo sitio web (puerto), deben tener nombres diferentes. Por ejemplo, en un mismo sitio web no puede haber dos Web Adaptor llamados arcgis. Si desea contar con varios Web Adaptor con el mismo nombre, debe instalarlos en sitios web distintos (puertos).

Nota:

El programa de instalación detecta y evita posibles conflictos con el nombre de Web Adaptor. Si ve un mensaje que indica que el directorio virtual ya existe, especifique un nombre de Web Adaptor distinto o seleccione un sitio Web diferente.

Nota:

Para aplicar un service pack de Web Adaptor, no se puede quitar la instancia base.

Instalar ArcGIS Web Adaptor de manera automática

Las siguientes líneas de comando son los parámetros que deben utilizarse al instalar ArcGIS Web Adaptor en modo silencioso. Si no se invocan estos parámetros de línea de comandos durante una instalación automática, la aplicación web de ArcGIS Web Adaptor se creará bajo el sitio Web predeterminado con el nombre predeterminado arcgis.

ACCEPTEULA=yes

Esta propiedad es necesaria para aceptar el contrato de licencia del usuario final durante una instalación automática. Indique "sí" para aceptar el EULA e instalar el software. Si indica "no" u omite esta propiedad, se producirá un error de instalación. La descarga contiene una versión en PDF del contrato de licencia del usuario final (EULA). El archivo EULA.pdf se encuentra en la carpeta \Documentation.
WEBSITE_ID=<valor numérico del sitio web>

El parámetro WEBSITE_ID se utiliza para especificar el sitio web en el que se creará la aplicación web de ArcGIS Web Adaptor. El valor para WEBSITE_ID es un número específico para cada sitio web en el servidor y lo asigna IIS. Los Id. para los sitios web en el servidor se pueden encontrar en el Administrador de IIS. El sitio web predeterminado tiene un Id. de sitio web igual a 1. Por defecto, el parámetro WEBSITE_ID se establece en el sitio web predeterminado (incluso si existen varias páginas Web). El parámetro WEBSITE_ID distingue entre mayúsculas y minúsculas.
PORT=<número de puerto>

Además, si cuenta con un sitio web con muchos puertos, puede usar el parámetro PORT para instalar en el puerto especificado de WEBSITE_ID.

Por ejemplo, la ruta es <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb VDIRNAME=arcgis_external WEBSITE_ID=4059640 PORT=82.
VDIRNAME=

Este parámetro de línea de comando es opcional. De forma predeterminada, la propiedad VDIRNAME está configurada como arcgis. Si no invoca el parámetro VDIRNAME en la línea de comandos, Web Adaptor se crea como arcgis. El parámetro VDIRNAME distingue entre mayúsculas y minúsculas. El nombre del Web Adaptor no puede contener espacios.

Por ejemplo, la ruta es <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb ACCEPTEULA=yes VDIRNAME=arcgis_external WEBSITE_ID=4059640.
CONFIGUREIIS=TRUE

Este parámetro opcional permite al programa de instalación configurar e instalar automáticamente todos los componentes de Microsoft IIS requeridos para ArcGIS Web Adaptor.

A continuación, se muestran los parámetros de la línea de comandos de Windows Installer que se deben utilizar para instalar ArcGIS Web Adaptor de forma automática:

ACCEPTEULA=yes

Esta propiedad es necesaria para aceptar el contrato de licencia del usuario final durante una instalación automática. Indique "sí" para aceptar el EULA e instalar el software. Si indica "no" u omite esta propiedad, se producirá un error de instalación. La descarga contiene una versión en PDF del contrato de licencia del usuario final (EULA). El archivo EULA.pdf se encuentra en la carpeta \Documentation.
INSTALLDIR=<ubicación de instalación>

Esta propiedad le permite especificar la ubicación de instalación de ArcGIS Web Adaptor desde la línea de comandos. Si no establece esta propiedad, se utiliza la ubicación de instalación predeterminada de C:\Program Files\ArcGIS\WebAdaptor12.0\java\.

Por ejemplo:

<path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes INSTALLDIR="C:\NewInstallDir" /qb
Utilice este comando para instalar automáticamente ArcGIS Web Adaptor sin especificar la ubicación de instalación:

<path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes /qb

Una vez instalado ArcGIS Web Adaptor, puede configurarlo con un sitio de servidor o un portal.

Nota:

Para instalar ArcGIS Web Adaptor automáticamente, siga estos pasos:

Antes de iniciar la instalación, lea el contrato maestro que se encuentra en <CD_ROOT or untar directory>/Documentation/EULA.pdf y, si está de acuerdo, acepte los términos.
Ejecute setup de forma automática en la ventana de comandos. Ejemplo de sintaxis:

<CD_ROOT or untar directory>/Setup -m silent -l yes

Uso: [Opciones] de configuración

Opción	Descripción
-m;-modo MODE	Opcional. El valor predeterminado de GUI. MODE es silent o gui.
-l;--acuerdo de licencia CHOICE	Es necesario para el modo automático. CHOICE puede ser Yes (Sí) o No. Yes (Sí) indica que ha leído el Acuerdo maestro de Esri (E204, E300) y lo acepta. Consulte https://www.esri.com/legal/licensing-translations para leer el contrato.
d-; -directorio DIRECTORY d;--	Opcional. De forma predeterminada, ArcGIS Web Adaptor se instala en su directorio $HOME. DIRECTORY especifica un directorio de instalación diferente. La ruta /arcgis/webadaptor12.0/ se añade al directorio de instalación. El nombre del directorio de instalación debe estar en minúsculas. Las muestras y datos instalados requieren que la ruta de datos sea minúscula. Se recomienda no instalar ArcGIS Web Adaptor en una unidad de red remota. Si la unidad remota no está accesible en el momento de la desinstalación, la desinstalación podría fracasar y dejar atrás los archivos.
-v; --verbose	El instalador se ejecuta en modo verbose.
-h;-- ayuda	Muestra la ayuda de línea de comandos y se cierra.
-e; ejemplos	Muestra ejemplos de uso de estas opciones y salidas.

Busque la carpeta de instalación de ArcGIS Web Adaptor e implemente el archivo .war apropiado en su servidor de aplicaciones Java en un sitio web que se ejecute en el puerto 80. Si está utilizando Apache Tomcat 10.1.x, debe implementar el archivo arcgis_tomcat10.war. Para Tomcat 9.0.x y todos los demás servidores de aplicaciones Java, debe implementar el archivo arcgis.war. Para obtener instrucciones sobre cómo implementar un archivo .war, consulte la documentación de su servidor de aplicaciones Java.
Opcionalmente, para implementar varios Web Adaptor en el equipo host, vuelva a implementar el archivo .war según sea necesario. Si va a implementar varios Web Adaptor en el mismo sitio web (puerto), deben utilizar nombres distintos; por ejemplo, no puede haber dos Web Adaptor que se llamen arcgis en el mismo sitio web. Si desea contar con varios Web Adaptor con el mismo nombre, debe instalarlos en sitios web distintos (puertos).
Una vez instalado ArcGIS Web Adaptor, puede configurarlo con un sitio de servidor o un portal.

Puede instalar varios Web Adaptor ejecutando la instalación mediante los parámetros de la línea de comandos. No se requieren parámetros de línea de comandos adicionales para instalar varios Web Adaptor.