Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Manuel Sopena Ballesteros committed Jun 18, 2024
1 parent 6049915 commit e9b6419
Showing 1 changed file with 10 additions and 3 deletions.
13 changes: 10 additions & 3 deletions docs/qa.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Q&A

??? info "**WIP**"
This is work in progress

!!! question "What should we put here?"
- List most common questions when using manta (eg: like a howto guide)
- Don't put errors here
Expand All @@ -22,6 +19,8 @@ Parent HSM: nodes_free
```
manta is locked to cluster `adula`, therefore it will ignore other cluster's information, to remove this property run command `manta config unset hsm`

---

**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:
Expand All @@ -39,6 +38,8 @@ 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

---

**Q: My sessions are failing due to an error while running ansible playbook. How can Iinteractively run my ansible outside the management plane?**

**A:** You can start an `ephemeral session`, ephemeral sessions tries to replicate the host targeting the ansible playbook started by the session. To start an ephemeral environment run the following command
Expand All @@ -65,10 +66,14 @@ Have a lot of fun...
cray-ims-1eff1535-c13c-4d21-ba3f-0c852abd713b-customize-xxl7f:/root #
```
---
**Q: How can I add a new site to manta?**
**A:** Each site needs to be included in your [configuration file](configuration.md) under the `sites` section. Please get in contact with an Alps administrator to help you configuring a new site since manta needs to know the APIs to talk to.
---
**Q: How can I list the number of sites `site` I have available?**
**A:** To check all sites available, please run the command below.
Expand All @@ -77,6 +82,8 @@ cray-ims-1eff1535-c13c-4d21-ba3f-0c852abd713b-customize-xxl7f:/root #
manta config show
```
---
**Q: How can I tell manta to switch from one `site` to another?**
**A:** To tell manta to talk to `site name` please run the command below.
Expand Down

0 comments on commit e9b6419

Please sign in to comment.