How to Upgrade ListManager by hand

If you do not want to use the "install_lm.pl" script to upgrade your existing ListManager installation, you can follow these steps to upgrade it by hand. Note that these instructions presume an upgrade from ListManager 4.x to ListManager 5.x.

1) Make a backup of your ListManager directory before starting the upgrade. Make sure ListManager is not running. If you are using the included apache web server, make sure it is not running.

2) Uncompress the ListManager 5.x tar file to a temporary location, such as /tmp/lm; copy the contents of the '/tmp/lm/bin' and ‘/tmp/lm/apache’ directories to their counterparts in your existing ListManager installation (which will henceforth be referred to as ~lm).

3) Copy the files in /tmp/lm/apache/lib to your Perl library directory (probably something similar to ‘/usr/lib/perl5/site_perl/5.005’) - if you need to determine your Perl library directory, you can run the command:

perl -e 'print join("\n",@INC)'

4) 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";

Making the appropriate substitution for where ListManager is installed. Additionally, LMpath.pm needs to be modified to specify addition include paths. Add the following item:

unshift(@INC,"/usr/local/lm/apache/lib");

Again, adjusting the path for your particular installation.

5) 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.

6) Run the command:

~lm/bin/lm copy2sql

To copy the ListManager data to the new database.

7) Run the command:

~lm/bin/lm start

To run ListManager in the foreground or run the command:

~lm/bin/lm 1>/tmp/lm-stdout.txt 2>/tmp/lm-stderr.txt &

To run ListManager in the background.

8) Send mail to lyris@your-server to make sure that ListManager is answering email.

9) If you are not using the included apache web server, 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.

10) Change directory (cd) to ~lm/apache/cgi-bin, or to your web server's CGI directory. Run the command:

./lyris.pl

You should see a page full of HTML displayed.

11) Start your web server. With a web browser, go to the URL http://your-server/cgi-bin/lyris.pl. The ListManager web interface should appear.

ListManager should now be upgraded on your system.