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 16, 2024
1 parent e6625e8 commit 7864bc6
Showing 1 changed file with 14 additions and 9 deletions.
23 changes: 14 additions & 9 deletions docs/qa.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,23 +5,24 @@

List most common questions when using manta (don't put errors here)

Q: `manta get ...` only shows information of 1 cluster, I am missing other clusters data
**Q: `manta get ...` only shows information of 1 cluster, I am missing other clusters data**

A: make sure manta is not locked to a cluster, run `manta config show` and make sure there is no `Current HSM` value.
**A:** make sure manta is not locked to a cluster, run `manta config show` and make sure there is no `Current HSM` value.

In this example:
```bash
$ manta config show
manta config show
Sites: ["prealps", "alps", "alpsm"]
Current site: alps
HSM available: ["adula", "alps", "burst", "burst_gh", "burst_mc", "eiger", "fora", "nodes_free", "psidev", "psidev_cn", "psidev_uan", "psitds", "psitds_cn", "psitds_uan", "zinal", "zinal_cta", "zinal_moleson_tds", "zinal_tds", "zinal_zinal"]
Current HSM: adula
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:
**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

Expand All @@ -36,9 +37,9 @@ 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 erro while running ansible playbook. How can Iinteractively run my ansible outside the management plane?
**Q: My sessions are failing due to an erro 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
**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

```bash
$ manta apply ephemeral-environment --image-id 4bf91021-8d99-4adf-945f-46de2ff50a3d
Expand All @@ -62,12 +63,16 @@ Have a lot of fun...
cray-ims-1eff1535-c13c-4d21-ba3f-0c852abd713b-customize-xxl7f:/root #
```
Q: I have clusters in different sites/systems/locations. How can I `manta` to be aware of this?
**Q: I have clusters in different sites/systems/locations. How can I `manta` to be aware of this?**
**A:**
??? info "**WIP**"
This is work in progress
Q: How can I tell manta to switch from one `site` to another?
**Q: How can I tell manta to switch from one `site` to another?**
**A:**
??? info "**WIP**"
This is work in progress
Expand Down

0 comments on commit 7864bc6

Please sign in to comment.