Novell Documentation: GroupWise 6.5 - Using Messaging Agent Startup Switches

Using Messaging Agent Startup Switches

You can override settings provided in ConsoleOne by using startup switches in the Messaging Agent startup file (strtup.ma). On NetWare and Windows, the startup file is located in the Messenger Agent installation directory. On Linux, the startup file is located in /etc/opt/novell/messenger. You can override startup switches provided in the startup file by using startup switches on the command line. For more information about starting the Messaging Agent, see Starting the Messaging Agent.

The table below summarizes the Messaging Agent startup switches and how they correspond to configuration settings in ConsoleOne.

NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent	ConsoleOne Setting
/certfile	--certfile	/certfile	SSL Certificate
/certpath	--certpath	/certpath	Certificate Path
/cluster	N/A	N/A	N/A
/dirdefaultconnections	--dirdefaultconnections	/dirdefaultconnections	Default Number of Connections (LDAP profile)
/diridletimeout	--diridletimeout	/diridletimeout	Idle Timeout (LDAP profile)
/dirmaxconnections	--dirmaxconnections	/dirmaxconnections	Maximum Number of Connections (LDAP profile)
/dirpoolresettime	--dirpoolresettime	/dirpoolresettime	N/A
/dirquerymaxresults	--dirquerymaxresults	/dirquerymaxresults	Maximum Query Results
N/A	--dirreplicaipaddr	/dirreplicaipaddr	N/A
/diruseralias	--diruseralias	/diruseralias	N/A
/diruserauthbind	--diruserauthbind	/diruserauthbind	N/A
/diruserforcedirect	--diruserforcedirect	/diruserforcedirect	N/A
/home	--home	/home	N/A
/httppassword	--httppassword	/httppassword	HTTP Password
/httpport	--httpport	/httpport	HTTP Port
/httpuser	--httpuser	/httpuser	HTTP Username
/httpssl	--httpssl	/httpssl	Enable SSL for Web Console
/ip	--ip	/ip	Host IP Address with Bind to this Address selected
/keepalive	--keepalive	/keepalive	N/A
/keyfile	--keyfile	/keyfile	SSL Key File
/keypassword	--keypassword	/keypassword	SSL Set Password
N/A	N/A	/language	N/A
/ldapipaddr	--ldapipaddr	/ldapipaddr	LDAP Connection IP Address
/ldapport	--ldapport	/ldapport	LDAP Connection Port
/ldappwd	--ldappwd	/ldappwd	LDAP Profile Set Password
/ldapssl	--ldapssl	/ldapssl	LDAP Connection SSL Enabled
/ldapsslkey	--ldapsslkey	/ldapsslkey	LDAP Connection Root Certificate
/ldapuser	--ldapuser	/ldapuser	LDAP Profile Username
/log	--log	/log	Log Files Path
/logdays	--logdays	/logdays	Log Maximum Age
/logdiskoff	--logdiskoff	/logdiskoff	Enable Disk Logging
/loglevel	--loglevel	/loglevel	Log Level
/logmax	--logmax	/logmax	Log Maximum Size
/maxconns	--maxconns	/maxconns	Maximum Number of Users
/mtpconnecttimeout	--mtpconnecttimeout	/mtpconnecttimeout	N/A
/mtpdatatimeout	--mtpdatatimeout	/mtpdatatimeout	N/A
/mtpipaddr	--mtpipaddr	/mtpipaddr	Host Address (Archive Agent)
/mtpport	--mtpport	/mtpport	Message Transfer Port (Archive Agent)
/mtpssl	--mtpssl	/mtpssl	Enable SSL for Message Transfer Protocol (Archive Agent)
/nomtp	--nomtp	/nomtp	N/A
/nosnmp	--nosnmp	/nosnmp	Enable SNMP
/password	--password	/password	Set Password
/port	--port	/port	Client/Server Port
/queue	--queue	/queue	Messaging Queue Path
/ssl	--ssl	/ssl	Enable SSL for Client/Server
/threads	--threads	/threads	Client/Server Threads
/user	--user	/user	Username

/certfile

Specifies the full path to the public certificate file used to provide secure SSL communication between the Messaging Agent and other programs. See Establishing Messaging Security with SSL Encryption.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/certfile-[svr\][vol:]\dir\file /certfile-\\svr\vol\dir\file	--certfile /dir/file	/certfile-[drive:]\dir\file /certfile-\\svr\sharename\dir\file
Example:	/certfile-\novell\nm\ma\certs\nm.crt /certfile-svr2\sys:\novell\nm\ma\certs\nm.crt /certfile-\\svr2\sys\novell\nm\ma\certs\nm.crt	--certfile /certs/gw.crt	/certfile-\novell\nm\ma\certs\nm.crt /certfile-m:\novell\nm\ma\certs\nm.crt /certfile-\\s2\c\novell\nm\ma\certs\nm.crt

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

/certpath

Specifies the full path to the directory where public certificate file are stored on your system. See Establishing Messaging Security with SSL Encryption.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/certpath-[svr\][vol:]\dir/certpath-\\svr\vol\dir	--certpath /dir	/certpath-[drive:]\dir /certpath-\\svr\sharename\dir
Example:	/certpath-\novell\nm\ma\certs /certpath-svr2\sys:\novell\nm\ma\certs /certpath-\\svr2\sys\novell\nm\ma\certs	--certpath /certs	/certpath-\novell\nm\ma\certs /certpath-m:\novell\nm\ma\certs /certpath-\\svr2\c\novell\nm\ma\certs

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

/cluster (NetWare only)

Informs the Messaging Agent that it is running in a clustering environment. See "Implementing Messenger in a Novell Cluster" in "Novell Cluster Services" in the GroupWise 6.5 Interoperability Guide.

If you are running the Messaging Agent on the latest version of NetWare 6.x and Novell Cluster Services^TM, the Messaging Agent can detect the cluster automatically.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/cluster	N/A	N/A

/dirdefaultconnections

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 Optimizing Messaging Agent Performance.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/dirdefaultconnections-number	--dirdefaultconnections number	/dirdefaultconnections-number
Example:	/dirdefaultconnections-20	--dirdefaultconnections 30	/dirdefaultconnections-50

See also /diridletimeout and /dirmaxconnections.

/diridletimeout

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 Optimizing Messaging Agent Performance.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/diridletimeout-seconds	--diridletimeout seconds	/diridletimeout-seconds
Example:	/diridletimeout-20	--diridletimeout 60	/diridletimeout-90

/dirmaxconnections

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/dirmaxconnections-number	--dirmaxconnections number	/dirmaxconnections-number
Example:	/dirmaxconnections-200	--dirmaxconnections 100	/dirmaxconnections-100

/dirpoolresettime

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/dirpoolresettime-minutes	--dirpoolresettime minutes	/dirpoolresettime-minutes
Example:	/dirpoolresettime-10	--dirpoolresettime 10	/dirpoolresettime-10

/dirquerymaxresults

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 Optimizing Messaging Agent Performance.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/dirquerymaxresults-contacts	--dirquerymaxresults contacts	/dirquerymaxresults-contacts
Example:	/dirquerymaxresults-50	--dirquerymaxresults 200	/dirquerymaxresults-200

/dirreplicaipaddr (Linux and Windows only)

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	N/A	--dirreplicaipaddr IP_address	/dirreplicaipaddr-IP_address
Example:	N/A	--dirreplicaipaddr 172.16.5.18	/dirreplicaipaddr-172.16.5.19

/diruseralias

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/diruseralias-"eDirectory_attribute"	--diruseralias-"eDirectory_attribute"	/diruseralias-"eDirectory_attribute"
Example:	/diruseralias-"Internet EMail Address"	--diruseralias-"Internet EMail Address"	/diruseralias-"Internet EMail Address"

/diruserauthbind

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/diruserauthbind	--diruserauthbind	/diruserauthbind

/diruserforcedirect

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/diruserforcedirect	--diruserforcedirect	/diruserforcedirect

/home

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 Starting the Messaging Agent.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/home-CN=agent_object, OU=server_object, OU=Messenger_system, O=organization	--home CN=agent_object, OU=server_object, OU=Messenger_system, O=organization	/home-CN=agent_object, OU=server_object, OU=Messenger_system, O=organization
Example:	/home-CN=MessagingAgent, OU=PRV-GWSERVER, OU=MessengerService, O=Novell	--home CN=MessagingAgent, OU=PRV-GWSERVER, OU=MessengerService, O=Novell	/home-CN=MessagingAgent, OU=PRV-GWSERVER, OU=MessengerService, O=Novell

IMPORTANT: Note the use of commas, rather than periods, between object names. If any object name includes a space, surround the switch value with double quotation marks.

/httppassword

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/httppassword-unique_password	--httppassword unique_password	/httppassword-unique_password
Example:	/httppassword-AgentWatch	--httppassword AgentWatch	/httppassword-AgentWatch

/httpport

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/httpport-port_number	--httpport port_number	/httpport-port_number
Example:	/httpport-8314	--httpport 8315	/httpport-8316

/httpssl

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/httpssl-setting	--httpssl setting	/httpssl-setting
Example:	/httpssl-enable	--httpssl enable	/httpssl-enable

/httpuser

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/httpuser-unique_username	--httpuser unique_username	/httpuser-unique_username
Example:	/httpuser-NMWebConsole	--httpuser NMWebConsole	/httpuser-NMWebConsole

/ip

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ip-IP_address	--ip IP_address	/ip-IP_address
Example:	/ip-172.16.5.18	--ip 172.16.5.19	/ip-172.16.5.20

/keepalive

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 getting unexpectedly disconnected. You can increase the interval to decrease network traffic. Use a setting of 0 (zero) to turn off the ping activity.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/keepalive-minutes	--keepalive minutes	/keepalive-minutes
Example:	/keepalive-20	--keepalive 5	/keepalive-15

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

/keyfile

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/keyfile-[svr\][vol:]\dir\file /keyfile-\\svr\vol\dir\file	--keyfile /dir/file	/keyfile-[drive:]\dir\file /keyfile-\\svr\sharename\dir\file
Example:	/keyfile-\novell\nm\ma\certs\nm.key /keyfile-svr2\sys:\novell\nm\ma\certs\nm.key /keyfile-\\svr2\sys\novell\nm\ma\certs\nm.key	---keyfile /certs/gw.key	/keyfile-\novell\nm\ma\certs\nm.key /keyfile-m:\novell\nm\ma\certs\nm.key /keyfile-\\svr2\c\novell\nm\ma\certs\nm.key

/keypassword

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/keypassword-password	--keypassword password	/keypassword-password
Example:	/keypassword-gwssl	--keypassword gwssl	/keypassword-gwssl

/language (Windows only)

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. You only need to use this switch if you need to override these defaults.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	N/A	N/A	/language-code
Example:	N/A	N/A	/language-fr

The table below lists the valid language codes:

Language	Language Code
English	EN
French	FR
German	DE
Portuguese	PT
Spanish	ES

/ldapipaddr

Specifies the LDAP server's network address as either an IP address or a DNS hostname. You can specify multiple network addresses to provide failover capabilities for your LDAP servers. See Customizing eDirectory Access for Users.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ldapipaddr-network_address	--ldapipaddr network_address	/ldapipaddr-network_address
Example:	/ldapipaddr-172.16.5.18 /ldapipaddr-server1 server2	--ldapipaddr 172.16.5.19 --ldapipaddr server1 server2	/ldapipaddr-172.16.5.20 /ldapipaddr-server1 server2

If you specify multiple LDAP servers, use a space between each address. When so configured, the Messaging Agent tries to contact the first LDAP server in order to access eDirectory. If that LDAP server is down, the Messaging Agent tries the next LDAP server in the list, and so on until it is able to access eDirectory.

/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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ldapport-port_number	--ldapport port_number	/ldapport-port_number
Example:	/ldapport-390	--ldapport 391	/ldapport-392

/ldappwd

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ldappwd-LDAP_password	--ldappwd LDAP_password	/ldappwd-LDAP_password
Example:	/ldappwd-nmldap	--ldappwd nmldap	/ldappwd-nmldap

/ldapssl

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ldapssl	--ldapssl	/ldapssl

/ldapsslkey

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ldapsslkey-[svr\][vol:]\dir\file /ldapsslkey-\\svr\vol\dir\file	--ldapsslkey /dir/file	/ldapsslkey-[drive:]\dir\file /ldapsslkey-\\svr\sharename\dir\file
Example:	/ldapsslkey- \novell\nm\ma\certs\nmkey.der /ldapsslkey- server2\sys:\novell\nm\ ma\certs\nmkey.der /ldapsslkey- \\server2\sys\novell\nm\ ma\certs\nmkey.der	--ldapsslkey /certs/gwkey.der	/ldapsslkey- novell\nm\ma\certs\\nmkey.der /ldapsslkey- m:\novell\nm\ma\certs\nmkey.der /ldapsslkey- \\server2\c\novell\nm\ ma\certs\nmkey.der

/ldapuser

Specifies the username 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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ldapuser-LDAP_userID	--ldapuser LDAP_userID	/ldapuser-LDAP_userID
Example:	/ldapuser-NMAuth	--ldapuser NMAuth	/ldapuser-NMAuth

/log

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/log-[svr\][vol:]\dir /log-\\svr\vol\dir	--log /dir	/log-[drive:]\dir /log-\\svr\sharename\dir
Example:	/log-\nmlog\ma /log-\\server2\mail:\nmlog\ma /log-\\server2\mail\nmlog\ma	--log /nm/log/ma	/log-\nmlog\ma /log-m:\nmlog\ma /log-\\server2\c\mail\nmlog\ma

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

/logdays

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/logdays-days	--logdays days	/logdays-days
Example:	/logdays-7	--logdays 30	/logdays-90

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

/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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/logdiskoff	--logdiskoff	/logdiskoff

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

/loglevel

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/loglevel-level	--loglevel level	/loglevel-level
Example:	/loglevel-verbose	--loglevel diagnostic	/loglevel-diagnostic

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

/logmax

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/logmax-megabytes	--logmax megabytes	/logmax-megabytes
Example:	/logmax-64	--logmax 256	/logmax-256

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

/maxconns

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/maxconns-connections	--maxconns connections	/maxconns-connections
Example:	/maxconns-10000	--maxconns 10000	/maxconns-10000

/mtpconnecttimeout

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/mtpconnecttimeout-seconds	--mtpconnecttimeout seconds	/mtpconnecttimeout-seconds
Example:	/mtpconnecttimeout-30	--mtpconnecttimeout 60	/mtpconnecttimeout-60

/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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/mtpdatatimeout-seconds	--mtpdatatimeout seconds	/mtpdatatimeout-seconds
Example:	/mtpconnecttimeout-30	--mtpconnecttimeout 40	/mtpconnecttimeout-60

/mtpipaddr

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/mtpipaddr-network_address	--mtpipaddr network_address	/mtpipaddr-network_address
Example:	/mtpipaddr-172.16.5.18 /mtpipaddr-server2	--mtpipaddr 172.16.5.19 --mtpipaddr server3	/mtpipaddr-172.16.5.20 /mtpipaddr-server4

/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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/mtpport-port_number	--mtpport port_number	/mtpport-port_number
Example:	/mtpport-8412	--mtpport 8413	/mtpport-8414

/mtpssl

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/mtpssl-setting	--mtpssl setting	/mtpssl-setting
Example:	/mtpssl-enable	--mtpssl enable	/mtpssl-enable

/nomtp

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.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/nomtp	--nomtp	/nomtp

/nosnmp

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/nosnmp	--nosnmp	/nosnmp

/password

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 Starting the Messaging Agent.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/password-eDir_password	--password eDir_password	/password-eDir_password
Example:	/password-NMAgent	--password NMAgent	/password-NMAgent

/port

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/port-port_number	--port port_number	/port-port_number
Example:	/port-8301	--port 8302	/port-8303

/queue

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

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/queue-[svr\][vol:]\dir /queue-\\svr\vol\dir	--queue /dir	/queue-[drive:]\dir /queue-\\svr\sharename\dir\
Example:	/queue-\nmqueues\ma /queue-\\server2\mail:\nmqueues\ma /queue-\\server2\mail\nmqueues\ma	--queue /nmqueues/ma	/queue-\nmqueues\ma /queue-m:\nmqueues\ma /queue-\\server2\c\mail\nmqueues\ma

/ssl

Sets the availability of SSL encryption between the Messaging Agent, the Archive Agent, and Messenger clients. Valid values are enable and disable. See Establishing Messaging Security with SSL Encryption.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/ssl-setting	--ssl setting	/ssl-setting
Example:	/ssl-enable	--ssl enable	/ssl-enable

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

/threads

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

	NetWare Messaging Agent	Linux Messaging Agent	WIndows Messaging Agent
Syntax:	/threads-number	--threads number	/threads-number
Example:	/threads-10	--threads 20	/threads-30

/user

Provides the eDirectory username 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 Starting the Messaging Agent.

	NetWare Messaging Agent	Linux Messaging Agent	Windows Messaging Agent
Syntax:	/user-CN=User_object, OU=org_unit,O=organization	--user CN=User_object, OU=org_unit,O=organization	/user-CN=User_object, OU=org_unit,O=organization
Example:	/user-CN=Messenger, OU=Users,O=Novell	--user CN=Messenger, OU=Users,O=Novell	/user-CN=Messenger, OU=Users,O=Novell

IMPORTANT: Note the use of commas, rather than periods, between object names. If any object name includes a space, surround the switch value with double quotation marks.