Optional section in the IDE notebook

Author: ivan-khvostishkov

SageMaker_SSH_IDE.ipynb

@@ -18,7 +18,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Environment & SSM Setup"
+    "## Environment setup"
    ]
   },
   {
@@ -78,32 +78,47 @@
   },
   {
    "cell_type": "markdown",
-   "metadata": {},
    "source": [
-    "Specify JetBrains License Server host name in `JB_LICENSE_SERVER_HOST` variable. Leave it as is if you don't use one, e.g. use PyCharm Community or VS Code, or already configured one from another kernel app (the value will be shared between apps).\n",
+    "## (Optional) Remote desktop / VNC setup\n",
     "\n",
-    "Please, make sure you've configured the same value on your local machine (see the script `sm-local-ssh-ide`)."
-   ]
+    "If you don't plan to run any GUI apps inside SageMaker Studio, skip to the next section or run the cells as is (safe defaults)."
+   ],
+   "metadata": {
+    "collapsed": false
+   }
+  },
+  {
+   "cell_type": "markdown",
+   "source": [
+    "Choose your VNC password. It's safe to leave it as is, because your connection will be already secured with SSH and SSM. You need some password, because some VNC clients do not allow passwordless connections.\n",
+    "\n",
+    "If you already configured password from another kernel app, this cell will take no effect (the encrypted password file will be shared between apps)."
+   ],
+   "metadata": {
+    "collapsed": false
+   }
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
    "outputs": [],
    "source": [
     "%%sh\n",
-    "JB_LICENSE_SERVER_HOST=\"jetbrains-license-server.example.com\"  # replace with your JetBrains License Server host name\n",
+    "VNC_PASSWORD=\"123456\"  # replace with your password\n",
     "\n",
-    "sm-ssh-ide set-jb-license-server \"$JB_LICENSE_SERVER_HOST\""
-   ]
+    "sm-ssh-ide set-vnc-password \"$VNC_PASSWORD\""
+   ],
+   "metadata": {
+    "collapsed": false
+   }
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Now choose your VNC password. It's safe to leave it as is, because your connection will be already secured with SSH and SSM. You need some password, because some VNC clients do not allow passwordless connections.\n",
+    "Specify JetBrains License Server host name in `JB_LICENSE_SERVER_HOST` variable. Leave it as is if you don't use one, e.g. use PyCharm Community or VS Code, or already configured one from another kernel app (the value will be shared between apps).\n",
     "\n",
-    "If you already configured password from another kernel app, this cell will take no effect (the encrypted password file will be shared between apps)."
+    "Please, make sure you've configured the same value on your local machine (see the script `sm-local-ssh-ide`)."
    ]
   },
   {
@@ -113,11 +128,20 @@
    "outputs": [],
    "source": [
     "%%sh\n",
-    "VNC_PASSWORD=\"123456\"  # replace with your password\n",
+    "JB_LICENSE_SERVER_HOST=\"jetbrains-license-server.example.com\"  # replace with your JetBrains License Server host name\n",
     "\n",
-    "sm-ssh-ide set-vnc-password \"$VNC_PASSWORD\""
+    "sm-ssh-ide set-jb-license-server \"$JB_LICENSE_SERVER_HOST\""
    ]
   },
+  {
+   "cell_type": "markdown",
+   "source": [
+    "## SSM setup"
+   ],
+   "metadata": {
+    "collapsed": false
+   }
+  },
   {
    "cell_type": "markdown",
    "metadata": {
@@ -154,7 +178,7 @@
    "source": [
     "The `start` command will run the background applications for remote access – SSH daemon, VNC server and Jupyter notebook. The `stop` command helps with cleanup from previous runs (see the next section).\n",
     "\n",
-    "If you don't want to run a VNC server and Jupyter notebook, pass the flag `--ssh-only` to the `start` command. Also consider passing the same flag to the `sm-local-ssh-ide` command."
+    "If you don't want to run a VNC server and Jupyter notebook, pass the flag `--ssh-only` to the `start` command. Also consider passing the same flag to the `sm-local-ssh-ide` command (you will find it in further instructions)."
    ]
   },
   {