update docs

eth-cscs · Jun 16, 2024 · 5a50c1e · 5a50c1e
1 parent 3b55f3a
commit 5a50c1e
Show file tree

Hide file tree

Showing 4 changed files with 26 additions and 9 deletions.
diff --git a/docs/migration.md b/docs/migration.md
@@ -1,10 +1,10 @@
 # Migration
 
+??? info "**WIP**"
+    This is work in progress
+
 Operations to migrate clusters. Cluster migration includes operations like:
 
 - Upscale hardware resources
 - Downscale hardware resources
 - Move compute nodes and configure them across different sites
-
-??? info "**WIP**"
-    This is work in progress
diff --git a/docs/qa.md b/docs/qa.md
@@ -23,3 +23,20 @@ manta is locked to cluster `adula`, therefore it will ignore other cluster's inf
 Q: I have clusters in different sites/systems/locations. How can I `manta` to be aware of this?
 
 Q: How can I tell manta to switch from one `site` to another?
+
+Q: I have been given access to a new cluster, however I can't see it.
+
+A: The user authentication token keeps the number of clusters the user has access to. Any changes related to the user access needs a token refresh. To do this run the following commands:
+
+Delete token for the site hosting the cluster the user needs access to
+
+```bash
+manta config unset auth
+Please chose the site token to delete from the list below:
+> prealps_auth
+  alps_auth
+```
+
+Select the site which auth token needs to be deleted (eg prealps_auth)
+
+Manta will ask the user to authenticate upon the next operation against `prealps`, if authentication is successful, then the user should receive a new token with the new list of cluster he has access to this site/system
diff --git a/docs/security.md b/docs/security.md
@@ -1,10 +1,10 @@
 # Security
 
+??? info "**WIP**"
+    This is work in progress
+
 Manta validates the users command against the information in their JWT authentication token.
 
 If the user tries to submit an operation against a cluster or node that does not have access, then the operation will fail.
 
 Discuss about how manta uses the JWT auth token to restrict user actions
-
-??? info "**WIP**"
-    This is work in progress
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
@@ -1,5 +1,8 @@
 # Troubleshooting
 
+??? info "**WIP**"
+    This is work in progress
+
 List most common errors when using manta
 
 - Error with configuration file
@@ -8,6 +11,3 @@ List most common errors when using manta
 - Error when processing SAT files:
   - Error when having `-` in variable files because the jinja template engine will process it as a math operator
   - Error when a value is not found in vars file
-
-??? info "**WIP**"
-    This is work in progress