Differences

This shows you the differences between two versions of the page.

--- habrok:connecting_to_the_system:web_portal [2023/07/27 08:32] – admin
+++ habrok:connecting_to_the_system:web_portal [2023/11/08 08:50] (current) – [Jupyter Notebook] fokke
@@ Line 1: / Line 1: @@
+{{indexmenu_n>5}}
+**
+''The Web Portal for Hábrók is now available, but some functionality is still lacking. For instance, the interactive apps for TensorFlow and PyTorch are not available yet.''
+**
+====== Web Portal ======
+We have implemented a new web portal for Hábrók, based on software developed at the [[https://www.osc.edu/|Ohio Supercomputer Center]], called [[http://openondemand.org/|OpenOnDemand]] (affectionately known as [[https://en.wikipedia.org/wiki/Ood|OOD]]). Using your username and password, just as you would do on Hábrók, you can log in to this portal at the following address:
+https://portal.hb.hpc.rug.nl
+Important to know is that the “Log Out” menu item doesn’t do what you would expect, i.e. log you out. To actually log out, you would have to close the browser session, which is why the developers of OpenOnDemand suggest using the incognito/private mode of your preferred browser.
+===== Logging in =====
+  - If you already have a Hábrók account, you can just go to [[https://portal.hb.hpc.rug.nl]] and click on the <html><span class="glyphicon glyphicon-log-in hidden-sm"></span></html> Login button at the top-right corner. You will be prompted to enter your username, password, and MFA token, using the RUG single sign-on page, after which you will be logged in to the Web Portal.
+  - If you don't have a Hábrók account, then go the [[https://iris.service.rug.nl|IRIS]] support system to request an account (more information at the [[..:introduction/policies|"Accounts and policies"]] page). Once your account has been added to Hábrók, follow from step 1 here to login.
+===== The Dashboard =====
+Once logged in, you will be presented with a dashboard.
+{{dashboard.png|}}
+Here, in addition to the “Message of the Day” that you see when you ''ssh'' into Hábrók, we will also display messages relevant only to the web portal (such as any planned maintenance of the portal).
+The menu has several items, the most useful ones being:
+  * Files
+  * Jobs
+  * Clusters
+  * Interactive Apps
+  * My Interactive Sessions
+===== The Files menu =====
+In the ''%%Files%%'' menu you have access to your home, ''%%/projects%%'' and ''%%/scratch%%'' folders, as well as any group folders in ''%%/scratch%%'' for groups you belong to, and which are named as ''%%hb-<group-name>%%''. When accessing any of the submenus in ''%%Files%%'', the corresponding folder will be opened in a file explorer in a new browser tab. From here you can navigate, perform file operations (copy, delete, etc.), view and even edit files (the file editor has syntax highlighting for a large number of text file formats).
+===== The Jobs menu =====
+In the ''%%Jobs%%'' menu, there are two subitems: ''%%Active Jobs%%'' and ''%%Job Composer%%''. The ''%%Job Composer%%'' allows you to define a submit a job directly from the web portal, but at the moment it is a bit cumbersome and counter-intuitive in our opinion, so we do not recommend using it just yet. The ''%%Active Jobs%%'' provides an overview of jobs on the cluster, either for yourself or all users. It is similar to the ''%%squeue%%'' from the command line.
+===== The Clusters menu =====
+This menu provides shell access to the Hábrók login and interactive nodes directly in your web browser! There’s not much to say about this, it gives you all the functionality that you have from the command line.
+===== The Interactive Apps menu =====
+This is where things become more interesting. At the moment we have a single interactive app (with more to come), which you can launch as jobs from this menu:
 ==== Jupyter Notebook ====
@@ Line 19: / Line 72: @@
   * ''<ipython_version> = IPython/8.5.0-GCCcore-11.3.0'' for ''Python 3.10.4''
+  * ''<ipython_version> = IPython/7.26.0-GCCcore-11.2.0'' for ''Python 3.8.16''
 Now build a virtual environment in ''$HOME/venvs'':
@@ Line 36: / Line 90: @@
 Before you are able to build a Jupyter Notebook kernel for your new virtual environment, there are a few additional packages that you need to install:
 <code>
-pip install pip install tomlkit jupyter-contrib-core
+pip install tomlkit jupyter-contrib-core
 </code>
@@ Line 49: / Line 103: @@
 Any packages you install in this virtual environment will be available from the Jupyter Notebook immediately. We suggest you use a ''requirements.txt'' file to keep track of the packages you've installed.
 ==== Hábrók Remote Desktop ====
@@ Line 55: / Line 108: @@
 The Remote Desktop app will launch a graphical desktop environment (based on ([[https://mate-desktop.org/|MATE]]) on a compute node, allowing you to interactively run tools with a graphical user interface with some more resources than what's available on the login/interactive nodes. By submitting to the ''gpu'' partition, you can even make use of a GPU and do OpenGL hardware rendering. The desktop environment itself has some tools like a web browser, text editors, and terminal available, but in a terminal you can also make use of all the modules. This would allow you to run tools like MATLAB, Mathematica, ParaView, or VMD.
+{{portal_remote_desktop.png?1600|}}
+===== Testing =====
+The Web Portal is still in the test phase, and we would appreciate if you send any feedback you have to [[hpc@rug.nl]], with the subject line including “OOD Portal”.
+Enjoy the Web Portal!