Configurar ArcGIS Web Adaptor

Después de instalar ArcGIS Web Adaptor, debe configurarlo para que funcione con un sitio de servidor y su portal de ArcGIS Enterprise. Esto se puede hacer desde la página web de configuración o mediante la utilidad de línea de comandos instalada con Web Adaptor.

Al abrir la página de configuración se muestra el estado actual de ArcGIS Web Adaptor. Indica si ArcGIS Web Adaptor se ha configurado con anterioridad. Para ver el tipo de plataforma y el número de versión de Web Adaptor, haga clic en Acerca de en la página de configuración.

Nota:

A partir de ArcGIS Enterprise 11.5, el acceso administrativo al sitio de ArcGIS Server a través de Web Adaptor está habilitado de forma predeterminada y no se puede deshabilitar. Para implementaciones de ArcGIS Enterprise a través de internet, considere utilizar un balanceador de carga con firewall de aplicaciones web (WAF) de producción como interfaz frontal en lugar de Web Adaptor. Para obtener más información, consulte la Guía sobre refuerzo de ArcGIS Enterprise.

Si ya ha configurado un Web Adaptor con su portal de ArcGIS Enterprise y desea actualizar el portal para utilizar otro Web Adaptor, primero debe dar de baja el Web Adaptor actual. Esto solo se puede hacer desde el Directorio de Portal. La funcionalidad de dar de baja no está disponible desde la página de configuración de Web Adaptor ni desde el sitio web del portal. Para obtener las instrucciones completas, consulte Dar de baja ArcGIS Web Adaptor con Portal for ArcGIS.

Precaución:

Aunque puede modificar Web Adaptor de un portal registrando uno nuevo, al hacerlo, el contenido de usuario dentro del portal (por ejemplo, notas de mapa u otros elementos) podría verse afectado.

Nota:

Es adecuado usar el puerto 443 HTTPS predeterminado para la 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.

Configurar ArcGIS Web Adaptor con un sitio de servidor

Las siguientes secciones describen cómo configurar ArcGIS Web Adaptor con un sitio de servidor desde la página de configuración y la utilidad de línea de comandos.

Configurar desde la página web de configuración

Para configurar ArcGIS Web Adaptor con un sitio de servidor desde la página web de configuración instalada con el software, siga los pasos siguientes.

Nota:

Existen consideraciones adicionales para ArcGIS Mission Server, ArcGIS Notebook Server y ArcGIS Video Server que se deben consultar en este momento.

Abra la página de configuración en un navegador web.

La URL tiene el formato https://webadaptorhost.example.com/webadaptorname/webadaptor.

Nota:

Si el servidor web donde instaló ArcGIS Web Adaptor está configurado para utilizar un proxy de reenvío, deshabilítelo mientras registra el Web Adaptor. De lo contrario, no podrá acceder a la página de configuración de Web Adaptor.
Seleccione el tipo de servidor que desea configurar con el Web Adaptor. Haga clic en Siguiente.
Introduzca el nombre del equipo de uno de los servidores que está registrando en su sitio.

Este nombre de equipo se utilizará para descubrir todos los equipos que participan en su sitio de servidor y los registra con el Web Adaptor. El nombre del equipo debería tener el formato server.example.com.
Proporcione un nombre de usuario y una contraseña para una cuenta que tenga privilegios administrativos en el sitio de servidor. Por lo general, utilizará el nombre de usuario y contraseña de la cuenta de administrador principal del sitio que definió cuando creó el sitio. Si la cuenta del administrador principal del sitio está desactivada, se deberá especificar una cuenta con acceso de administración al sitio.
Haga clic en Configurar para aplicar la configuración al adaptador Web.

Cuando la configuración es correcta, los equipos que reconoce Web Adaptor aparecen en la parte inferior de la página de configuración (resaltados en verde). Puede volver a esta página en cualquier momento para ver la lista de los equipos reconocidos y ajustar la configuración de Web Adaptor.

Configurar desde la línea de comandos

Puede configurar ArcGIS Web Adaptor con un sitio de servidor mediante la utilidad de la línea de comandos (ConfigureWebAdaptor.exe) de C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools.

Los parámetros disponibles son los siguientes:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password>

Puede configurar ArcGIS Web Adaptor con un sitio de servidor mediante la utilidad de la línea de comandos (ConfigureWebAdaptor.bat) de <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools.

Los parámetros disponibles son los siguientes:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

Puede configurar ArcGIS Web Adaptor con un sitio de servidor mediante la utilidad de la línea de comandos (configurewebadaptor.sh) de <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools. Esto es especialmente ventajoso si el equipo donde está alojado Web Adaptor no dispone de interfaz gráfica de usuario (GUI).

Los parámetros disponibles son los siguientes:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

<Mode>: el componente con el que se configurará Web Adaptor. De forma predeterminada, este parámetro se establece en server, lo que significa que Web Adaptor se puede configurar para usarse con ArcGIS Server. A continuación se muestran los parámetros que puede usar para configurar otros componentes.
- Portal for ArcGIS: portal
- ArcGIS Mission Server: mission
- Notebook Server: notebook
- Video Server: video
- ArcGIS Monitor: monitor
- ArcGIS Data Pipelines: datapipelines
<WebAdaptorURL>: la URL del Web Adaptor que desea configurar desde la línea de comandos. Es la misma URL que se utilizaría para acceder a la página de configuración de Web Adaptor desde un navegador web. Si se instaló Web Adaptor en un puerto distinto del puerto 80 predeterminado, deberá especificar el puerto en la URL.
<MachineName|URL>: el nombre del equipo de uno de los equipos de su sitio de servidor, por ejemplo, server.example.com. También puede utilizar la URL del equipo servidor en lugar del nombre del equipo. Si está configurando Web Adaptor con ArcGIS Server, la URL o nombre del equipo se utilizará para descubrir todos los equipos que forman parte de su sitio.
<Username>: el nombre de usuario de una cuenta con privilegios administrativos sobre el sitio de servidor. En el caso de ArcGIS Server, esta cuenta podría ser la cuenta del administrador principal del sitio que se introdujo cuando se creó el sitio por primera vez, o bien una cuenta a la que se han asignado privilegios administrativos. En el caso ArcGIS Mission Server, Notebook Server y Video Server, introduzca el nombre de usuario de la cuenta del administrador principal del sitio que utilizó cuando se creó el sitio.
<Password>: la contraseña de la cuenta con privilegios administrativos sobre el sitio de servidor.

Vea el siguiente ejemplo: ConfigureWebAdaptor.exe /m server /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g server.example.com /u siteadmin /p secret

Vea el siguiente ejemplo: ConfigureWebAdaptor.bat -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

Vea el siguiente ejemplo: $ ./configurewebadaptor.sh -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

Nota:

Para ejecutar la utilidad de línea de comandos, es necesario tener Java Runtime Environment (JRE) instalado en el equipo donde se aloja Web Adaptor. Si JRE no se encuentra en su equipo, se produce un error al ejecutar la utilidad. Consulte las instrucciones sobre la descarga y la instalación de JRE en el sistema en el sitio de descargas de Java SE.

Configure ArcGIS Web Adaptor con un portal

Las siguientes secciones describen cómo configurar ArcGIS Web Adaptor con su portal de ArcGIS Enterprise desde la página de configuración y la utilidad de línea de comandos.

Configurar desde la página web de configuración

Para configurar ArcGIS Web Adaptor con su portal desde la página web de configuración instalada con el software, siga los pasos a continuación:

Precaución:

Para agregar un alias DNS o un proxy inverso después de que un sitio de ArcGIS Server se haya federado con su portal, consulte Actualizar la URL de la organización.

Si no lo ha hecho todavía, habilite HTTPS en su servidor web.
Abra la página de configuración en un navegador web utilizando una dirección URL HTTPS, como https://webadaptorhost.example.com/webadaptorname/webadaptor. Si se va a usar un alias de DNS con el portal, el Web Adaptor debe configurarse mediante el alias de DNS en su lugar, usando una URL como https://<dnsalias.example.com>/<webadaptorname>/webadaptor.

Nota:

Si hay un proxy de reenvío ejecutándose en el servidor web donde ha instalado ArcGIS Web Adaptor, deshabilítelo mientras registra el Web Adaptor. De lo contrario, no podrá acceder a la página de configuración de Web Adaptor.
Elija Portal for ArcGIS y haga clic en Siguiente.
Introduzca el nombre del equipo que aloja Portal for ArcGIS. Incluya el nombre de dominio totalmente calificado, por ejemplo, portal.example.com.
Especifique un nombre de usuario y la contraseña de una cuenta que tenga privilegios administrativos en Portal for ArcGIS. Por lo general, utilizará el nombre de usuario y contraseña de la cuenta de administrador inicial que definió cuando instaló su portal. Si degradó o eliminó la cuenta de administrador inicial, debe especificar una cuenta con acceso administrativo al sitio web del portal.
Haga clic en Configurar.

ArcGIS Web Adaptor está configurado para su uso con el equipo que aloja Portal for ArcGIS. Ahora, podrá acceder a su portal a través de la dirección URL de ArcGIS Web Adaptor, en lugar del puerto 7443. La dirección URL tiene el siguiente formato: https://webadaptorhost.example.com/webadaptorname/home.

Si ha configurado el portal para que utilice HTTPS para todas las comunicaciones, debería actualizar el sitio web del portal instalado y procurar que las direcciones URL de los accesos directos usen https en lugar de http. De lo contrario, se producirán fallos en el navegador al tratar de acceder a las direcciones URL de accesos directos originales.

Si va a configurar Portal for ArcGIS con el servidor proxy inverso de su organización, debe proporcionar alguna información al portal acerca del servidor proxy. Para obtener instrucciones completas, consulte Integrar su portal con un proxy inverso o un equilibrador de carga.

Configurar desde la línea de comandos

Puede configurar ArcGIS Web Adaptor con su portal mediante la utilidad de la línea de comandos (ConfigureWebAdaptor.exe) de C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools.

Los parámetros disponibles son los siguientes:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password> -r <ReindexPortal>

Puede configurar ArcGIS Web Adaptor con su portal mediante la utilidad de la línea de comandos (ConfigureWebAdaptor.bat) de <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools.

Los parámetros disponibles son los siguientes:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

Puede configurar ArcGIS Web Adaptor con su portal mediante la utilidad de la línea de comandos (configurewebadaptor.sh) de <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools. Esto es especialmente ventajoso si el equipo donde está alojado Web Adaptor no dispone de interfaz gráfica de usuario (GUI).

Los parámetros disponibles son los siguientes:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

<Mode>: el componente con el que se configurará Web Adaptor. De forma predeterminada, este parámetro se establece en server, lo que significa que Web Adaptor se configurará para usarse con GIS Server, Image Server o GeoAnalytics Server. Dado que está configurando Web Adaptor para su uso con Portal for ArcGIS, especifique este parámetro como portal.
<WebAdaptorURL>: la URL del Web Adaptor que desea configurar desde la línea de comandos. Es la misma URL que se utilizaría para acceder a la página de configuración de Web Adaptor desde un navegador web. Debe especificar la dirección URL HTTPS de Web Adaptor, por ejemplo, https://webadaptorhost.example.com/webadaptorname/webadaptor. Si se va a usar un alias de DNS con el portal, el Web Adaptor debe configurarse mediante el alias de DNS en su lugar, usando una URL como https://<dnsalias.example.com>/<webadaptorname>/webadaptor.
<MachineName|URL>: el nombre del equipo de uno de los equipos que alojan Portal for ArcGIS. Incluya el nombre de dominio totalmente calificado del equipo, por ejemplo, portal.example.com. También puede utilizar la URL del equipo que aloja Portal for ArcGIS en lugar del nombre del equipo.
<Username>: el nombre de usuario de una cuenta con privilegios administrativos en Portal for ArcGIS. Es posible que esta cuenta sea la cuenta de administrador inicial que se introdujo al configurar el portal por primera vez, o bien una cuenta a la que se han asignado privilegios administrativos.
<Password>: la contraseña de la cuenta con privilegios administrativos en Portal for ArcGIS.
<ReindexPortal>: indica si es preciso reindexar el contenido predeterminado del portal al registrar el Web Adaptor. Esta opción es útil cuando se quiere configurar la implementación con un proxy inverso o un equilibrador de carga. El registro Web Adaptor tarda menos en realizarse sin indexación. Una vez que se configure webContextURL, el contenido integrado hará referencia a webContextURL.

Ejemplo: ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g portal.example.com /u initialadmin /p secret -r true

Ejemplo: ConfigureWebAdaptor.bat -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

Ejemplo: ConfigureWebAdaptor.sh -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

Tras ejecutar el comando, ArcGIS Web Adaptor está configurado para su uso con el equipo que aloja Portal for ArcGIS. Ahora, podrá acceder a su portal a través de la dirección URL de ArcGIS Web Adaptor, en lugar del puerto 7443. La dirección URL tiene el siguiente formato: https://webadaptorhost.example.com/webadaptorname/home.

Si va a configurar Portal for ArcGIS con el servidor proxy de su organización, debe proporcionar alguna información al portal acerca del servidor proxy. Para obtener instrucciones completas, consulte Integrar su portal con un proxy inverso o un equilibrador de carga.

Configurar varios ArcGIS Web Adaptors

Se requieren varios ArcGIS Web Adaptor a la hora de configurar un portal de alta disponibilidad que utilice la autenticación de nivel web. Para configurar varios Web Adaptor con Portal for ArcGIS, se debe utilizar un único extremo para acceder al portal. Esta dirección URL debe estar definida en la propiedad WebContextURL. Así se pueden configurar varios Web Adaptors con el portal siguiendo los pasos que se indican a continuación.

Configure el primer ArcGIS Web Adaptor con su portal.
Agregue Portal for ArcGIS a su servidor proxy inverso. Configure la propiedad WebContextURL de la siguiente manera:
1. Abra un navegador web e inicie sesión en el Directorio del administrador del portal como administrador de su organización.
  
  La dirección URL tiene el formato https://portal.example.com:7443/arcgis/portaladmin.
2. Haga clic en Sistema > Propiedades > Actualizar propiedades.
  
  El servicio Portal for ArcGIS se reinicia automáticamente. Espere hasta que finalice el reinicio antes de continuar.
3. En el cuadro de diálogo Update System Properties, inserte el JSON siguiente, sustituyendo la dirección URL de alias DNS o de su servidor proxy inverso tal como la ven los usuarios de fuera del firewall de su organización.
```
   {
      "WebContextURL": "https://reverseproxy.example.com/myorg"
   }
```
1. Haga clic en Actualizar propiedades.
Configure Web Adaptors adicionales.

Todos los Web Adaptor configurados con el portal se muestran en la página de resumen de la configuración. Los usuarios acceden al portal a través del servidor proxy inverso o de la URL del alias de DNS.

Nota:

Portal for ArcGIS solo admite una única URL de organización.

Después de configurar ArcGIS Web Adaptor

Ahora que se ha configurado ArcGIS Web Adaptor para su uso, tenga en cuenta los siguientes elementos.

Agregar o eliminar equipos servidor

Al agregar o eliminar equipos servidor del sitio, Web Adaptor tarda un minuto en reconocer los cambios del sitio. Si desea que Web Adaptor reconozca inmediatamente las máquinas agregadas o quitadas, puede reconfigurarlo siguiendo las instrucciones anteriores.

Instalar múltiples Web Adaptor

Puede proporcionar distintos puntos de entrada web en su sitio de servidor al instalar varios Web Adaptor. De esta manera, aumenta la disponibilidad del sitio para los clientes, proporciona compatibilidad para aplicaciones anteriores y permite la publicación a usuarios específicos en un entorno de alta seguridad. Para obtener más información, consulte las Situaciones de implementación.

Es posible instalar varios Web Adaptor en el mismo equipo al mismo tiempo, o se pueden instalar en equipos diferentes. Para instalar varios Web Adaptor en el mismo sitio web (puerto), utilice nombres distintos para ellos. 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).