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
|