summaryrefslogtreecommitdiffstats
path: root/Code/ReadMe.txt
diff options
context:
space:
mode:
authorgsmselftest2011-11-09 18:36:32 +0100
committergsmselftest2011-11-09 18:36:32 +0100
commitd9cc13649b9da33116e7c7a709ecb792be835be0 (patch)
treeafdb255cf868fd3725fe45a5dfae2b5148416701 /Code/ReadMe.txt
parentrenamed the file (diff)
downloadgsm-selftest-d9cc13649b9da33116e7c7a709ecb792be835be0.tar.gz
gsm-selftest-d9cc13649b9da33116e7c7a709ecb792be835be0.tar.xz
gsm-selftest-d9cc13649b9da33116e7c7a709ecb792be835be0.zip
added READ ME.TXT
Diffstat (limited to 'Code/ReadMe.txt')
-rw-r--r--Code/ReadMe.txt38
1 files changed, 20 insertions, 18 deletions
diff --git a/Code/ReadMe.txt b/Code/ReadMe.txt
index 9e6e1a5..065326e 100644
--- a/Code/ReadMe.txt
+++ b/Code/ReadMe.txt
@@ -1,35 +1,34 @@
-How to install this software on the new system:
-(More information and explanation are on the report chapter 9 (Employing the test Software system) and chapter 7.1 (Encryption on the communication chanels)
+How to install the software on a new system:
+(More infromation and details can be found in the report, in chapter 9 (Employing the test Software system) and chapter 7.1 (Encryption on the communication chanels)
-1. You need to install required library which used by the software:
+1. You need to install the required libraries which are used by the software:
(http://lab.ks.uni-freiburg.de/projects/gsm-selftest/wiki/Library_req)
1.a. PJSIP Library.
- - First you need to have The Utilities Packets, e.g. make, gcc, and binutils.
- - Second you need to have Python development package, to build the C extension. "python2.4-dev or python2.5-dev". The name depend on which version of your python installed in the system.
- - Third, Dowload the required library package for PJSIP. http://www.pjsip.org/download.htm
+ - First you need to have The Utilities Packets and compilers, e.g. make, gcc, and binutils.
+ - Second you need to have the Python development package, to build the C extension. "python2.4-dev or python2.5-dev". The name depends on the installed version of python on the system. (we suggest python 2.7)
+ - Third, dowload the required library package for PJSIP. http://www.pjsip.org/download.htm
- Using Python build script:
1. Build the PJSIP libraries first with the usual "./configure && make dep && make" commands.
2. Go to pjsip-apps/src/python directory.
- 3. Run "sudo python ./setup.py install" or just ''sudo make"
+ 3. Run "sudo python ./setup.py install" or just "sudo make"
4. $ cd your-pjsip-root-dir
5. $ ./configure && make dep && make
6. $ cd pjsip-apps/src/python
7. $ sudo make
- - Try to test the library:
+ - Test the installation of the library by typing:
$ python
> import pjsua
> ^Z
-
$
- - If you dont have any error importing the library you are done.
+ - If you don't get any error message while importing the library, you are done.
1.b. Setproctile library
- You need to install "easy_install" first:
$ sudo apt-get install python-setuptools
- - Now install setproctile using following command:
+ - Now install setproctile using the following command:
$ sudo easy_install setproctitle
1.c. Install socket library for python:
@@ -42,18 +41,21 @@ How to install this software on the new system:
- $ sudo apt-get install mysql-server
1.f. Install MySQLDB library for python:
- - $ Sudo apt-get install python-mysqldb
+ - $ sudo apt-get install python-mysqldb
-2. Configuration SSH to make tunneling with GSMBox.
- Explanation about how to configure the SSH tunneling are on the report chapter 7.1 or you can see it on this address:
+2. Configuration of the SSH to make a virtual tunnel with the GSMBoxes.
+ Tutorials how to configure the SSH tunneling are in the report, chapter 7.1 or you can see it on the given link which we used as well:
http://www.thegeekstuff.com/2008/11/3-steps-to-perform-ssh-login-without-password-using-ssh-keygen-ssh-copy-id/
- - The software communicated with the beagle box using default port number 7884, If you have problem on the beagle board and need to reinstal the system, please make sure that the port communicate for ssh is 7884.
+ - The software communicates with the Beagle box using the port number 7884. If you have some problems on the beagle board and need to reinstall the system, please make sure that the SSH port is 7884.
+
+3. Configuring HTTPS and .htaccess on the server. You can find the tutorials how to configure HTTPS and .htaccess in the report, section 7.2.
-3. Configure HTTPS access on the server. You can see explanation how to configure HTTPS on the report chapter 7.
+4. The username and password for MySQL.
+ The default username and password are stored in these files: initTestClass.py, GsmSelfTest.py, UsbDetectClass.py and truthtableClass.py in the initDB() function. You need to edit your login information for the database in these files.
-4. Configure username and password for MySQL.
- The default username and password are store in these file: initTestClass.py, GsmSelfTest.py, UsbDetectClass.py and truthtableClass.py under initDB function. You need to edit your login information for Database in those files.
+5. To start the software testing, you need first to start manually startSoftware.py:
+ - $ python startSoftware.py