ZCS Administrator Guide 8.0
ZCS Administrator Guide 8.0
Network Edition


Multiple-Server Installation > Installing zimbra-proxy

Installing zimbra-proxy
Installing the zimbra-proxy package is optional, but recommended for scalable multi-server deployment. Zimbra proxy is normally installed on the MTA server or can be configured on a separate server. Zimbra proxy can be installed on more than one server. At least one instance of zimbra-memcached must be installed to cache the data for NGINX.
Important: If you are moving from a non-proxy environment (for example, single server to multi-server environment), additional steps are necessary for the mailbox server and proxy configuration. After you complete the proxy installation, reconfigure the mailbox server as described in the ZCS Administration Guide, Zimbra Proxy chapter.
Note:
If you are installing zimbra-proxy on the MTA server, select the zimbra-proxy package and the zimbra-memcached package. Follow the installation process for Installing Zimbra MTA on a Server. After Step 8, configure the Zimbra-proxy.
1.
On the MTA server to install the zimbra-proxy package, type Y and press Enter to install the selected package.
2.
The Bind password for Nginx ldap user is configured when the LDAP server was installed. This is set when the MTA connected to the LDAP server. This is not used unless the Kerberos5 authenticating mechanism is enabled. Note: Setting the password even though GSSAPI auth/proxy is not set up does not cause any issues.
 
Return to the MTA section, Step 8 on page 43 to continue the MTA server installation.
Installing Zimbra-Proxy on a separate server
The LDAP host name and the Zimbra LDAP password must be known to the proxy server. If not, the proxy server cannot contact the LDAP server and the installation fails.
1.
Follow steps 1 through 4 in Starting the Installation Process to open a SSH session to the server, log on to the server as root, and unpack the Zimbra software.
2.
Type Y and press Enter to install the zimbra-proxy package. The other packages should be marked N. If you have not installed zimbra-proxy on another server, you must have at least one instance of zimbra-memcached installed to cache the data for NGINX, as shown in the following screen shot example.
Note:
 
3.
Type Y, and press Enter to install the selected package.
4.
The Main menu displays. Type 1 and press Enter to go to the Common Configuration menu.
The mailbox server hostname is displayed. You must change the LDAP master host name and password to be the values configured on the LDAP server.
Type 2, press Enter, and type the LDAP host name.
(ldap-1.example.com, in this example.)
Type 4, press Enter, and type the LDAP password.
After you set these values, the server immediately contacts the LDAP server. If it cannot contact the server, you cannot proceed.
Type 7 to set the correct time zone, if your time zone is not Pacific Time.
5.
Type r to return to the Main menu.
6.
Type 2 to select zimbra-proxy.
 
7.
The Proxy Configuration menu displays. You can modify any of the values.
The Bind password for Nginx ldap user is configured when the LDAP server was installed. This is set when the MTA connected to the LDAP server. This is not used unless the Kerberos5 authenticating mechanism is enabled. Note: Setting the password even though GSSAPI auth/proxy is not set up does not cause any issues.
 
8.
Type r to return to the Main menu.
9.
When the proxy server is configured, return to the Main menu and type a to apply the configuration changes. Press Enter to save the configuration data.
10.
When Save Configuration data to a file appears, press Enter.
11.
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.
12.
When The system will be modified - continue? appears, type y and press Enter.
13.
When Installation complete - press return to exit displays, press Enter.
The installation of the proxy server is complete.
Copyright © 2012 VMware Inc.