syncope-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Syncope > Install connector bundles
Date Wed, 07 Nov 2012 17:59:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2042/9/3/_/styles/combined.css?spaceKey=SYNCOPE&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/SYNCOPE/Install+connector+bundles">Install
connector bundles</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~massi">Massimiliano
Perrone</a>
    </h4>
        <br/>
                         <h4>Changes (2)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >              &lt;artifactItem&gt;
<br>                &lt;groupId&gt;org.connid.bundles&lt;/groupId&gt;
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">&lt;artifactId&gt;org.connid.bundles.ad&lt;/artifactId&gt;</span>
<span class="diff-added-words"style="background-color: #dfd;">&lt;artifactId&gt;${connid.bundle.name}&lt;/artifactId&gt;</span>
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">&lt;version&gt;1.0.1&lt;/version&gt;</span>
<span class="diff-added-words"style="background-color: #dfd;">&lt;version&gt;${connid.bundle.version}&lt;/version&gt;</span>
<br></td></tr>
            <tr><td class="diff-unchanged" >                &lt;outputDirectory&gt;${bundles.directory}&lt;/outputDirectory&gt;
<br>              &lt;/artifactItem&gt; <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <style type='text/css'>/*<![CDATA[*/
div.rbtoc1352311117924 {margin-left: 1.5em;padding: 0px;}
div.rbtoc1352311117924 ul {list-style: decimal;margin-left: 0px;}
div.rbtoc1352311117924 li {margin-left: 0px;padding-left: 0px;}

/*]]>*/</style><div class='rbtoc1352311117924'>
<ul>
    <li><a href='#Installconnectorbundles-Addbundlesatprojectdefinitiontime'>Add
bundles at project definition time</a></li>
    <li><a href='#Installconnectorbundles-Addbundlesatruntime'>Add bundles at
run-time</a></li>
</ul></div>
<p>Provided as a JAR file, a <a href="http://code.google.com/p/connid/" class="external-link"
rel="nofollow">ConnId</a> connector bundle implements a consistent generic layer
between Syncope and external resources.</p>

<p>The specific connector bundle is always a pre-requisite to link a particular external
resource.</p>

<p>There is a connector bundle for each linkable external resource type. Obviously,
a single connector bundle can be used to link more than one resources of the same type.</p>

<p>Connector bundles can be added:</p>

<ol>
	<li>at project definition time;</li>
	<li>at run-time.</li>
</ol>


<h1><a name="Installconnectorbundles-Addbundlesatprojectdefinitiontime"></a>Add
bundles at project definition time</h1>
<p>Connector bundles are added at project definition time by modifying the Maven project.</p>

<p>For each new connector bundle you have to perform the following steps.</p>

<ul>
	<li>modify the global pom.xml file by adding the following <em>properties</em>
and <em>dependency</em>.
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
&lt;properties&gt;
   ...
   &lt;connid.bundle.version&gt; ... &lt;/connid.bundle.version&gt;
   &lt;connid.bundle.name&gt; ... &lt;/connid.bundle.name&gt;
&lt;/properties&gt;

&lt;dependencies&gt;
   ...
   &lt;dependency&gt;
      &lt;groupId&gt;org.connid.bundles&lt;/groupId&gt;
      &lt;artifactId&gt;${connid.bundle.name}&lt;/artifactId&gt;
      &lt;version&gt;${connid.bundle.version}&lt;/version&gt;
      &lt;scope&gt;test&lt;/scope&gt;
   &lt;/dependency&gt;
&lt;/dependencies&gt;
</pre>
</div></div></li>
</ul>


<ul>
	<li>modify core/pom.xml file by adding the following <em>dependency</em>
element.
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
&lt;dependencies&gt;
   ...
   &lt;dependency&gt;
      &lt;groupId&gt;org.connid.bundles&lt;/groupId&gt;
      &lt;artifactId&gt;${connid.bundle.name}&lt;/artifactId&gt;
      &lt;scope&gt;test&lt;/scope&gt;
   &lt;/dependency&gt;
&lt;/dependencies&gt;
</pre>
</div></div>
<p>and adding the following rows to maven-dependency-plugin</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
&lt;configuration&gt;
            &lt;artifactItems&gt;
              &lt;artifactItem&gt;
                &lt;groupId&gt;org.connid.bundles&lt;/groupId&gt;
                &lt;artifactId&gt;${connid.bundle.name}&lt;/artifactId&gt;
                &lt;version&gt;${connid.bundle.version}&lt;/version&gt;
                &lt;outputDirectory&gt;${bundles.directory}&lt;/outputDirectory&gt;
              &lt;/artifactItem&gt;
            &lt;/artifactItems&gt;
&lt;/configuration&gt;
</pre>
</div></div></li>
</ul>


<ul>
	<li>modify console/pom.xml file by adding the following <em>artifactItem</em>
element.
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
&lt;artifactItems&gt;
   ...
   &lt;artifactItem&gt;
      &lt;groupId&gt;org.connid.bundles&lt;/groupId&gt;
      &lt;artifactId&gt;${connid.bundle.name}&lt;/artifactId&gt;
      &lt;version&gt;${connid.bundle.version}&lt;/version&gt;
      &lt;outputDirectory&gt;${bundles.directory}&lt;/outputDirectory&gt;
   &lt;/artifactItem&gt;
&lt;/artifactItems&gt;
</pre>
</div></div></li>
</ul>


<p>At build time all added connector bundles will be downloaded and copied into the
specified bundle directory.</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
mvn clean <span class="code-keyword">package</span> -Dbundles.directory=/opt/syncope/bundles
-Dlog.directory=/opt/syncope/log
</pre>
</div></div>
<p>where <em>bundles.directory</em> is the connector bundle directory where
the bundle JAR files are located and <em>log.directory</em> is the directory where
will be located the syncope, core and console, logs (directories must be created before).</p>

<p>Look for available <a href="http://repo1.maven.org/maven2/org/connid/bundles/"
class="external-link" rel="nofollow">ConnId bundles</a>.</p>

<h1><a name="Installconnectorbundles-Addbundlesatruntime"></a>Add bundles
at run-time</h1>
<p>Connector bundles can be added at run-time just performing the following two steps.</p>

<ol>
	<li><a href="http://repo1.maven.org/maven2/org/connid/bundles/" class="external-link"
rel="nofollow">Download needed connector bundle JAR file</a>.</li>
	<li>Copy downloaded JAR file into the connector bundles directory specified into the
configuration parameter <em>connid.bundles.directory</em> (stored into the local
repository).</li>
</ol>

    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/SYNCOPE/Install+connector+bundles">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=27841542&revisedVersion=6&originalVersion=5">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/SYNCOPE/Install+connector+bundles?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message