File: SETUP

package info (click to toggle)
pimppa 0.5.7-3
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 1,748 kB
  • ctags: 1,347
  • sloc: ansic: 8,731; sh: 3,795; sql: 144; makefile: 118; perl: 11
file content (67 lines) | stat: -rw-r--r-- 2,178 bytes parent folder | download
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.