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.

Note:

If your Notebook server is currently in read-only mode, turn the mode off before beginning the upgrade process.

Upgrade ArcGIS Notebook Server on Windows Server 2022

To upgrade ArcGIS Notebook Server on Windows Server 2022, complete the following steps:

1. Upgrade your ArcGIS Enterprise deployment.
2. Uninstall ArcGIS Notebook Server samples 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.4 and configure it with ArcGIS Notebook Server.

   Note:

   Ensure the same web adaptor instance name is maintained.

7. Upgrade Mirantis Container Runtime to version 23.0.14 or later.
8. Install the most recent ArcGIS Notebook Server Windows container images.
9. Update the runtime of existing notebook items to the most recent ArcGIS Notebook Server runtime.

   See the Change a notebook runtime section for more information.

   Note:

   If any notebooks were running custom runtimes, you must rebuild and reregister the custom runtimes on the Windows Notebook Server and update the runtime settings for the associated notebook items.

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

10. Optionally, you can remove the previous version of the ArcGIS Notebook Server runtimes image to free up disk space.

    Caution:

    Ensure that all existing notebooks have been updated to use the most recent version of the ArcGIS Notebook Server runtime image.

    1. List the images.

       docker images -a

    2. Note the IMAGE ID corresponding to the previous version of the ArcGIS Notebook Server runtime image.
    3. Remove the image.

       docker image rm <IMAGE ID>

Upgrade ArcGIS Notebook Server on Windows Server 2022 and migrate from Linux containers to Windows containers

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.4 and configure it with ArcGIS Notebook Server.

   Note:

   Ensure the same web adaptor instance name is maintained.

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

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

10. Uninstall Docker Desktop.
11. Install Mirantis Container Runtime.
12. Install the most recent ArcGIS Notebook Server Windows container images.

    Note:

    For a multimachine site, repeat steps 3 and 10 through 12 for each machine in your site.

13. Update the runtime of existing notebook items to the most recent ArcGIS Notebook Server runtime.

    See the Change a notebook runtime section for more information.

    Note:

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

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

Upgrade from ArcGIS Notebook Server on Windows Server 2019 with Linux containers to ArcGIS Notebook Server on Windows Server 2022 with Windows containers

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.4 on Windows Server containers.
5. Configure ArcGIS Notebook Server after installation.
6. Create a site.
7. Install and configure ArcGIS Web Adaptor.
8. For a multimachine site, repeat steps 4 and 5 on each machine and join additional machines to the site.
9. Configure ArcGIS Notebook Server with the Portal.
10. Update the runtime of existing notebook items to the most recent ArcGIS Notebook Server runtime.

    See the Change a notebook runtime section for more information.

    Note:

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

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