Lyris User's Guide
[previous] [next] [contents]
How to Install the Web Interface on a separate machine
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 you get the "Protocol Not Supported" Error
· · · 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 Install the Web Interface on a separate machine

The web interface does not need to be installed on the same machine as the Lyris List Manager it can be on a different machine. If you already have a production web server, this may be more convenient. Note: We use the name ~lyris as a means of designating the location where the Lyris List Manager is installed.

The easiest way to install the web interface is to run install_lyris and get the web interface working on the local server. Then, proceed to step 6 to tell the web interface to use another Lyris List Manager server.

To install by hand the web interface to a web server running on a different machine, follow these steps:

1) Uncompress the lyris tar file to the temporary directory.

2) Create a directory named "/lyris" under your HTML document root directory on your web server, then copy the files from ~lyris/docs/lyris 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 ~lyris/bin/perl to /usr/bin/perl. Make a Perl library directory (site_perl). Run the command:

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

To determine where that directory belongs.

4) Copy the files in ~lyris/apache/lib and ~lyris/apache/cgi-bin to your Perl library directory.

5) Copy the files 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.

6) The file named "lyris.plc" contains the configuration settings for the web interface. If you have configured your Lyris List Manager installation to use your web server, the "lyris.plc" file will be in the CGI-BIN directory (or SCRIPTS directory, if you are using IIS). If you are using the Apache web server installed with Lyris List Manager, this file will be found in the lib directory under Apache. Change the line which reads "server_ip_address=127.0.0.1" so instead point to a TCP/IP address that your Lyris List Manager is listening to, on the other machine.

7) Go to the machine running your Lyris List Manager. Type the command:

    ~lyris/bin/lyris lcp 207.105.6.2

Substituting the TCP/IP address that the Lyris Web Interface on your web server will be coming from. By default, the Lyris List Manager rejects all Lyris Command Protocol connection requests from unknown TCP/IP addresses. This step is necessary so that the lyris.pl script on your web server is allowed to connect to your Lyris List Manager.

8) Stop your Lyris List Manager, and start it in debug mode, with the command:

    ~lyris/bin/lyris start debug

Now, try to display the web interface by pointing a web browser at the URL http://web.server/cgi-bin/lyris.pl. The web interface should appear in your browser. If it does not, look at the Lyris List Manager console. If it says, "unauthorized connection attempt from ZZZZ", then repeat step #7 for that TCP/IP address and try again. If something else is wrong, go to your cgi-bin directory, type /lyris.pl and see what happens. You should get a page of HTML. If you do not, an error message will be displayed indicating the problem.

That's all!

Consult Modifying lyris.plc. If you would like additional information about the configuration options available in the web interface.

More:

If you get the "Protocol Not Supported" Error

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