Add Testing chapter
authorCarlos Hernandez <ceh@ti.com>
Wed, 29 May 2013 15:59:41 +0000 (11:59 -0400)
committerCarlos Hernandez <ceh@ti.com>
Wed, 29 May 2013 16:01:14 +0000 (12:01 -0400)
Signed-off-by: Carlos Hernandez <ceh@ti.com>
main.tex
testing.tex [new file with mode: 0644]

index 238512945e9395cc55e94d62e9fae1a14ebcf50e..80abd199ede9c4c89b6203f05a387b9edc5b40b7 100644 (file)
--- a/main.tex
+++ b/main.tex
@@ -72,6 +72,7 @@
 \input{work-breakdown.tex}
 \input{estimating.tex}
 \input{definition-of-done.tex}
+\input{testing.tex}
 
 \nocite{*}
 \bibliographystyle{alpha}
diff --git a/testing.tex b/testing.tex
new file mode 100644 (file)
index 0000000..57ff360
--- /dev/null
@@ -0,0 +1,99 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%\r
+%% %%\r
+%% Copyright (C) 2013 Texas Instruments Incorporated - http://www.ti.com %%\r
+%% %%\r
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%\r
+\chapter{Testing}\r
+\label{chap:lcpd-tests}\r
+\r
+\paragraph{}\r
+As was discussed in chapter \ref{chap:definition-of-done}, a backlog item \r
+must be \textbf{tested} and the test code should be \textbf{submitted} to\r
+system test before we can call the backlog item done.\r
+\r
+\section{Test Code}\r
+\paragraph{}\r
+LCPD's core-sdk filesystem must be used for kernel testing. LCPD's core-sdk \r
+image comes with various test-related applications pre-installed:\r
+\begin{enumerate}\r
+    \item ltp-ddt\r
+    \item iperf\r
+    \item bonnie++ \r
+    \item hdparm\r
+    \item iozone3\r
+    \item lmbench\r
+    \item rt-tests\r
+    \item evtest\r
+    \item libdrm-tests\r
+    \item and others...\r
+\end{enumerate}\r
+So users are encouraged to check if there is already a test case or test \r
+utility available in the core-sdk filesystem before they start developing a new one.\r
+\r
+\subsection{Submitting test code}\r
+\label{sec:sub-test-code}\r
+\paragraph{}\r
+The preferred way to submit test code to system test is to submit ltp-ddt patches to\r
+opentest@arago-project.org mailing list.  \r
+\paragraph{}\r
+Alternatively, LCPD team members can request help from systest to productize their\r
+test code by creating a test task (i.e. \textit{add test} functionality) in VersionOne.\r
+\paragraph{}\r
+Once a test have been submitted, the systest team will take care of integrating it\r
+into Opentest.\r
+\r
+\subsection{LTP-DDT}\r
+\label{sec:ltp-ddt}\r
+\r
+\subsection{Getting LTP-DDT}\r
+\paragraph{}\r
+There are couple of ways to get LTP-DDT sources:\r
+\begin{enumerate}\r
+    \item Clone it from http://arago-project.org/git/projects/test-automation/ltp-ddt.git\r
+    \item Use \textit{linux-devtest.py -U} to get it cloned automatically\r
+\end{enumerate}\r
+\r
+\subsection{Creating new LTP-DDT tests}\r
+\paragraph{}\r
+The recommended LTP-DDT development flow is to clone ltp-ddt, build and install it\r
+on a nfs filesystem, so you can quickly check your LTP-DDT changes on a real target.\r
+You can get a core-sdk filesystem tarball that you can use to setup your nfs at\r
+\href{http://lcpd.dal.design.ti.com/core-sdk/}{LCPD core sdk}\r
+\r
+\paragraph{}\r
+Please refer to \href{http://arago-project.org/git/projects/?p=test-automation/ltp-ddt.git;a=blob;f=README-DDT#l19}{LTP-DDT README} sections 3 and 4 for detailed information about creating new LTP-DDT tests.\r
+\r
+\paragraph{}\r
+Please refer to \href{http://arago-project.org/git/projects/?p=test-automation/ltp-ddt.git;a=blob;f=README-DDT#l163}{LTP-DDT README} sections 6 and 7 for LTP-DDT build instructions.\r
+\r
+\subsection{Running LTP-DDT tests}\r
+\paragraph{}\r
+Please refer to \href{http://arago-project.org/git/projects/test-automation/ltp-ddt.git?p=projects/test-automation/ltp-ddt.git;a=blob;f=README-DDT;#l223}{LTP-DDT README} section 8.\r
+\r
+\section{Test Automation Frameworks}\r
+\subsection{Opentest}\r
+\label{sec:Opentest}\r
+\paragraph{}\r
+\href{http://arago-project.org/wiki/index.php/Opentest}{Opentest} test automation\r
+framework is used to manage test plans, test results, test hardware and test \r
+execution.\r
+\r
+\paragraph{}\r
+You don't need Opentest to develop LTP-DDT test cases. You don't need Opentest \r
+either to run LTP-DDT tests. However, you will need Opentest if you:\r
+\begin{enumerate}\r
+  \item want to run tests on boards that you don't have.\r
+  \item want to run complex tests that require test equipment.\r
+  \item want to run testplans defined in Testlink\r
+  \item want to store results in Testlink\r
+  \item want to request multiple test runs and don't want to baby-sit them, you just want to \textbf{Click-and-Forget}\r
+\end{enumerate}\r
+\r
+\subsection{Installing Opentest}\r
+\paragraph{}\r
+Check \href{http://arago-project.org/wiki/index.php/OpentestOtherSrvLinuxDevtest}{Opentest Installation}\r
+\paragraph{}\r
+\textbf{IMPORTANT:} Typical LCPD users should not install complete Opentest framework\r
+in their desktop but instead we recommend just installing Options 2 (Staf) and\r
+8 (Command Line Tools).\r
+\r