To remove the Windows service from the command line, open a command prompt, change to the ListManager directory, and run the following command: lm -remove
To start ListManager from the command line after installing it as a service, run the following command: net start listmanager
To stop ListManager from the command line after installing it as a service, run the following command: net stop listmanager
Running MSDE as a Service
MSDE is installed to automatically run as a service. To start MSDE from the command line after it has been installed as a service, run the following command: net start mssqlserver
To stop MSDE from the command line after it has been installed as a service, run the following command: net stop mssqlserver
Installing on Linux
Installing ListManager on Linux -- Overview
See General Installation Instructions for general information about installing
ListManager on all platforms and database servers.
Also see Supported Platforms for supported operating systems and databases. Other operating systems and databases have not been tested, and are not supported.
ListManager for Unix does not include a database as part of the installer. Before you install ListManager on Linux, you will need to have a database server already installed, and client software installed on the ListManager server if it will be connecting to the database remotely.
After downloading the correct installer for your operating system and database, install
ListManager by running the installation program, "install_lm.pl".
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 52
Please have the following information ready:
Information about your SQL database (if using your own database, not one included with ListManager):
The name of your SQL machine.
The SQL database server login or user name (blanks allowed for MSSQL with integrated security).
The SQL database password (blanks allowed for MSSQL with integrated security).
The database name.
Whether or not you have a mail server running on the ListManager machine. See
Mail Server Coexistence for more information.
What port you'd like the web interface on, if you already have a web server running
(Unix only).
Your ListManager serial code. If you don't have a serial code, contact your Lyris account representative at 800-768-2929 or [email protected]
.
The email address and password of the server administrator.
If you have previously installed ListManager, you should still run the "install_lm.pl" program. It will ask you if you are upgrading an existing copy of ListManager, and if you answer yes, will automatically upgrade your ListManager installation for you.
Required Unix File Descriptors
The number of file descriptors you need depends on the version of ListManager you are running. We recommend the following number of file descriptors depending on your license level:
File Descriptors
License
Platinum or less
10,000 msgs/hr
Platinum Plus100,000 msgs/hr
Diamond200,000 msgs/hr
Extreme300,000+ msgs/hr
File Descriptors
1000
2000
4000
8000
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 53
On most versions of Unix, run the following command: ulimit -n
If the number displayed is smaller than the values displayed above for your license, you do not have enough file descriptors for ListManager to function properly.
Run the following to increase them: ulimit -n 4000
Example: root@siri2:/# ulimit -n
64 root@siri2:/# sh
# ulimit -n 4096
# ulimit -n
4096
#
Installing/Running as Non-Root
We strongly recommend that ListManager run as root. Normally, ListManager runs as root to have access to the ports and network files only root has access to (e.g., SMTP on 25).
However, if you want to install and run ListManager with a user other than root, simply run the installer as the user who should own ListManager. The installer will warn you against doing so, and inform you that the standard ports ListManager uses will be moved as follows:
Tcl Webserver: 1080
SMTP: 1025
NNTP: 1119
In order for others to access ListManager, you will need to route traffic that normally would come to ListManager on ports 80, 25 and 119 to the ports specified for your
ListManager installation.
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 54
Installing on Linux
When installing and running ListManager, you will need to be logged in as root.
Basic Installation
1. Download the installation file.
2. Untar and unzip the file in the directory of your choice. gunzip lm-x.x-abcd.tar.gz tar xf lm-x.x-abcd.tar
3. Cd to the directory created after untarring/unzipping the installation file.
4. Run (as root):
./install_lm.pl
After installation is complete, you may remove the files created by the installer.
Oracle and ListManager (Linux)
NOTE: Although ListManager may use Oracle, Lyris does not support the Oracle database itself. These instructions are provided for the convenience of those using
ListManager with Oracle. For complete Oracle documentation, go to http://oracle.com/ .
Before installing ListManager, you’ll need to install the Oracle Client Tools (or Basic
Client Software) on the machine which will be running ListManager. Then, you’ll create a user and password to be used by ListManager. When you’re done, you’re ready to install ListManager. Your DBA (database administrator) can assist you in installing the client software on the server that will be running ListManager.
Be sure that LD_LIBRARY_PATH is set to point to Oracle's libraries before installing, and that you select the installer that matches the version of client tools you've installed.
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 55
Permissions Needed to run ListManager against your Oracle database
The DBA will need to know the common permissions required for Oracle users. The following is an example only. You may use any username or a different tablespace if desired. drop user username cascade; create user username identified by password default tablespace users quota unlimited on users; grant connect, resource to username;
Changing the Character Set of your Oracle Instance
Oracle servers, by default, do not install with a character set that allows 8-bit ASCII characters to be represented correctly. Any high ASCII characters (greater than 127) are translated into other characters. This can cause a problem if you expect that any mail flowing through ListManager will use special accent characters, such as ÿ or á. If your server has this problem, ListManager will give you one of these errors when starting it in the foreground:
Your database is not configured to store all data exactly as it was sent. This will cause some messages, especially those in foreign languages, to be incorrectly saved. It is recommended that you change your database configuration to ensure that this is not a problem.
Your database and/or client configuration will cause problems, as errors were generated when special characters (such as used by foreign languages) were sent and/or retrieved from the database. This will VERY LIKELY CAUSE ERRORS and should be corrected before continuing.
To solve this problem, create your Oracle instance with an 8-bit ASCII character set. If you don't have a preference, we recommend you use:
WE8ISO8859P1
However, if you choose a different character set, the data will be translated into the client character set, which will almost certainly cause problems. The client character set can be configured using an environmental variable called NLS_LANG. The syntax of the variable is <language>_<country>.<char set>, such as
American_America.US8PC437
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 56
Setting the Environment Variable for Unix
For a UNIX client, set the environment variable in this manner. Try each one until the error message no longer appears on boot up. csh/tcsh: setenv NLS_LANG 'AMERICAN_AMERICA' setenv NLS_LANG 'AMERICAN_AMERICA.WE8ISO8859P1' setenv NLS_LANG 'American_America.US8PC437' sh/bash: NLS_LANG='AMERICAN_AMERICA'; export NLS_LANG
NLS_LANG='AMERICAN_AMERICA.WE8ISO8859P1'; export NLS_LANG
NLS_LANG='American_America.US8PC437'; export NLS_LANG
Once you have determined which one is the correct one, you should configure the appropriate startup file (e.g., /etc/profile or similar) to set NLS_LANG so that
ListManager will have it set properly at startup.
Database Server Password Security
As the database password is saved unencrypted in a file ( lmcfg.txt
), you may later remove the password saved in this file and then specify that the password be provided on startup by altering this file.
Installing ListManager by Hand
If you do not want to use the "install_lm.pl" script, you can follow these steps to install
ListManager by hand.
1. Uncompress the ListManager tar file to the directory from which you will run it
(which will henceforth be referred to as ~lm).
2. Install and configure the appropriate database software or client software. Create a database for ListManager to use.
3. Rename ~lm/bin/lmcfg_template.txt to lmcfg.txt, and edit it, adding database connection information.
Note that 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.
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 57
Check the database connection by running the following command:
~lm/bin/lm version
If ListManager connects successfully, a version string is displayed.
4. Run the following command:
~lm/bin/lm dbcreate <admin-password>
To create the Lyris database tables. Specify the administrator password you would like to use on this server. For example, "lm dbcreate sesame" would create an account named "admin" with a password of "sesame"
5. Run the following commands:
lm serial yourserialnumber lm getactivation
This will enter your serial number, and retrieve your activation code.
6. If you want ListManager 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.
7. If you do not allow ListManager to listen to 127.0.0.1, you will need to edit the file
"tclhttpd.rc" that is located in your tclweb/bin directory, so that the line which reads
"Config ipaddr" points to a TCP/IP address that ListManager is listening on.
Note: The Command Protocol that the web interface uses to communicate with
ListManager listens on port 2021.
8. 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 ListManager in the foreground, or run the command:
/opt/lm/bin/lm start 1>/tmp/lm_stdout 2>/tmp/lm_stderr &
You can now run ListManager in the foreground with the command:
/opt/lm/bin/lm start
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 58
Note:
If you run ListManager in the foreground without running the output to a logfile, and you inadvertently click on the window commenting any text, the process running in the window will halt. To stop this from occurring, either:
- pipe the output to a logfile or
- turn off the Quick edit mode by right clicking on the Windows bar and going to
Properties -> Options -> uncheck "Quick edit".
To start ListManager in the background, in "sh" or "bash" use a command such as
/opt/lm/bin/lm start 1>/tmp/lm_stdout 2>/tmp/lm_stderr &
To run ListManager in the background. If you encounter a problem, run ListManager in the foreground, with the command "~lm/bin/lm start".
9. Send mail to listmanager@your-server to make sure that ListManager is answering email.
10. 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.
11. 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/httpdlm-stderr.txt &
To run the ListManager Web Server in the background.
12) With a web browser, go to the URL http://your-server.com/.
For Linux users, Linux normally has a limitation of 4096 file descriptors for the whole
OS (1024 max per process). To increase the maximum for the whole OS, you edit the
/proc/sys/fs/file-max file.
ListManager should now be running on your system.
Lyris, Inc. | 6401 Hollis Street, Suite 125 | Emeryville CA 94608 USA |
www.lyris.com
Toll free +1.800.768.2929 | International calls +1.510.844.1600å | Fax +1.510.844.1598
Page 59
