ZCS Administrator Guide 8.0

Network Edition

Installing Zimbra Software

 

Important: Before you begin, make sure to: • Store your license in a directory folder on your server as it is needed to complete your installation of ZCS. For more information about licenses, see Zimbra License Requirements for ZCS Network Edition. • Confirm you have the latest system requirements and prerequisites for installing ZCS, as described in System Requirements for VMware Zimbra Collaboration Server 8.0.

Open an SSH session to the Zimbra server and follow the steps below.

1.	Log in as root to the Zimbra server and cd to the directory where the ZCS archive tar file is saved (cd /var/<tmp>). Type the following commands:

•	tar xzvf [zcsfullfilename.tgz], to unpack the file.

•	cd [zcsfullfilename] to change to the correct directory.

•	./install.sh to begin the installation.

The install.sh script reviews the installation software to verify that the Zimbra packages are available.

 

[root@mailhost tmp]# tar xzvf zcs.tgz zcs-NETWORK-8.0.0_GA_3107.UBUNTU10_64.20100916012803/ zcs-NETWORK-8.0.00_GA_3107.UBUNTU10_64.20100916012803/packages/ zcs-NETWORK-8.0.0_GA_3107.UBUNTU10_64.20100916012803/packages/zimbra-apache_8.0.0_GA_3107.UBUNTU10_64_amd64.deb . . zcs-NETWORK-8.0.0_GA_3107.UBUNTU10_64.20101015012627/install.sh zcs-NETWORK-8.0.0_GA_3107.UBUNTU10_64.20101015012627/README.txt . [root@mailhost tmp]# cd zcs-NETWORK-8.0.0_GA_3107.UBUNTU10_64.20101015012627 [root@mailhost tmp/zcs-NETWORK-8.0.0_GA_3107.UBUNTU10_64.20101015012627# ./install.sh . . Operations logged to /tmp/install.log.3833 Checking for existing installation... zimbra-ldap...NOT FOUND zimbra-logger...NOT FOUND zimbra-mta...NOT FOUND zimbra-snmp...NOT FOUND zimbra-store...NOT FOUND zimbra-apache...NOT FOUND zimbra-spell...NOT FOUND     zimbra-convertd...NOT FOUND     zimbra-memcached...NOT FOUND zimbra-proxy...NOT FOUND zimbra-archiving...NOT FOUND     zimbra-cluster...NOT FOUND     zimbra-core...NOT FOUND

Screenshots in this guide are examples of the Zimbra installation script. The actual script may be different.

2.	The installation process checks to see if Sendmail, Postfix, and MySQL software are running. If any of these applications are running, you are asked to disable them. Disabling MySQL is optional but highly recommended. Sendmail and Postfix must be disabled for the ZCS to start correctly.

3.	The Zimbra software agreement displays. Read the agreement and when Do you agree with the terms of the software license agreement? [N] displays, enter Y to continue.

Important: The license agreement displays in three sections, and you must accept each section of the license agreement.

 

VMWARE END USER LICENSE AGREEMENT   IMPORTANT-READ CAREFULLY: BY DOWNLOADING, INSTALLING, OR USING THE SOFTWARE, YOU (THE INDIVIDUAL OR LEGAL ENTITY) AGREE TO BE BOUND BY THE TERMS OF THIS END USER LICENSE AGREEMENT (EULA). IF YOU DO NOT AGREE TO THE TERMS OF THIS EULA, YOU MUST NOT DOWNLOAD, INSTALL, OR USE THE SOFTWARE, AND YOU MUST DELETE OR RETURN THE UNUSED SOFTWARE TO THE VENDOR FROM WHICH YOU ACQUIRED IT WITHIN THIRTY (30) DAYS AND REQUEST A REFUND OF THE LICENSE FEE, IF ANY, THAT YOU PAID FOR THE SOFTWARE.   EVALUATION LICENSE. If You are licensing the Software for evaluation purposes, your use of the Software is only permitted in a non-production environment and for the period limited by the Software License Key. Notwithstanding any other provision in this EULA, an Evaluation License of the Software is provided AS-IS without support or warranty of any kind, expressed or implied.   1. DEFINITIONS . .   Additional License Terms You may create and use for up to the number of Mailbox for which you have paid the applicable license fees.   For Software licensed on a Subscription basis, You may create and use for up to the number of Mailbox during the term of the Subscription. Upon expiration or termination of a Subscription, You shall promptly cease use of the Software and product documentation and destroy (and certify to VMware in writing the fact of such destruction), or return to VMware all copies of the Software and product documentation then in Your possession or control.   Do you agree with the terms of the software license agreement? [N] y

4.

Next, the installer checks to see that the prerequisite software is installed. If the prerequisite software packages are not installed, the installation process stops. You must fix the problem and start the installation over. See Other Dependencies in System Requirements for VMware Zimbra Collaboration Server 8.0.

 

Checking for prerequisites...      FOUND: NPTL      FOUND: netcat-openbsd-1.89-3ubuntu2 FOUND: sudo-1.7.2p1-1ubuntu5.3 FOUND: libidn11-1.15-2 FOUND: libpcre3-7.8-3build1 FOUND: libgmp3c2-2:4.3.2+dfsg-1ubuntu1 FOUND: libexpat1-2.0.1-7ubuntu1 FOUND: libstdc++6-4.4.3-4ubuntu5 FOUND: libperl5.10-5.10.1-8ubuntu2 Checking for suggested prerequisites... FOUND: perl-5.10.1 FOUND: sysstat     FOUND: sqlite3 Prerequisite check complete.

5.	Select the services to be installed on this server. To install ZCS on a single server, enter Y for the ldap, logger, mta, snmp, store, and spell packages. If you use IMAP/POP Proxy, enter Y for the Zimbra proxy package.

Note:

For the cross mailbox search feature, install the Zimbra Archive package. To use the archiving and discovery feature, contact Zimbra sales.

The installer verifies that there is enough room to install ZCS. If there is not, the installation stops.

 

Checking for installable packages   Found zimbra-core Found zimbra-ldap Found zimbra-logger Found zimbra-mta Found zimbra-snmp Found zimbra-store Found zimbra-apache Found zimbra-spell Found zimbra-convertd Found zimbra-memcached Found zimbra-proxy Found zimbra-archiving   Select the packages to install     Install zimbra-ldap [Y] Install zimbra-logger [Y] Install zimbra-mta [Y] Install zimbra-snmp [Y] Install zimbra-store [Y] Install zimbra-apache [Y] Install zimbra-spell [Y] Install zimbra-convertd [Y] Install zimbra-memcached [N] Install zimbra-proxy [N] Install zimbra-archiving [N] Checking required space for zimbra-core checking space for zimbra-store   Installing: zimbra-core zimbra-ldap zimbra-logger zimbra-mta zimbra-snmp zimbra-store zimbra-apache zimbra-spell zimbra-convertd

6.	Next, type Y and press Enter to modify the system.

•	Selected packages are installed on the server.

•	Checks to see if MX record is configured in DNS. The installer checks to see if the hostname is resolvable via DNS. If there is an error, the installer asks if you would like to change the hostname. We recommend that the domain name have an MX record configured in DNS.

•	Checks for port conflict.

 

The system will be modified. Continue? [N] y Installing packages     zimbra-core......zimbra-core_8.0.0_GA_3107.UBUNTU10_64_amd64.deb...done zimbra-ldap......zimbra-ldap_8.0.0_GA_3107.UBUNTU10_64_amd64.deb...done zimbra-logger......zimbra-logger_8.0.0_GA_3107.UBUNTU10_64_amd64.deb...done zimbra-mta......zimbra-mta_8.0.0_GA_3107.UBUNTU10_64_amd64.deb...done zimbra-snmp......zimbra-snmp_8.0.0_GA_3107.UBUNTU10_64_amd64.deb...done . . . Operations logged to /tmp/zmsetup.07032012-144038.log Installing LDAP configuration database...done. Setting defaults... . . . DNS ERROR - resolving MX records for mailhost.example.com resolve to this host. It is suggested that the domain name have an MX record configured in DNS Change domain name? [Yes] n done. Checking for port conflicts

7.

At this point, the Main menu displays showing the default entries for the Zimbra component you are installing. To expand the menu to see the configuration values, type X and press Enter. The Main menu expands to display configuration details for the package being installed. Values that require further configuration are marked with asterisks (****) to their left.

To navigate the Main menu, select the menu item to change. You can modify any of the defaults. See Main Menu Options, for a description of the Main menu.

For a quick installation, accepting all the defaults, you only need to do the following:

8.	If your time zone is not Pacific time, enter 1 to select Main menu 1, Common Configuration and then enter 6 for TimeZone. Set the correct time zone.

 

Main menu 1) Common Configuration: +Hostname:                           mailhost.example.com +Ldap master host:     mailhost.example.com +Ldap port:                          389 +Ldap Admin password:     set +Secure interprocess communications: yes +TimeZone:                           America/Los_Angeles         +IP Mode:                            ipv4 2) zimbra-ldap:                          Enabled         +Status                             Enabled         +Create Domain:   yes +Domain to create:                  mailhost.example.com +Ldap root password:                set +Ldap replication password:         set +Ldap postfix password:             set +Ldap amavis password:  set         +Ldap nginx password                set         +Ldap Bes Searcher password         set 3) zimbra-store:                           Enabled         +Create Admin User:                   yes +Admin user to create:            admin@mailhost.example.com ******* +Admin Password                       UNSET +Anti-virus quarantine user: virus-quarantine.zodi72xmm6@mailhost.example.com +Enable automated spam training:      yes +Spam training user      spam.vviwu_izoj@mailhost.example.com      +Non-spam(Ham)training user: ham.unsbogyzer@mailhost.example.com +SMTP host:                        mailhost.example.com +Web server HTTP port: 80 +Web server HTTPS port: 443 +Web server mode: http +IMAP server port: 143 +IMAP server SSL port: 993 +POP server port: 110 +POP server SSL port: 995 +Use spell check server: yes       +Spell server URL: http://mailhost.example.com :7780/aspell.php +Configure for use with mail proxy: FALSE +Configure for use with web proxy: FALSE +Enable version update checks: TRUE +Enable version update notifications: TRUE +Version update notification email:admin@mailhost.example.com +Version update source email:      admin@mailhost.example.com ******* +License filename:  UNSET    4) zimbra-mta:                              Enabled    5) zimbra-snmp:    Enabled    6) zimbra-logger:  Enabled    7) zimbra-spell:   Enabled    8) zimbra-convertd:   Enabled    9) Enable VMware HA:                        yes   10) Default Class of Service Configuration:   11) Enable default backup schedule:          yes    r) Start servers after configuration        yes    s) Save config to file    x) Expand menu    q) Quit

9.	Type r to return to the Main menu.

10.	Enter 3 to select zimbra-store from the Main menu. The Store configuration menu displays.

11.	Select the following from the store configuration menu:

•	Type 4 and type the admin password. The password must be six or more characters. Press Enter.

•	Type <#> for License filename and type the directory and file name for the Zimbra license. For example, if you saved to the tmp directory, you would type /tmp/ZCSLicense.xml. If you do not have the license, you cannot proceed. See Zimbra License Requirements for ZCS Network Edition.

•	Enable version update checks and Enable version update notifications are set to TRUE. ZCS automatically checks for the latest ZCS software updates and notifies the account that is configured in Version update notification email. You can modify this later from the administration console.

 

Store configuration   1) Status: Enabled 2) Create Admin User:                     yes 3) Admin user to create:                  admin@mailhost.example.com ** 4) Admin Password UNSET 5) Anti-virus quarantine user:            virus-quarantine.zodi72xmm6@mailhost.example.com 6) Enable automated spam training: yes 7) Spam training user: spam.vviwu_izoj@mailhost.example.com 8) Non-spam(Ham) training user: ham.unsbogyzer@mailhost.example.com 9) SMTP host:                             mailhost.example.com 10) Web server HTTP port: 80 11) Web server HTTPS port: 443 12) Web server mode: http 13) IMAP server port: 143 14) IMAP server SSL port: 993 15) POP server port: 110 16) POP server SSL port: 995 17) Use spell check server: yes 18) Spell server URL:      http://mailhost.example.com :7780/aspell.php 19) Configure for use with mail proxy: FALSE 20) Configure for use with web proxy: FALSE 21) Enable version update checks: TRUE 22) Enable version update notifications:    TRUE 23) Version update notification email:     admin@mailhost.example.com 24) Version update source email:           admin@mailhost.example.com **25) License filename: UNSET   Select, or 'r' for previous menu [r] 4   Password for admin@mailhost.example.com (min 6 characters): [2LPoBSob] zimbra

12.	Type r to return to the Main menu.

13.	If you want to change the default Class of Service settings for new features that are listed here, type 10 for Default Class of Service Configuration. Then type the number for the feature to be enabled or disabled. Changes you make here are reflected in the default COS configuration.

14.	If no other defaults need to be changed, type a to apply the configuration changes. Press Enter.

 

*** CONFIGURATION COMPLETE - press 'a' to apply Select from menu, or press 'a' to apply config (? - help) a

15.	When Save Configuration data to file appears, type Yes and press Enter.

 

Save configuration data to a file? [Yes] y

16.	The next request asks where to save the files. To accept the default, press Enter. To save the files to another directory, enter the directory and then press Enter.

 

Save config in file: [/opt/zimbra/config.2910] Saving config in /opt/zimbra/config.2910...done.

17.	When The system will be modified - continue? appears, type Yes and press Enter.

The server is modified. Installing all the components and configuring the server can take several minutes. Components that are installed include spam training and documents, (wiki) accounts, time zone preferences, backup schedules, licenses, as well as common Zimlets.

 

The system will be modified - continue? [No] y Operations logged to /tmp/zmsetup.07032012-144038.log Setting local config values...done. Initializing core config...Setting up CA...done. Deploying CA to /opt/zimbra/conf/ca ...done. . . Installing webclient skins... hotrod...done. lavender...done. carbon...done. tree...done. smoke...done. . . Finished installing webclient skins. Setting zimbraFeatureIMEnabled=FALSE...done. Setting zimbraFeatureTasksEnabled=TRUE...done. . . Starting servers...done. Installing common zimlets... com_zimbra_email...done. com_zimbra_url...done. . . Finished installing common zimlets. Installing network zimlets... com_zimbra_mobilesync...done. com_zimbra_hsm...done. . . Finished installing network zimlets. Restarting mailboxd...done. Setting up zimbra crontab...done.   Moving /tmp/zmsetup.07032012-144038.log to /opt/zimbra/log

18.	When Configuration complete - press return to exit displays, press Enter.

 

Configuration complete - press return to exit