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
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 188.8.131.52" 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.
Consult Modifying lyris.plc if you would like additional information about the configuration options available in the web interface.