Skip to content

Commit 9b97d28

Browse files
authored
Merge pull request #162 from dsajdak/master
minor updates to text
2 parents 39af5e2 + a83b0fc commit 9b97d28

File tree

3 files changed

+9
-8
lines changed

3 files changed

+9
-8
lines changed

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# HPC Toolset Tutorial
22

3-
Tutorial for installing and configuring [ColdFront](http://coldfront.io), [OnDemand](https://openondemand.org/), and [Open XDMoD](https://open.xdmod.org): an HPC center management toolset.
3+
Tutorial for installing and configuring [ColdFront](http://coldfront.io), [Open OnDemand](https://openondemand.org/), and [Open XDMoD](https://open.xdmod.org): an HPC center management toolset.
44

55
### Presented by:
66

77
[![OSC Logo https://osc.edu](docs/osc_logo.png)](https://osc.edu)
88
[![CCR logo](docs/ccr_logo.jpg)](https://buffalo.edu/ccr)
99

1010

11-
This tutorial aims to demonstrate how three open source applications work in concert to provide a toolset for high performance computing (HPC) centers. ColdFront is an allocations management portal that provides users an easy way to request access to allocations for a Center's resources. HPC systems staff configure the data center’s resources with attributes that tie ColdFront’s plug-ins to systems such as job schedulers, authentication/account management systems, system monitoring, and Open XDMoD. Once the user's allocation is activated in ColdFront, they are able to access the resource using OnDemand, a web-based portal for accessing HPC services that removes the complexities of HPC system environments from the end-user. Through OnDemand, users can upload and download files, create, edit, submit and monitor jobs, create and share apps, run GUI applications and connect to a terminal, all via a web browser, with no client software to install and configure. The Open XDMoD portal provides a rich set of features, which are tailored to the role of the user. Sample metrics provided by Open XDMoD include: number of jobs, CPUs consumed, wait time, and wall time, with minimum, maximum and the average of these metrics. Performance and quality of service metrics of the HPC infrastructure are also provided, along with application specific performance metrics (flop/s, IO rates, network metrics, etc) for all user applications running on a given resource.
11+
This tutorial aims to demonstrate how three open source applications work in concert to provide a toolset for high performance computing (HPC) centers. ColdFront is an allocations management portal that provides users an easy way to request access to allocations for a Center's resources. HPC systems staff configure the data center’s resources with attributes that tie ColdFront’s plug-ins to systems such as job schedulers, authentication/account management systems, system monitoring, and Open XDMoD. Once the user's allocation is activated in ColdFront, they are able to access the resource using Open OnDemand, a web-based portal for accessing HPC services that removes the complexities of HPC system environments from the end-user. Through Open OnDemand, users can upload and download files, create, edit, submit and monitor jobs, create and share apps, run GUI applications and connect to a terminal, all via a web browser, with no client software to install and configure. The Open XDMoD portal provides a rich set of features, which are tailored to the role of the user. Sample metrics provided by Open XDMoD include: number of jobs, CPUs consumed, wait time, and wall time, with minimum, maximum and the average of these metrics. Performance and quality of service metrics of the HPC infrastructure are also provided, along with application specific performance metrics (flop/s, IO rates, network metrics, etc) for all user applications running on a given resource.
1212

1313

1414
## Tutorial Steps
@@ -17,8 +17,8 @@ This tutorial aims to demonstrate how three open source applications work in con
1717
[Getting Started](docs/getting_started.md)
1818
[Accessing the Applications](docs/applications.md)
1919
[ColdFront](/coldfront/README.md)
20+
[Open OnDemand](/ondemand/README.md)
2021
[Open XDMoD](/xdmod/README.md)
21-
[OnDemand](/ondemand/README.md)
2222

2323
[Acknowledgments](docs/acknowledgments.md)
2424

@@ -37,7 +37,7 @@ This [overview of HPC Toolset Tutorial](https://www.youtube.com/watch?v=9Nf1Guca
3737

3838
## Disclaimer
3939

40-
DO NOT run this project on production systems. This project is for educational
40+
**DO NOT run this project on production systems.** This project is for educational
4141
purposes only. The container images we publish for the tutorial are configured
4242
with hard coded insecure passwords and should be run locally in development for
4343
testing and learning only.

docs/containers_images.PNG

-25.7 KB
Loading

docs/docker_tips.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,14 +11,14 @@ $ git clone https://github.com/ubccr/hpc-toolset-tutorial.git
1111
$ cd hpc-toolset-tutorial
1212
```
1313

14-
Ensure you have pulled all the latest changes. This is very important as lots
14+
If you have previously cloned the repo, pull all the latest changes. This is very important as lots
1515
has changed from previous years:
1616

1717
```
1818
$ git pull
1919
```
2020

21-
This step is optional, only run this if you've previosly run our tutorial and
21+
This step is optional: only run this if you've previously run our tutorial and
2222
need to remove any old containers, volumes, and images. You can also run this
2323
if you need to start completely fresh. NOTE: this will delete all the hpcts
2424
container images and you will need to re-download them:
@@ -35,7 +35,7 @@ $ ./hpcts start
3535

3636
### If something goes wrong...
3737

38-
First, thing to try is stopping the containers, removing the volumes and re-starting:
38+
First thing to try is stopping the containers, removing the volumes and re-starting:
3939

4040
```
4141
$ ./hpcts destroy
@@ -46,7 +46,7 @@ $ ./hpcts start
4646

4747
- [Docker](https://docs.docker.com)
4848
- [Install & Start Docker](https://docs.docker.com/engine/install/)
49-
- [Linux & WSL](https://docs.docker.com/engine/install/linux-postinstall/)
49+
- [Linux & Windows Subsystem for Linux](https://docs.docker.com/engine/install/linux-postinstall/)
5050
- [MacOS Docker Desktop](https://docs.docker.com/docker-for-mac/troubleshoot/)
5151

5252
### Helpful Docker commands
@@ -59,6 +59,7 @@ $ docker compose up -d
5959
$ docker compose logs -f
6060
$ docker compose logs -f coldfront
6161
$ docker compose logs -f xdmod
62+
$ docker compose logs -f ondemand
6263
6364
# Stop containers
6465
$ docker compose stop

0 commit comments

Comments
 (0)