Lyris User's Guide
[previous] [next] [contents]
How to Upgrade Lyris List Manager by Hand
Table of Contents
· Introduction
· Email Commands
· Web Interface for Users
· Server Administrator
· Site Administrator
· List Administrator
· Other Topics
· Add-On Packages
· Installing and Upgrading
· · Installing Lyris List Manager
· · Installing Lyris List Manager on Unix
· · · Basic Unix Installation Instructions
· · · After Installing Lyris on Unix
· · · Getting Help
· · · How to Install Lyris List Manager by Hand
· · · How to Upgrade Lyris List Manager by Hand
· · · How to Install the Web Interface on a separate machine
· · · If Lyris List Manager Will Not Run
· · · Unix Directory Permissions Needed
· · · Making your Unix Mail Server and Lyris List Manager coexist
· · Mail Server Coexistence
· · Upgrading to Lyris List Manager from Another List Manager
· · Troubleshooting
· Appendix
· Frequently Asked Questions

How to Upgrade Lyris List Manager by Hand

If you do not want to use the "install_lyris" script to upgrade your existing Lyris List Manager installation, you can follow these steps to upgrade it by hand.

1) Make a backup your Lyris directory before starting the upgrade.

2) Copy the contents of the installation 'bin' directory to the 'bin' directory of your Lyris installation.

3) Copy the files in ~lyris/apache/lib to your Perl library directory that is 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) Copy the files lyris.pl, lyrispath.pm in the ~lyris/apache/cgi-bin directory to the "cgi-bin" directory on your web server. 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.

5) 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/lyris/apache/lib";

Making the appropriate substitution for where you installed the lyris package. Additionally, lyrispath.pm needs to be modified to specify addition include paths. Add the following item:

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

Again, adjusting the path for your particular installation.

6) Run the command:

    ~lyris/bin/lyris dbupgrade UP4-XXXXX-XXX

Using your Lyris-provided upgrade code to upgrade your Lyris databases to the current version.

7) Run the command:

    ~lyris/bin/lyris start

To run Lyris in the foreground or run the command:

    ~lyris/bin/lyris -bd

To run Lyris in the background.

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

9) Change directory (cd) to your web server's CGI directory. Run the command:

    ./lyris.pl

You should see a page full of HTML displayed.

10) With a web browser, go to the URL http://localhost/cgi-bin/lyris.pl. The Lyris web interface should appear.

That's all! Lyris List Manager should now be upgraded on your system!

Other pages which link to this page:
  • Installing Lyris List Manager on Unix
  • Page 518 of 629