How to Install the Web Interface by Hand

The ListManager Web Server does not need to be installed on the same machine as ListManager; it can be on a different machine. The easiest way to install the ListManager Web Server on another machine is to run the installer on that machine and select the appropriate option to install just the web server.

However, if you wish to install the ListManager Web Server by hand on a different machine, follow these steps:

1) Uncompress the ListManager archive to the directory from which you will run the ListManager Web Server. Note: We use the name ~lm to refer to this directory.

2) The file ~lm/tclweb/lib/lyris.plc contains the configuration settings for the web interface. Change the line which reads "server_ip_address=127.0.0.1" to instead point to a TCP/IP address that your ListManager is listening to, on the other machine.

3) On the machine running ListManager, type the command:

~lm/bin/lm lcp 207.105.6.2

Substituting the TCP/IP address that the ListManager Web Interface on your web server will be coming from. By default, the ListManager 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 ListManager.

4) Now, type the command:

~lm/bin/lm tclport 207.105.6.2

Again substituting the TCP/IP address that the ListManager Web Interface on your web server will be coming from. Tclport is an additional protocol, similar to LCP, used by the ListManager Web Server.

5) Rename the file ~lm/tclweb/bin/tclhttpd_template.rc to tclhttpd.rc. Edit it, replacing ‘$HOSTNAME’ with the name of the machine; ‘$PORT’ with the port you want the web server to listen to (e.g., 80); and ‘$EMAILADDR’ with the email address of the administrator.

5) Run the command:

~lm/tclweb/bin/httpd-lm

To run the ListManager Web Server in the foreground, or run the command:

~lm/tclweb/bin/httpd-lm 1>/tmp/httpd-lm-stdout.txt 2>/tmp/httpd-lm-stderr.txt &

To run the ListManager Web Server in the background.

6) Stop ListManager, and start it in debug mode, with the command:

~lm/bin/lm start debug

Now, try to display the web interface by pointing a web browser at the URL http://your.web.server/. The web interface should appear in your browser. If it does not, look at the ListManager console. If it says, "unauthorized connection attempt from ZZZZ", then repeat step #7 for that TCP/IP address and try again.

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