Lyris User's Guide
[previous] [next] [contents]
How to Install Lyris by Hand
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 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 Lyris by Hand

If you do not want to use the "install_lyris" script, you can follow these steps to install it by hand.

1) uncompress lyris tar file to the directory where you want to run it from

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 following files in the ~/lyris/cgi directory to the "cgi-bin" directory on your web server: lyris.pl, lyrislib.pl, lyrispg.pl, lyris.plc. 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) run "~/lyris/bin/lyris dbcreate <admin-password>" to create the Lyris databases. Specify the administrator password you would like to use on this server. For example, "lyris dbcreate sesame" would create an account named "admin" with a password of "sesame"

7) run "~/lyris/bin/lyris dns 127.0.0.1" to assign Lyris to your DNS server. Change "127.0.0.1" to the TCP/IP of your DNS server.

8) if you want Lyris to run its SMTP receiving agent on a alternate port, run "~/lyris/bin/lyris smtpport 26" where "26" specifies the port you want Lyris to use.

9) if you want Lyris to only listen to specific TCP/IP addresses, run "~/lyris/bin/lyris tcpip 207.105.6.2 127.0.0.1" substituting the TCP/IP addresses you want Lyris to use. Note that we recommend that you let Lyris listen to the localhost address (127.0.0.1) because the Lyris Web Interface (lyris.pl) goes to that by default. If you do not allow Lyris to listen to 127.0.0.1, you will need to edit the file "lyris.plc" that is located in your cgi-bin directory, so that the line which reads "server_ip_address=" points to a TCP/IP address that Lyris is listening on. Note that the Lyris Command Protocol that the web interface uses to communicate with the Lyris Server, listens on port 2020.

10) read the directions below to decide on a method for having Sendmail and Lyris coexist.

11) Run the command "ulimit -n 512" to increase your file descriptor limit. Then, run "~/lyris/bin/lyris start" to run Lyris in the foreground or run "~/lyris/bin/lyris -bd" to run Lyris in the background. If you encounter a problem, run Lyris in the foreground, in debug mode, with the command "~/lyris/bin/lyris start debug"

12) send mail to lyris@your-server to make sure that Lyris is answering email

13) cd to your web server's CGI directory. Run "./lyris.pl". You should see a page full of HTML displayed.

14) With a web browser, go to the URL http://localhost/cgi-bin/lyris.pl and follow the configuration instructions.

15) Copy the file "S96lyris" from the Lyris /bin installation directory, into your /etc/rc2.d directory. If you did not install Lyris in /opt/lyris you will need to edit this file to point to the location where you did install Lyris to. This S96 file will automatically start and stop the Lyris background daemon whenever you boot up and shut down.

16) run the command "/usr/bin/ulimit -n". If a number smaller than 150 is displayed, you do not have enough file descriptors for Lyris to function correctly.

On most Unixes, you can increase your file descriptor limit by issuing the command:

    ulimit -n 512

be sure to issue this command before you run Lyris. Note that the S96Lyris file does this for you before running the Lyris background daemon. If you always use this S96lyris to start and stop Lyris, then you do not need to worry about file descriptors, since it fixes this for you.

On Solaris, to permanently increase the maximum file descriptor limit, add these two lines to /etc/system

    set rlim_fd_max=0x400
    set rlim_fd_cur=0x300

You will need to reboot your Solaris in order for this change to take effect. Once you reboot, check that the change worked, with "/usr/bin/ulimit -n"

That's all! Lyris should now be running on your system!

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