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 62 63 64 65 66 67
|
This is a quick step-by-step PIMPPA installation guide.
Usage information, help, etc. is available in README.
Requirements
------------
NOTE: required version numbers may not be strict. The ones
mentioned are those currently used for devel.
- Linux 2.x.x
- MySQL. (>= v3.23.41. NOTE: v3.23.49 does NOT work!)
You can get them free for noncommercial use from "http://www.mysql.org/"
- Suck (>= v4.3.2) for downloading newsgroups. It should be
available at "http://www.sucknews.org/"
- Uudeview (>= v0.5.19) for decoding news. It should be
available at "http://www.fpx.de/fp/Software/UUDeview/"
Optional:
- fget (v1.1 will do) for ftp leeching. From
"http://www-dev.cso.uiuc.edu/fget/". Remember that it must
be patched for pimppa (patch included in "patches/")!
- GNOME for GUI. See "http://www.gnome.org/"
Install
-------
Follow these steps for first time installation:
1) Get and install MySQL, Suck and Uudeview.
See their respective manuals for installation.
1a) Install optional components
If you want FTP leeching supported, patch and compile
fget with a patch from "patches/" dir. See "patches/fget_patch.txt"
for further instructions.
2) mysqld must always be running when you use PIMPPA utils and scripts.
You should start it from your /etc/rc.d/ files. Suck and uudeview
must be on command execution path.
3) Modify "src/pimppa.h" to suit your needs. It contains important
configuration stuff, like the temporary directory location.
Then do "./configure", "make", followed by "make install".
All files will be installed as default to the subdirs
of "/usr/local/".
4) Enter "sql/" directory and execute "./createdb". (It's a
shell script for adding PIMPPA's MySQL tables)
5) Set a new password for SQL user pimppa by editing ~/.my.cnf
and then using
$ mysql -u root -p --execute="USE mysql; UPDATE user \
SET password=PASSWORD('your_new_pass') where user='pimppa';"
Wow, all done! Quick and easy, eh? ;)
Upgrading
---------
If you're upgrading from a previous version, see file
"ChangeLog" for lines "CHANGE:" to see what you MUST do.
After that, just do step 3 above.
|