-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathzimbra-installation.tex
309 lines (251 loc) · 12 KB
/
zimbra-installation.tex
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
% Zimbra installation
\chapter{Zimbra installation}
\label{chap:zimbra-installation}
This chapter explains the Zimbra OSE installation.
\section {Introduction}
Zimbra is an enterprise-class email, calendar and collaboration solution, built for the cloud, both public and private. With a redesigned browser-based interface, Zimbra offers the most innovative messaging experience available today, connecting end users to the information and activity in their personal clouds (\cite{ZimbraWeb}).
One of the main Zimbra services is a web server where the final user can check its own email, calendar and contacts among others. This is the service that we will check when testing HA.
\section {Operating system checks}
\subsection {/etc/hosts}
\textbf{On both nodes}
We will make sure in \textit{/etc/hosts} file that we have:
\begin{verbatim}
192.168.77.203 public.zimbraha.lan public
\end{verbatim}
\subsection {/etc/hostname}
\textbf{On both nodes}
We will make sure that \textit{/etc/hostname} contains:
\begin{verbatim}
public
\end{verbatim}
. In order to apply changes we will run:
\begin{verbatim}
service hostname restart
\end{verbatim}
\section {Package requirements}
\textbf{On both nodes} we will make sure we meet the Zimbra system package requirements.
\begin{verbatim}
sudo apt-get install libgmp3c2 libexpat1 \
libstdc++6 sysstat libpcre3 libperl5.14 \
sqlite3 libidn11 pax
\end{verbatim}
\section {Zimbra 8.0.4 for Ubuntu 12.04}
\textbf{On both nodes}
Zimbra 8.0.4 for Ubuntu 12.04 in form of a tar.gz file was downloaded from \cite{Zimbra8Download}.
Once downloaded is advised to check its md5sum. Finally we untar it and cd into the untarred directory.
First we download tgz file and its md5sum file:
\begin{verbatim}
wget "http://files2.zimbra.com\
/downloads/8.0.4_GA/zcs-8.0.4\
_GA_5737.UBUNTU12_64\
.20130524120036.tgz.md5"
wget "http://files2.zimbra.com\
/downloads/8.0.4_GA/zcs-8.0.4\
_GA_5737.UBUNTU12_64\
.20130524120036.tgz"
\end{verbatim}
Then we check if the download is correct by calculating its md5sum:
\begin{verbatim}
md5sum -c zcs-8.0.4\
_GA_5737.UBUNTU12_64\
.20130524120036.tgz.md5
\end{verbatim}
If md5sum is correct you will see:
\begin{verbatim}
zcs-8.0.4_GA_5737.UBUNTU12_64.20130524120036.tgz: OK
\end{verbatim}
Finally we untar it:
\begin{verbatim}
tar xzf zcs-8.0.4\
_GA_5737.UBUNTU12_64\
.20130524120036.tgz
\end{verbatim}
\section {\label{sec:complete-install-script-on-primary}Complete Install script on Primary}
\subsection {Service link manual configuration}
We need to configure service link manually with:
\begin{verbatim}
ifconfig eth0 192.168.77.203 \
netmask 255.255.255.0
\end{verbatim}
\subsection {Installation start}
\textbf{Only on primary node} we will change directory into Zimbra installation directory and run installation script:
\begin{verbatim}
cd zcs-8.0.4_GA_5737.UBUNTU12_64.20130524120036
./install.sh
\end{verbatim}
\subsection {License agreement}
We will have to agree with the terms of the software license agreement by typing \textit{Yes} and pressing Return key.
\subsection {\label{subsec:zimbra-packages-install}Zimbra packages install}
Now we are requested which Zimbra packages we want to install. We will choose the default ones.
\begin{verbatim}
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-memcached [N]
Install zimbra-proxy [N]
\end{verbatim}
We are told that the system will be modified and if we want to continue. We reply \textit{Yes}.
Zimbra packages installation is being performed.
\subsection {Change hostname}
When asked:
\begin{verbatim}
DNS ERROR resolving public.zimbraha.lan
It is suggested that the hostname be resolvable via DNS
Change hostname [Yes]
\end{verbatim}
We will answer that \textit{No} we do not want to re-enter hostname.
In a production environment we will need to make sure an A DNS field so that public.zimbraha.lan resolves to its public ip or internal ip.
\subsection {Change domain name}
When asked:
\begin{verbatim}
DNS ERROR resolving MX for public.zimbraha.lan
It is suggested that the domain name have
an MX record configured in DNS
Change domain name? [Yes]
\end{verbatim}
we will change the domain name and specify \textit{zimbraha.lan}. As DNS is not setup the same question will be asked. We will answer that \textit{No} we do not want to re-enter domain name.
\subsection {Set password and apply}
We are shown the zmsetup script:
\begin{verbatim}
Main menu
1) Common Configuration:
2) zimbra-ldap: Enabled
3) zimbra-store: Enabled
+Create Admin User: yes
+Admin user to create: [email protected]
*** +Admin Password UNSET
+Anti-virus quarantine user: virus-quarantine.
+Enable automated spam training: yes
+Spam training user: [email protected]
+Non-spam(Ham) training user: [email protected]
+SMTP host: public.zimbraha.lan
+Web server HTTP port: 80
+Web server HTTPS port: 443
+Web server mode: https
+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://public.
zimbraha.lan: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: [email protected]
+Version update source email: [email protected]
4) zimbra-mta: Enabled
5) zimbra-snmp: Enabled
6) zimbra-logger: Enabled
7) zimbra-spell: Enabled
8) Default Class of Service Configuration:
r) Start servers after configuration yes
s) Save config to file
x) Expand menu
q) Quit
\end{verbatim}
we will type \textit{3} in order to select \textit {zimbra-store} configuration.
We are shown Store configuration:
\begin{verbatim}
Store configuration
1) Status: Enabled
2) Create Admin User: yes
3) Admin user to create: [email protected]
** 4) Admin Password UNSET
5) Anti-virus quarantine user: virus-quarantine.
6) Enable automated spam training: yes
7) Spam training user: [email protected]
8) Non-spam(Ham) training user: [email protected]
9) SMTP host: public.zimbraha.lan
10) Web server HTTP port: 80
11) Web server HTTPS port: 443
12) Web server mode: https
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://public.
zimbraha.lan: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: [email protected]
24) Version update source email: [email protected]
Select, or 'r' for previous menu [r]
\end{verbatim}
we will select \textit{4} for \textit{Admin password}.
We are shown:
\begin{verbatim}
Password for [email protected] (min 6 characters): [31I2YlBw3]
\end{verbatim}
We will just press enter to accept suggested password.
Now setup is complete:
\begin{verbatim}
Main menu
1) Common Configuration:
2) zimbra-ldap: Enabled
3) zimbra-store: Enabled
4) zimbra-mta: Enabled
5) zimbra-snmp: Enabled
6) zimbra-logger: Enabled
7) zimbra-spell: Enabled
8) Default Class of Service Configuration:
r) Start servers after configuration yes
s) Save config to file
x) Expand menu
q) Quit
*** CONFIGURATION COMPLETE - press 'a' to apply
Select from menu, or press 'a' to apply config (? - help)
\end{verbatim}
We press \textit{r} to return to previous menu and finally we apply the configuration by pressing \textit{a}.
We are asked to save configuration data to a file and we are offered a file name for it. We will just accept defaults:
\begin{verbatim}
Save configuration data to a file? [Yes]
Save config in file: [/opt/zimbra/config.21624]
Saving config in /opt/zimbra/config.21624...done.
\end{verbatim}
When informed that the system will be modified we will just said that \textit{Yes} we want to continue.
\begin{verbatim}
The system will be modified - continue? [No]
\end{verbatim}
\subsection {Zimbra notification}
We are asked to notify Zimbra of our installation. We will reply \textit{No}.
\begin{verbatim}
You have the option of notifying Zimbra of your installation.
This helps us to track the uptake of the
Zimbra Collaboration Server.
The only information that will be transmitted is:
The VERSION of zcs installed (8.0.4_GA_5737_UBUNTU12_64)
The ADMIN EMAIL ADDRESS created ([email protected])
Notify Zimbra of your installation? [Yes]
\end{verbatim}
\subsection {End of installation}
Installation ends with this message where we can just press Return.
\begin{verbatim}
Configuration complete - press return to exit
\end{verbatim}
\subsection {\label{service-link-disable}Service link disable}
In order to perform dummy installation on Secondary we need service link to be configured manually on secondary node. That conflicts with service link being configured on primary node. We will also need to stop Zimbra services.
We are going to disable service link on primary with:
\begin{verbatim}
service zimbra stop
ifconfig eth0 down
\end{verbatim}
\section {Dummy installation on Secondary}
We will perform the same exact installation steps as the ones described in
\textbf{\ref{sec:complete-install-script-on-primary} Complete Install script on Primary} even the \textbf{\ref{service-link-disable} Service link disable} subsection which we need because the Cluster will be the only one to configure the service link.
Now we are going to delete our unused Zimbra installation \textbf{only on secondary node} with:
\begin{verbatim}
rm -rf /opt/zimbra
\end{verbatim}
As this is a dummy installation we do not need to write down Zimbra Administration password.