goPronto! [ INSTALL ] news | screenshots | themes | download | development | support | archives
The easiest way to install Pronto is to use the ProntoInstaller.pl
script. This script is included in the RPM and the tarball, and is
an all in one installation utility. It will even fetch the latest
stable Pronto for you, so you really only need to download the
installer itself, as it will get everything else for you.

Running the installer without passing any command line argument will make it
fall back on wget, the default internet fetching utility. If you do not have
wget, no panic, pass it an argument of another fetching utility like so,

ProntoInstaller.pl ncftpget or if you need to pass arguments to your
fetching utility even, do this.

ProntoInstaller.pl "ncftpget -f" or
ProntoInstaller.pl "wget --proxy=someproxy --password=somepass"

The installer lets you choose tarball or RPM installation, and will
install the appropriate version of Pronto. Note, the perl modules
are not all available in RPM format, so we use tarball for them.
Sorry for those of you who want everything to pass through the
package management system... you can manually hunt down rpms if
you like.

Note to upgraders: If you are upgrading from an earlier version,
you should check the changelog to see if any special actions are
required. (As this is very quickly evolving software the
database structure changes occasionally.)
Scripts useful for upgrading from an older version are in migration-scripts/.
PLEASE read the changelog!

Pronto requires gtk 1.2.3 or later. If you are running a recent version
of Gnome, you probably have that. If not, you can get it from
http://www.gnome.org/start/

Pronto requires the following perl modules.

DBI-1.13
For CSV database support:
Text-CSV_XS-0.20
SQL-Statement-0.1016
DBD-CSV-0.1022
For PostgreSQL database support:
DBD-Pg-0.93
For MySQL/mSQL database support:
Msql-Mysql-modules-1.2213
DateManip-5.35
MIME-Tools-4.124
MIME-Types-0.02
URI-1.05
HTML-Parser-2.25
Lingua-Ispell-0.07

Gnome-Perl CVS (available from http://www.muhri.net/pronto/gnome-perl.tar.gz or the
Gnome project's cvs server)

if you want to compile support for an HTML widget you are going to use:
Pronto supports both the XmHTML widget (old and buggy)
as well as the new still-under-development GtkHTML widget.

For GtkXmHTML support, cd to gnome-perl/GtkXmHTML/ and perl Makefile.PL;
make; make install

For GtkHTML support, install GtkHTML (From Gnome's cvs server) and then
cd to gnome-perl/GtkHTML/ and perl Makefile.PL; make; make install

Some distributions don't include IO::Socket even though it is part of the
base Perl distribution (as of 5.004) so you might need module IO-1.20 or higher.

The modules are also available as binary RPM packages, visit rpmfind.net.

To install Pronto (in /usr/local/bin by default), do

make install

or if you prefer to install it somewhere else, for example
in /usr/bin , do

make install PREFIX=/usr

(Note: a make step is not required, just make install). The place where
Pronto is located MUST be in your path because otherwise it
won't find its companion scripts to get and send mail.

Pronto can take advantage of some (most?) SQL databases to store
information about messages. This is highly recomended. The CSV
driver is very slow if you have more than a few hundred messages.

The next section explains how to set up some SQL databases to work with
Pronto.

Databases known to work include PostgreSQL and mySQL. You can probably
use other databases, but you may have to set up the tables by hand.

First you need to get and install the database. mySQL is a very high
performance database, and probably the database of choice unless you have
another one installed already. RedHat comes with PostgreSQL,
Either will work 100% with Pronto.

http://www.mysql.org/download.html
http://www.postgresql.org/sites.html

Then, get and install DBD drivers for your database from CPAN.
for Postgress, that is module DBI-Pg, and for mySQL it is Msql-Mysql-modules
or later versions ofcourse:

http://www.cpan.org/authors/id/JWIED/Msql-Mysql-modules-1.2210.tar.gz
http://www.cpan.org/authors/id/MERGL/DBD-Pg-0.93.tar.gz

Make an empty database for any users whom you wish to be able
to use Pronto. These users do not need any special
permissions. Make the empty database have the same name as the user
it belongs to. (See the documentation for your specific backend for
details on how to do this.)


If you run mySQL 3.22+, do this:
Replace all instances of <username> with your login name

mysql -u root
create database <username>;
use <username>;
grant all privileges on *.* to <user>@localhost;

If you run Postgres 6.5.x, do this:

su postgres
createuser <username>
Enter user's postgres ID or RETURN to use unix user ID:
<press return>
Is user "<username>" allowed to create databases (y/n)
Is user "<username>" a superuser? (y/n>
createuser: <username> was successfully added
Shall I create a database for "<username>" (y/n)
exit


When you first run Pronto, it will prompt you for what database
driver you wish to use. Select the appropriate driver for whatever
database you have installed (if no db, then use CSV, but make sure
you have installed the modules listed above that are required for
csv to work.)