Section 20 Editing LISTSERV Maestro INI Files

The following rules apply to the lui.ini, hub.ini, tracker.ini, and tomcat.ini INI-files, which are the configuration files for the Maestro User Interface, Administration Hub, and Maestro Tracker components. (The my.ini configuration file of the internal MySQL database follows different rules since it’s a third party product. See the MySQL documentation for details.)

·          All INI-files are text files and assumed to be encoded in the default encoding for the platform being used. For most English/European installations that would be ISO-8859-1 [Latin 1 – Western European].

·         In the files, every parameter occupies one line. Each line must be terminated by a line terminator (LF, CR, or CRLF). All lines in the file are processed.

·         A line that contains only white space or whose first non-white space character is an ASCII “#” or “!” is regarded as a comment, and its content is ignored.

·         Every line other than a blank line or a comment line describes one parameter (except if a line ends with a backslash “\”, then the following line, if it exists, is treated as a continuation line, as described below).

·         A parameter always consists of a key and a value. Keys and values are separated by white space or “=” or “:”. Any white space around the separation character is also ignored.

·         All remaining characters on the line become part of the associated value. Some characters which otherwise have special meanings, need to be escaped with a backslash. The ASCII escape sequences “\t”(TAB), “\n”(LF), “\r”(CR), “\\”(backslash), “\"”(quotation mark), “\'”(apostrophe), “\ “(space), and “\uxxxx” (where “xxxx” is the Unicode-value of the required character, expressed in hexadecimal format) are recognized and converted to single characters.

·         In the case that the last character on a line is a “\”, then the next line is treated as a continuation of the current line; the “\” and line terminator is simply discarded, and any leading white space characters on the continuation line are also discarded and are not part of the parameter value.

Examples:

Each of the following four lines specifies the key "Truth" and the associated value "Beauty":

Truth = Beauty

Truth:Beauty

Truth             :Beauty

Truth Beauty

The following three lines specify a single parameter:

fruits                        apple, banana, pear, \

                                  cantaloupe, watermelon, \

                                  kiwi, mango

The key is "fruits" and the associated value is:

apple, banana, pear, cantaloupe, watermelon, kiwi, mango

Note that a space appears before each “\” so that a space will appear after each comma in the final result; the “\”, the line terminator and leading white space on the continuation line are discarded and are not replaced by one or more other characters.

As a last example, the line:

cheeses

specifies that the key is "cheeses" and the associated value is the empty string.

20.1 Maestro User Interface INI-File Entries

The following table shows all possible entries of the lui.ini file for the Maestro User Interface component. For any entry that is missing in the INI-file, the corresponding default value is assumed. Changes in INI files require a restart of the affected component in order to take effect.

  Table 4              Maestro User Interface INI-File Entries

Entry Key

Description

AllowCharsetChoice

Defines if the user is allowed to change the content charset on a job-by-job basis, or if he has to accept the default charset (see “DefaultMailCharset”).
Default:
true

See Section 23.1 Defining the Default Mail Charset

AllowISO-i-Mails 

Defines if the special bi-directional charsets”ISO-8859-6-i” and “ISO-8859-8-i” will be used in outgoing mail instead of their normal Iso-8859 counterparts.

Default: true

See Section 23.2 Allowing or Disallowing Bi-Directional Character Sets.

ChangeLog

Specifies whether or not a change log of subscriber activities (for hosted lists and datasets) is to be created.

(Optionally) If a change log file is used, then this defines the time period for each log (i.e. daily, weekly, monthly, or yearly).

See Section 13.2 Subscriber Activity Change Log.

Default: false

ClickThroughURL

Path-part of the click-through tracking URL used for URLs without passing of merged parameters.
Default:
/trk/click

ClickThroughPPURL

Path-part of the click-through tracking URL used for URLs with passing of merged parameters.
Default:
/trk/clickp

CreatePersonalProfileTables

Specify whether full personal profiles should be stored in the system database when personal tracking is used.
Default:
true

See Section 19 Tracking and Recipient Profiles

DefaultMailCharset

Defines the charset that is to be used as the charset of the content for newly created jobs that are not copies of existing jobs. May or may not be changed by user (see “AllowCharsetChoice”).
Default:
ISO-8859-1

See Section 23.1 Defining the Default Mail Charset

ExpiredConfirmCleanupInterval

Determines how often the system looks for (and cleans out) expired unconfirmed subscriptions to hosted tables and lists (i.e., subscriptions that were not confirmed during the given expiration interval – see INI-file parameter OptInConfirmationExpiration). Specified as a number, which defines the cleanup interval length in “hours” (i.e., every “N” hours the system checks for expired subscriptions and cleans them out).

Default: 1

See the LISTSERV Maestro Data Administrator’s Manual for more information about subscription confirmations.

ExternalHostName

The host name of the Maestro User Interface server as seen by clients that access the user interface with a web browser. To be used if clients shall access the server with a different host name than the normal internal host name of the server, for example if the server has several names or when using a proxy.

Default: normal host name (canonical host name) of the server running the Maestro User Interface.

See Section 21 Distributed Components

ExternalHTTPPort

The HTTP (or HTTPS) port of the Maestro User Interface server as seen by clients that access the user interface with a web browser. To be used if the external port of the server is different than the default for the protocol employed (both if the normal HTTP or the secure HTTPS protocol is employed).
Default:
80 (if the protocol is HTTP) or 443 (if the protocol is HTTPS)

See Section 14.2.1 Configuring the HTTP Port

ExternalProtocolIsHTTPS

Defines if HTTPS is used as the access protocol for the Maestro User Interface web-interface pages. Set to “true” if HTTPS is used, or “false”, if normal HTTP is used.

Default: false

See Section 18 Securing Access With SSL

Home

Home folder in which work-files are kept.
Default: subfolder “
lui” in installation folder

HubContext

Context-path part of the user interface access URLs for the Administration Hub component.

Default: hub

HubExternalHostName

The host name of the Administration Hub server as seen by clients that access the hub interface with a web browser. To be used if clients shall access the hub server with a different host name than the normal internal host name of the server, for example if the server has several names or when using a proxy.

Default: the host name defined by the RegistryHubHost parameter. If that parameter is not present either, the normal host name (canonical host name) of the server running the Maestro User Interface.

See Section 21 Distributed Components

HubExternalHTTPPort

The HTTP (or HTTPS) port of the Administration Hub server as seen by clients that access the hub user interface with a web browser. To be used if the external port of the server is different than the default for the protocol employed (both if the normal HTTP or the secure HTTPS protocol is employed).

Default: 80 (if the protocol is HTTP) or 443 (if the protocol is HTTPS)

See Section 14.2.1 Configuring the HTTP Port

HubExternalProtocolIsHTTPS

Defines if HTTPS is used as the access protocol for the Administration Hub web-interface pages. Set to “true” if HTTPS is used, or “false”, if normal HTTP is used.

Default: false

See Section 18 Securing Access With SSL

HubRMIPort

Internal communication port (RMI-Port) of the Administration Hub server.
Default:
1099

See Section 14.2.2 Configuring the Internal Communication Port

MaintenanceMode

Defines if the Maestro User Interface component will run in maintenance mode or not.
Default:
false

See Section 8.2 Runtime Administration and System Shutdown

OpenUpURL

Path-part of the open-up tracking URL.
Default:
/trk/open

OptInConfirmExpiration

The expiration time for unconfirmed subscriptions to hosted datasets and lists – i.e., the amount of time after the initial subscription request during which the subscriber may confirm the subscription (“double opt-in”) before the subscription request expires and is removed. Specified as a number, which defines the expiration time in hours.
Default:
48

See the LISTSERV Maestro Data Administrator’s Manual for more information about subscription confirmations.

RegistryHubHost

Host name of the server with the Administration Hub component.
Default:
localhost

RemoteAdminPassword

Password for remote log file access.
Default: none (no remote log file access allowed)

RestoreBackup

Path name of the folder containing the backup that shall be restored during the next startup. Note: This key will be automatically removed from the INI-file during the next startup.

Default: none

See Section 11.7 Restoring a Backup

RMIPort

Internal communication port (RMI-Port) of the Maestro User Interface server.
Default:
1099

See Section 14.2.2 Configuring the Internal Communication Port

TrackerHost

Host name of the server with the Maestro Tracker component.
Default:
localhost

See Section 21.2.3 Moving the Maestro Tracker Component to Another Server

TrackerRMIPort

Internal communications port (RMI-Port) of the Maestro Tracker server

Default: 1099

See Section 14.2.2 Configuring the Internal Communications Port

UnsubscribedCleanupInterval

Determines how often the system looks for (and cleans out) subscribers of hosted LISTSERV lists that have unsubscribed by email (i.e. not by the LISTSERV Maestro web interface). Specified as a number, which defines the cleanup interval length in “minutes” (i.e., every “N” minutes the system checks for unsubscribed subscribers and cleans out their data.)

Default: 10

See the LISTSERV Maestro Data Administrator’s Manual for more information about subscription confirmations.

 

20.2 Administration Hub INI-File Entries

The following table shows all possible entries of the hub.ini file for the Administration Hub component. For any entry that is missing in the INI-file, the corresponding default value is assumed. Changes in INI files require a restart of the affected component to take effect.

   Table 5              Administration Hub INI-File Entries

Entry Key

Description

Home

Home folder in which work-files are kept.
Default: subfolder “
hub” in installation folder

RegistryDomain

The domain name with which the Administration Hub component stores its settings in its own registry.
Default:
HUB

RemoteAdminPassword

Password for remote log file access.
Default: none (no remote log file access allowed)

See Section 13.1 Remote Log Access

RMIPort

Internal communication port (RMI-Port) of the Administration Hub server.
Default:
1099

See Section 14.2.2 Configuring the Internal Communication Port

 

20.3 Maestro Tracker INI-File Entries

The following table shows all possible entries of the tracker.ini file for the Maestro Tracker component. For any entry that is missing in the INI-file, the corresponding default value is assumed. Changes in INI files require a restart of the affected component to take effect.

  Table 6              Maestro Tracker INI-File Entries

Entry Key

Description

FixUserAgentTable

Set this key to “true” if you want Tracker to check the user-agents table for consistency and to repair it (if there is any file corruption found). Tracker will notice the key during the next startup and perform the check/repair during the startup.

This key is automatically removed from the INI-file during startup.

Default: none

Use this only if instructed to by L-Soft Support.

Home

Home folder in which work-files are kept.
Default: subfolder “
trk” in installation folder

HubRMIPort

Internal communication port (RMI-Port) of the Administration Hub server.
Default:
1099

See Section 14.2.2 Configuring the Internal Communication Port

RegistryDomain

The domain name with which the Maestro Tracker component stores its settings in the Administration Hub registry.
Default:
TRK

RegistryHubHost

Host name of the server with the Administration Hub component.
Default:
localhost

RemoteAdminPassword

Password for remote log file access.
Default: none (no remote log file access allowed)

See Section 13.1 Remote Log Access

RMIPort

Internal communication port (RMI-Port) of the Maestro Tracker server.
Default:
1099

See Section 14.2.2 Configuring the Internal Communication Port

20.4 Tomcat INI-File Entries

The following tables show all possible entries of the tomcat.ini file for Tomcat. For any entry that is missing in the INI-file, the corresponding default value is assumed. Changes in INI files require a restart of the affected component to take effect.

20.4.1 Basic Tomcat Configuration Parameters

The following table shows the basic entries of the tomcat.ini file for Tomcat.

                         Table 7              Basic Configuration for Tomcat INI-File Entries

Entry Key

Description

BindAddress

The local IP-address that the server shall bind to (i.e. the server will accept connections only if directed to this IP Address).

Default: By default, the server binds to all addresses of the local computer (i.e. accepts connections on all of these addresses).

See Section 15 Defining IP Addresses.

MaxPostSize

The maximum size (in bytes) that the server will accept in a POST request (i.e. the maximum size of bytes that be uploaded to the server). The limit can be disabled by setting to a value less than or equal to 0.

Default: −1 (i.e. the limit is disabled by default).

Port

The HTTP (or HTTPS) port used to accept client connections.

Default: 80 (for HTTP) or 443 (for HTTPS).

Restrict.CONTEXT.N

Restrict access to component specified by “CONTEXT” (HUB, LUI, TRK, and LIST) to certain IP addresses.

See Section 17.1 IP Address Restrictions.

ShutdownPort

The port used listen for shutdown requests.

Default: 8007

SSL-Related Entries (See Section 18 Securing Access with SSL)

SecureServer

Defines if the server is supposed to be secure (true) or not (false). A secure server uses the HTTPS protocol; a non-secure server used the normal HTTP protocol.

Default: false

KeystoreFile

Only used if “SecureServer=true”.

The name of the keystore-file that contains the server certificate to be used for the HTTPS protocol. The file must exist and must contain a usable server certificate. The given filemane must include the full absolute path to the file (for Windows, include the drive letter).

Default: [install_folder]/conf/keys.keystore

KeystorePassword

Only used if “SecureServer=true”.

The password used to access the keystore-file as defined by the “KeystoreFile” entry.

Default: changeit 

20.4.2 Advanced Tomcat Configuration Parameters

The following table shows the advanced entries of the tomcat.ini file for Tomcat. Do not change these unless instructed by L-Soft Support.

                 Table 8              Advanced Configuration for Tomcat INI-File Entries

Entry Key

Description

AcceptCount

The maximum queue length for incoming connection requests when all possible request processing threads are in use. Any requests received when the queue is full will be refused.

Default: 100

AllowTrace

Specifies whether the TRACE HTTP method is enabled (true) or not (false).

Default: false

BufferSize

The size (in bytes) of the buffer to be provided for input streams servicing incoming requests.

Default: 2048

ConnectionLinger

The number of milliseconds during which the sockets used by the server will linger when they are closed. Socket linger can be disabled by setting this entry to “−1”.

Default: −1 (disabled by default)

ConnectionTimeout

Defines the number of milliseconds the server will wait, after accepting a connection, for the request URI line to be presented.

Default: 60000 (60 seconds)

DefaultContext

Defines the default context. See Section 25 Adding Content to the Tomcat Server for details.

Default: none

MaxKeepAliveRequests

The maximum number of HTTP requests which can be pipelined until the connection is closed by the server. Setting this entry to “1” will disable HTTP/1.0 keep-alive as well as HTTP/1.1 keep-alive and pipelining. Setting this entry to “-1” will allow an unlimited amount of pipelined or keep-alive HTTP requests.

Default: 100

MaxSpareThreads

The maximum number of unused request processing threads that will be allowed to exist until the thread pool starts stopping the unnecessary threads.

Default: 50 

MaxThreads

The maximum number of request processing threads to be created by this server (i.e. the maximum number of simultaneous requests that can be handled).

Default: 200

MinSpareThreads

The number of request processing threads that will be created when the server is first started. The server will also make sure that it has the specified number of idle processing threads available. This entry should be set to a value smaller than that for the “MaxThreads” entry.

Default: 10

SSL-related Entries (See Section 18 Securing Access with SSL)

KeystoreType

Only used when “SecureServer=true”.

Defines the type of the keystore-file. Possible types are “JKS” or “PKCS12”. Usually you should use keystore files of the “JKS” type.

Default: JKS

SSLProtocol

Only used when “SecureServer=true”.

Defines the version of the SSL protocol to use. Possible versions are “TLS” and “SSL”. It is recommended to always use the “TLS” protocol.

Default: TLS