OSSP CVS Repository |
|
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>