Documentation
  	
1. What is GPRS Easy Connect?

2. What is SG program?

3. Downloading, installing of GPRS Easy Connect
    3.1. Depedencies
        3.1.1 Perl modules
            3.1.1.1 Installing needed Perl modules
                3.1.1.1.1 Offline installing
                3.1.1.1.2 Online installing
            3.1.1.2 Installing needed Perl modules for Mandriva/Mandrake.
        3.1.2 Other programs
    3.2. Installing GPRS Easy Connect with own Installer program
    3.3. Installing GPRS Easy Connect from outer source

4. First steps before try getting connection

5. Supported phones (2005.10.21.)

6. Supported providers (2005.10.21.)

7. GPRS Easy Connect made by

8. Special thanks to

9. Troubleshooter
    9.1 Connection built, got IP(s), DNS(s), seem like all OK, but there's no data transmittion
    9.2 Connection drops after 2 minutes
    9.3 I tried everthing but couldn't connect, what can I do?

10. Knowledge
 
1. What is GPRS Easy Connect?

GPRS Easy Connect is a free (GNU GPL) Perl-Gtk2 based GUI program for Linux (version < 3.0.0 supports FreeBSD too) what can configurate and manage Internet connection for mobile phones. GPRSEC supports COM, USB, IrDA, Bluetooth connections on GPRS, EDGE and UMTS technologies.
2. What is SG program?

SG is the console version of GPRS Easy Connect. This program can build needed Internet connection scripts for pppd and chat programs.
3. Downloading and installing of GPRS Easy Connect

GPRS Easy Connect is available from our site:
http://www.gprsec.hu/modules/downloads/list.php?category=1

It contains GPRSEC and SG program too.
3.1. Depedencies:

3.1.1. Perl modules:

Usually you can find all needed modules for all Linux Distributions on their Package CDs or online package database. Your best choose would be using of those with your Package Handler program.
If you don't find some Perl modules on your source you can download those from Internet.
If you are Mandriva/Mandrake user click here.

You need following modules if you want to install one or more needed modules for program from source:

Compress-Zlib-1.34
http://search.cpan.org/~pmqs/Compress-Zlib-1.34/

ExtUtils-Depends-0.205
http://search.cpan.org/~rmcfarla/ExtUtils-Depends-0.205/

ExtUtils-PkgConfig-1.07
http://search.cpan.org/~rmcfarla/ExtUtils-PkgConfig-1.07/

Needed modules for GPRSEC:

Glib-1.081 (minimal: 1.05)
http://search.cpan.org/~tsch/Glib-1.081/

Gtk2-1.081 (minimal: 1.05)
http://search.cpan.org/~tsch/Gtk2-1.081/

Note: Version number of Glib and Gtk2 must to be same!

Gtk2-TrayIcon-0.03
http://search.cpan.org/~mlehmann/Gtk2-TrayIcon-0.03/

Gnome2-VFS-1.021
http://search.cpan.org/~tsch/Gnome2-VFS-1.021/
   
Gnome2-Canvas-1.002
http://search.cpan.org/~tsch/Gnome2-Canvas-1.002/
   
Gnome2-1.021
http://search.cpan.org/~tsch/Gnome2-1.021/

Encode-2.10
http://search.cpan.org/~dankogai/Encode-2.10/

Getopt-Long-2.34
http://search.cpan.org/~jv/Getopt-Long-2.34/

3.1.1.1 Installing needed Perl modules.
                          
Order of depedencies:
Compress-Zlib-1.34-->ExtUtils-Depends-0.205-->ExtUtils-PkgConfig-1.07-->
Glib-1.081-->Gtk2-1.081-->Gtk2-TrayIcon-0.03-->
Gnome2-VFS-1.021-->Gnome2-Canvas-1.002-->Gnome2-1.021-->
Encode-2.10-->Getopt-Long-2.34

3.1.1.1.1 Offline installing

After downloading you need to unpack the modul open a console as root, go where you downloaded that, eg.:

cp ~/downloads/

unpack package, eg.:

tar -xzf Compress-Zlib-1.34.tar.gz
cp ./PACKAGE_NAME

Compile Perl module:

perl Makefile.PL
make
make test
make install

Repeat unpack and compile steps in order what you red above while don't you finish last one module.

3.1.1.1.2 Online installing

You can install Perl modules by automaticly download, compile and install from CPAN.
Open a console as root and type or copy step by step:

perl -MCPAN -e 'install Compress-Zlib-1.34'
perl -MCPAN -e 'install ExtUtils-Depends-0.205'
perl -MCPAN -e 'install ExtUtils-PkgConfig-1.07'
perl -MCPAN -e 'install Glib-1.081'
perl -MCPAN -e 'install Gtk2-1.081'
perl -MCPAN -e 'install Gtk2-TrayIcon-0.03'
perl -MCPAN -e 'install Gnome2-VFS-1.021'
perl -MCPAN -e 'install Gnome2-Canvas-1.002'
perl -MCPAN -e 'install Gnome2-1.021'
perl -MCPAN -e 'install Encode-2.10'
perl -MCPAN -e 'install Getopt-Long-2.34'

3.1.1.2 Installing needed Perl modules for Mandriva/Mandrake

Never use CPAN for Gtk2 and Gnome2 modules, because Mandriva had patched Gtk2 and uses for Mandriva's helper applications (eg.: Mandriva Contorll Center, etc.). The CPAN modules are NOT patched and Mandriva's helper applications won't work anymore. If you don't find needed modules' packages on your Installation disks, then you can use easyurpmi.zarb.org to find an online rpm source base for your Mandriva/Mandrake distribution, where you can find your needed modules in rpm format. Also you can download needed modules from the mirror sites of Mandriva.

a) Gtk2 modules:
Note: Usually the needed perl-Gtk2 modules can be found on intallation CDs.

Or you can download directly needed Gtk2 modules eg. from here:
ftp://ftp.u-strasbg.fr/pub/linux/distributions/NAME_OF_DISTR/devel/YOUR_DISTRIBUTION/i586/media/main/

Where
NAME_OF_DISTR can be: mandrake or mandriva
YOUR_DISTRIBUTION can be: 10.0, 10.1, 10.2, 2005, 2006.0, etc

You need to download and install the following rpm files:

perl-Gtk2
perl-Glib
perl-Gtk2-TrayIcon

b) Gnome2 modules:
Note: Usually the needed perl-Gnome2 modules can be found on intallation CDs.
Or you can download directly needed Gnome2 modules eg. from here:

ftp://ftp.u-strasbg.fr/pub/linux/distributions/NAME_OF_DISTR/devel/YOUR_DISTRIBUTION/i586/media/contrib/

Where
NAME_OF_DISTR can be: mandrake or mandriva
YOUR_DISTRIBUTION can be: 10.0, 10.1, 10.2, 2005, 2006.0, etc

You need to download and install the following rpm files:

perl-Gnome2-Canvas
perl-Gnome2-VFS
perl-Gnome2


c) Installing downloded modules:

You can install the downloaded rpm files as root like this:
Open a console as root and go where is your downloaded rpm file eg.:

cp ~/downloads/

Install rpm file eg.:

urpmi perl-Gnome2-Canvas-1.002-3mdk.i586.rpm

etc...

3.1.2 Other programs

wget-1.9.1
http://ftp.gnu.org/gnu/wget/

ppp-2.4.x
http://ppp.samba.org/

These two programs are very elemental program, so you will found these on your installation CDs and you can install them easily with your package handler program.

3.2. Installing GPRS Easy Connect with own Installer program

After you downloaded GPRS Easy Connect and are sure all depedencies are installed, you can begin install the program as root. Open a console and go where you downloaded it, eg.:

cp ~/downloads/

Unpack GPRSEC, eg.:

tar -xjf ./GPRS_Easy_Connect_300_Install.tar.bz2
cp ./GPRSEC_VERSION_NUMBER

Where VERSION_NUMBER can be different, but it is same the package version. In this sample this is 300.

Type:

./INSTALL

All instruction will be showed what you have to do. Installer report you errors and the successful installing.

3.3 Installing GPRS Easy Connect from outer source

There would be many different packages for different Linux Distributions. In every case you must to you must to use your distribution's own package handler program. Usually this handler program will be install all depedencies too. If not, you should install missing programs manually. (See above.)

4. First steps

You need to set minimal informations up in the program:
Phone type, provider - check username and password -, connection port. Save parameters and click on Connect button.
5. Supported phones (2005.10.21.)

You can find list of currently supported phones on http://www.gprsec.hu/modules/phones/list.php.
6. Supported providers (2005.10.21.)

You can find list of currently supported providers on http://www.gprsec.hu/modules/providers/index.php.
7. GPRS Easy Connect made by

Péter Simon (simon d0t peter {} gprsec d0t hu)

    * Main program
    * Gtk widgets
    * Connection scripts
    * A part of documentation
    * English, Hungarian translate


Gábor Pintér (pinter d0t gabor {} gprsec d0t hu)

    * SG program
    * Installer program
    * Homepage
    * Connection scripts
    * A part of documentation


Andrea Bravetti (brand77 {} gmail d0t com)

    * Gtk widgets
    * Lot of patches
    * Alghorythms
    * Ideas
    * Italian translate



8. Special thanks to

Webspace: Christian Hamar
Domain: Miklós Honti
Splash image: Zoltán Csáki
Webspace for the 1st 2 years: "Oregon"

Translators:

Honza Mach
Pasi Kuokkanen & Ronja Kuokkanen
David Lacravate
Jakub Kasprzycki
Andreas Krause
Jonathan Stevano
Francesco Di Mare
Tomás Mateo
Altan Demirkilic

Testers:


Adam Jurkiewicz 	David Robson 	Kádár Andor 	Pratik Dholakia
Aleksandr Kiselyov 	Emanuele Pizzuto 	Kállai Miklós 	Pásztor Lajos
Alessandro Bonometti 	Erdei Sándor 	Kósa Lajos 	Remo Franceschelli
Alessandro Di Camillo 	Eric Hidle 	Lars Degenhardt 	Rosolen Giancarlo
Alessandro Moroni 	Fabio Soncin 	Lars Segerlund 	Sandro Zaccarini
Alessandro Nardecchia 	Fakan Tibor 	Luca Micocci 	Sertac Cesur Guercay
Alfredo Laghi 	Farkas Norbert 	Luis Cofino 	Shartwork
Altan Demirkilic 	Federico Vettorazzo 	Marcato Fabio 	Soós Tibor
Andrea Bertolin 	Ferran Orsola 	Maria Manenti 	Stevan Stanimirovic
Andreas Krause 	Francesco Di Mare 	Mariusz Rzepkowski 	Sweet Sydro
Angelo Capone 	Francesco Maria Marcacci 	Martin Spevak 	Vadász József
Ani Adarsh 	Fred Zinner 	Matt Carnegie 	Varjasi Ferenc
Antonio Forte 	Giovanni Petix 	Matteo Croce 	Vittorio Cagnetta
Arameus Teomo 	Gisueppe Marocchio 	Matthias Oster 	Zsigmond Attila
Balwinder Singh Dheeman 	Haryo Timur 	Maurizio Cavalletti 	Ódor Péter
Baranyi Gábor 	Heath Miller 	Miklós József 	Ökrös Attila
Barcza Károly 	Hefkó Levente 	Molnár Ferenc 	
Baricza Tibor 	Heiszler József 	Molnár Gergely 	
Biegelbauer Ákos 	Hornyák László 	Munir Nassar 	
Bogi Kornél 	Hullám Pál 	Murat Koç 	
Bús József 	Ivan E. Moore II 	Nate Davis 	
Charles Oertel 	Jakub Kasprzycki 	Nikos Avraam 	
Christian Ludwig 	Jaroslav Uzik 	Oguz Oktar 	
Cosimo De Santis 	Jesika Hurdelbrink 	Olivier Bornet 	
Costas Ziakas 	Jonathan Stevano 	Paul Tap 	
Dan Rivers 	Kayode Titus 	Paul Wong 	
Daniel Paessler 	Kim Hendrikse 	Perviz Askerov 	
Daniele Cono D'Elia 	Kiss Bálint 	Pierpaolo Carone 	
Danyi Csaba 	Kovács József 	Pocsai Csaba 	
David Irvine 	Kovács Zoltán 	Polgár István 	

9. Troubleshooter
(Ordered just to came to mind.)


9.1 Connection built, got IP(s), DNS(s), seem like all OK, but there's no data transmittion

Possibility reason #1:
Somehow /etc/resolv.conf didn't come into existence. (There's no usable DNS servers.)

Solution:
Check your /etc/ip-up file. If you use dynamic DNS it must to contain a cp command from /etc/ppp/resolv.conf to /etc/resolv.conf. If it doesn't, you should re-install GPRSEC or copy from Installer of GPRSEC ip-up file to /etc/ppp.

Possibility reason #2:
Your shorewall doesn't enable ppp connection. Typicaly when you use ethX for Internet defending it with shorewall firewall and you change Internet connection to ppp with GPRSEC.

Solution:
Change shorewall firewall to ppp connection or turn it off (not recommended).

9.2 Connection drops after 2 minutes

Possibility reason #1:
There's time limit in /etc/ppp/option file.

Solution:
Delete or comment with a # mark the following lines in /etc/ppp/option file eg.:

# lcp-echo-interval
# 30 lcp-echo-failure 4

9.3 I tried everthing but couldn't connect, what can I do?

Send us Bugreport including a Console output. Please do this steps:

Be sure before you do the next steps, you've set everything in GPRSEC's setup and saved that!
Eg. with mc program open for edit ~/.gprsec/run file. Comment line begining filename like this:

# filename(etc...)

Save file and, if you use mc, press CTRL+O to show a clean console and type:

/usr/sbin/pppd file ./run

In this case the connection's getting build and echoes all things into this console. Yes, we need this output text. Please copy and attach to your Bugreport too.
Don't forget to uncomment line filename after this.
10. Knowledge
(Ordered just to came to mind.)

Etc...