ZCS Administrator's Guide, Open Source Edition 4.5 Rev 2 11/07

Appendix A   Command-Line Utilities

General Tool Information

Zimbra CLI Commands

zmprov (Provisioning)

zmaccts

zmcontrol (Start/Stop Service)

zmcreatecert and zmcertinstall (For a Certificate)

zmldappasswd

zmlocalconfig

zmmailbox

zmtlsctl

zmmsgtrace

zmmylogpasswd

zmmypasswd

zmtrainsa

zmvolume

zmzimletctl

Command Line Interface (CLI) can be used to create, modify and delete certain features and functions of the Zimbra Collaboration Suite. The administration console is the main tool for maintaining the Zimbra Collaboration Suite, but some functions can only be changed from the CLI utility.

The CLI utility can be used for the following:

•	Provisioning accounts*

•	Starting and stopping a service

•	Installing self-signed certificates

•	Local configuration

*In general, provisioning and managing accounts should be performed from the administration console, but bulk provisioning can be done from the CLI

General Tool Information

The Zimbra command-line utilities follow standard UNIX command-line conventions.

Follow these guidelines when using the commands

•	CLI commands are run as the zimbra user, that is su - zimbra.

•	The actual CLI commands are case-sensitive. You must type them in lower case.

•	Press ENTER after you type a command.

•	Typing the CLI command and then - h displays the usage options for the command. Example: zmprov - h lists all the options available for the zmprov utility.

•	Each operation is invoked through command-line options. Many have a long name and a short name. For example, these two commands are equivalent:

zmprov createAccount joe@domain.com test123

zmprov ca joe@domain.com test123

Syntax Conventions

When demonstrating the syntax of each tool, the following conventions indicate required, optional, and alternate values:

•	{attribute} in curly brackets is required information.

•	[attribute] in square brackets are optional arguments or information.

•	{a|b|c} or [a|b|c] options separated by the pipe character | means "a” OR "b” OR "c”

•	For attribute names that may contain spaces, surround the name with double quotes.

Location of Command-Line Utilities

The command-line tools available for administrators are all located in the
/opt/zimbra/bin directory on the Zimbra server.

 

Zimbra CLI Commands

 

The table below lists the CLI commands in /opt/zimbra/bin.

Table 1 Zimbra CLI Commands

CLI	Description
ldap	Start, stop, or find the status of Zimbra LDAP
ldapsearch	Perform a search on an LDAP server
logmysql	Start, stop, or find the status of the MySql session. Enters interactive command-line MySQL session with the logger mysql
logmysql.server	Start, stop the SQL instance for the logger package
logmysqladmin	Send myslqadmin commands to the logger mysql
mysql	Enters interactive command-line MySQL session with the mailbox mysql
mysql.server	Start, stop the SQL instance for the mailbox package
mysqladmin	Send admin commands to MySQL
postconf	Postfix command to view or modify the postfix configuration
postfix	Start, stop, reload, flush, check, upgrade-configuration of postfix
qshape	Examine postfix queue in relation to time and sender/recipient domain
tomcat	Start, stop, find the status of the Tomcat server
zmaccts	Lists the accounts and gives the status of accounts on the domain
zmamavisdctl	Start, stop, or find the status of the Amavis-D New
zmantispamctl	Start, stop, reload, status for anti-spam service
zmantivirusctl	Start, stop, reload, status for the anti-virus service
zmapachectl	Start, stop, status of Apache service (for spell check)
zmclamdctl	Start, stop, or find the status of Clam AV
zmcleaniplanetics	Clean iPlanet ICS calendar files
zmcontrol	Start, stop, status of the Zimbra servers. Also can use to find the ZCS version installed.
zmconvertctl	Start, stop, the conversion server or find the status of the converted attachments conversion/indexing
zmcertinstall	Installs the self-signed certificate created with zmcreatecert.
zmcreateca	Creates a signing certificate. Used with zmcreatecert and zmcertinstall
zmcreatecert	Create a new self-signed certificate
zmdumpenv	General information about the server environment is displayed
zmfixtz	Fixes calendar entries with incorrect TZ offset
zmhostname	Find the hostname of the Zimbra server
zmjava	Execute Java with Zimbra-specific environment settings
zmldappasswd	Changes the LDAP password
zmlmtpinject	Testing tool
zmlocalconfig	Used to set or get the local configuration of a Zimbra server
zmloggerctl	Start, stop, reload, or find the status of the Zimbra logger service
zmlogswatchctl	Start, stop, status of the swatch that is monitoring logging
zmmailbox	Performs mailbox management tasks
zmmailboxdctl	Start, stop, reload, or find the status of the mailbox components (Tomcat, MySQL, convert)
zmmsgtrace	Trace messages
zmmtaconfigctl	Start, stop, or find the status of the MTA configuration daemon
zmmtactl	Start, stop, or find the status of the MTA
zmmylogpasswd	Change logger MySQL password
zmmypasswd	Change MySQL passwords
zmmysqlstatus	Status of mailbox SQL instance
zmperditionctl	Start, stop, or find the status of the perdition IMAP proxy
zmprov	Performs all provisioning tasks in Zimbra LDAP, including creating accounts, domains, distribution lists and aliases
zmproxyctl	Start or stop IMAP proxy service
zmsaslauthdctl	Start, stop, or find the status of saslauthd (authentication)
zmshutil	Used for other zm scripts, do not use
zmspamextract	Retrieve spam and relocate it to a specified directory
zmspellctl	Start, stop, or find the status of the spell check server
zmsshkeygen	Generate Zimbra’s SSH encryption keys
zmstorectl	Start, stop, or find the status of Zimbra store services
zmswatchctl	Start, stop, or find the status of the Swatch process, which is used in monitoring
zmsyslogsetup	Used to setup system log config file
zmtlsctl	Set the Web server mode to the communication protocol options: HTTP, HTTPS or mixed
zmtrainsa	Used to train the anti-spam filter to recognize what is spam or ham
zmupdateauthkeys	Used to fetch the ssh encryption keys created by zmsshkeygen
zmvolume	Manage storage volumes on your Zimbra Mailbox server
zmzimletctl	Deploy and configure Zimlets

ZCS Administrator's Guide, Open Source Edition 4.5 Rev 2 11/07