Skip To Content

Actualizar Portal for ArcGIS

El programa de instalación de Portal for ArcGIS 10.4.1 está diseñado para detectar y actualizar una instalación existente de Portal for ArcGIS.

Consideraciones previas a la actualización de Portal for ArcGIS

Antes de actualizar, repase con detenimiento la siguiente información.

¿Puedo actualizar directamente a Portal for ArcGIS 10.4.1?

Sí. Por ejemplo, si tiene instalada la versión 10.2.1, la ejecución del programa de instalación de 10.4.1 actualizará automáticamente a 10.4.1. No existe ninguna necesidad de obtener e instalar cada versión publicada con el fin de actualizar a 10.4.1.

¿Es necesario desinstalar la versión anterior de Portal for ArcGIS antes de instalar Portal for ArcGIS 10.4.1?

No, pero puede hacerlo. Si tiene una versión anterior de Portal for ArcGIS instalada, la configuración iniciará automáticamente la actualización a 10.4.1. Cuando la instalación haya terminado de ejecutarse, creará la cuenta de administrador inicial para completar la actualización. Si desinstala la versión anterior y a continuación instala 10.4.1, el comportamiento será el mismo.

¿En qué orden se debe actualizar una implementación de Portal for ArcGIS a 10.4.1?

No hay ningún orden en particular que deba seguir para actualizar la implementación a 10.4.1 a menos que su implementación incluya ArcGIS Data Store. En ese caso, ArcGIS Server debe actualizarse antes de que actualice el data store.

Es importante tener en cuenta que el portal estará sin conexión durante la actualización. Si la implementación incluye un sitio de ArcGIS Server federado, el portal y el sitio federado dejarán de tener conexión durante la actualización.

Si tiene elementos registrados en su portal de un sitio no federado con ArcGIS Server, no es necesario actualizar el servidor a 10.4.1 para usar los servicios del sitio con su portal. Los servicios de versiones anteriores de ArcGIS Server se pueden consumir desde Portal for ArcGIS 10.4.1.

¿Es necesario volver a autorizar cuando se actualiza a 10.4.1?

No. La autorización anterior se conservará y se volverá a configurar para el uso con 10.4.1.

¿Cuánto tiempo tarda en completarse la actualización?

El tiempo necesario para completar la actualización varía dependiendo del contenido que hay en el portal y del número de cuentas que se han registrado. Por ejemplo, una organización pequeña (cientos de usuarios y elementos de contenido) que ejecute Portal for ArcGIS en un equipo con 8 núcleos puede tardar 50 minutos en actualizarse. Por el contrario, una organización grande (decenas de miles de usuarios y elementos de contenido) que ejecute Portal for ArcGIS en un equipo con 8 núcleos puede tardar más de 3 horas en actualizarse.

El tiempo que tarda en completarse también depende del número de componentes y personalizaciones implementados. Por ejemplo, si ha configurado licencias de ArcGIS Pro con su organización, tiene varios sitios de ArcGIS Server federados y ArcGIS Data Store o, si su portal está muy personalizado, la actualización tardará más que si ha implementado Portal for ArcGIS y un sitio de ArcGIS Server federado.

¿Tengo que crear copias de seguridad de la información antes de realizar la actualización?

Si va a utilizar ArcGIS Data Store con el servidor de alojamiento de su portal, cree una copia de seguridad completa del data store antes de proceder a la actualización.

También tendrá que hacer copias de seguridad de las personalizaciones que haya configurado en su portal (como las propiedades que haya modificado en config.js).

Legado:

Previamente tendrá que hacer una copia de seguridad del keystore de certificados (portal.ks) que contiene los certificados que se hayan importado previamente en el portal. A partir de la versión 10.4.1, esto ya no es necesario; el keystore del portal migrará automáticamente durante la actualización.

Si ha realizado una personalización muy intensa de la versión anterior del portal, le recomendamos que instale 10.4.1 en un equipo aparte y realice una prueba de la actualización del portal.

Las extensiones de Operations Dashboard o Web AppBuilder también requieren copias de seguridad. La actualización no conservará ninguna de las extensiones que se hayan implementado para estos clientes. Una vez que haya completado la actualización, debe volver a implementar las extensiones.

Por el contrario, el contenido, los servicios, la información del sitio y la configuración de seguridad se copian automáticamente y se conservan al actualizar. La configuración general que haya modificado a través del sitio web del portal, por ejemplo al agregar el logotipo y el nombre de su organización al sitio web, también se conservan durante la actualización. No es necesario crear copias de seguridad manuales de la información antes de realizar la actualización.

Para asegurarse de que tiene suficiente espacio en disco para realizar la copia de seguridad automática durante la actualización, determine la cantidad de espacio asignada a los directorios content, index, db y temp del portal. Asegúrese de que la cantidad de espacio libre disponible en el disco sea al menos 2,5 veces esta cantidad. Si no es así, asigne al menos 2,5 veces más espacio en disco. La actualización del portal necesitará este espacio libre para crear correctamente la copia de seguridad y actualizar el contenido del portal, la información del sitio y la configuración de seguridad. La ubicación predeterminada de estos directorios es <Portal for ArcGIS installation directory>/arcgisportal. Si el directorio de contenido reside en un equipo diferente, se aplica la misma recomendación.

Cuando se complete la actualización, la información incluida en la copia de seguridad se conservará en el disco. Por ejemplo, verá esta información con el sufijo _10.<version number> añadido al final del directorio. Es recomendable mover esta información a otra ubicación para ahorrar espacio en disco.

¿Es necesario tener sincronizadas las versiones de los productos ArcGIS Web Adaptor y Portal for ArcGIS?

Sí. No puede configurar una versión anterior de ArcGIS Web Adaptor para que funcione con Portal for ArcGIS 10.4.1. La versión de Web Adaptor siempre debe coincidir con la versión instalada de Portal for ArcGIS.

Si no puede actualizar el Web Adaptor actual, puede instalar como alternativa una 10.4.1 de ArcGIS Web Adaptor junto con la versión anterior en el mismo equipo. Por ejemplo, puede conservar la versión 10.1 SP1 de ArcGIS Web Adaptor e instalar la 10.4.1 en el mismo servidor web.

Para obtener las instrucciones completas, vea los temas siguientes:

Si he federado ArcGIS Server con el portal, ¿debo actualizar ArcGIS Server cuando actualice el portal?

Sí. Para que su implementación del portal funcione correctamente, es necesario que las versiones del portal y de ArcGIS Server coincidan. Si el sitio de ArcGIS Server que ha federado con el portal incluye más de un equipo, actualice sus servidores SIG secuencialmente. Si tiene ArcGIS Web Adaptor configurado (uno o varios) con su sitio de ArcGIS Server, también deberá actualizar los Web Adaptor a la misma versión de ArcGIS Server.

He federado ArcGIS Server con mi portal. ¿Debería anular la federación antes de actualizar?

No. Es recomendable que no anule la federación cuando actualice la implementación del portal. De lo contrario, puede afectar negativamente a la implementación del portal. Por ejemplo, cuando anule la federación, todos los elementos del servicio alojados permanecen en el portal pero se desconectan de sus servicios en ArcGIS Server. Esto significa que los miembros no podrán acceder, compartir ni usar estos servicios en el portal. Además, los servicios de ArcGIS Server existentes que se han importado durante el proceso de federación se eliminan del portal y dejan de estar disponibles.

Si tengo un servidor de alojamiento que utiliza ArcGIS Data Store, ¿tengo que actualizar el data store al actualizar el portal?

Sí. Las versiones del portal, ArcGIS Server y ArcGIS Data Store deben coincidir. Durante el proceso de actualización, actualice siempre ArcGIS Server antes de actualizar ArcGIS Data Store con que se configura.

Como ya se ha mencionado, si el sitio de ArcGIS Server que ha federado con el portal incluye más de un equipo, actualice sus servidores SIG secuencialmente. Si tiene ArcGIS Web Adaptor configurado (uno o varios) con su sitio de ArcGIS Server, también deberá actualizar los Web Adaptor a la misma versión de ArcGIS Server.

Si he configurado licencias de ArcGIS Pro con mi organización, ¿tengo que actualizar el Administrador del servidor de licencias de ArcGIS o ArcGIS Pro al actualizar el portal?

No. Las versiones anteriores del Administrador del servidor de licencias de ArcGIS y ArcGIS Pro son compatibles con 10.4.1. Sin embargo, le recomendamos encarecidamente que actualice el Administrador del servidor de licencias de ArcGIS o ArcGIS Pro para aprovechar nuevas funcionalidades y correcciones de errores.

Nota:

A partir de ArcGIS Pro 1.2, ArcGIS License Server Administrator debe ser de la versión 10.4 o posterior. Si actualiza a ArcGIS Pro 1.2, también debe actualizar ArcGIS License Server Administrator a la versión 10.4 como mínimo.

No es necesario que vuelva a configurar licencias de ArcGIS Pro tras actualizar Portal for ArcGIS, el Administrador del servidor de licencias de ArcGIS o ArcGIS Pro.

Al actualizar Portal for ArcGIS o el Administrador del servidor de licencias de ArcGIS, los miembros con licencias de ArcGIS Pro no podrán acceder a ArcGIS Pro durante cada actualización. Actualmente, si los miembros inician sesión en ArcGIS Pro, verán un mensaje que indica que el programa se cerrará en veinticuatro horas porque ArcGIS Pro no puede conectarse al portal de licencias. Los miembros pueden completar o guardar su trabajo en este período de tiempo.

He configurado un portal de alta disponibilidad, ¿cómo actualizo mi configuración?

Si ha configurado un portal de alta disponibilidad, hay pasos muy específicos que tendrá que seguir para completar la actualización. Estos pasos se describen en el tema Configurar un portal de alta disponibilidad. Una vez que haya actualizado la configuración del portal, continúe con la actualización de los componentes de ArcGIS restantes en su organización como se describe a continuación.

¿Qué otras cosas debo tener en cuenta antes de actualizar el portal?

  • Si ha movido el directorio de contenido del portal a un directorio de red compartido, tendrá que llevar a cabo algunos pasos adicionales al actualizar. Los pasos de actualización siguientes incluyen instrucciones completas para configurar el portal actualizado de modo que use el directorio de contenido existente.
  • Si ha cambiado de lugar el índice, la base de datos o los directorios temporales del portal a un directorio compartido de red, deberá volverlos a poner en un directorio local antes de llevar a cabo la actualización. Portal for ArcGIS no admite que estos directorios estén en una ubicación compartida de la red. Deben ser locales en el equipo donde se encuentra el portal. Los pasos de actualización siguientes incluyen instrucciones completas para volver a mover estos directorios a los directorios locales.
  • Si publicó aplicaciones basadas en plantillas de aplicación configurables, compruebe si la plantilla de aplicación se retiró. Es posible que las plantillas de aplicación configurables retiradas no funcionen o no se muestren correctamente una vez actualizado su portal. Tendrá que volver a crear estas aplicaciones usando nuevas plantillas de aplicación. Tenga en cuenta que si su portal cuenta con varias versiones a sus espaldas, debe comprobar las plantillas retiradas para cada versión. Por ejemplo, si va a actualizar desde Portal for ArcGIS 10.2, compruebe la lista de plantillas retiradas para todas las versiones entre 10.2 y la versión actual.

Pasos para realizar una actualización de la implementación del portal

Precaución:

La implementación del portal, los sitios de ArcGIS Server que haya federado con el portal, ArcGIS Data Store (si se utiliza) y ArcGIS Pro (si se utiliza), quedarán sin conexión durante la actualización.

  1. Cree una copia de seguridad de la siguiente información:
    • Las personalizaciones que haya configurado en su portal, como las propiedades que haya modificado en config.js. Si ha realizado una personalización muy intensa de la versión anterior del portal, le recomendamos que instale 10.4.1 en un equipo aparte y realice una prueba de la actualización del portal.
    • La base de datos administrada de ArcGIS Data Store. Consulte Actualización de ArcGIS Data Store para obtener más información sobre cómo ejecutar la copia de seguridad.
    • Las extensiones que se hayan implementado para Operations Dashboard o Web AppBuilder. No se conservarán al actualizar y se tendrán que volver a implementar cuando la actualización se haya completado.
  2. Determine la cantidad de espacio en disco asignada a los directorios content, index, db y temp del portal. Asegúrese de que la cantidad de espacio libre disponible en el disco sea al menos 2,5 veces esta cantidad. Si no es así, asigne al menos 2,5 veces más espacio en disco. La actualización del portal necesitará este espacio libre para crear correctamente la copia de seguridad y actualizar el contenido del portal, la información del sitio y la configuración de seguridad. La ubicación predeterminada de estos directorios es <Portal for ArcGIS installation directory>/arcgisportal. Si el directorio de contenido reside en un equipo diferente, se aplica la misma recomendación.
    Nota:

    Cuando se complete la actualización, la información incluida en la copia de seguridad se conservará en el disco. Por ejemplo, verá esta información indicada con el sufijo _10.<version number> añadido al final del directorio. Es recomendable mover esta información a otra ubicación para ahorrar espacio en disco.

  3. Inicie sesión en el equipo donde se aloja el Web Adaptor que va a usar con su portal y desinstale ArcGIS Web Adaptor. Para obtener instrucciones completas, consulte el tema de desinstalación correspondiente a IIS, Java (Windows) o Java (Linux).
  4. En la ventana de comando, inicie la secuencia de comandos de configuración de Portal for ArcGIS con el mismo usuario que se haya utilizado para instalar el portal existente (por ejemplo, <CD ROOT or untar directory>/Setup). No es necesario que detenga Portal for ArcGIS antes de lanzar esta secuencia de comandos.
    Sugerencia:

    Para iniciar la secuencia de comandos de instalación desde el medio de instalación de Portal for ArcGIS, haga clic en la secuencia de comandos de instalación y seleccione el botón Run in Terminal (Ejecutar en terminal).

  5. El programa de instalación detectará la versión de Portal for ArcGIS existente en el equipo de destino y le pedirá que decida si desea continuar o salir de la actualización. Vea el siguiente ejemplo:
    =========================================================================
    Portal for ArcGIS 10.4.1 (Linux)
    =========================================================================
    Your Portal for ArcGIS 10.3 is installed at:
    /home/ags/arcgis/portal
    Confirm Settings
    =========================================================================
    Product to upgrade:             Portal for ArcGIS 10.3 (Linux)
    Location to upgrade:            /home/ags/arcgis/portal
    Your Portal for ArcGIS 10.3 will be stopped when performing the 
    upgrade and Portal for ArcGIS 10.4.1 
    will be started after the upgrade completes.
      'y' to continue with these settings
      'q' to exit without upgrading this product
    Enter choice [y,q] (y):
  6. Escriba y y pulse Intro para aceptar la configuración detectada y seguir con la actualización. Una vez que se complete la actualización del portal, el sitio web del portal se abre en una ventana del navegador.
  7. Borre la caché del navegador (incluidas las cookies). La información que permanece en el caché de la versión anterior del sitio web puede hacer que el sitio web actualizado se muestre incorrectamente y tal vez no pueda iniciar sesión. Se recomienda borrar el caché (incluidas las cookies) de todos los navegadores que vayan a ver el sitio web del portal actualizado.
  8. Elija crear un portal.
    Sugerencia:

    Al realizar una actualización, al crear un portal nuevo se creará una nueva versión del portal existente y se migrará el contenido, los usuarios y la configuración.

    Especifique el nombre de usuario, la contraseña, el correo electrónico y la pregunta y respuesta de identificación de la cuenta de administrador inicial. El cuadro de diálogo para la ubicación del directorio de contenido del portal se sombreará, dado que no podrá cambiar su ubicación en una actualización. Haga clic en Crear. Esto inicia la actualización y crea una copia de seguridad del contenido del portal, la información del sitio y la configuración de seguridad. Este paso puede tardar varios minutos en completarse.

    Nota:

    La información introducida de la cuenta de administrador inicial no debe coincidir con la información de la cuenta que especificó en la versión anterior de su portal. Si introduce nueva información, este paso creará una nueva cuenta y la cuenta de administrador inicial existente se conservará. Si introduce la misma información de la cuenta que en la versión anterior, la cuenta existente se usará como administrador inicial.

  9. Abra el Directorio de Portal for ArcGIS e inicie sesión con la cuenta de administrador inicial. La dirección URL tiene el formato https://portal.domain.com:7443/arcgis/portaladmin.
  10. Haga clic en Sistema > Indexador > Volver a indexar.
  11. Haga clic en la lista desplegable Modo y seleccione Completo.
  12. Haga clic en Volver a indexar. Este paso completará la actualización del portal. Según el número de usuarios y el volumen de contenido del portal, la reindexación puede tardar un tiempo en completarse. No interrumpa el proceso de reindexación. Puede supervisar el estado de indexación abriendo una nueva ventana (o pestaña) del navegador, desplazándose a System > Indexer > Index Status y actualizando la página. Cuando los recuentos del almacén y del índice se igualan, la reindexación y la actualización se habrán completado.
  13. Instale el Web Adaptor que se vaya a usar con el portal. Para obtener instrucciones completas, consulte el tema de instalación correspondiente a IIS, Java (Windows) o Java (Linux).
  14. Configure ArcGIS Web Adaptor con el portal. Para obtener instrucciones completas, consulte el tema de configuración correspondiente a IIS, Java (Windows) o Java (Linux).
  15. Verifique que puede iniciar sesión en el sitio web del portal a través de la dirección URL de ArcGIS Web Adaptor como Administrador de su organización. La dirección URL tiene el formato https://webadaptor.domain.com/arcgis/home.
  16. Si ha federado un sitio de ArcGIS Server con su portal y va a usar ArcGIS Web Adaptor con el sitio, inicie sesión en el equipo donde se aloja Web Adaptor y desinstale Web Adaptor. Tome nota del nombre de Web Adaptor; necesitará usar el mismo nombre cuando reinstale. Para obtener instrucciones completas, consulte el tema de desinstalación correspondiente a IIS, Java (Windows) o Java (Linux).
  17. Si ha federado un sitio de ArcGIS Server con el portal, actualice cada sitio a la versión 10.4.1. No es necesario desinstalar y volver a instalar. Tendrá que ejecutar la configuración en cada equipo de servidor SIG de cada sitio. Actualice sus servidores SIG secuencialmente (de forma consecutiva). Consulte las instrucciones completas en Actualización de una versión anterior de ArcGIS for Server.
  18. Al completarse la actualización del servidor, verifique que puede acceder a la dirección URL local del directorio de servicios de ArcGIS Server. La dirección URL local tiene el formato https://gisserver.domain.com:6443/arcgis/rest/services.
  19. Si anteriormente utilizaba un ArcGIS Web Adaptor con ArcGIS Server, vuelva a instalar ArcGIS Web Adaptor. Use el mismo nombre que ha especificado para Web Adaptor en la instalación anterior. Para obtener instrucciones completas, consulte el tema de instalación correspondiente a IIS, Java (Windows) o Java (Linux).
  20. Configure ArcGIS Web Adaptor con el servidor. Para obtener instrucciones completas, consulte el tema de configuración correspondiente a IIS, Java (Windows) o Java (Linux).
  21. Compruebe que puede acceder al directorio de servicios de ArcGIS Server a través de la dirección URL de ArcGIS Web Adaptor. La dirección URL tiene el formato https://webadaptor.domain.com/arcgis/rest/services.
  22. Si el servidor de alojamiento de su portal usa ArcGIS Data Store, cree una copia de seguridad del data store, actualice ArcGIS Data Store y vuelva a configurar el data store para trabajar con ArcGIS Server. Consulte la sección de actualización de ArcGIS Data Store para obtener instrucciones específicas.
  23. Si ha configurado licencias de ArcGIS Pro con su organización, actualice de manera opcional el Administrador del servidor de licencias de ArcGIS. Al actualizar el Administrador del servidor de licencias de ArcGIS, los miembros con licencias de ArcGIS Pro no podrán acceder a ArcGIS. Actualmente, si los miembros inician sesión en ArcGIS Pro, verán un mensaje que indica que el programa se cerrará en veinticuatro horas. Los miembros pueden completar o guardar su trabajo en este período de tiempo. No es necesario que vuelva a configurar licencias de ArcGIS Pro tras actualizar el Administrador del servidor de licencias de ArcGIS.
  24. Restablezca las personalizaciones que hubiese configurado anteriormente para su portal. Al restablecer las personalizaciones del portal en 10.4.1, se recomienda no sustituir los archivos modificados en la versión anterior en 10.4.1. Esto puede afectar negativamente a su implementación de la 10.4.1. Deberá abrir cada archivo en 10.4.1 y volver a agregar los comportamientos que personalizó en la versión anterior.

Consideraciones posteriores a la actualización de Portal for ArcGIS

Después de actualizar, repase con detenimiento la siguiente información.

Después de actualizar, el sitio web del portal no se ve correctamente, muestra un mensaje de error o no me permite iniciar sesión. ¿Qué ocurre?

Borre la caché del navegador (incluidas las cookies). Estos errores suelen deberse a la información de la versión anterior del sitio web que queda almacenada en la caché del navegador. Si sigue sin poder iniciar sesión, compruebe si está usando la cuenta de administrador inicial o una cuenta que tenga permisos administrativos para su portal.

Después de actualizar, no veo todos los elementos, grupos y usuarios de mi portal. ¿Qué sucede?

Después de actualizar el software y especificar la cuenta de administrador inicial, se le pedirá que vuelva a indexar el portal. Este paso completa la actualización del portal. Inicialmente, es posible que no vea todos los elementos, grupos y usuarios, porque la reindexación no se ha completado. Según el número de usuarios y el volumen de contenido del portal, la reindexación puede tardar un tiempo en completarse. Por ejemplo, una organización pequeña (cientos de usuarios y elementos de contenido) que ejecute Portal for ArcGIS en un equipo con 8 núcleos puede tardar 15 minutos en reindexarse. Por el contrario, una organización grande (decenas de miles de usuarios y elementos de contenido) que ejecute Portal for ArcGIS en un equipo con 8 núcleos puede tardar más de 3 horas en reindexarse.

También puede comprobar el estado de la reindexación siguiendo los pasos que se describen a continuación. Cuando los recuentos del almacén y del índice se igualan, la reindexación y la actualización se habrán completado.

  1. Abra el Directorio de Portal for ArcGIS e inicie sesión con la cuenta de administrador inicial. La dirección URL tiene el formato https://portal.domain.com:7443/arcgis/portaladmin.
  2. Haga clic en System > Indexer > Index Status.
  3. Actualice la página para obtener el estado más reciente.

Cuando accedo al sitio web del portal después de instalar 10.4.1, veo un error de autorización de software que indica que el número de miembros registrados en el portal supera el número máximo de miembros que admite la licencia del portal. ¿Cómo resuelvo este problema?

En Portal for ArcGIS 10.2.1 y versiones posteriores, se aplica el modelo de licencias por usuario nominal. No se pueden agregar más miembros al portal que aquellos para los que se dispone de licencia. Si el número de miembros para el que dispone de licencia el portal se supera en 10.4.1, verá un mensaje de error de autorización de software al acceder al sitio web del portal con una cuenta que disponga de permisos de administración. Además, los usuarios no podrán crear cuentas nuevas, y los miembros sin privilegios administrativos no podrán iniciar sesión en el portal. Consulte Aplicación de la licencia de usuario nominal para obtener más información sobre cómo resolver estos problemas.

Cuando intento crear la cuenta de administrador inicial al actualizar el portal, aparece el mensaje Se produjo un error al crearse su cuenta de administrador inicial. ¿Cómo resuelvo este problema para completar la actualización?

Si aparece este error al crear la cuenta de administrador inicial, la información contenida en los registros del portal puede ayudarle a resolver el problema. Con frecuencia, este error puede producirse si la conectividad de la red se ha perdido temporalmente al crear la cuenta. Para acceder a los registros, vaya al directorio de registros y abra el archivo de registro más reciente (por ejemplo, <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20141201.095803-8596-0.0.log). Si es necesario, puede compartir esta información con el Soporte de Esri.

He habilitado Operations Dashboard a través del portal; ¿debo actualizarlo después de cambiar a la nueva versión?

Sí. Si ha creado previamente un elemento que hace referencia a Operations Dashboard o si ha implementado la aplicación en el portal, tendrá que actualizar el elemento y volver a implementar la aplicación después de actualizar el portal. Para obtener instrucciones completas, consulte Actualizar Operations Dashboard for ArcGIS.