|
1
|
<!--
|
|
2
|
* replication.html
|
|
3
|
*
|
|
4
|
* Authors: Chad Berkley
|
|
5
|
* Copyright: 2000 Regents of the University of California and the
|
|
6
|
* National Center for Ecological Analysis and Synthesis
|
|
7
|
* For Details: http://www.nceas.ucsb.edu/
|
|
8
|
* Created: 2001 January 23
|
|
9
|
* Version:
|
|
10
|
* File Info: '$ '
|
|
11
|
*
|
|
12
|
*
|
|
13
|
-->
|
|
14
|
<HTML>
|
|
15
|
<HEAD>
|
|
16
|
<TITLE>Metacat Replication</TITLE>
|
|
17
|
<link rel="stylesheet" type="text/css" href="./common.css">
|
|
18
|
<link rel="stylesheet" type="text/css" href="./default.css">
|
|
19
|
</HEAD>
|
|
20
|
<BODY>
|
|
21
|
<table width="100%">
|
|
22
|
<tr>
|
|
23
|
<td class="tablehead" colspan="2"><p class="label">Replication</p></td>
|
|
24
|
<td class="tablehead" colspan="2" align="right">
|
|
25
|
<a href="./packages.html">Back</a> | <a href="./metacattour.html">Home</a> |
|
|
26
|
<a href="./datafiles.html">Next</a>
|
|
27
|
</td>
|
|
28
|
</tr>
|
|
29
|
</table>
|
|
30
|
|
|
31
|
<div class="header1">Table of Contents</div>
|
|
32
|
<div class="toc1"><a href="#Intro">Metacat Replication</a></div>
|
|
33
|
<div class="toc2"><a href="#Overview">Overview</a></div>
|
|
34
|
<div class="toc2"><a href="#DatabasedInfo">Databased Information</a></div>
|
|
35
|
<div class="toc2"><a href="#Example">Example</a></div>
|
|
36
|
<div class="toc3"><a href="#gamma">What happens with gamma?</a></div>
|
|
37
|
<div class="toc3"><a href="#alpha">What happens with alpha?</a></div>
|
|
38
|
<div class="toc3"><a href="#lamda">What happens with lamda?</a></div>
|
|
39
|
<div class="toc1"><a href="#ControlPanel">The Replication Control Panel</a></div>
|
|
40
|
<div class="toc1"><a href="#Certificates">Certificates</a></div>
|
|
41
|
<div class="toc2"><a href="#GenerateCertificates">Generate Certificates on both the replication client and server.</a></div>
|
|
42
|
<div class="toc3"><a href="#GenerateCertTomcat">Generate Certificate for Tomcat standalone (no Apache)</a></div>
|
|
43
|
<div class="toc3"><a href="#GenerateCertApache">Generate Certificate for Apache/Tomcat</a></div>
|
|
44
|
<div class="toc2"><a href="#RegisterPartner">Register the partner machines certificate</a></div>
|
|
45
|
|
|
46
|
<a name="Intro"></a><div class="header1">Metacat Replication</div>
|
|
47
|
<a name="Overview"></a><div class="header2">Overview</div>
|
|
48
|
<p>Metacat has built-in replication to allow different Metacat servers to
|
|
49
|
share data between themselves. Metacat not only replicates XML documents but
|
|
50
|
also data files. </p>
|
|
51
|
|
|
52
|
<p>Metacat's hub feature allows it to replicate not only it's own server's original
|
|
53
|
documents, but also those that were replicated from other servers. This functionality
|
|
54
|
allows for a more complex chaining replication structure.</p>
|
|
55
|
|
|
56
|
<p>The replication scheme that Metacat uses is both push and pull. There are
|
|
57
|
several triggers that can start a replication mechanism: </p>
|
|
58
|
<ul class="list1">
|
|
59
|
<li><b>Delta-T monitoring</b> - at a set time interval a server checks each of the
|
|
60
|
other servers in its list for updated documents</li>
|
|
61
|
<li><b>INSERT trigger</b> - Whenever a document is inserted, the server notifies
|
|
62
|
the remote hosts in its list that it has a new file available.</li>
|
|
63
|
<li><b>UPDATE trigger</b> - Whenever a document is updated, the server notifies
|
|
64
|
each server in its list of the update.</li>
|
|
65
|
<li><b>File locking</b> - When a local user tries to alter a document on a local
|
|
66
|
server that belongs to a remote server, the local server must first
|
|
67
|
obtain a lock on that file. Once the lock is obtained, the file can
|
|
68
|
be updated, then it is force replicated out to each server in the list.
|
|
69
|
The lock ensures that the remote copy is up to date and that an older
|
|
70
|
file does not overwrite a newer one. Only a documents home server
|
|
71
|
can give a lock for that file to be altered.</li>
|
|
72
|
</ul>
|
|
73
|
|
|
74
|
<a name="DatabasedInfo"></a><div class="header2">Databased Information</div>
|
|
75
|
<p>Each server contains a list of servers to which it can replicate. One-way
|
|
76
|
replication is enabled by the 'replicate' and 'datareplicate' flags in the
|
|
77
|
list. The server list may look like the following.</p>
|
|
78
|
<table border="1">
|
|
79
|
<tr>
|
|
80
|
<td><b>serverid</b></td>
|
|
81
|
<td><b>server</b></td>
|
|
82
|
<td><b>last_checked</b></td>
|
|
83
|
<td><b>replicate</b></td>
|
|
84
|
<td><b>datareplicate</b></td>
|
|
85
|
<td><b>hub</b></td>
|
|
86
|
</tr>
|
|
87
|
<tr>
|
|
88
|
<td>1</td>
|
|
89
|
<td>localhost</td>
|
|
90
|
<td>null</td>
|
|
91
|
<td>0</td>
|
|
92
|
<td>0</td>
|
|
93
|
<td>0</td>
|
|
94
|
</tr>
|
|
95
|
<tr>
|
|
96
|
<td>2</td>
|
|
97
|
<td>alpha.nceas.ucsb.edu:8080/berkley/servlet/replication</td>
|
|
98
|
<td>2001-01-22 14:52:12.1</td>
|
|
99
|
<td>0</td>
|
|
100
|
<td>0</td>
|
|
101
|
<td>0</td>
|
|
102
|
</tr>
|
|
103
|
<tr>
|
|
104
|
<td>3</td>
|
|
105
|
<td>dev.nceas.ucsb.edu/Metacat/servlet/replication</td>
|
|
106
|
<td>2001-01-23 9:10:02.5</td>
|
|
107
|
<td>1</td>
|
|
108
|
<td>1</td>
|
|
109
|
<td>0</td>
|
|
110
|
</tr>
|
|
111
|
</table>
|
|
112
|
|
|
113
|
<br>
|
|
114
|
The server list is kept in a table in the database called xml_replication.
|
|
115
|
Localhost must always be the first entry in the table and have a serverid of 1.
|
|
116
|
The database fields are:
|
|
117
|
<ul class="list1">
|
|
118
|
<li><b>serverid</b> - a unique ID that is generated by the database when a new field is added.</li>
|
|
119
|
<li><b>server</b> - this field always points to the partner server's replication servlet,
|
|
120
|
hence the "servlet/replication" on the end of both of the sample servers. Note
|
|
121
|
that any port numbers (if your servlet engine is not running on port 80) must
|
|
122
|
also be included. </li>
|
|
123
|
<li><b>last_checked</b> - a system generated values that holds the last time that a check was
|
|
124
|
made to see if replication needed to be performed.<li>
|
|
125
|
<li><b>replicate</b> - flag that is set to 1 if you want this server to replicate XML
|
|
126
|
metadata documents TO the remote host. Note that if this flag is set to 0, datareplicate
|
|
127
|
and hub fields have no meaning.</li>
|
|
128
|
<li><b>datareplicate</b> - flag that is set to 1 if you want this server to copy data
|
|
129
|
files to the remote host. Note that this field has no meaning if replicate is not set to 1.</li>
|
|
130
|
If this server is a hub to the remote host, the hub flag should be set to.
|
|
131
|
<li><b>hub</b> - if this flag is set to true, this server will not only replicate it's own
|
|
132
|
original documents, it will also replicate documents that were replicated to it. Thus it
|
|
133
|
acts as a replication hub to one or more other Metacat servers.</li>
|
|
134
|
</ul>
|
|
135
|
|
|
136
|
<a name="Example"></a><div class="header2">Example</div>
|
|
137
|
Here we show an example setup of three replication servers. We will discuss each.<br><br>
|
|
138
|
|
|
139
|
First, note that in order for replication to occur, both partner servers must have
|
|
140
|
each other in their respective tables or replication will not take place. Also,
|
|
141
|
certificates must be set up correctly on both servers in order for replication to
|
|
142
|
work. See the <a href="#Certificates">certificates</a> section below.<br><br>
|
|
143
|
|
|
144
|
<table border="1">
|
|
145
|
<tr>
|
|
146
|
<td>host</td>
|
|
147
|
<td>replication table</td>
|
|
148
|
</tr>
|
|
149
|
<tr>
|
|
150
|
<td>gamma.nceas.ucsb.edu</td>
|
|
151
|
<td>
|
|
152
|
<table border="2">
|
|
153
|
<tr>
|
|
154
|
<td><b>server</b></td>
|
|
155
|
<td><b>last_checked</b></td>
|
|
156
|
<td><b>replicate</b></td>
|
|
157
|
<td><b>datareplicate</b></td>
|
|
158
|
<td><b>hub</b></td>
|
|
159
|
</tr>
|
|
160
|
<tr>
|
|
161
|
<td>localhost</td>
|
|
162
|
<td>null</td>
|
|
163
|
<td>0</td>
|
|
164
|
<td>0</td>
|
|
165
|
<td>0</td>
|
|
166
|
</tr>
|
|
167
|
<tr>
|
|
168
|
<td>alpha.nceas.ucsb.edu:8080/berkley/servlet/replication </td>
|
|
169
|
<td>2001-01-22 14:52:12.1</td>
|
|
170
|
<td>0</td>
|
|
171
|
<td>0</td>
|
|
172
|
<td>0</td>
|
|
173
|
</tr>
|
|
174
|
<tr>
|
|
175
|
<td>lamda.nceas.ucsb.edu/Metacat/servlet/replication</td>
|
|
176
|
<td>2001-01-23 9:10:02.5</td>
|
|
177
|
<td>1</td>
|
|
178
|
<td>1</td>
|
|
179
|
<td>0</td>
|
|
180
|
</tr>
|
|
181
|
</table>
|
|
182
|
</td>
|
|
183
|
</tr>
|
|
184
|
<tr>
|
|
185
|
<td>alpha.nceas.ucsb.edu</td>
|
|
186
|
<td>
|
|
187
|
<table border="2">
|
|
188
|
<tr>
|
|
189
|
<td><b>server</b></td>
|
|
190
|
<td><b>last_checked</b></td>
|
|
191
|
<td><b>replicate</b></td>
|
|
192
|
<td><b>datareplicate</b></td>
|
|
193
|
<td><b>hub</b></td>
|
|
194
|
</tr>
|
|
195
|
<tr>
|
|
196
|
<td>localhost</td>
|
|
197
|
<td>null</td>
|
|
198
|
<td>0</td>
|
|
199
|
<td>0</td>
|
|
200
|
<td>0</td>
|
|
201
|
</tr>
|
|
202
|
<tr>
|
|
203
|
<td>gamma.nceas.ucsb.edu:8080/berkley/servlet/replication</td>
|
|
204
|
<td>2001-01-21 11:33:12.7</td>
|
|
205
|
<td>0</td>
|
|
206
|
<td>1</td>
|
|
207
|
<td>0</td>
|
|
208
|
</tr>
|
|
209
|
<tr>
|
|
210
|
<td>lamda.nceas.ucsb.edu/Metacat/servlet/replication</td>
|
|
211
|
<td>2001-01-23 10:22:02.5</td>
|
|
212
|
<td>1</td>
|
|
213
|
<td>0</td>
|
|
214
|
<td>0</td>
|
|
215
|
</tr>
|
|
216
|
</table>
|
|
217
|
</td>
|
|
218
|
</tr>
|
|
219
|
<tr>
|
|
220
|
<td>lamda.nceas.ucsb.edu</td>
|
|
221
|
<td>
|
|
222
|
<table border="2">
|
|
223
|
<tr>
|
|
224
|
<td><b>server</b></td>
|
|
225
|
<td><b>last_checked</b></td>
|
|
226
|
<td><b>replicate</b></td>
|
|
227
|
<td><b>datareplicate</b></td>
|
|
228
|
<td><b>hub</b></td>
|
|
229
|
</tr>
|
|
230
|
<tr>
|
|
231
|
<td>localhost</td>
|
|
232
|
<td>null</td>
|
|
233
|
<td>0</td>
|
|
234
|
<td>0</td>
|
|
235
|
<td>0</td>
|
|
236
|
</tr>
|
|
237
|
<tr>
|
|
238
|
<td>gamma.nceas.ucsb.edu:8080/berkley/servlet/replication</td>
|
|
239
|
<td>2001-01-21 11:33:12.7</td>
|
|
240
|
<td>0</td>
|
|
241
|
<td>0</td>
|
|
242
|
<td>0</td>
|
|
243
|
</tr>
|
|
244
|
<tr>
|
|
245
|
<td>alpha.nceas.ucsb.edu:8080/Metacat/servlet/replication</td>
|
|
246
|
<td>2001-01-22 12:15:32.5</td>
|
|
247
|
<td>1</td>
|
|
248
|
<td>1</td>
|
|
249
|
<td>1</td>
|
|
250
|
</tr>
|
|
251
|
</table>
|
|
252
|
</td>
|
|
253
|
</tr>
|
|
254
|
</table>
|
|
255
|
|
|
256
|
<a name="gamma"></a><div class="header3">What happens with gamma?</div>
|
|
257
|
<ul class="list1">
|
|
258
|
<li>The localhost entry is required internally for replication to work on
|
|
259
|
gamma. As long as we see it there, we can safely disregard it.</li>
|
|
260
|
<li>We see the entry for the alpha machine has all zeros in replicate,
|
|
261
|
datareplicate and hub columns. This means that gamma is configured to
|
|
262
|
accept replication information from alpha. (As we will see in a moment,
|
|
263
|
alpha is not actually correctly configured to send data to gamma.)</li>
|
|
264
|
<li>We see that the entry for the lamda machine has ones in the replicate
|
|
265
|
and data replicate columns and a zero in the hub column. This tells us
|
|
266
|
that gamma will replicate it's original documents to lamda, assuming that
|
|
267
|
lambda is configured to accept replication from gamma (we will see that it
|
|
268
|
is). However, because the hub value is zero, any documents that replicate
|
|
269
|
to gamma will not be further replicated to lamda.</li>
|
|
270
|
</ul>
|
|
271
|
|
|
272
|
<a name="alpha"></a><div class="header3">What happens with alpha?</div>
|
|
273
|
<ul class="list1">
|
|
274
|
<li>The localhost entry is required internally for replication to work on
|
|
275
|
alpha. As long as we see it there, we can safely disregard it.</li>
|
|
276
|
<li>We see that the entry for gamma has a zero in the replicate column.
|
|
277
|
This means that all other entries are meaningless and can be disregarded.
|
|
278
|
Even though there is a one in the datareplicate column on alpha and gamma
|
|
279
|
is configured to accept replication from alpha, no replicationwill happen
|
|
280
|
from alpha to gamma.</li>
|
|
281
|
<li>We see that the entry for lamda is a one in the replicate column and zeros
|
|
282
|
in the datareplicate and hub columns. Assuming lamda is configured to
|
|
283
|
accept replication from alpha, alpha will replicate metadata only to lamda
|
|
284
|
(and indeed, we will see that lambda is set up to accept replication from
|
|
285
|
alpha). </li>
|
|
286
|
</ul>
|
|
287
|
|
|
288
|
<a name="lamda"></a><div class="header3">What happens with lamda?</div>
|
|
289
|
<ul class="list1">
|
|
290
|
<li>The localhost entry is required internally for replication to work on
|
|
291
|
lamda. As long as we see it there, we can safely disregard it.</li>
|
|
292
|
<li>We see that the entry for gamma has all zeros in replicate, datareplicate
|
|
293
|
and hub, so lamba is set up to accept replication from gamma. As we have
|
|
294
|
already seen, gamma is correctly configured to replicate metadata and data
|
|
295
|
to lambda. We should see data and metadata replication from gamma to lamda.
|
|
296
|
<li>We see that the entry for alpha has ones in the replicate datareplicate and
|
|
297
|
hub columns. There's a lot going on here:
|
|
298
|
<ul class="list2">
|
|
299
|
<li>First, lamda will replicate original metadata and data to alpha if
|
|
300
|
alpha is configured to accept replication from lamda. Because alpha
|
|
301
|
has an entry for lambda, lamba will be allowed to replicate to alpha. </li>
|
|
302
|
<li>Second, because the alpha entry has a one in the hub column, lambda
|
|
303
|
will not only replicate it's original data, it will also replicate
|
|
304
|
data that was replicated to it. Remember that gamma was configured
|
|
305
|
to replicate to lamda. So any data or metadata that gamma sends to
|
|
306
|
lambda will get further replicated to alpha.</li>
|
|
307
|
<li>Finally, the alpha entry in the table allows the alpha server to
|
|
308
|
replicate to lambda. Since the alpha server is set up to replicate
|
|
309
|
metadata only, we would expect any original metadata on alpha to
|
|
310
|
wind up on lambda.</li>
|
|
311
|
</ul>
|
|
312
|
</ul>
|
|
313
|
|
|
314
|
<a name="ControlPanel"></a><div class="header1">The Replication Control Panel:</div>
|
|
315
|
There is an html control panel for controling replication. After
|
|
316
|
<a href="./Metacat-install.html">installing</a> Metacat, you can access
|
|
317
|
it by going through the Metacat servlet context you have setup and calling up
|
|
318
|
replControl.html. For instance, if you setup a Metacat servlet instance
|
|
319
|
called 'knb' you would probably type
|
|
320
|
|
|
321
|
<div class="code">http://server.domain.com:8080/Metacat/style/skins/dev/replControl.html</div>
|
|
322
|
|
|
323
|
The control panel is an easy interface for adding/removing/altering servers and
|
|
324
|
starting the delta-T handler. It will also allow you to 'force replicate' your
|
|
325
|
server list. This is useful if you want to initialize the state of one Metacat
|
|
326
|
server from an existing state of another (i.e. copy all of the data from an existing
|
|
327
|
server).</p>
|
|
328
|
|
|
329
|
<a name="Certificates"></a><div class="header1">Certificates:</div>
|
|
330
|
You will need to generate security certificates on both the replication client
|
|
331
|
and server. The certificates will be exchanged so that each machine understands
|
|
332
|
that the other has access for replication.<br><br>
|
|
333
|
The following are the steps to generate and exchange certificates on systems
|
|
334
|
running Tomcat 5 and java 1.5. Note that if Tomcat is running in conjunction with
|
|
335
|
Apache, the process is somewhat different than if it is running standalone.
|
|
336
|
|
|
337
|
<a name="GenerateCertificates"></a><div class="header2">Generate Certificates on both the replication client and server.</div>
|
|
338
|
|
|
339
|
<a name="GenerateCertTomcat"></a><div class="header3">Generate Certificate for Tomcat standalone (no Apache)</div>
|
|
340
|
<ul class="list1">
|
|
341
|
<li>Generate keys in java default key store - this will create a secure key and put it
|
|
342
|
into the binary certificates file located at $JAVA_HOME/lib/security/cacerts</li>
|
|
343
|
<ul class="list2">
|
|
344
|
<li>Run the command:
|
|
345
|
<div class="code">keytool -genkey -alias <aliasname> -keyalg RSA -validity 800 -keystore $JAVA_HOME/lib/security/cacerts</div>
|
|
346
|
where <aliasname> is a unique name that you choose for this cert. Something like "<hostname-tomcat>"
|
|
347
|
might be appropriate, where <hostname-tomcat> is the name of this host.</li>
|
|
348
|
</ul>
|
|
349
|
</li>
|
|
350
|
<li>
|
|
351
|
Password - keytool will ask for a password. If this is a pre-existing keystore, you will need
|
|
352
|
to know its password to modify it. If you are creating a new keystore, the password you enter
|
|
353
|
will become the keystore password.
|
|
354
|
</li>
|
|
355
|
<li>Sample values when creating certificate</li>
|
|
356
|
<ul class="list2">
|
|
357
|
<li>What is your first and last name? <b>myserver.nceas.ucsb.edu </b>
|
|
358
|
(note: use the host name without port number)<li>
|
|
359
|
<li>What is the name of your organizional unit? <b>NCEAS</b></li>
|
|
360
|
<li>What is the name of your organizional unit? <b>UCSB</b></li>
|
|
361
|
<li>What is the name of your City or Locality? <b>Santa Barbara</b></li>
|
|
362
|
<li>What is the name of your State or Province? <b>California</b>
|
|
363
|
(note: this is spelled in full)<li>
|
|
364
|
<li>What is the two-letter country code for this unit? <b>US</b></li>
|
|
365
|
</ul>
|
|
366
|
<li>Generate certificate - this will pull the certificate you created from the cacerts file
|
|
367
|
and put it into a local file</li>
|
|
368
|
<ul class="list2">
|
|
369
|
<li>Run the command:
|
|
370
|
<div class="code">keytool -export -alias <aliasname> -file <outputfile>.cert -keystore $JAVA_HOME/lib/security/cacerts</div>
|
|
371
|
where <aliasname> is the same name you used when you created the certificate. </li>
|
|
372
|
<li>A file named <outputfile>.cert will be created in the same directory where you run the keytool
|
|
373
|
command. You can name the output file anything you like, but keep in mind that it will get sent to the
|
|
374
|
partner machine used for replication. The filename should have have enough meaning that someone who sees
|
|
375
|
it on that machine can have some idea where it came from. Again, something like "<hostname>-tomcat.cert"
|
|
376
|
will suffice.</li>
|
|
377
|
</ul>
|
|
378
|
</li>
|
|
379
|
<li>Enable SSL in Tomcat
|
|
380
|
<ul class="list2">
|
|
381
|
<li>Edit the Tomcat server file at $TOMCAT_HOME/conf/server.xml</li>
|
|
382
|
<li>
|
|
383
|
uncomment the section that starts with "<Connector port="8443" ... (Note: Databased Informationcomments start with
|
|
384
|
<!-- and end with -->).
|
|
385
|
</li>
|
|
386
|
<li>add two attribute to that section that read:
|
|
387
|
<div class="code">keystoreFile="<JAVA_HOME>/lib/security/cacerts"</div>
|
|
388
|
<div class="code">keystorePass="<keystore_password>"</div>
|
|
389
|
where <JAVA_HOME> should be the actual java path and <keystore_password> should be the
|
|
390
|
password you used when you created the keystore.
|
|
391
|
</li>
|
|
392
|
</ul>
|
|
393
|
</li>
|
|
394
|
</ul>
|
|
395
|
|
|
396
|
<a name="GenerateCertApache"></a><div class="header3">Generate Certificate for Apache/Tomcat</div>
|
|
397
|
<ul class="list1">
|
|
398
|
<li>Generate keys using openssl
|
|
399
|
<ul class="list2">
|
|
400
|
<li>Run the command:
|
|
401
|
<div class="code"> openssl req -new -out REQ.pem -keyout <hostname>-apache.key</div>
|
|
402
|
</li>
|
|
403
|
</ul>
|
|
404
|
</li>
|
|
405
|
<li>Sample values when creating certificate</li>
|
|
406
|
<ul class="list2">
|
|
407
|
<li>Country Name (2 letter code) [AU]: <b>US</b></li>
|
|
408
|
<li>State or Province Name (full name) [Some-State]: <b>California</b>
|
|
409
|
(note: this is spelled in full)</li>
|
|
410
|
<li>Locality Name (eg, city) []: <b>Santa Barbara</b></li>
|
|
411
|
<li>Organization Name (eg, company) [Internet Widgits Pty Ltd]: </b>UCSB</b></li>
|
|
412
|
<li>Organizational Unit Name (eg, section) []: <b>NCEAS</b></li>
|
|
413
|
<li>Common Name (eg, YOUR name) []: <b>myserver.mydomain.edu</b>
|
|
414
|
(note: use the host name without port number)</li>
|
|
415
|
<li>Email Address []: <b>administrator@mydomain.edu</b></li>
|
|
416
|
<li>A challenge password []: (note: leave blank)</li>
|
|
417
|
<li>An optional company name []: (note: leave blank)</li>
|
|
418
|
</ul>
|
|
419
|
</li>
|
|
420
|
<li>Generate certificate - this will create a local file with your certificate</li>
|
|
421
|
<ul class="list2">
|
|
422
|
<li>Run the command:
|
|
423
|
<div class="code">openssl req -x509 -days 800 -in REQ.pem -key <hostname>-apache.key -out <hostname>-apache.crt</div>
|
|
424
|
where <aliasname> is the same name you used when you created the certificate. </li>
|
|
425
|
<li>A file named <outputfile>.cert will be created in the same directory where you run the keytool
|
|
426
|
command. You can name the output file anything you like, but keep in mind that it will get sent to the
|
|
427
|
partner machine used for replication. The filename should have have enough meaning that someone who sees
|
|
428
|
it on that machine can have some idea where it came from. Again, something like "<hostname>-tomcat.cert"
|
|
429
|
will suffice.</li>
|
|
430
|
</ul>
|
|
431
|
</li>
|
|
432
|
<li>Enter the certificate into apache security configuration - you need to register the certificate
|
|
433
|
in the local Apache instance. Note that the security files may be in a different place depending
|
|
434
|
on how you installed apache.</li>
|
|
435
|
<ul class="list2">
|
|
436
|
<li>Copy the certificate and key file to the apache ssl directories and enable ssl.</li>
|
|
437
|
<li>For Ubuntu/Debian based systems:
|
|
438
|
<ul class="list3">
|
|
439
|
<li>sudo cp <hostname>-apache.crt /etc/ssl/certs</li>
|
|
440
|
<li>sudo cp <hostname>-apache.key /etc/ssl/private</li>
|
|
441
|
<li>As root edit /etc/apache2/sites-available/default. In the VirtualHost section
|
|
442
|
after the DocumentRoot line, add:<br>
|
|
443
|
SSLEngine on<br>
|
|
444
|
SSLOptions +FakeBasicAuth +ExportCertData +CompatEnvVars +StrictRequire<br>
|
|
445
|
SSLCertificateFile /etc/ssl/certs/server.crt<br>
|
|
446
|
SSLCertificateKeyFile /etc/ssl/private/server.key<br>
|
|
447
|
</li>
|
|
448
|
</ul>
|
|
449
|
</li>
|
|
450
|
</ul>
|
|
451
|
<ul class="list2">
|
|
452
|
<li>For other systems:
|
|
453
|
<ul class="list3">
|
|
454
|
<li>sudo cp <hostname>-apache.crt $APACHE_HOME/conf/ssl.crt</li>
|
|
455
|
<li>sudo cp <hostname>-apache.key $APACHE_HOME/conf/ssl.key</li>
|
|
456
|
<li> ADD STEPS TO ENABLE SSL ON NON_DEBIAN SYSTEMS HERE</li>
|
|
457
|
</ul>
|
|
458
|
</li>
|
|
459
|
</ul>
|
|
460
|
<li>scp <hostname>-apache.crt to the replication partner machine.</li>
|
|
461
|
</ul>
|
|
462
|
|
|
463
|
<a name="RegisterPartner"></a><div class="header2">Register the partner machines certificate.</div>
|
|
464
|
At this point, you have created a certificate for each replication server and
|
|
465
|
scp-ed them across to each other. Now you need to import the remote server's
|
|
466
|
certificate on the local machine. Perform the following steps for each
|
|
467
|
replication server.
|
|
468
|
<ul class="list1">
|
|
469
|
<li>Import the remote certificate by running:
|
|
470
|
<div class="code">keytool -import -alias <remotehostalias> -file <remotehostfilename>.cert -keystore $JAVA_HOME/lib/security/cacerts</div>
|
|
471
|
where the <remotehostfilename> is the certificate file you created on the remote machine and
|
|
472
|
copied to this machine. The <remotehostalias> is the name the certificate will use in
|
|
473
|
the keystore. It should be something that identifies the remote host.
|
|
474
|
</li>
|
|
475
|
<li>Restart Apache and Tomcat on both replication machines</li>
|
|
476
|
</ul>
|
|
477
|
|
|
478
|
<a href="./packages.html">Back</a> | <a href="./metacattour.html">Home</a> |
|
|
479
|
<a href="./datafiles.html">Next</a>
|
|
480
|
</ul>
|
|
481
|
|
|
482
|
|
|
483
|
</BODY>
|
|
484
|
</HTML>
|
