You are here: Upgrading ListManager > Upgrade Instructions > Upgrading By Hand--Linux

Upgrading By Hand--Linux

 

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.

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

Check the database connection by running the following command:

 

~lm/bin/lm version

 

If ListManager connects successfully, a version string is displayed.

 

4. To upgrade your database to the current version, run the command:

 

./lm dbupgrade

5. To start ListManager, run the command:

 

~lm/bin/lm start

 

To run ListManager in the background:

 

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

6. Send mail to listmanager@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. To run the ListManager Web Server in the foreground, run the command:

 

~lm/tclweb/bin/httpd-lm

 

To run the ListManager Web Server in the background, run the command:

 

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

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

ListManager should now be upgraded on your system.