directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Directory Project Management > OID Assignment Scheme
Date Sun, 15 Nov 2009 16:54:00 GMT
<html>
<head>
    <base href="http://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1519/1/1/_/styles/combined.css?spaceKey=DIRxPMGT&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background-color: white" bgcolor="white">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
     <h2><a href="http://cwiki.apache.org/confluence/display/DIRxPMGT/OID+Assignment+Scheme">OID
Assignment Scheme</a></h2>
     <h4>Page <b>edited</b> by             <a href="http://cwiki.apache.org/confluence/display/~akarasulu">Alex
Karasulu</a>
    </h4>
     
          <br/>
     <div class="notificationGreySide">
         <h2><a name="OIDAssignmentScheme-Introduction"></a>Introduction</h2>

<p>OID strings are unique numeric identifiers based off of a hierarchical numeric namespace
controlled by a central authority on the Internet: <a href="http://www.iana.org/" rel="nofollow">IANA</a>
(Internet Assigned Numbers Authority).</p>

<p>IANA allows companies and organizations to register for a specific OID base called
an enterprise number.  There can only be one IANA Enterprise Number per organization.</p>

<h2><a name="OIDAssignmentScheme-TheASF%27sEnterpriseNumber"></a>The ASF's
Enterprise Number</h2>

<p>Apache has such an enterprise number.  You can look at the IANA assigned numbers
<a href="http://www.iana.org/assignments/enterprise-numbers" rel="nofollow">here</a>.
 Here's the record in this database for the Apache Software Foundation: </p>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedHeader
panelHeader" style="border-bottom-width: 1px;"><b>Apache Software Foundation</b></div><div
class="preformattedContent panelContent">
<pre>18060
  The Apache Software Foundation
    Alex Karasulu
      akarasulu@apache.org
</pre>
</div></div>

<p>This means the ASF can use the following unique OID base <b>1.3.6.1.4.1.18060</b>
for any of it's needs.  However we internal here at the ASF need some kind of scheme for assigning
these numbers internally so we do not have collisions.  </p>

<h2><a name="OIDAssignmentScheme-CurrentAssignments"></a>Current Assignments</h2>

<p>Here's what we've assigned to date:</p>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>Branch Assignments</th>
<th class='confluenceTh'>Assign To</th>
<th class='confluenceTh'>Contact Person</th>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060</td>
<td class='confluenceTd'> <a href="http://www.apache.org" rel="nofollow">ASF</a>
</td>
<td class='confluenceTd'> <a href="mailto:akarasulu@apache.org" rel="nofollow">Alex
Karasulu</a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.0</td>
<td class='confluenceTd'> <a href="http://directory.apache.org" rel="nofollow">Directory</a>
</td>
<td class='confluenceTd'> <a href="mailto:akarasulu@apache.org" rel="nofollow">Alex
Karasulu</a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.1</td>
<td class='confluenceTd'> <a href="http://geronimo.apache.org" rel="nofollow">Geronimo</a>
</td>
<td class='confluenceTd'> <a href="mailto:acabrera@apache.org" rel="nofollow">Alan
Cabrera</a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.2</td>
<td class='confluenceTd'> <a href="mailto:infrastructure@apache.org" rel="nofollow">Apache
Infrastructure</a> </td>
<td class='confluenceTd'> <a href="mailto:ben@algroup.co.uk" rel="nofollow">Ben
Laurie</a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.3</td>
<td class='confluenceTd'> <a href="http://maven.apache.org" rel="nofollow">Maven</a>
</td>
<td class='confluenceTd'> <a href="mailto:jvanzyl@apache.org" rel="nofollow">Jason
Van Zyl</a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.4</td>
<td class='confluenceTd'> <a href="http://maven.apache.org" rel="nofollow">Tuscany</a>
</td>
<td class='confluenceTd'> <a href="mailto:luckbr1975@gmail.com" rel="nofollow">Luciano
Resende </a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.5</td>
<td class='confluenceTd'> <a href="http://directory.apache.org/triplesec" rel="nofollow">Triplesec</a>
</td>
<td class='confluenceTd'> <a href="mailto:akarasulu@apache.org" rel="nofollow">Alex
Karasulu</a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.10</td>
<td class='confluenceTd'> <a href="http://hadoop.apache.org" rel="nofollow">Hadoop</a>
</td>
<td class='confluenceTd'> <a href="mailto:omalley@apache.org" rel="nofollow">Owen
O'Malley</a> </td>
</tr>
<tr>
<td class='confluenceTd'>1.3.6.1.4.1.18060.11</td>
<td class='confluenceTd'> <a href="http://hadoop.apache.org" rel="nofollow">Hadoop</a>
</td>
<td class='confluenceTd'> <a href="mailto:omalley@apache.org" rel="nofollow">Owen
O'Malley</a> </td>
</tr>
</tbody></table>

<p>Each contact person is the authority for assigning unique OID values and ranges to
projects or persons.  Contact that person for more assignments.</p>

<h2><a name="OIDAssignmentScheme-MakingAssignments"></a>Making Assignments</h2>

<p>Contacts may wonder what scheme is best for making assignments.  There is no rule
for doing this.  However some would recommend assigning the first digit past the enterprise
number of an organization to be for identifying a protocol.  Obviously we did not do this
for Apache.  The reason for this is because we feel it's better to model the assignments based
on the structure of the organization since these are private ranges and need not conform to
a global convention.</p>

<p>However this still does not tell us how contacts should make assignments.  I think
this is up to you.  Perhaps a good example will be how the Directory TLP does things which
is somewhat specific to their products and the nature of their products.</p>

<h2><a name="OIDAssignmentScheme-AssignmentSchemeForApacheDirectory"></a>Assignment
Scheme For <a href="http://directory.apache.org" rel="nofollow">Apache Directory</a></h2>

<p>The ninth component in the OID could be reserved for subprojects like ApacheDS and
Triplesec.  This might be more attractive in TLPs with many subprojects because a single authority
or contact can be used for a specific subproject.  So here could be one assignment scheme:</p>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>Branch Assignments</th>
<th class='confluenceTh'>Assign To</th>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.0 </td>
<td class='confluenceTd'> ApacheDS </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1 </td>
<td class='confluenceTd'> Triplesec </td>
</tr>
</tbody></table>

<div class='panelMacro'><table class='warningMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/forbidden.gif" width="16"
height="16" align="absmiddle" alt="" border="0"></td><td><b>bad OID!</b><br
/><p>The Triplesec OID collides with another Directory OID. I suggest we use another
OID for Triplesec, like 1.3.6.1.4.1.18060.5.  And so this is what we have set it up as above.</p></td></tr></table></div>

<p>Here's how the ApacheDS OID is branched off:</p>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>Branch Assignments</th>
<th class='confluenceTh'>Assign To</th>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.0 </td>
<td class='confluenceTd'> ApacheDS LDAP Controls </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1 </td>
<td class='confluenceTd'> ApacheDS LDAP Extended Operations </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.2 </td>
<td class='confluenceTd'> ApacheDS LDAP Supported Features </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.3 </td>
<td class='confluenceTd'> ApacheDS LDAP Protocol Mechanisms </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.5 </td>
<td class='confluenceTd'> ApacheDS LDAP Attribute Values </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.X.0 </td>
<td class='confluenceTd'> ApacheDS LDAP Schema syntaxes </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.X.1 </td>
<td class='confluenceTd'> ApacheDS LDAP Schema matchingRules </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.X.2 </td>
<td class='confluenceTd'> ApacheDS LDAP Schema attributeTypes </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.X.3 </td>
<td class='confluenceTd'> ApacheDS LDAP Schema objectClasses </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.X.4 </td>
<td class='confluenceTd'> ApacheDS LDAP Schema dITStructureRules </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.X.5 </td>
<td class='confluenceTd'> ApacheDS LDAP Schema nameForms </td>
</tr>
</tbody></table>

<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/warning.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td><p>dITContentRules do not
have their own OID, rather they reference the OID of the structural objectClass they influence.
 The same sort of situation exists for matchingRuleUse which uses the OID of the matchingRule
it is associated with.</p></td></tr></table></div>

<p>And here are the schema OIDs:</p>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>Branch Assignments</th>
<th class='confluenceTh'>Assign To</th>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.0 </td>
<td class='confluenceTd'> ApacheDS LDAP Meta Schema </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.1 </td>
<td class='confluenceTd'> ApacheDS LDAP Apache Schema </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.2 </td>
<td class='confluenceTd'> ApacheDS LDAP Apache DNS Schema </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.3 </td>
<td class='confluenceTd'> Apache Directory Documentation Examples Schema </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.4 </td>
<td class='confluenceTd'> Quartz Schema </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.4.5 </td>
<td class='confluenceTd'> Bean Schema </td>
</tr>
</tbody></table>


<h3><a name="OIDAssignmentScheme-OID%27sforApacheDSspecificcontrols"></a>OID's
for ApacheDS specific controls</h3>

<p>Here are the new OIDs used:</p>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>OID</th>
<th class='confluenceTh'>Control</th>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.0.1 </td>
<td class='confluenceTd'> CascadeControl </td>
</tr>
</tbody></table>

<h3><a name="OIDAssignmentScheme-OID%27sfortheextendedoperations"></a>OID's
for the extended operations</h3>

<p>Here are the new OIDs used:</p>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>OID</th>
<th class='confluenceTh'>Extended Operation</th>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1.1 </td>
<td class='confluenceTd'> LaunchDiagnosticUiRequest </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1.2 </td>
<td class='confluenceTd'> LaunchDiagnosticUiResponse </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1.3 </td>
<td class='confluenceTd'> GracefulShutdownRequest </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1.4 </td>
<td class='confluenceTd'> GracefulShutdownResponse </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1.5 </td>
<td class='confluenceTd'> GracefulDisconnect </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1.6 </td>
<td class='confluenceTd'> StoredProcedureRequest </td>
</tr>
<tr>
<td class='confluenceTd'> 1.3.6.1.4.1.18060.0.1.7 </td>
<td class='confluenceTd'> StoredProcedureResponse </td>
</tr>
</tbody></table>




     </div>
     <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href="http://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
       </div>

       <a href="http://cwiki.apache.org/confluence/display/DIRxPMGT/OID+Assignment+Scheme">View
Online</a>
       |
       <a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=31778&revisedVersion=23&originalVersion=22">View
Change</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message