r4496 - trunk/docs/user
daigle at ecoinformatics.org
daigle at ecoinformatics.org
Mon Nov 3 10:54:20 PST 2008
Author: daigle
Date: 2008-11-03 10:54:19 -0800 (Mon, 03 Nov 2008)
New Revision: 4496
Modified:
trunk/docs/user/default.css
trunk/docs/user/replication.html
Log:
Update replication documentation
Modified: trunk/docs/user/default.css
===================================================================
--- trunk/docs/user/default.css 2008-10-30 20:11:53 UTC (rev 4495)
+++ trunk/docs/user/default.css 2008-11-03 18:54:19 UTC (rev 4496)
@@ -201,14 +201,21 @@
}
.header1 {
- font-size: 1.5em;
- font-weight: bold;
- margin-top: .5em;
+ background: #ccccff;
+ vertical-align: baseline;
+ color: black;
+ font-size: 1.5em;
+ font-weight: bold;
+ margin-left: 0.25em;
+ margin-right: 0.25em;
+ margin-top: .5em;
+ padding: .5em;
}
.header2 {
font-size: 1.25em;
font-weight: bold;
margin-top: .5em;
+ padding-top: 1em;
}
.header3 {
font-size: 1em;
Modified: trunk/docs/user/replication.html
===================================================================
--- trunk/docs/user/replication.html 2008-10-30 20:11:53 UTC (rev 4495)
+++ trunk/docs/user/replication.html 2008-11-03 18:54:19 UTC (rev 4496)
@@ -13,7 +13,7 @@
-->
<HTML>
<HEAD>
-<TITLE>Metacat</TITLE>
+<TITLE>Metacat Replication</TITLE>
<link rel="stylesheet" type="text/css" href="./default.css">
</HEAD>
<BODY>
@@ -29,11 +29,13 @@
<div class="header1">Table of Contents</div>
<div class="toc1"><a href="#Intro">Metacat Replication</a></div>
+ <div class="toc2"><a href="#Overview">Overview</a></div>
<div class="toc2"><a href="#DatabasedInfo">Databased Information</a></div>
<div class="toc2"><a href="#Example">Example</a></div>
<div class="toc3"><a href="#gamma">What happens with gamma?</a></div>
<div class="toc3"><a href="#alpha">What happens with alpha?</a></div>
<div class="toc3"><a href="#lamda">What happens with lamda?</a></div>
+ <div class="toc1"><a href="#ControlPanel">The Replication Control Panel</a></div>
<div class="toc1"><a href="#Certificates">Certificates</a></div>
<div class="toc2"><a href="#GenerateCertificates">Generate Certificates on both the replication client and server.</a></div>
<div class="toc3"><a href="#GenerateCertTomcat">Generate Certificate for Tomcat standalone (no Apache)</a></div>
@@ -41,6 +43,7 @@
<div class="toc2"><a href="#RegisterPartner">Register the partner machines certificate</a></div>
<a name="Intro"></a><div class="header1">Metacat Replication</div>
+ <a name="Overview"></a><div class="header2">Overview</div>
<p>Metacat has built-in replication to allow different Metacat servers to
share data between themselves. Metacat not only replicates XML documents but
also data files. </p>
@@ -306,7 +309,8 @@
wind up on lambda.</li>
</ul>
</ul>
-
+
+<a name="ControlPanel"></a><div class="header1">The Replication Control Panel:</div>
There is an html control panel for controling replication. After
<a href="./Metacatinstall.html">installing</a> Metacat, you can access
it by going through the Metacat servlet context you have setup and calling up
@@ -337,11 +341,16 @@
into the binary certificates file located at $JAVA_HOME/lib/security/cacerts</li>
<ul class="list2">
<li>Run the command:
- <div class="code">keytool -genkey -alias <aliasname> -keyalg RSA -validity 800 -keystore cacerts</div>
+ <div class="code">keytool -genkey -alias <aliasname> -keyalg RSA -validity 800 -keystore $JAVA_HOME/lib/security/cacerts</div>
where <aliasname> is a unique name that you choose for this cert. Something like "<hostname-tomcat>"
- might be appropriate.</li>
+ might be appropriate, where <hostname-tomcat> is the name of this host.</li>
</ul>
</li>
+ <li>
+ Password - keytool will ask for a password. If this is a pre-existing keystore, you will need
+ to know its password to modify it. If you are creating a new keystore, the password you enter
+ will become the keystore password.
+ </li>
<li>Sample values when creating certificate</li>
<ul class="list2">
<li>What is your first and last name? <b>myserver.nceas.ucsb.edu </b>
@@ -357,7 +366,7 @@
and put it into a local file</li>
<ul class="list2">
<li>Run the command:
- <div class="code">keytool -export -alias <aliasname> -file <outputfile>.cert -keystore cacerts</div>
+ <div class="code">keytool -export -alias <aliasname> -file <outputfile>.cert -keystore $JAVA_HOME/lib/security/cacerts</div>
where <aliasname> is the same name you used when you created the certificate. </li>
<li>A file named <outputfile>.cert will be created in the same directory where you run the keytool
command. You can name the output file anything you like, but keep in mind that it will get sent to the
@@ -369,10 +378,15 @@
<li>Enable SSL in Tomcat
<ul class="list2">
<li>Edit the Tomcat server file at $TOMCAT_HOME/conf/server.xml</li>
- <li>uncomment the section that starts with "<Connector port="8443" ...</li>
- <li>add another attribute to that section that reads:
+ <li>
+ uncomment the section that starts with "<Connector port="8443" ... (Note: Databased Informationcomments start with
+ <!-- and end with -->).
+ </li>
+ <li>add two attribute to that section that read:
<div class="code">keystoreFile="<JAVA_HOME>/lib/security/cacerts"</div>
- where $JAVA_HOME should be the actual java path.
+ <div class="code">keystorePass="<keystore_password>"</div>
+ where <JAVA_HOME> should be the actual java path and <keystore_password> should be the
+ password you used when you created the keystore.
</li>
</ul>
</li>
@@ -452,7 +466,7 @@
replication server.
<ul class="list1">
<li>Import the remote certificate by running:
- <div class="code">keytool -import -alias <remotehostalias> -file <remotehostfilename>.cert -keystore cacerts</div>
+ <div class="code">keytool -import -alias <remotehostalias> -file <remotehostfilename>.cert -keystore $JAVA_HOME/lib/security/cacerts</div>
where the <remotehostfilename> is the certificate file you created on the remote machine and
copied to this machine. The <remotehostalias> is the name the certificate will use in
the keystore. It should be something that identifies the remote host.
More information about the Metacat-cvs
mailing list