summaryrefslogtreecommitdiffstats
path: root/notFinishedCode/Report
diff options
context:
space:
mode:
authorRefik Hadzialic2011-10-25 19:56:31 +0200
committerRefik Hadzialic2011-10-25 19:56:31 +0200
commit3162830d73e5b452944c18ef06363072d8012bb8 (patch)
tree42a8e198add2e994505f1624f38d7d3bf30c8115 /notFinishedCode/Report
parentReport writing (diff)
downloadgsm-selftest-3162830d73e5b452944c18ef06363072d8012bb8.tar.gz
gsm-selftest-3162830d73e5b452944c18ef06363072d8012bb8.tar.xz
gsm-selftest-3162830d73e5b452944c18ef06363072d8012bb8.zip
Report writing
Diffstat (limited to 'notFinishedCode/Report')
-rw-r--r--notFinishedCode/Report/test.aux8
-rw-r--r--notFinishedCode/Report/test.log10
-rw-r--r--notFinishedCode/Report/test.pdfbin1457495 -> 1458470 bytes
-rw-r--r--notFinishedCode/Report/test.tex13
-rw-r--r--notFinishedCode/Report/test.tex.backup72
-rw-r--r--notFinishedCode/Report/test.tex~13
-rw-r--r--notFinishedCode/Report/test.toc6
7 files changed, 88 insertions, 34 deletions
diff --git a/notFinishedCode/Report/test.aux b/notFinishedCode/Report/test.aux
index 8787d8d..cf2c849 100644
--- a/notFinishedCode/Report/test.aux
+++ b/notFinishedCode/Report/test.aux
@@ -78,15 +78,15 @@
\@writefile{toc}{\contentsline {subsection}{\numberline {9.1}Required software and libraries}{31}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.1}Python installation}{31}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.2}Apache Web server installation}{31}}
-\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.3}MySQL database and MySQL library}{31}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.3}MySQL database and MySQLdb library}{31}}
\citation{pChart}
\citation{proctitle}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.4}Serial port library}{32}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.5}PJSUA library}{32}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.6}pChart library}{32}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.1.7}proctitle library}{32}}
-\@writefile{toc}{\contentsline {subsection}{\numberline {9.2}Configuring hardware}{32}}
-\@writefile{toc}{\contentsline {section}{\numberline {10}Conclusion}{33}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {9.2}Configuring hardware}{33}}
+\@writefile{toc}{\contentsline {section}{\numberline {10}Conclusion}{34}}
\bibcite{network}{1}
\bibcite{python}{2}
\bibcite{mysqlManual}{3}
@@ -98,4 +98,4 @@
\bibcite{pChart}{9}
\bibcite{beagleDataSheet}{10}
\bibcite{proctitle}{11}
-\newlabel{LastPage}{{}{34}}
+\newlabel{LastPage}{{}{35}}
diff --git a/notFinishedCode/Report/test.log b/notFinishedCode/Report/test.log
index 81c31b5..f9b021b 100644
--- a/notFinishedCode/Report/test.log
+++ b/notFinishedCode/Report/test.log
@@ -1,4 +1,4 @@
-This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) (format=pdflatex 2011.9.27) 25 OCT 2011 19:40
+This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) (format=pdflatex 2011.9.27) 25 OCT 2011 19:56
entering extended mode
%&-line parsing enabled.
**test.tex
@@ -403,8 +403,8 @@ LaTeX Font Info: Font shape `OMS/cmr/m/n' in size <9> not available
<resultsImage.png, id=132, 702.625pt x 431.6125pt>
File: resultsImage.png Graphic file (type png)
<use resultsImage.png>
-[30 <./resultsImage.png (PNG copy)>] [31] [32] [33]
-AED: lastpage setting LastPage [34] (./test.aux) )
+[30 <./resultsImage.png (PNG copy)>] [31] [32] [33] [34]
+AED: lastpage setting LastPage [35] (./test.aux) )
Here is how much of TeX's memory you used:
4949 strings out of 495061
68803 string characters out of 1182621
@@ -427,9 +427,9 @@ ur/jknappen/ec/ecsx1440.600pk> </home/refik/.texmf-var/fonts/pk/ljfour/jknappen
sr/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi10.pfb></usr/share/te
xmf-texlive/fonts/type1/public/amsfonts/cm/cmsy10.pfb></usr/share/texmf-texlive
/fonts/type1/public/amsfonts/cm/cmsy9.pfb>
-Output written on test.pdf (34 pages, 1457495 bytes).
+Output written on test.pdf (35 pages, 1458470 bytes).
PDF statistics:
- 738 PDF objects out of 1000 (max. 8388607)
+ 741 PDF objects out of 1000 (max. 8388607)
0 named destinations out of 1000 (max. 500000)
96 words of extra memory for PDF output out of 10000 (max. 10000000)
diff --git a/notFinishedCode/Report/test.pdf b/notFinishedCode/Report/test.pdf
index d56efcd..2232be1 100644
--- a/notFinishedCode/Report/test.pdf
+++ b/notFinishedCode/Report/test.pdf
Binary files differ
diff --git a/notFinishedCode/Report/test.tex b/notFinishedCode/Report/test.tex
index 43295bb..14a0821 100644
--- a/notFinishedCode/Report/test.tex
+++ b/notFinishedCode/Report/test.tex
@@ -719,6 +719,7 @@ Our goal was to make a multiplatform test software, however we tested it only un
test software performed well, both on PC and MAC computers.
One should keep in mind that some of the libraries we had used do not work
under the 64 bit version of Linux OS.
+
\subsection{Required software and libraries}
In the next subsections, we will guide you how to install all the required software and
libraries to flawlessly run our test software on your employed server.
@@ -739,14 +740,18 @@ the \emph{root} password.
\subsubsection{Apache Web server installation}
We had decided to use the Apache web server because of its wide support on the internet
and safety reasons. If there are any bugs or security flaws, the patches are
-easily installed with the Ubuntu update manager.
+easily installed with the Ubuntu update manager. The Apache web server can be easily
+installed by typing the following command:
\begin{lstlisting}
sudo apt-get install apache2
\end{lstlisting}
+You might be required to follow other installation instructions printed on the
+terminal screen.
+After the installation has completed successfully, one can test if it works by going
+to the following web address: \emph{http://localhost}. For configuring the \emph{https}
+please go to the section 7.2.
-
-
-\subsubsection{MySQL database and MySQL library}
+\subsubsection{MySQL database and MySQLdb library}
The MySQLdb library is required to perform various operations on the MySQL database within
Python. We used the MySQLdb library instead of the native MySQL C API \emph{\_mysql} library
to make the code cleaner and more portable.
diff --git a/notFinishedCode/Report/test.tex.backup b/notFinishedCode/Report/test.tex.backup
index 3955e48..2e48780 100644
--- a/notFinishedCode/Report/test.tex.backup
+++ b/notFinishedCode/Report/test.tex.backup
@@ -185,7 +185,8 @@ depending on the test results. Error codes found in the \emph{ErrorCodeTable} ta
However, all the test tasks even after deleting them from \emph{TempTaskTable} are kept in the \emph{TaskTable}. The reason why the authors of this project divided it into two tables was because of the database row selection speed. We had made the assumption that with time the database size will grow and therefore the database speed will not be the same as during the development period.
\par The \emph{TaskTable} table, as mentioned before contains all the tests ever performed from the web site. It is made out of five attributes, \emph{taskID, taskNo, from, to, timestamp}. The first four fields are the same as in \emph{TempTaskTable}, however the last one, \emph{timestamp}, is used to record the exact time when the test was performed.
-
+\par The \emph{GSMListPrefix} table contains the data about the GSM networks and their prefixes. It consists of two
+attributes, both of varchar type, \emph{providerName} and \emph{prefix}.
\newpage
\section{Software design} % section 2.1
Software design was the next step after we analyzed the problem and developed a plan how to proceed further. Good analysis and planning with poor algorithmic implementation is valueless.
@@ -373,13 +374,7 @@ At the start we did not have a cable supplied for the Siemens S55 phone. We cont
\subsection{Cables for the cell phones}
Due to the fact that we had used 5 cell phones on a single computer, the best solution was to order 5 USB cables.
-Konrad bought 5 cables for 5 Sie\begin{itemize}
-\item Triangles represent BTS stations
-\item Cellphones represent the external networks (E-Plus, Vodaphone, T-Mobile and O2)
-\item Telephone represents the landline and a telephone with a mortarboard the University telephone network
-\item Servers represent the OpenBSC and LsfKs-Asterisk
-\item Two monitors represent the SIP system
-\end{itemize} mens S55 cell phones. All of the cables have an USB2Serial chip converter inside of them.
+Konrad bought 5 cables for 5 Siemens S55 cell phones. All of the cables have an USB2Serial chip converter inside of them.
Once they were plugged into the USB port, Ubuntu automatically recognized the cables and installed the drivers.
The virtual serial ports were created and could be found on \emph{/dev/ttyUSBx}, where $x$ is the automatically assigned number for the port.
Some of the cables had the capability to charge the Siemens S55 phones.
@@ -717,19 +712,47 @@ We use the pChart library\footnote{It is under the GNU GPLv3 license and our pro
\par On the right side of the result picture the test user can immediatelly identify the network operability in percentage\footnote{The test user has to take into account that this percantage is only valid if a full test is performed.}. Bellow the network operability statistics are the ping results statistics located.
If one of the fields is red it means the subsystem is not online or cannot be seen by our server computer where the test software is located.
\newpage
-\section{Employing the test system software}
+\section{Employing the test software system}
In this section the reader can find out how to install and how to use the test system.
Our goal was to make a multiplatform test software, however we tested it only under Ubuntu
11.04 32 bit Linux OS and the given instruction manual is only tested under that OS. The
test software performed well, both on PC and MAC computers.
One should keep in mind that some of the libraries we had used do not work
under the 64 bit version of Linux OS.
-\subsection{Required libraries}
-In the next subsections, we will guide you how to install all the required libraries
-to flawlessly run our test software on your employed server. You will be required to
-have \emph{root} access privileges and to open a new terminal window where the commands
-will be typed in.
-\subsubsection{MySQL library}
+\subsection{Required software and libraries}
+In the next subsections, we will guide you how to install all the required software and
+libraries to flawlessly run our test software on your employed server.
+You will be required to have \emph{root} access privileges and to open a new
+terminal window where the commands will be typed in.
+
+\subsubsection{Python installation}
+Python was our programming language of choice\footnote{We had explained earlier why we
+have decided to use Python.}. The required version of Python is 2.7. One can easily
+install python by typing the following commands:
+\begin{lstlisting}
+sudo apt-get update
+sudo apt-get install python2.7
+\end{lstlisting}
+It will take a short amount of time to be installed. You will be required to enter
+the \emph{root} password.
+
+\subsubsection{Apache Web server installation}
+We had decided to use the Apache web server because of its wide support on the internet
+and safety reasons. If there are any bugs or security flaws, the patches are
+easily installed with the Ubuntu update manager. The Apache web server can be easily
+installed by typing the following command:
+\begin{lstlisting}
+sudo apt-get install apache2
+\end{lstlisting}
+You might be required to follow other installation instructions printed on the
+terminal screen.
+After the installation has completed successfully, one can test if it works by going
+to the following web address: \emph{http://localhost}. For configuring the \emph{https}
+please go to the section 7.2.
+
+
+
+\subsubsection{MySQL database and MySQL library}
The MySQLdb library is required to perform various operations on the MySQL database within
Python. We used the MySQLdb library instead of the native MySQL C API \emph{\_mysql} library
to make the code cleaner and more portable.
@@ -764,7 +787,9 @@ sudo apt-get install python-serial
The installation should not produce any errors or warnings.
\subsubsection{PJSUA library}
-Tri needs to describe this!
+\emph{PJSUA} is an open source command line SIP user agent (softphone). We use the library
+for the SIP handler.
+Tri needs to describe installation steps!
\subsubsection{pChart library}
The pChart library is within our installation files and does not require to be installed
@@ -774,7 +799,19 @@ any licensing. However, if one needs to learn how the library works,
information can be found on the pChart web page \cite{pChart}.
\subsubsection{proctitle library}
+We had used this library to rename the currently executed process name.
+``The library allows a process to change its title (as displayed by system
+tools such as ps and top). Changing the title is mostly useful in
+multi-process systems, for example when a master process is forked:
+changing the children's title allows to identify the task each process is
+busy with.'' \cite{proctitle}. The library can be easily installed by typing:
+\begin{lstlisting}
+sudo easy_install setproctitle
+\end{lstlisting}
+
+
\subsection{Configuring hardware}
+
\newpage
\section{Conclusion}
@@ -815,6 +852,9 @@ Springer Verlag, Weizmann Institute of Science, Israel, ISBN: 978-1-84628-769-5,
\bibitem{beagleDataSheet} \emph{BeagleBoard System Reference Manual}, accessed on 20.06.2011, available at
\url{http://beagleboard.org/static/BBSRM_latest.pdf}.
+\bibitem{proctitle} \emph{setproctitle 1.1.2}, accessed on 20.10.2011, available at
+\url{http://pypi.python.org/pypi/setproctitle}.
+
%bibliography end
\end{thebibliography}
diff --git a/notFinishedCode/Report/test.tex~ b/notFinishedCode/Report/test.tex~
index 2204e28..9c21e80 100644
--- a/notFinishedCode/Report/test.tex~
+++ b/notFinishedCode/Report/test.tex~
@@ -736,14 +736,23 @@ sudo apt-get install python2.7
It will take a short amount of time to be installed. You will be required to enter
the \emph{root} password.
-\subsubsection{Apache web server installation}
+\subsubsection{Apache Web server installation}
+We had decided to use the Apache web server because of its wide support on the internet
+and safety reasons. If there are any bugs or security flaws, the patches are
+easily installed with the Ubuntu update manager. The Apache web server can be easily
+installed by typing the following command:
\begin{lstlisting}
sudo apt-get install apache2
\end{lstlisting}
+You might be required to follow other installation instructions printed on the
+terminal screen.
+After the installation has completed successfully, one can test if it works by going
+to the following web address: \emph{http://localhost}. For configuring the \emph{https}
+please go to the section 7.2.
-\subsubsection{MySQL database and MySQL library}
+\subsubsection{MySQL database and MySQLdb library}
The MySQLdb library is required to perform various operations on the MySQL database within
Python. We used the MySQLdb library instead of the native MySQL C API \emph{\_mysql} library
to make the code cleaner and more portable.
diff --git a/notFinishedCode/Report/test.toc b/notFinishedCode/Report/test.toc
index 1da60ac..3585b69 100644
--- a/notFinishedCode/Report/test.toc
+++ b/notFinishedCode/Report/test.toc
@@ -34,10 +34,10 @@
\contentsline {subsection}{\numberline {9.1}Required software and libraries}{31}
\contentsline {subsubsection}{\numberline {9.1.1}Python installation}{31}
\contentsline {subsubsection}{\numberline {9.1.2}Apache Web server installation}{31}
-\contentsline {subsubsection}{\numberline {9.1.3}MySQL database and MySQL library}{31}
+\contentsline {subsubsection}{\numberline {9.1.3}MySQL database and MySQLdb library}{31}
\contentsline {subsubsection}{\numberline {9.1.4}Serial port library}{32}
\contentsline {subsubsection}{\numberline {9.1.5}PJSUA library}{32}
\contentsline {subsubsection}{\numberline {9.1.6}pChart library}{32}
\contentsline {subsubsection}{\numberline {9.1.7}proctitle library}{32}
-\contentsline {subsection}{\numberline {9.2}Configuring hardware}{32}
-\contentsline {section}{\numberline {10}Conclusion}{33}
+\contentsline {subsection}{\numberline {9.2}Configuring hardware}{33}
+\contentsline {section}{\numberline {10}Conclusion}{34}