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

How to Install the Web Interface on a separate machine

The Lyris web interface does not need to be installed on the same machine as the Lyris Server, it can be on a different machine. If you already have a production web server, this may be more convenient.

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

By hand, to install the Lyris 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 ~/graphics 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/perl/bin/perl to /usr/bin/perl Make a directory named /usr/local/lib/perl5

4) Copy the files in ~/lyris/perl/lib to your Perl library directory that should be /usr/local/lib/perl5

5) Copy the files in the ~/lyris/cgi 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) In your web server's cgi-bin directory, you will find a file named "lyris.plc" which contains the configuration settings for the Lyris Web Interface. Change the line which reads "server_ip_address=127.0.0.1" so instead point to a TCP/IP address that your Lyris Server is listening to, on the other machine.

7) Go to the machine running your Lyris Server. 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 Server 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 server.

8) Stop your Lyris server, 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 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 should 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:

Other pages which link to this page:
  • Installing Lyris on Unix
  • Page 463 of 556