The Zimbra Administration Console is a browser-based user interface that allows you to centrally manage Zimbra servers and user accounts.
When you log in to the Administration Console, the tasks you are authorized to perform display on the Navigation pane. These tasks are based on the rights assigned to the administrator role.
Two types of administrator accounts can be created to manage {product-name}:
-
Global Administrators have full privileges to manage servers, globalsettings, domains, and accounts as well as create other administrators. One global administrator account is created when the software is installed. Additional global administrator accounts can be created. You can perform administration tasks from the Administration Console or the command line.
-
Delegated Administrators are granted customized administrator roles bythe global administrator to manage different tasks from the Administration Console. See also Delegated Administration for more details.
-
To launch the Administration Console in a typical installation, use the following URL pattern.
Parameter Description server,domain
The Zimbra server name or IP address.
7071
The default HTTP listen port.
-
At the login screen, enter the complete administrator address - as [email protected] - and the password that was configured during serverinstallation of {product-name}.
You can change the password - from either the Administration Console or the CLI - at any time.
From the Administration Console, use the Change Password screen to set the new password string, and to define policy for user password modifications.
Home> Manage> Accounts; select/highlight user account
or
From the Gear icon, select Change Password from the popup menu.
zmprov sp [email protected] passwordA different login and logout page can be configured either as a global setting or as a domain setting.
To specify a URL to redirect administrators if their login is not authenticated, or if authentication has expired:
Global:
zmprov mcf zimbraAdminConsoleLoginURL <https:/example.com>Domain:
zmprov md <domain> zimbraAdminConsoleLoginURL<https:// example.comTo specify a URL to redirect administrators, for logging out:
Global:
zmprov mcf zimbraAdminConsoleLogoutURL <https:/example.com>Domain:
zmprov md <domain> zimbraAdminConsoleLogoutURL<https:// example.comMost {product-abbrev} tasks - such as creating accounts and Classes of Service, Server Status Monitoring, Domain management, Backup Scheduling and Session management - can be managed from the Administration Console.
Other configuration and maintenance tasks cannot be handled from the Administration Console - such as starting and stopping services and managing the local server configuration - and require use of the Zimbra CLI.
At the Administration Console, if you need to view the attribute associated with a particular function, you can click on the text labels of the configuration page currently in view to view the information in a popup. Guide text is also provided from these popups, as demonstrated in the following illustration.
Click the field label to view the Attribute popup. |
|
With the attribute popup in view, click More to view guidetext about the field. |
|
The {product-name} Administration Console is organized to provide quick navigation to the configuration and monitoring tools and views associated with your login privileges. It also provides easy access to various types of Help and the on-screen guide text.
After logging in to the Administration Console, the Home page is displayed to provide status information and options you can select to navigate to the configuration and viewing options described in this user guide.
-
Go to Previous or Next page
-
Current Location/Path
-
Search
-
Screen Refresh
-
Current User and Logout Option
-
Help
-
Gear Icon
-
Status Pane
-
Viewing Pane
-
Navigation Pane
The displays and options in the navigation pane and viewing pane change in accordance with your selections. Other portions of the UI — arrow buttons, search field, screen refresh, current location/path, current login, and Help — always remain in view.
The Gear Icon 
is displayed with
certain screens, to enable quick access to functions associated with the
functions provided in the screens. For more information about the Gear
icon, see Using the Gear icon
The options provided in the Home navigation pane are categorically defined under the Home directory. Some of the options lead to configuration pages; others lead to pages containing reports, as associated with your selections.
The illustration at right is an expanded view of the options currently supported in the Navigation Pane.
Your current position in the hierarchy is always displayed at the upper bar of the page currently in view, and you can use multiple options for dismissing the current view:
-
To return to a previous page or go to a next page, click the left or right arrows.
-
To return to a specific portion of the UI, select an option from the Home drop down.
-
To go directly to a specific option, click through the hierarchy in the Navigation Pane.
The Navigation pane options are described in the following topics:
The Home screen is the default, login view, which provides the Home navigation pane and the Home page. This page provides a snapshot view of system status and a series of quick access links for essential tasks.
-
Go to Previous or Next page
-
Search
-
Screen Refresh
-
Current User and Logout Option
-
Help
-
System Status
-
Status Pane
-
Quick Start
-
Navigation Pane
| Topic | Description |
|---|---|
Summary |
Displays the version of {product-name} currently running and in view, and the detected number of servers, account, domains, and classes of service associated with this session. |
Maintenance |
Displays the most recent software backup performed. |
Runtime |
Displays the runtime statistics for Service, Active Session, and Queue Length. |
1 Get Started |
Displays the steps essential to getting started with your {product-name} operations, and provides quick inks to the functions in this UI:
|
2 Set up Domain |
Displays the steps you use to establish the domain(s) to be managed by the Collaborator. Each step is a link to the function in this UI:
|
3 Add Accounts |
Displays the steps for adding accounts for management by the Collaborator. Each step is a link to the function in this UI:
|
The Monitor screen provides the Monitor navigation pane and the Monitor pages, which display various itemizations about servers monitored by the Collaborator.
-
Go to Previous or Next page
-
Search
-
Screen Refresh
-
Current User and Logout Option
-
Help
-
Status Pane
-
Navigation Pane
The options provided in the Monitor pages provide various methods- dynamic charts, or tables-for viewing the individual or system-wide monitored servers and services listed in the following table.
|
Note
|
Adobe Flash Player must be activated to enable views of the dynamic charts. |
| Option | Description |
|---|---|
Server Status |
Server, Service, and Time details for each server monitored by the Collaborator. |
Advanced Statistics |
System-wide Information page, for Advanced Statistics, which allows you to set up a new monitoring chart using parameters from the selection fields available from this page: Server, Group, Start, end, and Counters. + From this Advanced Statistics page, you can also elect to perform the following operations:
|
Message Count |
System-wide Information page, for Message Counts, to examine charts depicting counts over the last 48, 30, 60, and 365 days. The information provided is based on the number of recipients of messages using either SMTP or LMTP. The polling intervals for the counts are posted directly beneath each chart. |
Message Volume |
System-wide Information page, for Message Volume, to view charts depicting the number of recipients of messages-using either SMTP or LMTP-and associated message sizes. These counts are shown in periods over the last 48, 30, 60, and 365 days. The polling intervals for the counts are posted directly beneath each chart. |
Anti-Spam/Anti-Virus |
System-wide Information page, for Anti-Spam/Anti-Virus |
Activity |
Activity, depicting the number of unique messages processed by the AS/AC system over the last 48, 30, 60, and 365 days. The polling intervals for the counts are posted directly beneath each chart. |
Mobile Sync Statistics |
System-wide Information page, for Mobile Sync Sessions, which reports the total number of Active Sync devices across servers |
Server Statistics |
Access to statistics for a selected Service Host. You can view information for a selected host, as follows:
For the selected Server, the Server Statistics navigation pane provides options to view Disk, Session, Mailbox Quota, Message Count, Message Volume, and Anti- Spam/Anti-Virus Activity. |
Mail Queues |
Tab pages from which to view counts of Deferred, Incoming, Active, Held, and Corrupt statistics for detected mail queues. Each tab page provides summary filtering information and Message details. |
The Manage screen provides the Manage navigation pane and the Manage pages, which display the tables categorically provided as Accounts, Aliases, Distribution Lists, and Resources that are currently managed by Collaborator.
-
Go to Previous or Next page
-
Search
-
Screen Refresh
-
Current User and Logout Option
-
Help
-
Gear Icon
-
Status Pane
-
Navigation Pane
| Option | Description |
|---|---|
Accounts (count) |
Table of accounts managed by the Collaborator. Actions you can perform:
|
Aliases (count) |
Table of Aliases managed by the Collaborator. Each alias is an email address that forwards all email to a specified account. Actions you can perform:
|
Distribution Lists (count) |
Table of Distribution Lists managed by the Collaborator. A Distribution List is a group of mail addresses contained in a list, with a common mail address. When you sen to a distribution list, you are sending to everyone whose address is included in the list. the To: address line displays the distribution list address. Actions you can perform:
|
Resources (count) |
Table of Resources managed by the Collaborator. A Resource is a location or a piece of equipment that can be scheduled for meetings. Actions you can perform:
|
The Configure screen provides the Configure navigation pane and the Configure pages, which enable configurations for individual and/or globalcomponents.
-
Go to Previous or Next page
-
Search
-
Screen Refresh
-
Help
-
Gear Icon
-
Status Pane
-
Configure Navigation Pane
| Option | Description |
|---|---|
Class of Service |
Displays the COSs managed from this AdministrationConsole.
|
Domains |
Displays the domains managed from this Administration Console.
|
Servers |
Displays the servers managed from this Administration Console.
|
Global Settings |
Provides access to tools you use to set various global parameters for your {product-name}. Gear Icon: Save, Download, Update License, Activate License, Manually Activate License |
Zimlets |
Displays the Zimlets managed from this Administration Console.
|
Admin Extensions |
Displays the Admin Extensions managed from this Administration Console.
|
Certificates |
Displays the Certificates managed from this Administration Console.
|
Rights |
Displays the various Rights managed from this Administration Console.
|
Global ACL |
Displays the Global Access Control Lists managed from this Administration Console.
|
Global Settings define the default global values for servers, accounts, COS, and domains. These default values and parameters apply if the values and parameters have not been explicitly defined in settings configures elsewhere.
The defaults for Global Settings are configured during installation. You can change the settings at any time from Global Settings at the Administration Console.
| Option | Description |
|---|---|
General Information |
For more information, see General Information Configuration |
Attachments |
For more information, see Attachments Configuration. |
MTA |
For more information, see MTA Configuration. |
IMAP |
Enable IMAP service. Changes to these settings do not take effect until the server is restarted. |
POP |
Enable POPS3 Service. Changes to these settings do not take effect until the server is restarted. |
AS/AV |
Set anti-spam and anti-virus rules. Change to the Spam-check settings do not take effect until the server is restarted. |
Themes |
Change to theme settings require the server theme cache to be flushed, by using the Flush Cache toolbar button at Server settings. For more information, see Color and Logo Management. |
Advanced |
|
Retention Policy |
Set up a retention and deletion time threshold for items in user folders. Retention and deletion policies can be configured as a global setting or your can configure COS-level policies instead of inheriting from the global settings. |
Proxy |
Set parameters for Web Proxy and Mail Proxy. Tools are also provided for setting Advanced Proxy parameters. |
S/MIME |
(Secure Multipurpose Internet Mail Extensions): Configure the LDAP settings on the S/MIME tab (if S/MIME feature has been enabled). Users will use LDAP servers to retrieve private keys. |
ACL |
(Access Control List): Go to ACE (Access Control Entry) configuration for delegated administration rights granted on selected target(s), to add, edit, or delete an ACE. |
Backup/Restore |
Set parameters for backup-for standard or auto- grouped mode. For more information see the Backup and Restore. |
HSM |
(hierarchical storage management): Configure aging of message before it is to be moved to secondary volume. |
License |
|
The Tools and Migration screen provides the Tools and Migration navigation pane, for access to system software management and system backup/restore. Administrators can access and download specific wizards and tools from this page.
-
Go to Previous or Next page
-
Search
-
Screen Refresh
-
Current User and Logout Option
-
Help
-
Status Pane
-
Tools and Migration Navigation Pane
| Option | Description |
|---|---|
Downloads |
Access Zimbra utilities, which provides downloadable zip packages - for general administration use, and to synchronize an individual end user - containing migration wizards for various platforms, and Outlook connectors. Additional information is provided in Downloadable Wizards and Connectors. |
Software Updates |
Find out if your system needs a Zimbra Server update or not, and use this page to view polling and email contact information pertinent to software updates for your system. |
Account Migration |
View tabular details about account migrations, as detected by your system. This page lists total imports, and status of each. This page also provides the name(s) of the owners for each account migration listed. See also Migrating Accounts from a Zimbra Server. |
Client Upload |
Use this page to browse for the latest version of software to be uploaded to your system. After selecting the image, you can use the Upload button on this page to complete the software upload. |
Backups |
Access a summary view of current free and total space (MB) based on the most recent system backup. You can also select a specific administrator from this navigation pane to view backup history as associated with the selected administrator. The history lists labels, start and end times. and success or failure for each backup occurrence; each of these are associated with the identical, displayed directory path to the backup target. Additional information is provided in Backup and Restore. |
Use the Tools and Migration screen Downloads option to get the tools described in this section.
{product-abbrev} Migration Wizard for Exchange/PST (32 bit) |
Get zip files to perform a server-to-server migration of mail calendar, and contacts, from Microsoft Exchange or PST file to the {product-name} Server. |
||
{product-abbrev} Migration Wizard for Domino |
Get zip files to perform a server-to-server migration of mail, calendar, and contacts from IBM Domino to the {product-name} Server. |
||
Legacy {product-abbrev} Migration Wizard for Exchange |
|
||
Zimbra Connector for Outlook MSI Customizer |
Present text file containing functions you can use to customize the standard ZCO MSI. Server name, port, other variables particular to an organization can be customized. |
||
Zimbra Connector for Outlook Branding MSI |
Get the Windows Visual Basic Script Edition (VBScript Script File) to customize the standard ZCO MSI. Customization replaces all instances of the Zimbra product name and logo. |
Legacy PST Import Wizard (User Instructions) |
|
||
Zimbra Connector for Outlook (32 bits) |
Get the Windows Installer Package zip file to install in a user’s Windows system. This application enables the user’s Outlook to synchronize calendar, contacts, and mail with the {product-abbrev} server. |
The Search screen displays the Search results from queries made in the Search field in the Administration Console header.
-
When you open this page without entering a search query, All Results is the default search, which displays accounts, domains, and distribution lists in the Content pane.
-
The auto-completion function allows you to enter a partial name, then select a searchable name from the displayed list of matched strings.
-
You can also use the Zimbra mailbox ID number to search for an account. However, to return a search from a mailbox ID, the complete ID string must be entered in the search.
-
Go to Previous or Next page
-
Search Options
-
Search
-
Screen Refresh
-
Current User and Logout Option
-
Help
-
Gear Icon
-
Status Pane
-
Search Navigation Pane
| Option | Description |
|---|---|
All Result |
View the count and table of all search results. |
Accounts |
View the count and table resulting from query for Accounts. |
Domains |
View the count and table resulting from query for Domains. |
Distribution Lists |
View the count and table resulting from query for Distribution Lists. |
Basic Attributes |
Search for a user by first name, last name, display name, or account ID number. You can search for administrators or delegated administrators only. |
Status |
Search for account by status: Active, closed, Locked, Logout, Pending, or Maintenance. |
Last Login Time |
Search for accounts by the last login time. You can specify a data range to search. |
External Email Address |
Search for an account with an external email address. |
COS |
Search for objects by COS or for objects that are not assigned a COS. |
Server |
Search for accounts on selected servers. |
Domains |
Search for accounts on selected domains. |
Saved Searches |
By default, this section includes predefined common search queries. You can also create and save your own queries. After you enter the query syntax, click Save Search and provide a name for the search. The search is then added to this Saved Searches section. |
-
At the Search field, use search options from the drop-down selector to define the type of search, as either accounts, distribution lists, aliases, resources, domains, class of service, or all objects.
For accounts, you can search by display name, first/last name, first part of email address, alias, delivery address, or mailbox ID.
-
Type the search string into the Search field.
Partial entries are allowed as search criteria, but a search based on mailbox ID must include the complete ID string.
-
Click Search.
The Search page is now presented, containing results of search based on your criteria.
-
View total number of results at the Navigation pane, in Search> All Results.
The Help Center is a reference of resources available from the online help and documentation, which you can access with the links provided in the Help Center screen. Use this page, also, to access community forums and to viewexpert responses to the top migration questions.
-
Go to Previous or Next page
-
Search
-
Screen Refresh
-
Current User and Logout Option
-
Help
-
Status Pane
-
Help Center Navigation Pane
Selection of a category from the Navigation pane typically results in tabular display of all managed objects for the selected category. All tables display labeled columns in which to view information such as email addresses, display names, status, last logins, and descriptions (if configured).
Each row in a table enables actions you can perform if you require additional information and/or access to configuration for the selected table entry.
| Action at Table Row | Result | |
|---|---|---|
Hold cursor |
Display ID details for the selection, similar to the example at right (invoked from an Accounts row). |
|
Right-click |
Access the popup menu for a selected table row. The popup menus from a common table may differ from row to row, as demonstrated in the following examples. |
Accounts and Aliases: Dist Lists and Resources: 
|
Global administrators can create message(s) of the day (MOTD) that administrators view when logging into the Administration Console.
The configured message displays at the top left of the Administration Console for each administrative login (similar to the example below).
The message can be closed, replaced, or removed.
To remove a message from view, click the Close button located alongside the message content.
Use the zimbraAdminConsoleLoginMessage attribute, with guidelines in
this section, to create a single message of the day, or to create
multiple messages to be displayed.
|
Note
|
When creating a message with your command entry, always place double quote marks at the beginning and end of the message to be displayed. |
Creating a global message or domain-specific message.
zmprov md domainexample.com zimbraAdminConsoleLoginMessage "message to display"Creating a multiple-message display:
zmprov md domainexample.com +zimbraAdminConsoleLoginMessage "second message to display"Use the zimbraAdminConsoleLoginMessage attribute, with guidelines in this
section, to delete a single message of the day, or to delete multiple
messages.
|
Note
|
When removing a message with your command entry, use the following guidelines for individual and multiple deletions: |
-
Place a minus sign (-) before the attribute, and double quote marks at the beginning and end of an individual message to be deleted.
-
Use single quote marks with the attribute to remove all messages.
Removing a specific message:
zmprov md domainexample.com -zimbraAdminConsoleLoginMessage "message to display"Removing all messages:
zmprov md domainexample.com zimbraAdminConsoleLoginMessage 'This section provides birds-eye views of the functions you can use when navigating the Administration Console, in the following topics:
A high-level view of the Administration Console UI is provided in the following illustration.
You can select options to perform on a selected entity from the navigation pane from the Gear icon or a topical popup menu.
The Gear icon is always located at the upper right edge of the page view if pertinent to selectable items in the displayed page.
To view the available options, highlight a topic at the navigation pane or in the page view: In the popup, the options that are not applicable to your selection are desensitized: other displayed options can be used with your selection. The following example demonstrates Gear options based on selection of a navigation bar topic, versus a table row entry from within the same page view.
The following table provides a high-level view of the operations derived from the Gear icon, which vary for particular functions.
| Navigation Pane Topic | Selections | Options |
|---|---|---|
Home Monitor |
Server Statistics |
View |
Mail Queues |
Flush |
|
Manage |
Accounts |
New, New Administrator, Edit, Delete, Change Password, Invalidate Sessions, View Mail, Move Mailbox, View Rights, Configure Grants |
Aliases |
New, New Administrator, Edit, Delete, Move Alias, Invalidate Sessions, View Mail, Move Mailbox, View Rights, Configure Grants |
|
Distribution Lists |
New, New Administrator, Edit, Delete, View Mail, View Rights, Configure Grants |
|
Resources |
New, New Administrator, Edit, Delete, View Mail, View Rights, Configure Rights |
|
Configure |
Class of Service |
New, Delete, Edit, Duplicate |
Domains |
New, Delete, Edit, Configure GAL, Configure Authentication, View Accounts, Add a Domain Alias, Configure Grants |
|
Servers |
Edit, Flush Cache, Enable Proxy, Disable Proxy |
|
Global Settings |
Save, Download, Update License, Activate License, Manually Activate License |
|
Zimlets |
Deploy, Undeploy, Toggle Status |
|
Admin Extensions |
Deploy, Undeploy |
|
Certificates |
Install Certificate, View Certificate |
|
Voice/Chat Service |
New, Delete, Edit, Generate Session ID |
|
Rights |
View |
|
Global ACL |
Add, Delete, Edit |
|
Tools and Migration |
Software Updates |
Save, Check Now |
Account Migration |
Delete Task, Refresh, Migration Wizard |
|
Backups |
View, Backup, Restore, Configure, Refresh |
|
Search |
All Result |
Delete, Edit, Change Password, View Mail, Move Alias, Invalidate Sessions, Move Mailbox, Download |
Accounts |
||
Domains |
||
Distribution Lists |
A wide range of Configuration options are logically grouped into containers in the Administration Console. Applicable configuration options inside these containers are listed in the High-level View of Administration Console UI
By default, all containers in a page are opened (expanded). You can opt to close (collapse) containers - which can free up additional space in a page view - by clicking on the collapse/ expand button located at the upper left edge of the container.
