Installing Aurea List Manager manually
Aurea List Manager can still be installed if you do not want to use the install_lm.pl
script from the installer downloaded from support.aurea.com.
Steps for installing Aurea List Manager manually
- Uncompress the
Aurea List Manager.tar
file downloaded from support.aurea.com to the directory from which Aurea List Manager is going to be run (which henceforth is going to be referred to as~lm
). - Install and configure the appropriate database software or client software.
- Create a database for Aurea List Manager to use.
- Rename
~lm/bin/lmcfg_template.txt
tolmcfg.txt
, and edit it, adding database-connection information.
Note
You can install more than one icon on your desktop for different lmcfg.txt
files by adding a command-line argument to specify a different lmcfg.txt
file.
- Check the database connection by running the following command:
~lm/bin/lm version
. If Aurea List Manager connects successfully, a version string is displayed - Run the following command:
~lm/bin/lm dbcreate <admin-password>
. - To create the Aurea List Manager database tables. Specify the administrator password you like to use on this server. For example,
lm dbcreate sesame
creates an account namedadmin
with a password ofsesame
. - Run the following commands:
lm serial yourserialnumber lm getactivation
. This enters your serial number, and retrieve your activation code. - If you want Aurea List Manager to run its SMTP receiving agent on an alternate port, run the following command:
~lm/bin/lm smtpport 26
where 26 specifies the port you want ListManager to use - If you do not allow Aurea List Manager to listen to
127.0.0.1
, you need to edit the filetclhttpd.rc
file that is located in yourtclweb/bin directory
, so that the line which readsConfig ipaddr
points to a TCP/IP address that Aurea List Manager is listening on.
Note
The Command Protocol that the web interface uses to communicate with Aurea List Manager listens on port 2021
.
- Run the command:
ulimit -n 5000
, preferably in the bash shell, to increase your file descriptor limit. Then, run:~lm/bin/lm start
- To run Aurea List Manager in the foreground, run the command
/opt/lm/bin/lm start 1>/tmp/lm_stdout 2>/tmp/lm_stderr
before running the command:/opt/lm/bin/lm start
Note
If you run Aurea List Manager in the foreground without running the output to a log file and you inadvertently click on the window commenting any text, the process running in the window halts. To stop this from occurring, either pipe the output to a log file or, turn off the Quick edit mode.
To turn off the Quick edit mode:
- Right click the Windows bar.
- Go to Properties > Options.
- Uncheck Quick edit.
- Send mail to
listmanager@your-server
to make sure that Aurea List Manager is answering email. - Rename the file
~lm/tclweb/bin/tclhttpd_template.rc
totclhttpd.rc
. Edit it, replacing$HOSTNAME
with the name of the machine. Also, replace$PORT
with the port you want the web server to listen to (For example, 80) and$EMAILADDR
with the email address of the administrator. - Run the command:
~lm/tclweb/bin/httpd-lm
. - To run the Aurea List Manager Web Server in the foreground, run the command :
~lm/tclweb/bin/httpd-lm 1>/tmp/httpd-lm-stdout.txt 2>/tmp/httpd-lm-stderr.txt
- To run the Aurea List Manager Web Server in the background, with a web browser, go to the URL
http://your-server.com/
. - For Linux users, Linux has a limitation of 4096 file descriptors for the whole operating system (1024 max per process). To increase the maximum for the whole operating system, you edit the
/proc/sys/fs/file-max
file. - Aurea List Manager should now be running on your system.