summaryrefslogtreecommitdiffstats
path: root/Code/ReadMe.txt
blob: 065326ef79c32b90b5823e7441dc35eb998cb788 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

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 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 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"
			4. $ cd your-pjsip-root-dir
   			5. $ ./configure && make dep && make
   			6. $ cd pjsip-apps/src/python
   			7. $ sudo make
		- Test the installation of the library by typing:
			$ python
				> import pjsua
				> ^Z
			$
		- 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 the following command: 
			$ sudo easy_install setproctitle

	1.c. Install socket library for python:
		- $ sudo apt-get install python-serial

	1.d. Installing PhpMyAdmin:
		- $ sudo apt-get install phpmyadmin
	
	1.e. Install MySQL Server:
		- $ sudo apt-get install mysql-server

	1.f. Install MySQLDB library for python:
		- $ sudo apt-get install python-mysqldb

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 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.

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.

5. To start the software testing, you need first to start manually startSoftware.py:
	- $ python startSoftware.py