diff --git a/docs/qa.md b/docs/qa.md index 20745f29..ab2907ea 100644 --- a/docs/qa.md +++ b/docs/qa.md @@ -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 @@ -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: @@ -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 @@ -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. @@ -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.