summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSofia Wallin <sofia.wallin@ericsson.com>2016-01-12 16:12:35 +0100
committerSofia Wallin <sofia.wallin@ericsson.com>2016-01-12 16:15:05 +0100
commitc7f20d6f115677bd3965d484667eb654be5104c9 (patch)
treebb53f4a0b22095cbce560f666c0aafb15b794c35
parent1d0d7b0d1a9eeaa3d6c9f17aec1d1907e8fe6bff (diff)
Added templates for feature configuration description/reference
The featureconfig.rst document should be used to describe the configuration of the <XYZ> feature. The content will be added to the Brahmaputra configuration guide which intends to describe how to configure the Brahmaputra release to a stable and ready state For feature projects this should refer to the use of deployment tool scenario selections and post deployment configuration specific to the feature. Also added is the postinstall.rst document for features to describe how to check and analyze the result of test cases for respective feature. Change-Id: Idf700026792efb2dfd9b72fe5dd49e605e41a84a Signed-off-by: Sofia Wallin <sofia.wallin@ericsson.com>
-rw-r--r--docs/configguide/featureconfig.rst24
-rw-r--r--docs/configguide/postinstall.rst26
2 files changed, 50 insertions, 0 deletions
diff --git a/docs/configguide/featureconfig.rst b/docs/configguide/featureconfig.rst
new file mode 100644
index 0000000..9189902
--- /dev/null
+++ b/docs/configguide/featureconfig.rst
@@ -0,0 +1,24 @@
+<Project> configuration
+=======================
+Add a brief introduction to configure OPNFV with this specific feature including
+dependancies on platform components, this description should be at a level that
+will apply to any installer providing the pre-requisite components.
+
+Pre-configuration activities
+----------------------------
+Describe specific pre-configuration activities. This should include ensuring the
+right components are installed by the installation tools as required for your
+feature to function. Refer to the previous installer configuration chapters,
+installations guide and release notes
+
+Hardware configuration
+----------------------
+Describe the hardware configuration needed for this specific feature
+
+Feature configuration
+---------------------
+Describe the procedures to configure your feature on the platform in order
+that it is ready to use according to the feature instructions in the platform
+user guide. Where applicable you should add content in the postinstall.rst
+to validate the feature is configured for use.
+(checking components are installed correctly etc...)
diff --git a/docs/configguide/postinstall.rst b/docs/configguide/postinstall.rst
new file mode 100644
index 0000000..1702cea
--- /dev/null
+++ b/docs/configguide/postinstall.rst
@@ -0,0 +1,26 @@
+<Project> post installation procedures
+======================================
+Add a brief introduction to the methods of validating the installation
+according to this specific installer or feature.
+
+Automated post installation activities
+--------------------------------------
+Describe specific post installation activities performed by the OPNFV
+deployment pipeline including testing activities and reports. Refer to
+the relevant testing guides, results, and release notes.
+
+note: this section should be singular and derived from the test projects
+once we have one test suite to run for all deploy tools. This is not the
+case yet so each deploy tool will need to provide (hopefully very simillar)
+documentation of this.
+
+<Project> post configuration procedures
+--------------------------------------
+Describe any deploy tool or feature specific scripts, tests or procedures
+that should be carried out on the deployment post install and configuration
+in this section.
+
+Platform components validation
+---------------------------------
+Describe any component specific validation procedures necessary for your
+deployment tool in this section.