24bae40be7
always will be licensed under GPL, so use "Petidomo" as the program name everywhere and consistently.
91 lines
3.2 KiB
Plaintext
91 lines
3.2 KiB
Plaintext
|
|
Petidomo Mailing List Manager
|
|
Version 4
|
|
|
|
|
|
Greetings citizen,
|
|
|
|
I know how tedious reading "manuals" is when you're eager to install
|
|
the new software, so I'll keep it as short as possible. Before
|
|
Petidomo can be installed, either from a binary or a source
|
|
distribution, you -must- do the following:
|
|
|
|
1) Create a user of the name "petidomo".
|
|
|
|
The petidomo-user is needed by the software, but will usually not
|
|
be used to log into the system, so you should set the password
|
|
entry to "*" and the login shell to "/usr/bin/true" or
|
|
"/sbin/nologin" -- depending on what your system uses.
|
|
|
|
|
|
2) Create a group of the name "petidomo".
|
|
|
|
This group should contain all users of your system who are allowed
|
|
to administrate Petidomo or for other reasons need access to the
|
|
installation. The "petidomo" user should be a member of this
|
|
group, too, even though this is not strictly necessary.
|
|
|
|
|
|
3) Create the home directory of the "petidomo" user.
|
|
|
|
The home directory is the place where the package will live. A
|
|
good place is "/usr/local/petidomo", but you can place it
|
|
wherever it suits your installation.
|
|
|
|
|
|
Once the user, the group and the directory exist, you can use the
|
|
following mechanisms to do the actual installation.
|
|
|
|
If you're upgrading from Petidomo 2.0 and have some mailing lists
|
|
installed already, you can safely use these mechanisms, too. In no
|
|
event will the installation procedure overwrite your config files or
|
|
change anything except for the actual binaries.
|
|
|
|
The installation itself works as follows:
|
|
|
|
Binary distribution:
|
|
|
|
Become 'root' and start the "install.sh" script, which can be
|
|
found in the same directory as this file. install.sh will populate
|
|
the home directory of the petidomo user and insert the required
|
|
mail aliases into /etc/aliases. Then it will install the CGI
|
|
config manager and that's it: Petidomo is ready to run.
|
|
|
|
|
|
Source distribution:
|
|
|
|
Obviously you need to compile the sources first of all. In order
|
|
to compile Petidomo, you will need the following tools:
|
|
|
|
- a C compiler, preferably gcc or egcs
|
|
|
|
- a version of make(1) that understands the "include" and
|
|
".PHONY" statement (use GNU make if your native make doesn't)
|
|
|
|
- flex, the GNU version of lex
|
|
|
|
- bison, the GNU version of yacc, at least version 1.25. Older
|
|
version -might- work, but I had problems with them, because
|
|
they're lacking the YYERROR_VERBOSE mechanism.
|
|
|
|
If you have all these tools, you can compile Petidomo with the
|
|
following commands:
|
|
|
|
$ make
|
|
$ make install (must be done as root)
|
|
|
|
|
|
In case you experience any problems you're not able to fix, you're
|
|
welcome to file a problem report with the "send-pr" utility, included
|
|
in the distribution. You might also want to check out the
|
|
petidomo-users mailing list, to which you can subscribe by sending a
|
|
SUBSCRIBE command to the following address:
|
|
|
|
petidomo-users-request@petidomo.com
|
|
|
|
Okay, I hope you'll find the Petidomo Mailing List Manager useful, and
|
|
may the force be with you!
|
|
|
|
|
|
Peter Simons <simons@petidomo.com>
|