How to Install ListManager by hand
If you do not want to use the "install_lm.pl" script, technically sophisticated users can follow these steps to install ListManager by hand.
1) Uncompress the ListManager tar file to the directory from which you will run it (which will henceforth be referred to as ~lm).
2) Create a directory named "/lyris" under your HTML document root directory on your web server (possibly named html or htdocs), then copy the files from directory ~lm/apache/docs/lyris (~lm being the directory where ListManager is installed) to this directory. You should be able to see these graphics from the URL http://localhost/lyris.
3) If you have Perl installed, skip to the next step. If you do not have Perl installed, copy the file ~lm/bin/perl to /usr/bin/perl . Make a site_perl directory, based on the output of running:
/usr/bin/perl -e 'print join("\n",@INC)'
on the command line.
4) Copy the files in ~lm/apache/lib and ~lm/apache/cgi-bin to your local Perl library directory (site_perl).
5) Copy the following files in the ~lm/apache/cgi-bin directory to the "cgi-bin" directory on your web server: lyris.pl, LMpath.pm. This directory should already exist, and is not located in your HTML document directory. It is a separate directory your web server maintains for running CGI scripts.
6) To make lyris.pl function in the new directory, it needs the following line added to it (in the BEGIN section):
use lib "/usr/local/lm/apache/lib";
Be certain to make the appropriate substitution for where you installed the ListManager package. Additionally, LMpath.pm needs to be modified to specify addition include paths. Add the following item:
unshift(@INC,"/usr/local/lm/apache/lib");
Again, adjust the path for your particular installation.
7) Install and configure the appropriate database software or client software. Create a database for ListManager to use.
8) Rename ~lm/bin/lmcfg_template.txt to lmcfg.txt, and edit it, adding database connection information. For example, a PostgreSQL configuration would require you to add something like the following:
$sql_type = "POSTGRES";
$sql_server = "";
$sql_database = "listmanager";
$sql_user = "lmuser";
$sql_password = "lmpassword";
$sql_pool = "25";
Check the database connection by running the following command:
~lm/bin/lm version
If ListManager connects successfully, a version string is displayed.
9) Run the following command:
~lm/bin/lm dbcreate <admin-password>
To create the Lyris database tables. Specify the administrator password you would like to use on this server. For example, "lm dbcreate sesame" would create an account named "admin" with a password of "sesame"
10) Run the following command:
~lm/bin/lm dns 127.0.0.1
To assign a DNS server to ListManager. Change "127.0.0.1" to the TCP/IP address of your DNS server.
11) Run the following commands:
lm serial yourserialnumber
lm getactivation
This will enter your serial number, and retrieve your activation code.
12) If you want ListManager to run its SMTP receiving agent on an alternate port, run the following command:
~lm/bin/lm smtpport 26
Where "26" specifies the port you want ListManager to use.
13) If you want ListManager to only listen to specific TCP/IP addresses, run the command:
~lm/bin/lm tcpip 207.105.6.2 127.0.0.1
Substituting the TCP/IP addresses you want ListManager to use. Note: We recommend that you let ListManager listen to the localhost address (127.0.0.1) because the web interface (lyris.pl) goes to that by default. If you do not allow ListManager to listen to 127.0.0.1, you will need to edit the file "lyris.plc" that is located in your cgi-bin directory, so that the line which reads "server_ip_address=" points to a TCP/IP address that ListManager is listening on. Note: The Command Protocol that the web interface uses to communicate with the ListManager, listens on port 2020.
14) Run the command:
ulimit -n 2000
(preferably in the bash shell) to increase your file descriptor limit. Then, run:
~lm/bin/lm start
To run ListManager in the foreground, or run the command:
~lm/bin/lm start 1>/tmp/lm-stdout.txt 2>/tmp/lm-stderr.txt &
To run ListManager in the background. If you encounter a problem, run ListManager in the foreground, in debug mode, with the command "~lm/bin/lm start debug".
15) Send mail to lyris@your-server to make sure that ListManager is answering email.
16) Change directory (cd) to your web server's CGI directory. Run "./lyris.pl". You should see a page full of HTML displayed.
17) With a web browser, go to the URL http://localhost/cgi-bin/lyris.pl and follow the configuration instructions.
18) For Solaris, run the command:
/usr/bin/ulimit -n
If a number smaller than 150 is displayed, you do not have enough file descriptors for ListManager to function correctly.
On most Unixes, you can increase your file descriptor limit by issuing the command:
ulimit -n 512
Be sure to issue this command before you run ListManager.
On Solaris, to permanently increase the maximum file descriptor limit, add these two lines to /etc/system
set rlim_fd_max=0x400
set rlim_fd_cur=0x300
You will need to reboot your Solaris in order for this change to take effect. Once you reboot, check that the change worked, with "/usr/bin/ulimit -n"
For Linux users, Linux normally has a limitation of 4096 file descriptors for the whole OS (1024 max per process). To increase the maximum for the whole OS, you edit the /proc/sys/fs/file-max file.
ListManager should now be running on your system.
|
|