diff options
author | Jonathan Maw <jonathan.maw@codethink.co.uk> | 2012-08-01 10:22:54 +0100 |
---|---|---|
committer | Jannis Pohlmann <jannis.pohlmann@codethink.co.uk> | 2012-08-02 16:17:42 +0100 |
commit | bb96c5209f5acdde59aed7d68804134df772738d (patch) | |
tree | 49dc65b927975222e0905c9b6359b57b23622607 | |
parent | 1cefe8ead4276dd027c9ca8d93818f4a765816fe (diff) | |
download | node-startup-controller-bb96c5209f5acdde59aed7d68804134df772738d.tar.gz |
Add testing skeleton
Lays out the structure of the test document XML
-rw-r--r-- | docs/reference/node-startup-controller/node-startup-controller-docs.xml | 26 | ||||
-rw-r--r-- | docs/reference/node-startup-controller/test-example.xml | 51 |
2 files changed, 74 insertions, 3 deletions
diff --git a/docs/reference/node-startup-controller/node-startup-controller-docs.xml b/docs/reference/node-startup-controller/node-startup-controller-docs.xml index 311799b..9d8b6ae 100644 --- a/docs/reference/node-startup-controller/node-startup-controller-docs.xml +++ b/docs/reference/node-startup-controller/node-startup-controller-docs.xml @@ -81,9 +81,29 @@ <sect1> <title>Installing</title> </sect1> - <sect1> - <title>Testing</title> - </sect1> + <refentry> + <refmeta><refentrytitle>Testing</refentrytitle></refmeta> + <refnamediv> + <refname>Testing</refname> + <refpurpose> + Instructions on how to test the Node Startup Controller + </refpurpose> + </refnamediv> + + <refsection> + <title>Example tests</title> + <xi:include href="test-example.xml"/> + </refsection> + <refsection> + <title>Last User Context management tests</title> + </refsection> + <refsection> + <title>Legacy App Handling tests</title> + </refsection> + <refsection> + <title>Target Startup Monitoring tests</title> + </refsection> + </refentry> </chapter> <chapter> diff --git a/docs/reference/node-startup-controller/test-example.xml b/docs/reference/node-startup-controller/test-example.xml new file mode 100644 index 0000000..59ab2a5 --- /dev/null +++ b/docs/reference/node-startup-controller/test-example.xml @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ +]> + +<refsection id="test-example"> + <title> Example test</title> + <para> + An example of how tests should be structured + </para> + + <refsection> + <title>Test environment and setup</title> + <para> + Automated testing isn't possible. To make things easier, we have code snippets which + can be copied exactly, to get the required result. + <programlisting> + cp /lib/systemd/system/{graphical,focussed}.target + systemctl start boot-manager.target + </programlisting> + </para> + </refsection> + + <refsection> + <title>Test Overview</title> + <para> + A broad explanation of the different test cases in the scenario, i.e. + <itemizedlist> + <listitem>Add a shutdown client</listitem> + <listitem>Tell the shutdown client to shut down</listitem> + </itemizedlist> + </para> + </refsection> + + <refsection> + <title>Test steps</title> + <para> + Add a shutdown client + <orderedlist> + <listitem><programlisting>/usr/local/lib/boot-manager-1/legacy-app-handler -u cups.service -m 1</programlisting></listitem> + <listitem>Check the DLT log for appropriate output</listitem> + </orderedlist> + Tell the shutdown client to shut down + <orderedlist continuation="continues"> + <listitem><programlisting>kill -HUP $(pidof nsm-dummy)</programlisting></listitem> + <listitem>Check the DLT log for appropriate output</listitem> + </orderedlist> + </para> + </refsection> + +</refsection> |