Skip to content

Commit

Permalink
move ondemand known issues to separate page (#398)
Browse files Browse the repository at this point in the history
  • Loading branch information
chrisdjscott authored Nov 20, 2024
2 parents 2ccf0f4 + 87ff031 commit b4d1042
Show file tree
Hide file tree
Showing 5 changed files with 52 additions and 47 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,4 @@ nav:
- ...
- changes_from_jupyter_on_nesi.md
- Release Notes: Release_Notes
- Known Issues: known_issues
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,6 @@ It required work on K8s autoscaling and FreeIPA updates for auto-enrollment. Fur
- Hosted on public URL: [https://ondemand.nesi.org.nz/](https://ondemand.nesi.org.nz/)
- Minor UX improvements

### Known issues

- Users with dot in the name not yet supported



## 0.2.0 - initial internal release

NeSI OnDemand is NeSI’s new offering for providing researchers with access to JupyterLab and RStudio. We are adopting Open OnDemand technology, which enables us to build and extend the catalogue of web based applications.
Expand Down Expand Up @@ -57,46 +51,10 @@ This is our first release to a group of early access users for feedback around N
* NeSI is adopting a new Tuakiri based single sign on process for logging in to all NeSI services. This will mean that you won’t have to set up a separate NeSI account and password in order to be able to access NeSI services in the future.
* To ensure the security of our system, we have an additional OTP (one-time password) that is enforced on top of your institutional login. Over time, we will smooth out the user experience for setting this up and the frequency of having to enter the OTP.

### Current known issues

#### Link to mahuika filesystem

This release is an ephemeral environment for gathering feedback around the system therefore we have not linked it with your research data on Mahuika/Maui. Any data stored on the system during this early test phase may disappear at any point.

#### "You are already logged in" message

If you have a browser session of NeSI OnDemand that is older than ~3 hours, and try to log back into the system, you may encounter a message saying “You are already logged in” without any actionable button. This is a known bug, and for now you would need to go back to the NeSI OnDemand URL ([https://ondemand.nesi.org.nz/](https://ondemand.nesi.org.nz/)) and you will arrive on the correct landing page.

#### User accounts with dots in the username

If you have an existing NeSI account with a dot as a part of your Linux username, there is a known bug with Open OnDemand and Kubernetes which prevents us from initiating some application. Currently RStudio has this issue and we are working on a fix.

#### Token expiry

This is another known bug where the back-end system token isn’t refreshed correctly after timeouts. If you run into error messages while trying to launch an app, you can resolve this by logging out of NeSI OnDemand, logging back in again and then clicking on Help button at the top right and selecting Restart Web Server.

[![restart_web_server](restart_web_server.png)](restart_web_server.png)

#### "Error -- can't find user for …" messages

If you see this message after logging in, please reach out to us at [[email protected]](mailto:[email protected]) and we will be able to fix this problem.

#### UX, wording, information display

Due to this environment being our test build, you may encounter many internal technical terms that will be addressed through future iterations.

#### User home folder default content

Pre-populated with [Desktop Documents Downloads Music Pictures Public Templates Videos] folders, which is different to NeSI default.

#### User home folder permissions

Everybody seems to have read/execute access to all home folders.

### Where to log tickets and give feedback
!!! Note

We are in the early process of iterating and improving NeSI OnDemand. If you see any issues or suggestions, please let us know.
We are in the early process of iterating and improving NeSI OnDemand. If you see any issues or suggestions, please let us know.

- Please e-mail us on [[email protected]](mailto:[email protected]) with NeSI OnDemand as a part of the subject line and we will get back to you ASAP
- Given that this is an early release, the SLA will not follow NeSI standard SLA (9am-5pm working days), and the environment may not be as stable as the production environment. We will support you with the best effort.
- Please e-mail us on [[email protected]](mailto:[email protected]) with NeSI OnDemand as a part of the subject line and we will get back to you ASAP
- Given that this is an early release, the SLA will not follow NeSI standard SLA (9am-5pm working days), and the environment may not be as stable as the production environment. We will support you with the best effort.

Original file line number Diff line number Diff line change
Expand Up @@ -27,5 +27,5 @@ A number of interactive applications can be accessed through NeSI OnDemand, incl

## Release notes

Release notes can be found [here](Release_Notes/index.md) and the main differences
Release notes can be found [here](Release_Notes/index.md), known issues [here](known_issues/index.md) and the main differences
compared to our Jupyter on NeSI service are described [here](changes_from_jupyter_on_nesi.md).
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
!!! Note
ondemand is in development and accessible to early access users only.
If you are interested in helping us test it please contact us at [[email protected]](mailto:[email protected]).

# NeSI OnDemand Known Issues

This page contains a list of known issues with NeSI OnDemand, if any.

## Token expiry

This is another known bug where the back-end system token isn’t refreshed correctly after timeouts. If you run into error messages while trying to launch an app, you can resolve this by logging out of NeSI OnDemand, logging back in again and then clicking on Help button at the top right and selecting Restart Web Server.

[![restart_web_server](restart_web_server.png)](restart_web_server.png)

## Filesystem synchronisation

Your data will have been copied from Mahuika into the OnDemand environment. However, any changes made in OnDemand will not be synchronised back to Mahuika.

## "You are already logged in" message

If you have a browser session of NeSI OnDemand that is older than ~3 hours, and try to log back into the system, you may encounter a message saying “You are already logged in” without any actionable button. This is a known bug, and for now you would need to go back to the NeSI OnDemand URL ([https://ondemand.nesi.org.nz/](https://ondemand.nesi.org.nz/)) and you will arrive on the correct landing page.

## User accounts with dots in the username

If you have an existing NeSI account with a dot as a part of your Linux username, there is a known bug with Open OnDemand and Kubernetes which prevents us from initiating some application. Currently RStudio has this issue and we are working on a fix.

## "Error -- can't find user for …" messages

If you see this message after logging in, please reach out to us at [[email protected]](mailto:[email protected]) and we will be able to fix this problem.

## UX, wording, information display

Due to this environment being our test build, you may encounter many internal technical terms that will be addressed through future iterations.

## User home folder default content

Pre-populated with [Desktop Documents Downloads Music Pictures Public Templates Videos] folders, which is different to NeSI default.


!!! Note

We are in the early process of iterating and improving NeSI OnDemand. If you see any issues or suggestions, please let us know.

- Please e-mail us on [[email protected]](mailto:[email protected]) with NeSI OnDemand as a part of the subject line and we will get back to you ASAP
- Given that this is an early release, the SLA will not follow NeSI standard SLA (9am-5pm working days), and the environment may not be as stable as the production environment. We will support you with the best effort.

0 comments on commit b4d1042

Please sign in to comment.