From ee1692106a3876c7efd62d6c09e8f062f0158037 Mon Sep 17 00:00:00 2001
From: bemonts <71267207+bemonts@users.noreply.github.com>
Date: Fri, 15 Nov 2024 12:14:54 -0500
Subject: [PATCH] Created using Colab

---
 docs/notebooks/introduction.ipynb | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/notebooks/introduction.ipynb b/docs/notebooks/introduction.ipynb
index a02025bb..2f21a778 100644
--- a/docs/notebooks/introduction.ipynb
+++ b/docs/notebooks/introduction.ipynb
@@ -359,6 +359,7 @@
         "\n",
         "**Summary Most Important Issues**\n",
         "\n",
+        "- Default CASA installation on **Google Colab** is currently failing (as of 11/11/2024), and requires setting the version of *protobuf* back to 3.20 in Colab Notebooks\n",
         "- The **CASA Viewer** is no longer included in Mac OS packages.\n",
         "- Task **simobserve** may fail on Mac OS 14.\n",
         "- Task **simanalyze** with two or more input MSs in *vis* may not work.\n",
@@ -391,6 +392,13 @@
         "\n",
         "### Installation\n",
         "\n",
+        "- Installing CASA with default commands on Google Colab is currently failing. Reason is that as of 11/11/2024, Google rolled out an update to Colab with updated default packages, of which the *protobuf* package is incompatible with the current default pip version of CASA. CASA is currently stuck to protobuf 3.20 and older, based on choices made for compatibility with the RHEL8 build systems.  A solution in CASA is currently under investigation. The problem can be fixed by pinning the *protobuf* version to 3.20 in Colab Notebooks:\n",
+        "```\n",
+        "os.system('pip install protobuf==3.20.3')\n",
+        "import google.protobuf as gpbuf\n",
+        "print('Protobuf version must be 3.20.X, it is: ',gpbuf.__version__)\n",
+        "```\n",
+        "\n",
         "- Running **importfits** in modular CASA may fail with a *CFITSIO* error if also the NASA HEASoft software is installed, because of a conflict in CFITSIO setting between CASA and heasoft. As a workaround, comment out all parts of heasoft in your environment to made importfits work in the modular environment.\n",
         "\n",
         "- CASA 6 startup may fail on some Mac OS where users have set up a file system that is *case-sensitive* (as shown [here](https://support.apple.com/lt-lt/guide/disk-utility/dsku19ed921c/mac)). As a temporary work-around, please manually update the casapy script in /Applications/CASA.app/Contents/MacOS/casapy, by replacing the string \"Macos\" with \"MacOS\", which occurs in lines 36 and 39 of the casaspy script.\n",