You can override settings provided in ConsoleOne by using startup switches in the Archive Agent startup file (strtup.aa). 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 Archive Agent, see Section 4.2, Starting the Archive Agent.
This section contains information on the following Archive Agent startup switches:
The table below summarizes the Archive Agent startup switches and how they correspond to configuration settings in ConsoleOne. These startup switches must begin with a dash (-) when used in the Cross-Platform client.
Table 4-5 Archive Agent Startup Switches
Specifies the full path to the public certificate file used to provide secure SSL communication between the Archive Agent and other programs. See Section 4.6, Enhancing Archive Security with SSL Encryption.
See also /certpath, /keyfile, and /keypassword.
Specifies the full path to the directory where public certificate files are stored on your system. See Section 4.6, Enhancing Archive Security with SSL Encryption.
See also /certfile, /keyfile, and /keypassword.
Informs the Archive Agent that it is running in a clustering environment. The issues are the same as for the Messaging Agent. See Implementing Messenger in a NetWare Cluster
in Novell Cluster Services on NetWare
in the GroupWise 8 Interoperability Guide.
If you are running the Archive Agent on the latest version of NetWare 6.x and Novell Cluster Services, the Archive Agent can detect the cluster automatically.
See also /ip.
Specifies the minimum number of direct access connections you want open at all times between the Archive Agent and eDirectory. The default is 10 connections.
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 also /dirdefaultconnections.
Specifies the maximum number of direct access connections you want open between the Archive Agent and eDirectory. The default is 50 connections.
See also /dirdefaultconnections.
Specifies the number of minutes between the time when the Archive 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 Archive Agent to return to users in the Messenger client. The default maximum is 100 contacts.
Specifies the IP address of an eDirectory replica for an Archive Agent that is running on a Windows server. See Changing the eDirectory Access Method for Starting the Archive Agent.
Specifies the eDirectory attribute that the Archive Agent searches on for users in the Messenger client. By default, the Archive Agent searches on the CN attribute. If you use this startup switch for the Messaging Agent, as described in Customizing Authentication and Searches by eDirectory Attribute, you should use it for the Archive Agent as well, to keep searching functionality consistent.
Indicates that you want users to authenticate to eDirectory by using a bind rather than a compare operation.
Indicates that you want users to use direct access to eDirectory even though you have configured the Archive Agent to use LDAP access. See Using LDAP Access for the Archive Agent.
Specifies the distinguished name (DN) of the Archive Agent object where the Archive Agent configuration information is stored. There is no default location. You must use this switch in order to start the Messaging Agent. See Section 4.2, Starting the Archive Agent.
IMPORTANT:Use commas, rather than periods, between object names. If any object name includes a space, surround the switch value with double quotation marks.
Specifies the password for the Archive Agent to prompt for before allowing Archive 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 Archive Agent. See Using the Archive Agent Web Console and GroupWise Monitor.
See also /httpuser.
Sets the HTTP port number used for the Archive Agent to communicate with your Web browser. The setting must be unique on the server where the Archive Agent runs. See Using the Archive Agent Web Console and GroupWise Monitor.
Sets the availability of SSL encryption between the Archive Agent and the Web console displayed in your Web browser. Valid values are enable and disable. See Using the Archive Agent Web Console and GroupWise Monitor.
Specifies the username for the Archive Agent to prompt for before allowing Archive Agent status information to be displayed in a Web browser. Providing a username 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 Archive Agent. See Using the Archive Agent Web Console and GroupWise Monitor.
See also /httppassword.
Binds the Archive 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 Archive Agent binds to all available IP addresses and Messenger clients can communicate with the Messaging Agent on all available IP addresses.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive 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 |
See also /cluster.
Specifies the full path to the private file used to provide SSL encryption between the Archive Agent and other programs. See Section 4.6, Enhancing Archive Security with SSL Encryption.
See also /keypassword.
Specifies the password used to encrypt the private SSL key file when it was created. See Section 4.6, Enhancing Archive Security with SSL Encryption.
See also /keyfile.
Specifies the language to run the Archive 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 Archive Agent runs in English. You only need to use this switch if you need to override these defaults.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
N/A |
N/A |
/language-code |
|
Example: |
N/A |
N/A |
/language-fr |
The table below lists the valid language codes:
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 Section 3.2, Customizing eDirectory Access for Users.
If you specify multiple LDAP servers, use a space between each address. When so configured, the Archive Agent tries to contact the first LDAP server in order to access eDirectory. If that LDAP server is down, the Archive Agent tries the next LDAP server in the list, and so on until it is able to access eDirectory.
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.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/ldapport-port_number |
--ldapport port_number |
/ldapport-port_number |
|
Example: |
/ldapport-390 |
--ldapport 391 |
/ldapport-392 |
See also /ldapipaddr.
Provides the password for the LDAP user that the Archive Agent uses to log in to the LDAP server. See Providing LDAP Access to eDirectory for Messenger Users.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/ldappwd-LDAP_password |
--ldappwd LDAP_password |
/ldappwd-LDAP_password |
|
Example: |
/ldappwd-nmldap |
--ldappwd nmldap |
/ldappwd-nmldap |
See also /ldapuser.
Indicates to the Archive Agent that the LDAP server it is logging in to uses SSL encryption. See Section 4.6, Enhancing Archive 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 username that the Archive 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 Archive Agent stores its log files. The default location is the \novell\nm\aa\log directory. See Using Archive Agent Log Files.
See also /loglevel, /logdays, /logmax, and /logdiskoff.
Specifies how many days to keep Archive Agent log files on disk. The default is 14 days. See Using Archive Agent Log Files.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/logdays-days |
--logdays days |
/logdays-days |
|
Example: |
/logdays-7 |
--logdays 30 |
/logdays-30 |
See also /log, /loglevel, /logmax, and /logdiskoff.
Turns off disk logging for the Archive Agent so no information about the functioning of the Archive Agent is stored on disk. The default is for logging to be turned on. See Using Archive Agent Log Files.
Controls the amount of information logged by the Archive Agent. Logged information is displayed in the log message box and written to the Archive Agent log file during the current agent session. The default is Normal, which displays only the essential information suitable for a smoothly running Archive Agent. Use Verbose to display the essential information, plus additional information helpful for troubleshooting. Use Diagnostic to include code-specific information. See Using Archive Agent Log Files.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/loglevel-level |
--loglevel level |
/loglevel-level |
|
Example: |
/loglevel-verbose |
--loglevel diagnostic |
/loglevel-diagnostic |
See also /log, /logdays, /logmax, and /logdiskoff.
Sets the maximum amount of disk space for all Archive Agent log files. When the specified disk space is consumed, the Archive Agent deletes existing log files, starting with the oldest. The default is 128 MB. See Using Archive Agent Log Files.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/logmax-megabytes |
--logmax megabytes |
/logmax-megabytes |
|
Example: |
/logmax-64 |
--logmax 256 |
/logmax-256 |
See also /log, /loglevel, /logdays, and /logdiskoff
Specifies the maximum number of connections between the Archive Agent and Messenger clients. The default is 5120. See Optimizing Connections between the Archive Agent and Messenger Users.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/maxconns-connections |
--maxconns connections |
/maxconns-connections |
|
Example: |
/maxconns-10000 |
--maxconns 10000 |
/maxconns-10000 |
See also /threads.
Specifies the network address of the Server where the Messaging Agent runs, as either an IP address or a DNS hostname. By default, the Archive Agent uses the network address specified on the Identification page of the Messaging Agent object.
See also /mtpport.
Specifies the message transfer port number the Archive Agent listens on for conversations to archive. By default, the Archive Agent uses the message transfer port specified on the Identification page of the Archive Agent object, which is 8312.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/mtpport-port_number |
--mtpport port_number |
/mtpport-port_number |
|
Example: |
/mtpport-8412 |
--mtpport 8413 |
/mtpport-8413 |
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 4.6, Enhancing Archive Security with SSL Encryption.
Disables the Archive Agent's attempts to contact the Messaging Agent.
Disables SNMP for the Archive Agent. The default is to have SNMP enabled. See Using SNMP Monitoring Programs.
Provides the password for the Archive Agent to use when accessing eDirectory in order to obtain its configuration information from the Archive Agent object. This switch is required in order to start the Archive Agent. See Section 4.2, Starting the Archive Agent.
See also /user.
Sets the port number on which the Archive Agent listens for service requests from Messenger clients. The default is 8310. See Section 4.5, Configuring the Archive Agent in ConsoleOne.
Specifies the directory where the Archive Agent stores conversations it receives from the Messaging Agent while it is archiving other conversations. The default is \novell\nm\aa\queue. See Moving the Archive Agent Conversation Holding Queue
Sets the availability of SSL encryption between the Archive Agent, the Messaging Agent, and Messenger clients. Valid values are enable and disable. See Section 4.6, Enhancing Archive Security with SSL Encryption.
|
NetWare Archive Agent |
Linux Archive Agent |
Windows Archive Agent |
|---|---|---|---|
|
Syntax: |
/ssl-setting |
--ssl setting |
/ssl-setting |
|
Example: |
/ssl-enable |
--ssl enable |
/ssl-enable |
See also /certpath, /certfile, /keyfile, and /keypassword
Specifies the maximum number of client/server threads the Archive Agent can create. The default is 15. See Optimizing Connections between the Archive Agent and Messenger Users.
|
NetWare Archive Agent |
Linux Archive Agent |
WIndows Archive Agent |
|---|---|---|---|
|
Syntax: |
/threads-number |
--threads number |
/threads-number |
|
Example: |
/threads-10 |
--threads 20 |
/threads-20 |
See also /maxconns.
Provides the eDirectory username for the Archive Agent to use when accessing eDirectory to obtain its configuration information from the Archive Agent object. This switch is required in order to start the Messaging Agent. See Section 4.2, Starting the Archive Agent.
IMPORTANT:Use commas, rather than periods, between object names. If any object name includes a space, surround the switch value with double quotation marks.
See also /password.