581
Troubleshooting 
Problems Starting the ListManager Server 
If, when starting ListManager, you instead receive an error message about "invalid 
host" then the problem is likely with your TCP/IP machine name configuration.  
This problem is usually caused by an incomplete DNS configuration.  In order for 
ListManager to work, the TCP/IP host name on your machine must exist on your DNS 
server, and the TCP/IP addresses that your machine uses must themselves have 
names.  In technical-lingo, this means that you need both "forward and reverse DNS 
lookups" installed on your system. 
Check the hostname/domain name that you have set in your TCP/IP configuration.  
Make sure that you can ping this full name, both from your machine and from another 
machine.  You must have a DNS entry for your machine on your DNS server.  This 
hostname/domain-name setup is usually the cause of your problem.   
If you have multiple TCP/IP addresses, make sure that the first TCP/IP address on your 
system has a DNS name entry.  
With the program "nslookup.exe" (nslookup on UNIX), you can check to see if DNS 
entries are set up correctly.  If you do not have "nslookup.exe" on your computer, you 
can download it from: ftp://ftp.lyris.com/listmanager/scripts/nslookup.exe
If your computer is named "fia.yourcompany.com", you would type: 
nslookup fia.yourcompany.com 
And nslookup will respond with: 
C:\>nslookup fia.yourcompany.com   <- this is what you type 
Server:  kuno.yourcompany.com <- this is your DNS server   
Address:  207.105.6.156  <- this is your DNS server   
Name:    fia.yourcompany.com <- this is your host name 
Address:  207.105.6.147 <- your tcp/ip address 
If your DNS is not set up correctly, this forward lookup will say: 
*** kuno.yourcompany.com can't find fia.yourcompany.com: Non-existent 
host/domain 
If it did work and you did not get an error message, now do a "reverse lookup" by typing 
the TCP/IP address of your machine.  For example, if the TCP/IP address of your 
machine is "207.105.6.147", you would type: 
C:\>nslookup 207.105.6.147  <- this is what you type 
Server:  kuno.yourcompany.com <- this is your DNS server  
Address:  207.105.6.156  <- this is your DNS server 
How to convert pdf file to html - control SDK system:C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net, ASP.NET MVC, WinForms, WPF application
How to Convert PDF to HTML Webpage with C# PDF Conversion SDK
www.rasteredge.com
How to convert pdf file to html - control SDK system:VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.net, ASP.NET MVC, WinForms, WPF application
PDF to HTML Webpage Converter SDK for VB.NET PDF to HTML Conversion
www.rasteredge.com
582
Name:    fia.yourcompany.com <- your host name   
Address:  207.105.6.147 <- your tcp/ip address 
If your DNS is not set up correctly, the reverse lookup will say: 
*** kuno.yourcompany.com can't find 207.105.6.147: Non-existent host/domain 
If you do have a DNS problem, you should contact the person responsible for your 
DNS.  In most cases, this is your Internet Service Provider.  Once this is fixed, 
ListManager will work correctly for you. 
If you have multiple TCP/IP addresses, and only want ListManager to use some of 
them, see the next section, "Problems with Multiple TCP/IP Addresses
". 
What is the TCP/IP check for? 
The TCP/IP check looks to see if you are running a web server and/or an email server, 
retrieves your host name and TCP/IP address, and checks that your domain name 
server has a TCP/IP entry for your hostname.  Some of this information is used by 
Setup to self-configure ListManager for your system, and other information is used to 
verify that your TCP/IP configuration is correct. 
Do I need a Mail Server to run ListManager? 
No, you do not.   
ListManager has its own mail server built-in and does not need to use another mail 
server.  In fact, the mail engine included with ListManager is much faster than most any 
other mail package available, so by using a different mail engine to deliver mail you will 
actually be slowing down the performance of ListManager. 
ListManager can receive and send Internet email on its own.  If you want to run 
ListManager on a machine that already has a mail server installed, please see "Mail 
Server Coexistence
". 
Problems with Multiple TCP/IP Addresses 
If you have multiple TCP/IP addresses on your machine, some of which have reverse 
DNS defined, and some which do not, you can tell ListManager to only uses the TCP/IP 
addresses which have reverse DNS defined. 
To do this, you use the "tcpip" command line option. 
For example, if you have three TCP/IP addresses, say: 
207.90.101.4 
207.90.101.5 
207.90.101.6 
And the last one, 207.90.101.6, does not have reverse DNS defined, then you want 
ListManager to only use the first two.  To do this, you would run the following command: 
control SDK system:Online Convert PDF to HTML5 files. Best free online PDF html
Download Free Trial. Convert a PDF file to HTML. Just upload your file by clicking on the blue button or drag-and-drop your pdf file into the drop area.
www.rasteredge.com
control SDK system:VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
Convert smooth lines to curves. Detect and merge image fragments. Flatten visible layers. VB.NET Demo Code to Optimize An Exist PDF File in Visual C#.NET Project
www.rasteredge.com
583
lm tcpip 207.90.101.4 207.90.101.5 127.0.0.1 
Each TCP/IP address is separated by a space. Note: We added the TCP/IP address 
"127.0.0.1" to the end.  This is very important: the web interface talks to the 
ListManager server over the 127.0.0.1 TCP/IP address (note: 127.0.0.1 means 
"localhost", or this machine).  If you do not list 127.0.0.1 as a TCP/IP address for 
ListManager to use, your web interface will no longer work (it will say "server 
unavailable").  If you absolutely do not want to have ListManager use 127.0.0.1, you 
can make your web interface work by changing the server_ip= line of the lyris.plc file.  
You can reset ListManager to automatically use all TCP/IP addresses (the default) with 
the command line command: 
lm tcpip 
When using multiple TCP/IP addresses, it is important to remember that the TCP/IP 
address ListManager expects the Activation Code to be bound to is not necessarily one 
of the TCP/IP addresses ListManager is configured to listen to.  To determine which of 
your machine's TCP/IP addresses ListManager expects the Activation Code to be 
bound to, use the "gettcpip" command line option: 
lm gettcpip 
ListManager Does Not Respond to Email I Send to It 
If, when you send mail to ListManager, you never receive a response, it is likely that 
ListManager is not receiving your message.  In such a case, it is most likely that your 
Domain Name Service information is set up incorrectly and that your mail program is 
actually sending your mail elsewhere.   
Very often, the DNS for your organization has been set up so that email sent to a 
specific machine is routed to a mail server rather than to that specific machine.  For 
instance, the "mail preference" setting for a machine named "alpha.yourcompany.com" 
could be set up so that mail to "lyris@alpha.yourcompany.com" is instead sent to 
"lyris@mailserver.yourcompany.com".  In such a case, the mail never gets to 
alpha.yourcompany.com (the machine running ListManager).  That, of course, causes 
problems. 
If you are sure that your DNS is set up correctly, here is how you peek into ListManager 
to see what it happening to incoming mail. 
If you have a the programs and the knowledge to access your SQL Server directly you 
can look in your database at the table called inmail_, and all messages that 
ListManager has received will be there, along with their processing "status". 
Another way is to run ListManager with "debug" on the command line ("lm debug").  
You will then be displayed information as events occur.   Start the ListManager Server, 
and wait for the startup events to end.  Then, mail your message.  If the message gets 
to ListManager, you will see a bunch of activity for a few seconds as the message 
comes in and is processed. 
Here is a sample, correctly set up DNS entry.  Notice how "mail exchanger" with the 
lowest preference (preference = 5) is the machine itself.  This DNS is set up so that any 
mail to jingram.clark.net is sent directly to jingram.clark.net.  The preference=10 line 
indicates that if for some reason the preference=5 host is not available (perhaps it is 
turned off) then mail will be accepted by clarknet.clark.net, who will most likely hold the 
control SDK system:VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
Professional VB.NET PDF file merging SDK support Visual Studio .NET. Merge PDF without size limitation. Append one PDF file to the end of another one in VB.NET.
www.rasteredge.com
control SDK system:C# PDF File Split Library: Split, seperate PDF into multiple files
Application. Best and professional adobe PDF file splitting SDK for Visual Studio .NET. outputOps); Divide PDF File into Two Using C#.
www.rasteredge.com
584
mail and deliver it to jingram.clark.net once that host is once again reachable. 
> jingram.clark.net 
Server:  clark.net 
Address:  168.143.0.7 
jingram.clark.net Internet address = 168.143.7.97 
jingram.clark.net preference = 5, mail exchanger = jingram.clark.net 
jingram.clark.net preference = 10, mail exchanger = clarknet.clark.net 
clark.net       nameserver = sun1.clark.net 
clark.net       nameserver = icm1.icp.net 
jingram.clark.net       Internet address = 168.143.7.97 
clarknet.clark.net      Internet address = 168.143.0.2 
sun1.clark.net  Internet address = 198.17.243.2 
icm1.icp.net    Internet address = 192.94.207.66
Hard Disk Defraggers 
Several people have reported complete system crashes (blue screen of death, reboot) 
on Windows NT when running a hard disk de-fragmenter while the ListManager is busy.   
One person had their defragmenting utility use up all available system memory, thus, 
making it impossible to shut the server down or even terminate the task. 
For this reason, we do not recommend defragmenting your hard disk while the 
ListManager server is running. 
Can ListManager work on an Intranet? 
Can ListManager work on an Intranet, with no connection to the Internet? 
Yes, ListManager will work fine on an Internet TCP/IP based network.  A connection to 
the Internet is not required, as long as you are only using ListManager inside your 
network. 
Bus Error on Unix 
If, when you run the "lm" executable, ListManager crashes with a "bus error", "segment 
violation", or some sort of library error, it is likely that the version of your Unix operating 
system has not had all the Unix vendor's OS patches applied to it. 
Problems with McAfee Netshield 
If you are installing ListManager when running McAfee Netshield, you may have 
problems starting the ListManager web server.  To resolve this issue, stop McAfee 
Netshield, start the ListManager web server, and then restart McAfee Netshield. 
control SDK system:VB.NET PDF Convert to Jpeg SDK: Convert PDF to JPEG images in vb.
Convert PDF to Tiff; C#: Convert PDF to HTML; C#: Convert PDF to Jpeg; C# File: Compress PDF; C# File: Merge PDF; C# File: Split PDF;
www.rasteredge.com
control SDK system:VB.NET PDF File Split Library: Split, seperate PDF into multiple
Professional VB.NET PDF file splitting SDK for Visual Studio and .NET framework 2.0. Split PDF file into two or multiple files in ASP.NET webpage online.
www.rasteredge.com
585
Uninstalling ListManager 
Uninstalling on Windows 
Remove the services for Windows (if applicable): 
1.  Navigate to Start > Program Files > Lyris ListManager > Services. 
2.  Click on Remove ListManager Service. 
3.  Click on Remove LM Web Service. 
Uninstall ListManager: 
1.  Navigate to Start > Settings > Control Panel. 
2.  Select Add or Remove Programs. 
3.  Select Lyris ListManager. 
4.  Click Change/Remove. 
5.  When prompted to remove Lyris ListManager, click Yes. 
Uninstall MSDE (if applicable): 
1.  Navigate to Start > Settings > Control Panel. 
2.  Select Add or Remove Programs. 
3.  Select  Microsoft SQL Server Desktop Engine. 
4.  Click Change/Remove. 
5.  When prompted to remove  Microsoft SQL Server Desktop Engine, click Yes. 
Uninstalling on Unix 
6.  Log in as root. 
7.  Change to the ListManager/bin directory. 
8.  Run the uninstall_lm_now script.  It will delete your ListManager directory and 
everything in it. 
control SDK system:C# PDF File Compress Library: Compress reduce PDF size in C#.net
All object data. File attachment. Hidden layer content. Convert smooth lines to curves. Flatten visible layers. C#.NET DLLs: Compress PDF Document.
www.rasteredge.com
control SDK system:C# PDF File Merge Library: Merge, append PDF files in C#.net, ASP.
Professional C#.NET PDF SDK for merging PDF file merging in Visual Studio .NET. Append one PDF file to the end of another and save to a single PDF file.
www.rasteredge.com
586
ListManager Administration 
What Different Administrative Roles Are There? 
ListManager allows full delegation of rights and responsibilities to others, so that 
administrators only have control over what is appropriate for them to control.  The four 
roles are: 
Server Administrators   
The server administrator controls how the server runs.  The server administrator can 
create sites, and has control over things that affect all the sites on their server.  A server 
administrator can access all Site and List administration menus. 
Site Administrators 
A site administrator typically doesn't deal with the day-to-day workings of a mailing list.  
Instead, the site administrator can create and remove mailing lists, create documents, 
create auto-responders and other functions that affect the site as a whole.  A Site 
Administrator is also entitled to act as the list administrator of any mailing list in their 
site. 
Site administrators typically are not aware of other sites on the servers, nor are they 
aware of mailing lists belonging to these other sites. 
List Administrators 
Typically, someone (or several people) on each mailing list act as the administrator of 
the mailing list.  They can add and remove members of the group, approve moderated 
messages, and other things which concern regular mailing list maintenance. 
Members 
Someone who belongs to a mailing list run by your ListManager.  A mailing list member 
has no administrative powers. 
Each of these roles can be assigned to multiple people and each person can have 
multiple roles.  All roles are protected by a username / password combination and all 
roles except members are required to have a password.  If additional member security 
is desired, members can be required to define a password and will be automatically 
assigned a password if they do not.    
587
Command Line Options 
Starting ListManager 
To run Lyris List Manger, change to the directory where you have installed ListManager.  
Then, run 
lm start 
or 
./lm start 
if running Unix. 
Just plain "lm" with no command line parameters will display the available options and 
then exit: it will not run the program.   
To save the output to a file, run 
lm start 1>lm.log 2>lm2.log 
This command will redirect the standard output and the error log to files in your 
ListManager directory, which may be examined later. 
The "start" action can be modified with a number of options.  The options can be 
anywhere on the command line, in any order.  The options are: 
debug 
Run ListManager and display debugging information while running.   
If you are running ListManager in the foreground, you can toggle debug mode on or off 
without restarting the server.  
On Windows, you can do this by pressing the ctrl-break key.   
displaysmtp 
Run ListManager, and display all SMTP transactions.  This command is run with the 
debug command: 
lm start debug displaysmtp 
mailtest 
Run ListManager, do not actually deliver any email.  It will run completely as normal, but 
during the SMTP transaction will send a RESET and QUIT command right before it is 
supposed to send the DATA command.  This option can be useful to test the load-
capacity and stability of a ListManager installation. 
morestats 
Running ListManager in morestats mode gives additional information in the Server 
Statistics page. 
nocheck 
588
Run ListManager, but do not check for any TCP/IP conflicts.  When it starts up, it first 
checks to see if any other programs are using the TCP/IP addresses and ports that 
ListManager will need to use.  ListManager does this by trying to connect to port 25 
(SMTP mail) and port 2021 (Tclport) on all TCP/IP addresses of the machine, or just the 
TCP/IP addresses ListManager has been configured to use, if the "Multiple TCP/IP 
Addresses" setting has been used.  If one of the ports it needs is being used, 
ListManager will display an error message and not load.  If you prefer, you can bypass 
this test with the nocheck option, and it will start a few seconds faster. 
noincoming 
Run ListManager but do not run the incoming mail processing service. Incoming mail 
will not be processed. 
noindexer 
Run ListManager, but do not run the full text indexing service.  Messages waiting to be 
full text indexed will not be indexed. 
nomail 
Run ListManager but do not send any mail. 
For example, to start ListManager in "debug" mode with no outgoing mail, you would 
use the command: 
lm start debug nomail 
nonntpserver 
Run ListManager, but do not run the nntp server which allows Newsgroup access to the 
mailing lists. 
noscheduler 
Run ListManager, but do not run the scheduled task manager.  Tasks such as digests 
will not be run. 
noscreen 
Run ListManager with no screen output 
nosmtpserver 
Run ListManager, but do not run the SMTP server which receives mail.  No incoming 
mail will be accepted. 
notclport 
Run ListManager with no TCLPORT service (which runs on port 2021, by default).  The 
web interface will not be able to communicate with the server. 
tclporttrace 
Run ListManager so it keeps track of the current state of every tclport thread.   
threadtrack 
When you start ListManager in the foreground with the "threadtrack" option on the 
command line, it will keep track of the current state of every SMTP mail thread.  You 
can view the instant status of all mail sending threads from the server statistics page, 
where this additional information is appended.  This can be informative and useful in 
determining what the ListManager SMTP delivery engine is doing. 
Database Operations 
589
ListManager has a number of command line options for database actions.  To use 
them, open a command prompt, and change to the directory where you have installed 
ListManager.  Then, run  
lm command 
or  
./lm command 
if you're using Unix. 
configclear 
Clears the machine name from the ListManager Config_ table.  ListManager should not 
be running when this command is run. 
configcopy  
Copies an existing ListManager configuration to the machine name specified.  Use this 
option if you are adding a new node to a ListManager cluster. Note: Lyris ListManager 
configuration are stored by machine name: to obtain a list of existing configuration 
names, run the command "lm configlist".  You only need to specify an old-config-name 
if you have several pre-existing configurations in your Lyris ListManager database: 
lm configcopy oldname 
ListManager should not be running when this command is run. 
configlist 
Retreives a list of machine names configured in your Config_ table.  By default, there 
will be only one configuration.   
configmove 
Use this option if you have renamed the Lyris ListManager machine, or moved your 
Lyris ListManager installation to a new machine.   By default, you should only have one 
machine name configured in Lyris ListManager, and by running this command, this one 
configuration will be changed to the new machine name.  
Note: Lyris ListManager configuration are stored by machine name: to obtain a list of 
existing configuration names, run the command "lm configlist". 
You only need to specify an old-config-name if you have several pre-existing 
configurations in your Lyris ListManager database: 
lm configmove oldname 
copy2sql 
Converts ListManager 3.x and 4.x database files to SQL format.  This command creates 
a new ListManager database, and then inserts the data from the FoxPro database.  
Normally, the Setup program takes care of running this program for you when 
upgrading from earlier non-SQL versions.   
After running copy2sql, you'll need to manually update your serial code, either by 
running lm serial yourcode or by running ListManager and entering the code in Server 
Config.   See Setting Server Options
for more information about the serial command.  
ListManager should not be running when this command is run. 
590
dbcreatetemplates 
Creates or updates the default templates.  Normally, the Setup program takes care of 
creating the default templates for you.  The updated templates will not appear until you 
restart ListManager and the ListManager web server. 
dbbillingcreate 
Creates all the database tables used by ListManager for billing.  Any existing billing 
tables in the database will be deleted and recreated, deleting any data in those tables. 
ListManager must not be running when this command is run. 
dbcreate 
Creates all database tables used by ListManager.  Any existing ListManager tables in 
the database will be deleted and recreated.   
If you specify a password on the command line, this will be used to create a default 
administrator account with the name "admin".  If you do not specify a password the 
password for the admin account will be "lyris".   
For example, to create the databases with an admin password of "blue", you would 
type: 
lm dbcreate blue 
Please note that this will completely erase any data you have in the ListManager tables 
in your database and start you anew.  If you are unsure about this command, back up 
your database first. 
ListManager must not be running when this command is run. 
After running dbcreate, you'll need to tell ListManager what your activation code and 
DNS server TCP/IP address are.  You can either insert that data into the Config_ table 
directly, or use a command to enter this information.  See Setting Server Options
for 
more information about the activate and dns commands. 
dbinmailcreate 
Recreate the incoming mail database table, clearing the table that already exists. 
This option is useful if you want to quickly erase all email in the incoming mail database, 
perhaps because you sent a lot of email to ListManager that you now realize you do not 
want it to process.  
ListManager should not be running when this command is run. 
dboutmailcreate 
Recreate the outgoing mail database table, clearing the table that already exists. 
This option is useful if you want to quickly erase all email in the outgoing mail database, 
perhaps because you told ListManager to send a lot of email you now realize you do 
not want it to send. 
ListManager should not be running when this command is run. 
Documents you may be interested
Documents you may be interested