Interactive Desktop
Opening Interactive Desktop Form
-
The first step is to select the
Interactive appsand then click theDesktop(XFCE)in the Open OnDemand dashboard. -
Then you will see a form which needs to be filled to launch the interactive desktop on the compute nodes.
Partition
-
Partitions are work queues that has computational nodes in it to run the jobs. The partitions available in Colibri are
general-cpu,general-gpu,interactive-cpu,interactive-gpu,backfill,inbre, andprism. -
However, you will see only the list of authorized partitions available for your Colibri account and hence, you won’t see the partitions which you don’t have authorization in the select dropdown.
-
Select one of the partitions where you want to submit your job. Refer to the page → Partitions in Colibri to select the ideal partition for your job.
-
Jobs on the
backfillpartition are subject to being stopped and requeued.
Walltime(Hours)
-
Sets the Walltime for your job. The job gets killed if the Walltime you set gets elapsed. The maximum Walltime for each partition is listed in the table below.
Partition Max Hours backfill338
general-cpu169
general-gpu169
inbre169
interactive-cpu25
interactive-gpu25
prism169
CPUs(Threads)
-
Sets the Number of CPUs(Threads) for the job. The default and minimum value is 1 CPU thread.
Memory (GB/Gigabytes)
-
Sets the memory for the job in terms of GB. The memory you select is available to all assigned threads for the job. The default and minimum value is 1 GB.
GPUs
-
GPUs are available only in the partitions that contain GPU nodes:
general-gpu,interactive-gpu,backfill,inbre, andprism. If you select one of these partitions, you can see theGPUsdropdown enabled.
Node Selection
This is an optional node selection feature for submissions to Slurm. It allows users to specify a particular node or any node with specific feature flags.
Selection Options
There are four available options for node selection:
-
Disabled: This is the default setting. When "Disabled" is selected, the application will not send any specific node preferences to Slurm during job submission.
-
Node List: With this option, users can specify a particular node (one single node) where the job should run.
-
Node Features (--constraint): Users can select this option if they want to run their job on any node that meets a specific feature.
-
Node Features (--prefer): This option is similar to the "--constraint" option, but it only indicates a preference. If it’s not available, it might be scheduled elsewhere.
Email Address
-
If you want to get notified via email when the job starts/fails/ends, enter the email address associated with the Colibri account.
-
You can leave the text field
blankif you don’t want job notifications.
Submission Environment
You can select your desired submission environment from the drop down list. For example, to use an Apptainer image, select the Container option.
Containerized Desktop: Required Packages
To build your desktop container, there are some required packages.
-
TurboVNCandWebsockify:-
TurboVNCandWebsockifyneed to be installed inside the container. This is important as all processes will run inside the container and not on the host. -
Websockifyneeds to be installed in the default location.-
Websockify: "/usr/bin/websockify"
-
-
-
Apptainer:-
In order to use other containers within the containerized desktop (nested container), such as MATLAB, Apptainer needs to be installed.
-
If you don’t need to use other containers on your interactive desktop, just make sure that TurboVNC and Websockify are installed.
We use my_desktop.def as an example. The full my_desktop.def file can be found at the end of this page, and you can modify it to suit your needs.
To learn more about Apptainer container, please visit Apptainer.
Launching the Interactive Session
-
Once all the form fields are set, you can click the
Launchbutton. The interactive session will be launched and the below output is shown.
-
The above output shows that the interactive Desktop session has been launched successfully. You will see the Launch Desktop(Xfce) only if the resources you have requested becomes available. Else, you might need to wait for some more minutes for the resources allocation and then the Launch Desktop(Xfce) button appears.
-
You can also set the
CompressionandImage Qualityfor Interactive Desktop by using the slider. After setting the values, click the Launch Desktop(Xfce) button.
|
The interactive session won’t be launched if you try to submit your job to the partition that you don’t have access to. Also, the page gets reloaded and you need to select the value for the form fields again since the form gets reset. |
Opening Interactive Desktop
-
On clicking the Interactive Desktop(Xfce) button, the interactive desktop opens in a new tab through a VNC session.
-
You are provided with
four different workspaceswhich is displayed in the top right corner of the window and you can use it.
-
At the bottom of the screen, you will see different options like
Terminal Emulator, File Manager, Application Finder, Web Browser, Minimize windowswhich you can make use of it.
Opening applications
-
Click the
Applicationstab in the top left of the screen and you will see the list of available applications.
Output:
Killing the interactive session
-
Click the
Applicationstab and then select theLogoutoption. -
Then, you will get a pop-up to confirm.
-
On confirmation, you will be disconnected and the interactive session gets deleted. You will see a similar output like below:
Alternate way
-
Another way to delete the session is to go to the
My Interactive sessionstab and select theDeletebutton of the current interactive session.
|
Whenever you are done with the work, it’s always recommended to kill/delete the interactive session running on the compute nodes and free the resources. |
Definition File "my_desktop.def"
Bootstrap: docker
From: docker.io/rockylinux/rockylinux:8
%environment
PATH=/opt/TurboVNC/bin:$PATH
LANGUAGE="en_US.UTF-8"
LC_ALL="en_US.UTF-8"
LANG="en_US.UTF-8"
%post
# Install EPEL repository for additional packages
dnf install -y epel-release
dnf groupinstall -y xfce
dnf install -y python3-pip xorg-x11-xauth
pip3 install ts
# Install Websockify
dnf install -y https://yum.osc.edu/ondemand/latest/compute/el8Server/x86_64/python3-websockify-0.10.0-1.el8.noarch.rpm
# Install TurboVNC
dnf install -y https://yum.osc.edu/ondemand/latest/compute/el8Server/x86_64/turbovnc-2.2.5-1.el8.x86_64.rpm
# Install Apptainer
dnf install -y https://github.com/apptainer/apptainer/releases/download/v1.3.1/apptainer-1.3.1-1.x86_64.rpm
# dnf install -y apptainer
dnf clean all
chown root:root /opt/TurboVNC/etc/turbovncserver-security.conf
rm -rf /var/cache/dnf/*
%environment
export PATH=$PATH:/usr/local/bin