CLI zmlocalconfig (Local Configuration)

CLI zmlocalconfig (Local Configuration)

   KB 1493        Last updated on 07/11/2015  




0.00
(0 votes)
Article-check.png  - This is certified documentation and is protected for editing by Zimbra Employees & Moderators only.
 - This is archive documentation, which means it is not supported or valid for recent versions of Zimbra Collaboration.
 - This article is a Work in Progress, and may be unfinished or missing sections.

For the most recent information on this CLI, including syntax and description, see ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities. For the most recent commonly configured settings, see ZCS Administrator's Guide Network Edition > Appendix C The zmlocalconfig Settings

ZCS 6.0.x

  • Bug 25456 - Beginning in ZCS 6.0, zmcluctl now supports hardware only failover with Redhat Cluster Manager. CLI is zmlocalconfig – e zimbra_cluster_mode=hardware.
  • Bug 31413 - Beginning in ZCS 6.0, you can now change the default MTA value for the bounce_queue_lifetime parameter through zmlocalconfig. The default is 5-day bounce lifetime.
  • Bug 31510 - New installs of ZCS will limit spam/ham cleanup to the first MTA installed. zmlocalconfig -e zmtrainsa cleanup_host=TRUE can be set to allow additional hosts to run zmtrainsa --cleanup. At least one host should have this set to true.
  • Bug 36598 - New values have been appended to the mailboxd_java_options attribute in localconfig. These options enable Zimbra to debug issues related to GC activites.
    • -verbose:gc
    • -XX:+PrintGCDetails
    • -XX:+PrintGCTimeStamps
    • -XX:+PrintGCApplicationStoppedTime

zmlocalconfig

This command is used to set or get the local configuration for a zimbra server.

Syntax

zmlocalconfig [options]

Note: Execution of 'zmlocalconfig' without argument shows present Zimbra configuration parameters and values. To see the local config, type:

zmlocalconfig

Description

Long Name Short Name Description
--config -c <arg> File in which the configuration is stored
--default -d Show default values for keys listed in [args]
--edit -e Edit the configuration file, change keys and values specified. The [args] is in the key=value form.
--force -f Edit the keys whose change is known to be potentially dangerous
--help -h Shows the help for the usage options for this tool
--info -i Shows the documentation for the keys listed in [args]
--format -m <arg> Shows the values in one of these formats: plain (default), xml, shell, nokey.
--changed -n Shows the values for only those keys listed in the [args] that have been changed from their defaults
--path -p Shows which configuration file will be used
--quiet -q Suppress logging
--random -r This option is used with the edit option. Specified key is set to a random password string.
--show -s Forces the display of the password strings
--unset -u Remove a configuration key. If this is a key with compiled-in defaults, set its value to the empty string.
--expand -x Expand values

Examples

For examples of zmlocalconfig, see ZCS Administrator's Guide Network Edition > Appendix C The zmlocalconfig Settings.

ZCS 5.0

ZCS 4.5

Related Articles


Verified Against: ZCS 6.0.x Date Created: 5/3/2006
Article ID: http://wiki.zimbra.com/index.php?title=CLI_zmlocalconfig_(Local_Configuration) Date Modified: 07/11/2015



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search