aboutsummaryrefslogtreecommitdiffstats
path: root/docs/state/user/userguide.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/state/user/userguide.rst')
-rw-r--r--docs/state/user/userguide.rst20
1 files changed, 15 insertions, 5 deletions
diff --git a/docs/state/user/userguide.rst b/docs/state/user/userguide.rst
index ef95584..17470d8 100644
--- a/docs/state/user/userguide.rst
+++ b/docs/state/user/userguide.rst
@@ -2,11 +2,12 @@
SDVState User Guide
====================
-Currently, SDVState supports validation of Airship 1.7. Before running checks you need two files:
- - kubeconfig file which gives access to clusterAPI of Airship cluster.
- - PDF(Pod Descriptor File) of the current Airship deployment.
+Currently, SDVState supports validation of Airship 1.7 and Kuberef, Kuberef, a reference implementation according to the CNTT RA-2. Before running checks you need two files:
+ - kubeconfig file which gives access to clusterAPI of the cluster.
+ - PDF(Pod Descriptor File) of the current the deployment.
-Create a config file of SDVState using the above files as values. Look at example conf-file at sdv/docker/sdvstate/example/state.yml
+To choose between Airship and Kuberef, you need to specify the installer using "installer_used" field in the PDF of your deployment, it can either "airship" or "kuberef".
+You also need to create a config file of SDVState using the above files as values. Look at example conf-file at sdv/docker/sdvstate/settings/state.yml
To run checks use command:
@@ -19,4 +20,13 @@ After running checks, you can find all results at ``/tmp`` directory by default.
SDVState uses default settings stored at sdv/docker/sdvstate/settings. We can override default settings by adding those in our conf-file.
To view help and all available options with the SDVState tool check help command:
- ``./state --help`` \ No newline at end of file
+ ``./state --help``
+
+ For properly running validation on kuberef, we need some additions to the PDF file. Take a look at the PDF file at sdv/docker/sdvstate/settings/PDF.json
+
+ We need to add following entries in the "vim_functional" field of PDF to make the validation work properly.
+
+ - cpu_manager_policy: It includes the details about the cpu manager policy and it is important for the policy_checks
+ - topo_manager_policy: It includes the details about the topology manager policy and it is important for the policy_checks
+ - cnis_supported: It includes list of cnis supported by the cluster and it is important for the cni_plugin_check.
+