SAS is an Open OnDemand app that launches SAS as an interactive session on a compute node. It is designed for researchers who need data management, advanced analytics, multivariate analysis, business intelligence, and predictive analytics.
For how to create a Sandbox app, see the Developing your own app using Open OnDemand documentation.
Note
This section is intended for sys-admins, developers, and power users.
SAS is an Open OnDemand Batch Connect app that launches SAS as an interactive desktop session on HPC clusters. It is designed for researchers who need data management, advanced analytics, multivariate analysis, business intelligence, and predictive analytics.
This app uses the Batch Connect turbovnc template with Slurm.
- Upstream project: SAS
- Batch Connect template:
turbovnc - Scheduler: Slurm
SAS after re-organizing windows
- Launches SAS desktop GUI in a TurboVNC session with Xfce window manager
- Supports CPU and GPU execution
- Lmod module-based
- Configurable partition, memory, CPU cores, GPU cards, and wall time
- Optional additional Slurm options pass-through (long format)
- Optional reservation support for priority scheduling
- Optional email notification on job start
- OOM score management to prevent proxy errors on out-of-memory conditions
- SAS Lmod module and SAS license
- Xfce Desktop 4+
- Lmod
6.0.1+ or any other
module purgeandmodule load <modules>based CLI used to load appropriate environments within the batch job
- TurboVNC 2.1+
- websockify 0.8.0+
Please see the References section below for instructions on how to install the software that is launched by this App.
# Batch Connect apps:
cd /var/www/ood/apps/sys
git clone https://github.com/fasrc/ood-sas.git
cd ood-sasEdit form.yml and update these values for your cluster:
| Attribute | Description | FASRC settings | Change to |
|---|---|---|---|
cluster |
Target cluster ID | odyssey |
Your cluster name |
bc_num_hours |
Maximum wall time (HH:MM:SS) | user-defined; default 04:00:00 |
Your preferred default time |
bc_num_cores |
Number of cores | user-defined; default 1 |
Your preferred default number of cores |
bc_queue |
Default scheduler partition | user-defined; default shared |
Your preferred partition |
extra_slurm |
Extra slurm option (long-format) | user-defined | Remove if using aother scheduler |
custom_num_gpus |
Number of GPUs | user-defined; default 0 |
Your preferred default number of GPUs |
custom_memory_per_node |
Memory per job (GB) | user-defined; default: 4 |
Your preferredmemory allocation |
sas_version |
SAS module to load on compute node | sas/9.4-fasrc01 |
Your sas module |
Edit manifest.yml and update these values for your organization:
| Attribute | Change to |
|---|---|
description |
Your cluster and your documentation |
No OOD restart is needed (Batch Connect apps are detected automatically). Visit your OOD dashboard and look for SAS under Interactive Apps > Desktop Apps.
- Check the job's
output.login~/ondemand/data/sys/YOUR-APP/ - Verify the module loads correctly:
module load software/1.0 - For VNC apps, verify the window manager is installed:
which xfwm4
The module name in form.yml doesn't match your system. Run module spider software to find the correct name and update the modules attribute.
The app may need more time to start. Increase the connection timeout or check that the compute node can open the required port.
| Site | Operating System* | OOD Version | Scheduler | Status |
|---|---|---|---|---|
| FASRC | Rocky 8.10 | 3.1 | Slurm 25.11 | Tested |
| FASRC | Rocky 8.10 | 4.0 | Slurm 25.11 | Tested |
| FASRC | Rocky 8.10 | 4.1 | Slurm 25.11 | Tested |
Note
*Operating system of compute nodes
To verify your installation:
- Launch the app from the OOD dashboard with default settings
- Confirm the application loads in the browser
- Multi-node jobs are not supported
- Only tested on Centos 7 and Rocky 8; may not work on Ubuntu.
Contributions are welcome. To contribute:
- Fork this repository.
- Create a feature branch (
git checkout -b feature/my-improvement). - Submit a pull request with a description of your changes.
For bugs or feature requests, open an issue.
This app is part of the OOD Appverse. Join the Appverse Affinity Group to connect with other contributors.
- SAS — the application launched by this OOD app.
- Open OnDemand — the HPC portal framework.
This work is supported by FASRC at Harvard Univesity.