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 126.96.36.199 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:
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 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!