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 7.0 or higher.

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 8.0 tar file to a temporary location, such as /tmp/lm; copy the contents of the '/tmp/lm/bin' and ‘/tmp/lm/tclweb’ directories to their counterparts in your existing ListManager installation (which will henceforth be referred to as ~lm).

3. 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.

4. Run the command:

~lm/bin/lm copy2sql

To copy the ListManager data to the new database.

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

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

7. Rename the file ~lm/tclweb/bin/tclhttpd_template.rc to tclhttpd.rc. Edit it, replacing ‘$HOSTNAME’ with the name of the machine; ‘$PORT’ with the port you want the web server to listen to (e.g., 80); and ‘$EMAILADDR’ with the email address of the administrator.

8. Run the command:

~lm/tclweb/bin/httpd-lm

To run the ListManager Web Server in the foreground, or run the command:

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

To run the ListManager Web Server in the background.

9. With a web browser, go to the URL http://your-server.com/.

ListManager should now be upgraded on your system.