Setting Server Options

The following command line parameters let you set ListManager's configuration options.

Some of these parameters can be changed from the "Server Configuration" Web Interface page. The command line versions are included for convenience (particularly when you need to change options that are critical to the Aurea List Manager web interface).

To use them, open a command prompt, and change to the directory where you have installed Aurea List Manager. Then run any of the following:

• lm command
• ./lm command

If you're using Unix.

• activate
  Set ListManager activation code number to that specified on the command line.

Usage: lm activate code

In the above example, you would substitute code with your own activation code. You should not need to use this command, as it is done automatically by Aurea List Manager during installation.

• clearactivation

Clears the activation code.

Usage: lm clearactivation

If you are moving Aurea List Manager to another machine or are changing the network card, you must run clearactivation before activating your serial code on your new machine.

If there is no serial code, Aurea List Manager returns an error. Run lm serial to set the serial code.

• displaydns

No longer implemented. In older versions, it displayed the IP addresses of the DNS servers.

• dns

Aurea List Manager 6.0h and higher features an integrated DNS engine, so this setting is no longer available for users of 6.0h and higher. You no longer need to set up, configure, or maintain a DNS server for Aurea List Manager to use, nor is Aurea List Manager limited by slow DNS servers.

If you are running an earlier version of Aurea List Manager, we recommend you upgrade Aurea List Manager.

For those running 6.0g and earlier,this command allows you to set the Domain Name Server to the TCP/IP address specified on the command line.

Usage: lm dns ip_address [ip_address2] [...]

In the above example, you would substitute ip_address with the IP address of your DNS server. If you want to specify multiple DNS servers, you may do so by separating them with a space.

•  email
  Sets the email address of the administrator of this Aurea List Manager.

Usage: lm email emailaddress

In the above example, you would substitute "emailaddress" with the email address of the person who is the primary server admin.

• forward
  Set mail forwarding rule to "ip-address port".

Usage: lm forward ip_address port

In the above example, you would substitute ip_address with the IP address of the machine you want ListManager to forward non-ListManager mail to, and you would substitute port with the port number on that machine that is receiving mail.

• getactivation

  Activates your Aurea List Manager serial code.

  Usage: lm getactivation

  If Aurea List Manager has a valid serial code that has not been activated for another server, getactivation provides the activation code for the server. Stop and restart Aurea List Manager to have the new code take effect.

  If you have changed your Aurea List Manager license, it is updated automatically within 24 hours. However, if you'd like to unlock your new license sooner, getactivation updates your license.

  If you do not have a serial code specified for your server, getactivation returns an error message. Run lm serial (instructions below) to set the serial code from the command prompt.

• gettcpip

Specifies the first TCP/IP address on your server.

Usage: lm gettcpip

• helotext
  Sets the string ListManager uses in the HELO portion of the SMTP transaction.

Usage: lm helotext hostname

In the above example, you would substitute hostname with the text you want Aurea List Manager to use in the HELO statement. This is extremely useful if you are behind a firewall and machines on the Internet cannot resolve the hostname your machine uses.

• help
  Displays the command line help.

Usage: lm help

• lcp

Aurea List Manager7.5 and higher has been upgraded to use an HTTP based programming toolkit. LCP is no longer used or supported by Aurea List Manager. If you are running a version of Aurea List Manager older than 7.5, we recommend that you upgrade Aurea List Manager.

• mailreceive
  Sets the domains/hostnames the ListManager should accept mail for.

Usage: lm mailreceive domain [domain_2] [...]

In the above example, you would substitute domain with the domain you want Aurea List Manager to accept mail for. This command is extremely useful when you have Aurea List Manager coexisting with another mail server on the same machine, and the Aurea List Manager accepts mail for well defined domains, and passes all other mail onto the other mail server.

• moderatenotification
  Sets the type of moderated message notification for this ListManager host.

Usage: lm moderatenotification [old | new]

Use the "old" argument to receive traditional moderation notifications. Use the "new" argument to receive MIME-digest style moderation notifications.

• nntpport
  Sets the TCP/IP port that ListManager accepts incoming NNTP connections on. The default is 119.

Usage: lm nntpport port_value

In the above example, you would substitute port_value with the port you want Aurea List Manager to listen on for NNTP connections.

• rebrandname

Sets the name used when documents are sent from ListManager. By default, documents are sent from Lyris ListManager. To change this name to another, use the rebrandname option.

Usage: lm rebrandname your name

ListManager must be restarted for this change to take effect.

Changing the name requires that you have a rebrandable license. Contact your account representative at sales@lyris.com for more information about purchasing a rebrandable license.

• rebrandemail

Sets the email address used when documents are sent from Aurea List Manager. By default, documents are sent from lyris-admin@yourserver. Changing the email address removes the name Lyris, and replaces it with the name of your choice.

Usage: lm rebrandemail name

Aurea List Manager provides the @ sign and the domain name, so only add what you would like to come before the @ sign.

Aurea List Manager must be restarted for this change to take effect.

Changing the email address requires that you have a rebrandable license. Contact your account representative at sales@lyris.com for more information about purchasing a rebrandable license.

• reset_tcpip_server_admin

Resets the TCP/IP addresses allowed to access the server admin web interface. Normally, access to the web interface is limited by Utilities: Administration: Server: Server Settings: Security: Web. If the server admin inadvertently locks out access to the web interface, this command can be run to allow any TCP/IP access to the server admin web interface.

Usage: lm reset_tcpip_server_admin

Aurea List Manager and the ListManager web server should be restarted after running this command.

• retrytiming
  Allows you to set the number of retries and retry interval for this Aurea List Manager. The command takes any number of parameters, separated by commas.

Usage: lm retrytiming interval1 [,interval2] [,interval3] [...]

Each interval measures the time, in minutes, between the previous try and the next try. The smallest acceptable retry interval is five minutes and the largest acceptable retry interval is 1440 minutes (24 hours). Retry intervals which are not within the acceptable range is ignored.

For example, if you want to establish a retry schedule of 30 minutes, two hours, eight hours, and 24 hours, you would issue the following command:

lm retrytiming 30,120,480,1440

The default retry schedule is 30 minutes, two hours, four hours, eight hours, and 16 hours.

Please note that the retry interval is measured in relation to the time of the last retry, not the time the message was originally sent.

For most lists, three to five retries is more than enough. Also, it is a good idea to schedule one retry a full 24 hours after the message originally went out, to guard against temporary network outages.

serial

Sets the serial code for the server.

Usage: lm serialcode

Substitute your serial code for code above. Once you have entered your serial code, your activation code is updated within 24 hours. Or, you may activate it immediately by running getactivation.

• smtpport
  Sets the TCP/IP port that ListManager accepts incoming SMTP connections on. The default is 25.

Usage: lm smtpport port_value

In the above example, you would substitute port_value with the port you want Aurea List Manager to listen on for SMTP connections.

• tclport

Add the TCP/IP address specified on the command line to the list of allowed TCLport hosts.

Usage: lm tclport ip_address

In the above example, you would substitute ip_address with the IP address of the machine that makes TCLport connections with this Aurea List Manager host.

• tclportbindip

Sets the IP address Aurea List Manager binds to for tclport, which it uses to generate the web interface.

Using: lm tclportbindip ip_address

• tclportpass

Sets the password that the TCLport uses to log into this Aurea List Manager host.

Usage: lm tclportpass password

• tclportport

Sets the TCP/IP port that ListManager accepts incoming TCLport connections on. The default is 2021.

Usage: lm tclport port

In the above example, you would substitute port with the port you want TCLport on.


• tclporttimeout

Configures the time, in seconds, that a TCLport remains alive before being disconnected by Aurea List Manager. There are some situations where a TCLport connection might not be relinquished by the connecting server. The default timeout is 600 seconds, which should be sufficient for most users. The timeout can be changed with the tclporttimeout command-line parameter.

Usage: lm tclporttimeout seconds

where seconds is the time in seconds that an unused TCLport connection stays connected. Changing this setting isn't normally required, but if you have problems with TCLport connections being used up, you can set this to a lower number, such as 600 seconds.


• tclporttrace

Runs ListManager, and display all tclport (web interface) commands.

Usage: lm tclporttrace

• version
  Displays the version of ListManager that is running.

Usage: lm version