Skip To Content

Upgrade ArcGIS Notebook Server (Windows containers)

ArcGIS Notebook Server on Windows containers is only supported on Windows Server 2022. If you have a previous installation of ArcGIS Notebook Server on Windows Server 2019, you must upgrade the operating system prior to upgrading to ArcGIS Notebook Server on Windows containers. Alternatively, you can perform a fresh installation of ArcGIS Notebook Server on Windows Server 2022 and configure it as the Notebook Server for your ArcGIS Enterprise deployment.

Upgrade ArcGIS Notebook Server on Windows Server 2022

To upgrade ArcGIS Notebook Server on Windows Server 2022 from a previous installation and migrate from Linux containers to Windows containers, complete the following steps:

  1. Upgrade your ArcGIS Enterprise deployment.
  2. Uninstall ArcGIS Notebook Server sample data.
  3. Upgrade ArcGIS Notebook Server using the setup program or the command line.
  4. Unregister the previous instance of ArcGIS Web Adaptor from your site.
  5. Uninstall ArcGIS Web Adaptor.
  6. Install a new instance of ArcGIS Web Adaptor 11.1 and configure it with ArcGIS Notebook Server.

    Note:
    Ensure the same web adaptor instance name is maintained.

  7. Sign in to the notebook server administrator directory as an admin user and update the useWindowsContainers property to true.

    Note:
    This will restart the notebook server.

  8. Once your notebook server has restarted and the administrator site directory is accessible, sign in as an administrative user.
  9. Click Notebooks > Runtimes.
  10. Run Restore Factory Runtimes.

    This will update the Esri notebook runtimes to use the Windows container based notebook runtime images.

  11. Uninstall Docker Desktop.
  12. Install Mirantis Container Runtime.
  13. Install the ArcGIS Notebook Server 8.0 Windows container images.

    Note:
    For a multimachine site, repeat steps 3 and 11 through 13 for each machine in your site.

  14. Install and configure ArcGIS Notebook Server samples data using the setup program or silent installer.
  15. Update the runtime of existing notebook items to the ArcGIS Notebook Server 8.0 runtime.

    See the Change a notebook runtime section for more information.

    Note:

    If any notebooks were using custom runtimes, you will need to rebuild and reregister the custom runtimes on the Windows notebook server and update the runtime settings for the associated notebook items.

  16. Update the memory and CPU usage settings configured in your runtimes.

Upgrade ArcGIS Enterprise and configure a new installation of ArcGIS Notebook Server on Windows Server 2022

To upgrade to ArcGIS Enterprise on Windows Server 2022 with ArcGIS Notebook Server on Windows containers from a previous installation on Windows Server 2019 with Linux containers, complete the following steps:

  1. Remove your ArcGIS Notebook Server from ArcGIS Enterprise with the following substeps:
    1. Sign in to the ArcGIS Portal Directory administrator location as an administrator for your organization .

      Note:
      The URL is https://webadaptorhost.domain.com/arcgis/portaladmin, where arcgis is the name of the Web Adaptor registered with your portal.

    2. Click Federation > Servers.
    3. Choose the notebook server you want to unfederate.
    4. Click Unfederate.
  2. Upgrade your ArcGIS Enterprise deployment.
  3. On the new notebook server machine, set up prerequisite software.
  4. Install ArcGIS Notebook Server 11.1 on Windows Server containers.
  5. Configure ArcGIS Notebook Server after installation.
  6. Create a site.
  7. Install and configure ArcGIS Notebook Server samples data using the setup program or silent installer.
  8. Install and configure ArcGIS Web Adaptor.
  9. For a multimachine site, repeat steps 4 through 6 on each machine and join additional machines to the site.
  10. Configure ArcGIS Notebook Server with the Portal.
  11. Update the runtime of existing notebook items to the ArcGIS Notebook Server 8.0 runtime.

    See the Change a notebook runtime section for more information.

    Note:

    If any notebooks were using custom runtimes, you will need to rebuild and reregister the custom runtimes on the Windows notebook server and update the runtime settings for the associated notebook items.

  12. Update the memory and CPU usage settings configured in your runtimes.