Skip to main content

Actualizar Portal for ArcGIS

La instalación de Portal for ArcGIS está diseñada para detectar y actualizar una instalación existente de Portal for ArcGIS. Puede elegir actualizar de forma interactiva usando el programa de instalación o actualizar de forma automática.

Importante:

Antes de actualizar, consulte detenidamente la información para la actualización de ArcGIS Enterprise en general, así como la siguiente información específica para Portal for ArcGIS.

Precaución:

Su implementación base, sus sitios de servidor federados y ArcGIS Pro (si ha recibido una licencia a través del portal) estarán sin conexión durante la actualización.

Prepararse para actualizar

Para asegurarse de que su actualización se complete correctamente, repase las siguientes secciones para prepararse antes de comenzar el proceso de actualización.

Realizar una copia de seguridad de su contenido

Haga una copia de seguridad de los datos y la configuración de su implementación de ArcGIS Enterprise antes de actualizar Portal for ArcGIS. Para asegurarse de que dispone de las copias de seguridad necesarias, siga estos pasos:

  1. Verifique que ha creado copias de seguridad de lo siguiente:

    Sugerencia:

    Puede seguir los pasos que se describen a continuación para crear una copia de seguridad de un sitio o puede usar la herramienta WebGISDR para crear una copia de seguridad de su implementación de ArcGIS Enterprise. Para ello, siga los pasos para exportar ArcGIS Enterprise.

  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 de Portal for ArcGIS necesita 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.

    La actualización de Portal for ArcGIS necesita 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 C:\arcgisportal. Si el directorio de contenido reside en un equipo diferente, se aplica la misma recomendación.

Conceptos de actualización

Tenga en cuenta lo siguiente al actualizar:

  • El tiempo necesario para completar la actualización varía dependiendo del contenido que haya en el portal y del número de cuentas registradas, así como del número de componentes y personalizaciones que implemente.

  • Asegúrese de que los miembros de su organización sean conscientes de que la actualización requiere tiempo de inactividad y estén preparados para las nuevas entidades y cambios que se introducirán en la nueva versión.

  • Si su portal está actualmente en modo de solo lectura, desactive el modo antes de realizar la actualización.

  • Si no puede actualizar su adaptador web actual, como alternativa puede instalar una versión actualizada de ArcGIS Web Adaptor (IIS) junto con la versión anterior en el mismo equipo. Debe mantener el mismo contexto de adaptador web al actualizar. Para ello, desinstale el adaptador web configurado actualmente con su portal e instale la nueva versión del adaptador web con el mismo nombre utilizado previamente. Tenga en cuenta también que no se pueden instalar dos adaptadores web con el mismo contexto en el mismo equipo.

Nota:

El programa de instalación de Portal for ArcGIS le pedirá la cuenta con la que se va a ejecutar el servicio de Windows. Puede actualizar el contenido existente de un directorio de red compartido, siempre que la cuenta que ejecute el servicio de Windows tenga acceso completo a estas ubicaciones.

Si el servicio de Windows se está ejecutando actualmente como una cuenta LocalSystem sin ninguna contraseña aplicada, primero tiene que cambiar la cuenta a una cuenta local con una contraseña antes de continuar con la actualización.

Licencia de

Tenga en cuenta lo siguiente al conceder licencias:

  • Tendrá que obtener un nuevo archivo de licencia del portal desde My Esri y volver a autorizar el software.

    Nota:

    El archivo de licencia que introduce durante la actualización se utiliza para asignar licencias a los usuarios y aplicaciones del portal. Asegúrese de que el nuevo archivo de licencia es adecuado para su configuración actual de usuarios y aplicaciones.

  • Antes de actualizar Portal for ArcGIS, debe asegurarse de que todos los miembros de la organización hayan realizado el check-in de todas las licencias de ArcGIS Pro sin conexión. Puede ver la actividad de las licencias para determinar qué miembros han realizado el check-out de su licencia de ArcGIS Pro para el uso sin conexión. Para obtener más información sobre cómo realizar el check-in de una licencia sin conexión, consulte Check-in de una licencia sin conexión.

  • Los nombres de tipos de usuario de Editor, GIS Professional Standard y GIS Professional Advanced usados en algunas versiones anteriores han cambiado a Contributor, Professional y Professional Plus, respectivamente. Verá esta actualización al importar un nuevo archivo de licencia de Portal for ArcGIS.

  • Si el tipo de usuario de un miembro ya no está disponible después de la actualización, debe asignarle un tipo de usuario diferente. Para obtener una lista de tipos de usuario disponibles, consulte Tipos de usuario.

  • Tras la actualización, algunos tipos de usuario pueden incluir aplicaciones adicionales que antes solo estaban disponibles como licencias complementarias. Si se incluye una aplicación con un tipo de usuario asignado a un miembro, no es necesario que asigne una licencia complementaria al miembro para dicha aplicación. Consulte Introducción al licenciamiento de aplicaciones para obtener más información sobre las aplicaciones y los tipos de usuario que incluyen.

  • Cuando una o más licencias adicionales asignadas a los miembros se incluyen con sus tipos de usuario después de la actualización, verá un aviso en la pestaña Descripción general de la página de la organización que indica que algunos miembros tienen licencias asignadas dos veces. Puede desasignar licencias complementarias duplicadas de todos los miembros correspondientes para liberar dichas licencias.

  • A partir de la versión 11.4, ArcGIS License Manager ya no es necesario para habilitar licencias de usuario nominal para ArcGIS Pro, extensiones de ArcGIS Pro, ArcGIS Drone2Map y ArcGIS AllSource.

Contenido

Tenga en cuenta lo siguiente al trabajar con contenido:

  • Si ha registrado elementos en su portal desde un sitio de ArcGIS Server no federado, no tiene que actualizar el sitio de ArcGIS Server para usar los servicios del sitio con su portal. Portal for ArcGIS puede consumir servicios de versiones anteriores de ArcGIS Server.

  • Si ha creado un grupo de mapas base personalizados o aplicaciones configurables y ha compartido mapas base de Esri o aplicaciones de ArcGIS Configurable Apps con este grupo, debe volver a compartir estos elementos después de la actualización.

  • Si utiliza contenido de ArcGIS Living Atlas of the World en mapas o aplicaciones, compruebe que los elementos que utilice no tengan el estado de fase final de soporte ni obsoleto antes de actualizar. Con cada versión se retira parte del contenido de ArcGIS Living Atlas y deja de estar disponible. Si utiliza alguno de estos elementos, dejarán de funcionar cuando actualice. Para ver una lista del contenido de ArcGIS Living Atlas retirado en esta versión, consulte Ciclos de vida y actualizaciones de contenido de ArcGIS Living Atlas.

Aplicaciones

Tenga en cuenta lo siguiente al trabajar con aplicaciones:

  • Si ha configurado aplicaciones de Esri en su portal, debe asegurarse de que corresponden con una versión compatible con la versión de Portal for ArcGIS después de actualizar.

  • Si configuró paquetes de mapas móviles de ArcGIS Navigator con su portal, debe volver a configurarlos después de actualizar Portal for ArcGIS.

Entornos replicables y de alta disponibilidad

Para minimizar el tiempo de inactividad durante las actualizaciones, puede configurar un entorno duplicado y replicar el contenido en él antes de actualizar el entorno principal. Para obtener más información sobre esta estrategia de actualización y sobre cómo actualizar su entorno de alta disponibilidad o replicado, consulte Actualizar entornos de alta disponibilidad y replicado.

Actualizar mediante el programa de instalación

  1. En la ventana de comando, inicie el script de instalació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 este script.

    Sugerencia:

    Para iniciar el script de instalación desde el medio de instalación de Portal for ArcGIS, haga clic en el script de instalación y seleccione el botón Ejecutar en terminal.

  2. Elija continuar o salir de la actualización después de que la instalación detecte su versión de Portal for ArcGIS en el equipo de destino. Vea el siguiente ejemplo:

    =========================================================================
Portal for ArcGIS <New Version> (Linux)
=========================================================================
Your Portal for ArcGIS <Previous Version> is installed at:
/home/ags/arcgis/portal
Confirm Settings
=========================================================================
Product to upgrade:             Portal for ArcGIS <Previous Version> (Linux)
Location to upgrade:            /home/ags/arcgis/portal
Your Portal for ArcGIS <Previous Version> will be stopped when performing the
upgrade and Portal for ArcGIS <New Version>
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):

  3. Escriba y y pulse Intro para aceptar la configuración detectada y seguir con la actualización.

    Debe autorizar el software con un nuevo archivo de autorización .json. Una vez que se complete la actualización de Portal for ArcGIS, el sitio web del portal se abre en una ventana del navegador.

  4. Inicie el programa de instalación de Portal for ArcGIS (Setup.exe) y lea la pantalla de bienvenida y las condiciones de uso. Haga clic en Siguiente cuando esté listo para proceder.

  5. Lea el contrato de licencia y acéptelo o salga de la instalación si no está de acuerdo con los términos.

    Se muestran los componentes que se instalarán.

  6. Haga clic en Instalar para iniciar la actualización. No interrumpa el proceso de instalación.

    Nota:

    Esto puede tardar algún tiempo en completarse.

  7. Haga clic en Finalizar para cerrar el asistente de instalación.

    El sitio web del portal se abre en una ventana del navegador.

  8. Borre la caché del navegador (incluidas las cookies).

    La información que permanece en la 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 la caché (incluidas las cookies) de todos los navegadores que vayan a ver el sitio web del portal actualizado.

  9. En la página Importar archivo de licencia, vaya al archivo de licencia .json que obtuvo de My Esri que contiene los tipos de usuarios autorizados y aplicaciones. Haga clic en Continuar con actualización del portal.

    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:

    El archivo de licencia que introduce durante la actualización se utiliza para asignar licencias a los usuarios y aplicaciones del portal. Asegúrese de que el nuevo archivo de licencia es adecuado para su configuración actual de usuarios y aplicaciones.

  10. Inicie sesión en el equipo que aloja el ArcGIS Web Adaptor que está utilizando con su portal y desinstale ArcGIS Web Adaptor. Para disponer de instrucciones completas, consulte el tema de desinstalación para Java (Linux). Asegúrese de anotar el nombre del adaptador web antes de desinstalarlo.

  11. Instale el adaptador web que se usará con su portal. Para obtener instrucciones completas, consulte el tema de instalación para Java (Linux). Asegúrese de que utiliza el nombre del adaptador web que utilizó en la versión anterior.

  12. Configure ArcGIS Web Adaptor con su portal. Para obtener instrucciones, consulte el tema de configuración para Java (Linux).

    Nota:

    Si está presente, se debe usar el alias DNS para acceder al adaptador web cuando vuelva a registrar con el portal si no está definida la WebContextURL en las Propiedades del sistema.

  13. Inicie sesión en el equipo que aloja el ArcGIS Web Adaptor que está utilizando con su portal y desinstale ArcGIS Web Adaptor. Para disponer de instrucciones completas, consulte el tema de desinstalación para IIS o Java (Windows). Asegúrese de anotar el nombre del adaptador web antes de desinstalarlo.

  14. Instale el adaptador web que se usará con tu portal. Para obtener instrucciones completas, consulte el tema de instalación para IIS o Java (Windows). Asegúrese de que utiliza el nombre del adaptador web que utilizó en la versión anterior.

  15. Configure ArcGIS Web Adaptor con su portal. Para obtener instrucciones completas, consulte el tema de configuración para IIS o Java (Windows).

    Nota:

    Si está presente, se debe usar el alias DNS para acceder al adaptador web cuando vuelva a registrar con el portal si no está definida la WebContextURL en las Propiedades del sistema.

  16. Verifique que pueda iniciar sesión en el portal a través de la URL de ArcGIS Web Adaptor como administrador de su organización.

    La dirección URL tiene el formato https://webadaptorhost.example.com/webadaptorname/home.

    Nota:

    • Si recibe una notificación que indica que se requieren pasos posteriores a la actualización, debe hacer clic en Aceptar en el cuadro de diálogo del mensaje para completar los pasos requeridos posteriores a la actualización. Entre ellos se incluyen la actualización de la reindexación del contenido (es necesario realizar una reindexación manual después de cada actualización si el contenido se encuentra en un bucket de Amazon S3 o Azure Blob Storage) y la actualización de la asociación entre equipos de Portal for ArcGIS en un portal de alta disponibilidad.

    • Si recibe una notificación relativa a las licencias cuando inicie sesión en el portal después de una actualización, puede que no haya importado un archivo de licencia que cumpla la configuración de licenciamiento actual o puede que se haya asignado un tipo de usuario temporal a los usuarios. Consulte Consideraciones después de actualizar Portal for ArcGIS para obtener más información.

  17. Actualice los componentes de ArcGIS Enterprise restantes.

Actualizar de forma automática

Para instalar de forma automática, siga estos pasos:

  1. En la ventana de comando, inicie el script de instalación de Portal for ArcGIS con el mismo usuario que se haya utilizado para instalar el portal existente.

    El siguiente ejemplo proporciona al script los argumentos necesarios para actualizar Portal for ArcGIS de forma automática.

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

    Para obtener la explicación completa de los argumentos que pueden usarse con el script de intsalación, consulte Instalar Portal for ArcGIS en Linux de forma automática.

  2. Desde la ventana de comando, ejecute el script de instalación de Portal for ArcGIS.

    En el siguiente ejemplo, la cuenta de Portal for ArcGIS utilizada por el software es admin y la contraseña es itsasecret.

    <path to Portal for ArcGIS setup download>\setup.exe /qb USER_NAME=admin PASSWORD=itsasecret ACCEPTEULA=yes

    Para obtener la explicación completa de los argumentos que pueden usarse con el script de intsalación, consulte Instalar Portal for ArcGIS de forma automática.

  3. Use la utilidad de línea de comandos upgradeportal para completar la actualización y las operaciones posteriores a la actualización en modo automático.

    1. En la línea de comandos, vaya a la carpeta <Portal install directory>/tools/upgradeportal.

    2. En la línea de comandos, vaya a la carpeta <Portal install directory>\tools\upgradeportal.

    3. Ejecute el comando siguiente:

      upgradeportal.sh -lf <path to portal json file> -s

      upgradeportal.bat -lf <path to portal json file> -s

      Para obtener ayuda, ejecute el comando con -h o --help. También puede usar la operación de actualización en la API del Administrador de Portal for ArcGIS para actualizar Portal for ArcGIS. Para obtener más información sobre la operación de actualización, consulte la documentación Actualizar en la Ayuda de la API de administración de Portal for ArcGIS.

Tareas posteriores a la actualización

Después de actualizar Portal for ArcGIS, es posible que deba realizar las siguientes tareas posteriores a la actualización para garantizar que su implementación funcione según lo previsto.

Actualizar los archivos de propiedades de WebGISDR creados antes de la actualización

Si planea usar un archivo de propiedades de WebGISDR creado antes de actualizar ArcGIS Enterprise, revise el archivo antes de ejecutar operaciones de copia de seguridad o restauración. Solo los archivos de propiedades que contienen valores cifrados requieren actualizaciones.

Si el archivo de propiedades incluye valores cifrados, sustitúyalos por sus valores no cifrados y establezca los valores booleanos correspondientes que indican si una propiedad está cifrada como false.

Para obtener más información, consulte Archivo de propiedades de la herramienta WebGISDR.

Actualizar manualmente los servicios de utilidades

Si utiliza los servicios de utilidades OfflinePackaging, RasterUtilities o GeocodingTools, debe actualizarlos manualmente después de la actualización:

  1. Una vez la actualización se haya completado, inicie sesión en ArcGIS Server Manager como el usuario que posee los servicios de utilidades.

  2. En la sección Administrar servicios de la pestaña Servicios, haga clic en la carpeta Utilidades.

  3. Haga clic en el botón Propiedades de uso compartido .

  4. En el cuadro de diálogo que aparece, haga clic en Guardar.

    Esto actualiza el servicio en su portal.

  5. Inicie sesión en el portal como administrador. En la pestaña Contenido, localice el servicio que ha actualizado. Haga clic en Compartir. Actualice los ajustes de uso compartido si procede y haga clic en Aceptar.

    Con ello, se actualiza el servicio en cada grupo con el que se ha compartido.

  6. Repita estos pasos para cada servicio aplicable.

Configurar servicios de generación de rutas

Si configura servicios de generación de rutas mediante la publicación de servicios de generación de rutas con su dataset de red, se recomienda que vuelva a configurar los servicios de generación de rutas después de la actualización del servidor para utilizar los recursos más recientes. Para los servicios de generación de rutas basados en el geoprocesamiento, los nuevos parámetros de servicio y los nuevos recursos del servicio solo estarán disponibles al volver a publicar los servicios de generación de rutas después de actualizar su servidor.

Para volver a publicar servicios de generación de rutas utilizando el dataset de red, siga estos pasos:

  1. Inicie sesión como administrador predeterminado o con un rol personalizado con los privilegios adecuados para administrar la configuración del portal.

  2. En la parte superior del sitio, haga clic en Organización y en Configuración.

  3. Haga clic en Servicios de utilidades, en el lado izquierdo de la página.

  4. Haga clic en Indicaciones y creación de rutas en el lado derecho de la página.

  5. Haga clic en Actualizar servicios de generación de rutas y elija Un dataset de red que quisiera publicar.

  6. Siga los pasos de Configurar servicios de generación de rutas para configurar los servicios de generación de rutas utilizando su dataset de red.

Una vez que se haya ejecutado correctamente, puede utilizar ArcGIS Server Manager para eliminar la carpeta que contiene los servicios de generación de rutas publicados anteriormente.

Solución de problemas después de la actualización

Si ha tenido algún problema con la actualización, revise atentamente la siguiente información y las soluciones a los problemas más comunes.

Nota:

Tenga en cuenta que los problemas que encuentre después de la actualización no indican necesariamente que la actualización haya fallado.

El portal no se visualiza correctamente o no permite iniciar sesión

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. Si las tarjetas de la pestaña Información general de la organización no se cargan, importe el archivo de licencia del portal (.json). Es posible importar el archivo de licencia mediante el Directorio del administrador del portal utilizando la URL https://portal.example.com:7443/arcgis/portaladmin/license/importLicense. Asegúrese de que es el archivo de licencia correcto para el portal. Al importar un nuevo archivo de licencia, este sobrescribe todos los tipos de usuarios o licencias de aplicaciones que haya en la organización.

Los elementos, grupos y usuarios de un portal no son visibles

Después de instalar el software y especificar la cuenta de administrador inicial, se inicia una reindexació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 de la organización, 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 de 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.

Comprobar el estado de la reindexación

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 igualen, la reindexación y la actualización se habrán completado.

  1. Abra la API de administrador del portal e inicie sesión con la cuenta de administrador inicial.

    La URL está en el formato https://portal.example.com:7443/arcgis/portaladmin.

  2. Haga clic en Sistema > Indexador > Estado de índice.

  3. Actualice la página para obtener el estado más reciente.

Ya no es posible acceder al contenido de ArcGIS Living Atlas

Si no se puede acceder a una capa de ArcGIS Living Atlas en el contenido de la organización después de haber actualizado, es posible que el elemento se haya retirado en esta versión. Active Ciclos de vida y actualizaciones de contenido de ArcGIS Living Atlas para obtener una lista actualizada de elementos retirados.

Si los elementos de contenido de suscriptor o Premium no se pueden abrir después de la actualización, asegúrese de que la cuenta de ArcGIS Online que utilizó al configurar el portal para acceder al contenido todavía sea válida. Si no lo es, debe completar los pasos adicionales para actualizar esta cuenta y el contenido de ArcGIS Living Atlas.

Las licencias asignadas superan el número de licencias disponibles

Se muestra el aviso El número de licencias asignadas supera el número de licencias disponibles. Los miembros a los que se asignen estas licencias tal vez no puedan acceder al portal. Vaya a la pestaña Licencias para obtener más detalles. para los administradores cuando inician sesión en el portal y se ha superado el número de licencias del portal. El número de usuarios a los que se les ha asignado un tipo de usuario o se les ha agregado una licencia supera el número de licencias disponibles.

El administrador puede acceder a la pestaña Licencias para visualizar las licencias que se han superado. Las licencias que han superado tienen un número asignado mayor que el número disponible. En función de las necesidades de su organización, puede volver a asignar licencias u obtener un nuevo archivo de licencia del portal con la asignación de licencias correcta.

Hay miembros que tienen licencias asignadas dos veces

Se muestra el aviso Algunos miembros tienen licencias asignadas dos veces. Estos miembros tienen acceso a la misma licencia a través de su tipo de usuario y una licencia complementaria para los administradores cuando una o más licencias complementarias asignadas a miembros se incluyen con sus tipos de usuario tras actualizar el portal. El administrador puede desasignar las licencias complementarias duplicadas de todos los miembros que corresonda.

Error al crear una cuenta de administrador inicial

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.

Si va a volver a su implementación anterior, copie todos los archivos de registro antes de volver para ayudar a solucionar su incidencia de soporte. Para acceder a los registros, examine el directorio de registros (por ejemplo, <Portal for ArcGIS installation directory>/arcgisportal/logs/).

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, C:\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.

Si va a volver a su implementación anterior, copie todos los archivos de registro antes de volver para ayudar a solucionar su incidencia de soporte. Para acceder a los registros, examine el directorio de registros (por ejemplo, C:\arcgisportal\logs\).