Skip to Content.
Sympa Menu

notify-dpml - svn commit: r1486 - development/main/central/site/src/docs/products/transit/technical/hosts

notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

Chronological Thread  
  • From: niclas AT netcompartner.com
  • To: notify-dpml AT lists.ibiblio.org
  • Subject: svn commit: r1486 - development/main/central/site/src/docs/products/transit/technical/hosts
  • Date: Sun, 16 Jan 2005 09:54:56 +0100

Author: niclas
Date: Sun Jan 16 09:54:56 2005
New Revision: 1486

Modified:

development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml

development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
Log:
Touching up the Transit documentation.

Modified:
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
Sun Jan 16 09:54:56 2005
@@ -1,18 +1,18 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
+<!--
Copyright 2004 Niclas Hedhman

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
+ You may obtain a copy of the License at
+
http://www.dpml.net/central/about/legal/
-
+
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
-
+
See the License for the specific language governing permissions and
limitations under the License.
-->
@@ -21,17 +21,17 @@
<properties>
<author email="niclas AT hedhman.org">Niclas Hedhman</author>
<title>DPML Transit</title>
- </properties>
+ </properties>

- <body verified="false">
+ <body verified="true">

<section name="Authorative Host">

<p>
The Transit system may be configured locally or remotely depending on
- the value of the "dpml.transit.authority" property. The property
identifies
- a remote or local path to the authorative configuration and is held
within a
- file of the same name.
+ the value of the "dpml.transit.authority" property. The property
+ identifies a remote or local path to the authorative configuration
and
+ is held within a file of the same name.
</p>

<p>Search sequence:</p>
@@ -42,8 +42,8 @@
</ol>

<p>
- In the "dpml.transit.authority" file, a single property
- "dpml.transit.authority" is resolved to a URL of the
+ In the "dpml.transit.authority" file, a single property
+ "dpml.transit.authority" is resolved to a URL of the
Authorative Host. If no protocol is given, it is assumed to be a
directory in the local file system relative to
<i>${dpml.home}/transit</i>.
@@ -60,113 +60,42 @@
<pre>
${dpml.home}/transit/authority/
</pre>
-
- <p>
- The configuration of available hosts is contained in the file:
- </p>
+ <subsection name="XML based configuration" >
+ <p>
+ The configuration of available hosts is contained in the file:
+ </p>
<pre>
${dpml.transit.authority}/hosts.xml
</pre>
-
- <p>
- Transit will also look for property based host descriptors. If the
- value of ${dpml.transit.authority} is a file url host properties
files
- will be resolved relative to the following path:
- </p>
-
+ <p>
+ The format is found in the <a href="hosts.html" >Hosts
+ Configuration</a> document.
+ </p>
+ </subsection>
+ <subsection name="Properties based configuration" >
+ <p>
+ Transit will also look for property based host descriptors. If
the
+ value of ${dpml.transit.authority} is a file url host properties
+ files will be resolved relative to the following path:
+ </p>
<pre>
${dpml.transit.authority}/hosts/*.*
</pre>
- <p>
- All files found in the hosts/ directory will be read one by one.
- The priority property will determine in which order the hosts are
- queried for artifacts.
- </p>
- <p>
- If the location is a remote URL, it will read the file
- "index.lst" at that location. "index.lst" must contain a line
- separated list of files that can be read at the location,
containing
- the resource host defintions.
- </p>
-
- <!--
- <subsection name="Properties" >
- <p>
- The following properties must be located in the file authorative
host
- configuration file, default file location is
- ${dpml.home}/transit/authority/transit.conf
- </p>
- <table>
- <tr>
- <th>Property</th>
- <th>Default Value</th>
- <th>Description</th>
- <th>Note</th>
- </tr>
- <tr>
- <td>dpml.transit.authority.checksum.required</td>
- <td>false</td>
- <td>
- If true, artifacts that doesn't have a valid checksum will not
be
- loaded.
- </td>
- <td><strong>Not Implemented.</strong></td>
- </tr>
- <tr>
- <td>dpml.authority.checksum.from.trusted</td>
- <td>true</td>
- <td>
- If true, checksums will only be downloaded from the trusted
- repository hosts. This increases the security against spoofed
- codebases, by ensuring that the checksum of trusted host
matches
- the downloaded artifact from the non-trusted host. NOTE! It is
- still possible (although difficult) to create a codebase
artifact
- with a matching checksum, so for better security, please use
- signed codebases and a web of trust or a CA.
- </td>
- <td><strong>Not Implemented.</strong></td>
- </tr>
- <tr>
- <td>dpml.transit.authority.signature.required</td>
- <td>false</td>
- <td>
- If true, artifacts must be signed or the artifact will not
- be loaded. PGP signatures is the default requirement, but
- other signature system should be supported in the future.
- Signatures increases the trust level by many magnitudes. By
- installing signed keys it is fairly easy to establish a web of
- trust, without spending money on expensive certificates.
- </td>
- <td><strong>Not Implemented.</strong></td>
- </tr>
- <tr>
- <td>dpml.transit.authority.signature.anonymous.allow</td>
- <td>false</td>
- <td>
- If true, anonymous signatures will be allowed. Anonymous
- signatures are those that does not belong in the web of trust
- nor lead to a known CA.
- </td>
- <td><strong>Not Implemented.</strong></td>
- </tr>
- <tr>
- <td>dpml.transit.authority.signature.from.trusted</td>
- <td>true</td>
- <td>
- If true, signatures will only be downloaded from the trusted
- repository hosts. This increases the security, especially if
- anonymous signatures are allowed, to ensure that code bases
are
- not spoofed.
- </td>
- <td><strong>Not Implemented.</strong></td>
- </tr>
- </table>
- </subsection>
- -->
-
+ <p>
+ All files found in the hosts/ directory will be read one by one.
+ The priority property will determine in which order the hosts are
+ queried for artifacts.
+ </p>
+ <p>
+ If the location is a remote URL, it will read the file
+ "index.lst" at that location. "index.lst" must contain a line
+ separated list of files that can be read at the location,
containing
+ the resource host defintions.
+ </p>
+ </subsection>
</section>
</body>
</document>

-
-
+
+

Modified:
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
Sun Jan 16 09:54:56 2005
@@ -1,18 +1,18 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
+<!--
Copyright 2004 Niclas Hedhman

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
+ You may obtain a copy of the License at
+
http://www.dpml.net/central/about/legal/
-
+
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
-
+
See the License for the specific language governing permissions and
limitations under the License.
-->
@@ -21,15 +21,15 @@
<properties>
<author email="niclas AT hedhman.org">Niclas Hedhman</author>
<title>DPML Transit</title>
- </properties>
+ </properties>

- <body verified="false">
+ <body verified="true">
<section name="Resource Host - Classic Layout">
<p>
- The Classic resource host management model is based on the
- conventions popularized by the maven platform and subsequently used
+ The Classic resource host management model is based on the
+ conventions popularized by the Maven build system and subsequently
used
within the Apache Software Foundation as a format for repository
- layout. The Classic layout can be viewed as a super-set of the
+ layout. The Classic layout can be viewed as a super-set of the
Maven model in that Transit implementation fully supports unlimited
group segmentation.
</p>
@@ -41,7 +41,7 @@
<p>
which for Classic resource hosts will be translated into;
</p>
-<source> [resourcehost]/[group]/[type]s/[name]-[version].[type] </source>
+<source> [resource-host-base-url]/[group]/[type]s/[name]-[version].[type]
</source>
<p>
where,
</p>
@@ -55,7 +55,7 @@
<tr>
<td>group</td>
<td>
- The group the resource belongs to. Slashes in the group are
+ The group the resource belongs to. Slashes in the group are
allowed and denotes subgrouping.
</td>
</tr>
@@ -75,10 +75,16 @@
</td>
</tr>
</table>
+ <p>
+ with the exception that if the [version] is an empty string the
+ dash will not be part of the resolved URL.
+ </p>
+ <p>
+ Furthermore. for this resource host type there are currently some
+ semantic meaning built in to the Version, if it is "SNAPSHOT" (no
+ quotes), which we may remove in the near future.
+ </p>
</subsection>
</section>
</body>
</document>
-
-
-



  • svn commit: r1486 - development/main/central/site/src/docs/products/transit/technical/hosts, niclas, 01/16/2005

Archive powered by MHonArc 2.6.24.

Top of Page