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

  1. 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).
  2. Install and configure the appropriate database software or client software.
  3. Create a database for Aurea List Manager to use.
  4. Rename ~lm/bin/lmcfg_template.txt to lmcfg.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.

  1. Check the database connection by running the following command: ~lm/bin/lm version. If Aurea List Manager connects successfully, a version string is displayed
  2. Run the following command:~lm/bin/lm dbcreate <admin-password>.
  3. 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 named admin with a password of sesame.
  4. Run the following commands: lm serial yourserialnumber lm getactivation. This enters your serial number, and retrieve your activation code.
  5. 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
  6. If you do not allow Aurea List Manager to listen to 127.0.0.1, you need to edit the file tclhttpd.rc file that is located in your tclweb/bin directory, so that the line which reads Config 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.

  1. Run the command: ulimit -n 5000, preferably in the bash shell, to increase your file descriptor limit. Then, run: ~lm/bin/lm start
  2. 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:

  1. Right click the Windows bar.
  2. Go to Properties > Options.
  3. Uncheck Quick edit.
  1. Send mail to listmanager@your-server to make sure that Aurea List Manager is answering email.
  2. Rename the file ~lm/tclweb/bin/tclhttpd_template.rc to tclhttpd.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.
  3. Run the command: ~lm/tclweb/bin/httpd-lm.
  4. 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
  5. To run the Aurea List Manager Web Server in the background, with a web browser, go to the URL http://your-server.com/.
  6. 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.
  7. Aurea List Manager should now be running on your system.