diff --git a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/.pages.yml b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/.pages.yml index e6993043c..0651adb00 100644 --- a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/.pages.yml +++ b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/.pages.yml @@ -5,3 +5,4 @@ nav: - ... - changes_from_jupyter_on_nesi.md - Release Notes: Release_Notes + - Known Issues: known_issues diff --git a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/Release_Notes/index.md b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/Release_Notes/index.md index a6ba43acf..891c333ec 100644 --- a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/Release_Notes/index.md +++ b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/Release_Notes/index.md @@ -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. @@ -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 [support@nesi.org.nz](mailto:support@nesi.org.nz) 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 [support@nesi.org.nz](mailto:support@nesi.org.nz) 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 [support@nesi.org.nz](mailto:support@nesi.org.nz) 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. diff --git a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/index.md b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/index.md index 47a66e63f..2dc907e9d 100644 --- a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/index.md +++ b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/index.md @@ -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). diff --git a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/known_issues/index.md b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/known_issues/index.md new file mode 100644 index 000000000..66eee9c31 --- /dev/null +++ b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/known_issues/index.md @@ -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 [support@nesi.org.nz](mailto:support@nesi.org.nz). + +# 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 [support@nesi.org.nz](mailto:support@nesi.org.nz) 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 [support@nesi.org.nz](mailto:support@nesi.org.nz) 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. + diff --git a/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/Release_Notes/restart_web_server.png b/docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/known_issues/restart_web_server.png similarity index 100% rename from docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/Release_Notes/restart_web_server.png rename to docs/Scientific_Computing/Interactive_computing_with_NeSI_OnDemand/known_issues/restart_web_server.png