diff --git a/content/applications/app_specific/running_sas.md b/content/applications/app_specific/running_sas.md index a0585ef2b4a046889692fc5d4083fd3bc5733725..3b458b2e02c32e2aee4155234e32be2c882ffaf7 100644 --- a/content/applications/app_specific/running_sas.md +++ b/content/applications/app_specific/running_sas.md @@ -1,15 +1,15 @@ +++ -title = "Running SAS at HCC" +title = "Running SAS on HCC" description = "How to run SAS on HCC resources." +++ - [Running SAS through the command line](#sas-on-hcc-clusters) -- [Running SAS on JupyterHub](#sas-on-jupyterhub) +- [Running SAS on HCC OnDemand](#sas-on-hcc-ondemand) - [Running SAS on Anvil](#sas-on-anvil) -This quick start demonstrates how to implement a SAS program on -HCC supercomputers through the command line and JupyterHub, and on HCC's Anvil platform. The sample code and submit scripts can be +This quick start demonstrates how to use a SAS program on +HCC resources through the command line, HCC OnDemand, and HCC's Anvil platform. The sample code and submit scripts can be downloaded from [HCC's job-examples git repository](https://github.com/unlhcc/job-examples). {{% notice info%}} @@ -17,13 +17,15 @@ SAS is licensed software; users must have access to an existing license via an a If you are a current SAS user and would like to arrange for access on HCC machines, please contact hcc-support@unl.edu. {{% /notice %}} + + ## SAS on HCC Clusters -SAS applications can be ran on HCC clusters similar to other jobs. -[Connect to a HCC cluster]({{< relref "../../connecting/" >}}) and make a subdirectory +SAS applications can be run on HCC clusters similar to other jobs. +[Connect to an HCC cluster]({{< relref "../../connecting/" >}}) and make a subdirectory called `sas_demo` under your `$WORK` directory. -In the subdirectory `sas_demo`, save the sas code. Here we include a single demo -programs, `t_test.sas`, to perform a t test analysis on a small data set. +In the subdirectory `sas_demo`, save the SAS code. Here, we include a single demo +programs, `t_test.sas`, to perform a t-test analysis on a small data set. [t_test.sas](https://raw.githubusercontent.com/unlhcc/job-examples/master/sas/t-test.sas) @@ -33,8 +35,8 @@ programs, `t_test.sas`, to perform a t test analysis on a small data set. #### Creating a Submit Script -Create a submit script to request one core (default) and 10-min run time -on the supercomputer. The name of the main program enters at the last +Create a submit script to request one core (default) and 10 minutes run time +on the supercomputer. The name of the main program is entered at the last line. [sas.submit](https://raw.githubusercontent.com/unlhcc/job-examples/master/sas/sas.submit) @@ -55,21 +57,32 @@ Replace `<username>` with your HCC username. The results of the t-test are computed and printed to the `.lst` file -## SAS on JupyterHub -Sas can also be run on Jupyter notebook environments available through [HCC Open OnDemand]({{< relref "../../open_ondemand/connecting_to_hcc_ondemand/" >}}). [Launch a jupyter notebook session]({{< relref "../../open_ondemand/virtual_desktop_and_interactive_apps/" >}}). After the Jupyter Notebook session starts, select `SAS` from the `New` dropdown box. -{{< figure src="/images/jupyterNew.png" >}} -Here you can run code in the notebook's cells. The SAS code is then ran when you click on the "play" icon or pressing the `shift` and `enter` keys simultaneously. +## SAS on HCC OnDemand +On [HCC OnDemand]({{< relref "../../open_ondemand/connecting_to_hcc_ondemand/" >}}), SAS can be accessed via Jupyter Lab Notebook and dedicated SAS Interactive GUI Application, visible for researchers with valid SAS license. + +### SAS on Jupyter Lab +[Launch a Jupyter Lab Notebook session]({{< relref "../../open_ondemand/virtual_desktop_and_interactive_apps/" >}}). After the Jupyter Lab Notebook session starts, select `SAS` from the `New` dropdown box. +{{< figure src="/images/jupyterNew.png" >}} +Here, you can run code in the Notebook's cells. The SAS code is then executed when you click on the "play" icon or press the `shift` and `enter` keys simultaneously. {{< figure src="/images/jupyterCode.png" >}} +### SAS Interactive GUI Application +[Launch the Interactive App]({{< relref "../../open_ondemand/virtual_desktop_and_interactive_apps/" >}}) by selecting `SAS` from the `Interactive Apps` drop-down menu at the top of the OnDemand Dashboard page and filling in the parameters needed for your job. +{{< figure src="/images/sas_1.png" >}} +SAS scripts can then be run from the Editor, and the results will be shown in a browser. +{{< figure src="/images/sas_2.png" >}} + + + ## SAS on Anvil -SAS can also be ran on a Windows 10 instance on anvil. This allows SAS scripts to be run with a full GUI environment. +SAS can also be run on a Windows 10 instance on Anvil. This allows SAS scripts to be run with a full GUI environment. -Start off creating a `Windows 10 SAS` instance from the [Anvil dashboard](https://anvil.unl.edu/). [Create an instance]({{< relref "../../anvil/creating_an_instance.md" >}}) and use the image labeled `Windows 10 SAS`. Once the instance is fully launched, [connect to the instance]({{< relref "../../anvil/connecting_to_windows_instances.md" >}}) using the retrieved password. After connecting to the instance and logging , SAS can be launched from the desktop shortcut. +Start off creating a `Windows 10 SAS` instance from the [Anvil dashboard](https://anvil.unl.edu/). [Create an instance]({{< relref "../../anvil/creating_an_instance.md" >}}) and use the image labeled `Windows 10 SAS`. Once the instance is fully launched, [connect to the instance]({{< relref "../../anvil/connecting_to_windows_instances.md" >}}) using the retrieved password. After connecting to the instance and logging, SAS can be launched from the Desktop shortcut. {{< figure src="/images/sasAnvilDesktop.png" height="450" >}} -From here sas scripts can be ran from the editor at the bottom of the SAS window. Scripts can also be opened from a script file on the Anvil instance. +From here, SAS scripts can be run from the Editor at the bottom of the SAS window. Scripts can also be opened from a script file on the Anvil instance. {{< figure src="/images/sasAnvil.png" height="450" >}} -Executing a script is done at the top of the SAS window `Run` and click `Submit`. When the script finishes executing, the results will be displayed. +Executing a script is done by typing `run;` and clicking `Submit`. When the script finishes executing, the results will be displayed. {{< figure src="/images/sasAnvilResults.png" height="450" >}} diff --git a/static/images/sas_1.png b/static/images/sas_1.png new file mode 100644 index 0000000000000000000000000000000000000000..02a877ebeafab845715494572594b2900d60e056 Binary files /dev/null and b/static/images/sas_1.png differ diff --git a/static/images/sas_2.png b/static/images/sas_2.png new file mode 100644 index 0000000000000000000000000000000000000000..805730ec859fd457428dfbdff51f231128352fe4 Binary files /dev/null and b/static/images/sas_2.png differ