2.8 Using Messaging Agent Startup Switches

Specifies the full path to the certificate files used to provide secure SSL communication between the Messaging Agent and other programs. See Section 2.3, Configuring Messaging Security with SSL Encryption.

See also /certpath, /keyfile, and /keypassword.

Specifies the full path to the directory where certificate files are stored on your system. See Section 2.3, Configuring Messaging Security with SSL Encryption.

See also /certfile, /keyfile, and /keypassword.

Specifies a Diffie-Hellman cipher parameters file used for SSL/TLS to replace the default parameters set by Messenger. Messenger uses default Diffie-Hellman parameters of 2048 bits to generate the DH key. A valid DH parameter is in PEM format.

Specifies the minimum number of direct access connections you want open at all times between the Messaging Agent and eDirectory. The default is 10 connections. See Section 2.6, Optimizing Messaging Agent Performance.

See also /diridletimeout and /dirmaxconnections.

Specifies the number of seconds after which idle direct access connections in excess of the default number of connections are closed. The default is 30 seconds. See Section 2.6, Optimizing Messaging Agent Performance.

See also /dirdefaultconnections.

Specifies the maximum number of direct access connections you want open between the Messaging Agent and eDirectory. The default is 50 connections. See Section 2.6, Optimizing Messaging Agent Performance.

See also /dirdefaultconnections.

Specifies the number of minutes between the time when the Messaging Agent receives an error response from a pooled LDAP server and the time when that LDAP server is reinstated into the pool of available LDAP servers. The default is 5 minutes. See Providing LDAP Access to eDirectory for Messenger Users.

Specifies the maximum number of query results you want the Messaging Agent to return when users search for other users to add to their contact lists in the Messenger client. The default maximum is 100 contacts. See Section 2.6, Optimizing Messaging Agent Performance.

Specifies the IP address of an eDirectory replica for a Messaging Agent that is running on a Windows server. See Changing the eDirectory Access Method for Starting the Messaging Agent.

Specifies the eDirectory attribute that the Messaging Agent searches on when users use the User ID field to search for other Messenger users. By default, the Messaging Agent searches on the CN attribute. See Customizing Authentication and Searches by eDirectory Attribute.

Indicates that you want users to authenticate to eDirectory by using a bind rather than a compare operation. See Selecting Bind or Compare eDirectory Access for Users.

Indicates that you want users to use direct access to eDirectory even though you have configured the Messaging Agent to use LDAP access. See Using LDAP Access for the Messaging Agent.

Specifies the distinguished name (DN) of the Messaging Agent object where the Messaging Agent configuration information is stored. There is no default location. You must use this switch in order to start the Messaging Agent. See Section 2.1, Starting the Messaging Agent.

Specifies the password for the Messaging Agent to prompt for before allowing Messaging Agent status information to be displayed in your browser. Unless you are using SSL encryption, do not use an existing eDirectory password because the information passes over the connection between your browser and the Messaging Agent. See Using the Messaging Agent Web Console.

See also /httpuser.

Sets the HTTP port number used for the Messaging Agent to communicate with your browser. The setting must be unique on the server where the Messaging Agent runs. See Using the Messaging Agent Web Console.

Sets the availability of SSL encryption between the Messaging Agent and the Web Console displayed in your browser. Valid values are enable and disable. See Using the Messaging Agent Web Console.

Specifies the user name for the Messaging Agent to prompt for before allowing Messaging Agent status information to be displayed in a browser. Providing a user name is optional. Unless you are using SSL encryption, do not use an existing eDirectory user name because the information passes over the connection between your browser and the Messaging Agent. See Using the Messaging Agent Web Console.

See also /httppassword.

Binds the Messaging Agent to a specific IP address when the server where it runs uses multiple IP addresses, such as in a clustering environment. Without the /ip switch, the Messaging Agent binds to all available IP addresses and Messenger clients can communicate with the Messaging Agent on all available IP addresses.

Adjusts the default ping interval at which the Messenger clients notify the Messaging Agent that they are still active. The default interval is every 10 minutes. This regular communication between the Messaging Agent and the client prevents firewalls and routers from disconnecting connections that seem to be inactive. You can decrease the interval if client users are being unexpectedly disconnected. You can increase the interval to decrease network traffic. Use a setting of 0 (zero) to turn off the ping activity.

The ping interval can be adjusted for individual clients by using the /keepalive startup switch with the Messenger client.

Specifies the full path to the private file used to provide SSL encryption between the Messaging Agent and other programs. See Section 2.3, Configuring Messaging Security with SSL Encryption.

See also /keypassword.

Specifies the password used to encrypt the private SSL key file when it was created. See Section 2.3, Configuring Messaging Security with SSL Encryption.

See also /keyfile.

Specifies the language to run the Messaging Agent in, using a two-letter language code as listed below. When you install the Messenger agents, all language versions are automatically installed.

The initial default is the language used by the operating system. If that language is not available, the Messaging Agent runs in English. Use this switch only if you need to override these defaults.

The table below lists the valid language codes:

Specifies the LDAP server's network address as either an IP address or a DNS hostname. See Section 3.2, Customizing eDirectory Access for Users.

See also /ldapport.

Specifies the port number that the LDAP server listens on for service requests. The default is 389. See Providing LDAP Access to eDirectory for Messenger Users.

See also /ldapipaddr.

Provides the password for the LDAP user that the Messaging Agent uses to log in to the LDAP server. See Providing LDAP Access to eDirectory for Messenger Users.

See also /ldapuser.

Indicates to the Messaging Agent that the LDAP server it is logging in to uses SSL encryption. See Section 2.3, Configuring Messaging Security with SSL Encryption.

See also /ldapsslkey.

Specifies the full path to the private SSL key file used with LDAP authentication. See Providing LDAP Access to eDirectory for Messenger Users.

See also /ldapssl.

Specifies the user name that the Messaging Agent can use to log in to the LDAP server to obtain information from eDirectory. See Providing LDAP Access to eDirectory for Messenger Users.

See also /ldappwd.

Specifies the directory where the Messaging Agent will store its log files. The default location is the \novell\nm\ma\log directory. See Using Messaging Agent Log Files.

See also /loglevel, /logdays, /logmax, and /logdiskoff.

Specifies how many days to keep Messaging Agent log files on disk. The default is 14 days. See Using Messaging Agent Log Files.

See also /log, /loglevel, /logmax, and /logdiskoff.

Turns off disk logging for the Messaging Agent so no information about the functioning of the Messaging Agent is stored on disk. The default is for logging to be turned on. See Using Messaging Agent Log Files.

See also /log, /loglevel, /logdays, and /logmax.

Controls the amount of information logged by the Messaging Agent. Logged information is displayed in the log message box and written to the Messaging Agent log file during the current agent session. The default is Normal, which displays only the essential information suitable for a smoothly running Messaging Agent. Use Verbose to display the essential information, plus additional information helpful for troubleshooting. Use Diagnostic to include very detailed, code-specific information. See Using Messaging Agent Log Files.

See also /log, /logdays, /logmax, and /logdiskoff.

Sets the maximum amount of disk space for all Messaging Agent log files. When the specified disk space is consumed, the Messaging Agent deletes existing log files, starting with the oldest. The default is 128 MB. See Using Messaging Agent Log Files.

See also /log, /loglevel, /logdays, and /logdiskoff.

Specifies the maximum number of connections between the Messaging Agent and Messenger clients. The default is 5120. See Section 2.6, Optimizing Messaging Agent Performance.

See also /threads.

Specifies the number of seconds that the Messaging Agent waits for a response from the Archive Agent before returning an error. The default is 5 seconds. See Optimizing the Connection between the Archive Agent and the Messaging Agent.

See also /mtpdatatimeout.

Specify in seconds the amount of time the Messaging Agent tries to send conversations to the Archive agent before reporting an error. The default is 20 seconds. See Optimizing the Connection between the Archive Agent and the Messaging Agent.

See also /mtpdatatimeout.

Specifies the network address of the Server where the Archive Agent runs, as either an IP address or a DNS hostname. By default, the Messaging Agent uses the network address specified on the Identification page of the Archive Agent object.

See also /mtpport.

Specifies the message transfer port number the Archive Agent listens on for conversations to archive. By default, the Messaging Agent uses the message transfer port specified on the Identification page of the Archive Agent object, which is 8312.

See also /mtpipaddr.

Sets the availability of SSL encryption between the Archive Agent and the Messaging Agent. Valid values are enable and disable. See Section 5.6, Enhancing Archive Security with SSL Encryption.

Disables the Messaging Agent's attempts to contact the Archive Agent. You might want to do this if you do not plan to enable archiving.

Disables SNMP for the Messaging Agent. The default is to have SNMP enabled. See Using SNMP Monitoring Programs.

Provides the password for the Messaging Agent to use when accessing eDirectory in order to obtain its configuration information from the Messaging Agent object. This switch is required in order to start the Messaging Agent. See Section 2.1, Starting the Messaging Agent. By default, the password is obfuscated for security purposes. If the password has been obfuscated, the password is prepended with $$: in the startup file. In order to change the obfuscated password, you need to use the NMPassword utility. For additional information on how to use the NMPassword utility, see Section 2.4, Changing the Agent User Password.

See also /user.

Sets the port number on which the Messaging Agent listens for service requests from Messenger clients. The default is 8300. See Section 2.2, Configuring the Messaging Agent in ConsoleOne.

Sets the level of anonymous product information is sent to Micro Focus. The level is initially set during the install or upgrade. The following options are available:

Specifies the directory where the Messaging Agent stores conversations to archive if it is unable to communicate with the Archive Agent. The default is \novell\nm\ma\queue. See Moving the Messaging Agent Conversation Holding Queue.

Sets the SSL cipher suites used by the Archive Agent, the Messaging Agent, and Messenger clients. The cipher list must be in OpenSSL format. For more information on OpenSSL format, see Cipher List Format

Specify a specific SSL protocol to disable. By specifying SSL_OP_NO_TLSv1, Messenger will disable TLSv1 support. Specify additional options by adding the SSL key work separated by a comma.

Specifies the maximum number of client/server threads the Messaging Agent can create. The default is 15. See Section 2.6, Optimizing Messaging Agent Performance.

See also /maxconns.

Provides the eDirectory user name for the Messaging Agent to use when accessing eDirectory to obtain its configuration information from the Messaging Agent object. This switch is required in order to start the Messaging Agent. See Section 2.1, Starting the Messaging Agent.

See also /password.