syncope-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Syncope > Upgrade from 1.0.X to 1.1.X
Date Tue, 02 Apr 2013 13:36: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/Upgrade+from+1.0.X+to+1.1.X">Upgrade
from 1.0.X to 1.1.X</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~ilgrosso">Francesco
Chicchiricco</a>
    </h4>
        <br/>
                         <h4>Changes (8)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-unchanged" >{toc:style=decimal|maxLevel=2} <br>
<br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.
1.1.0 Espressivo -&gt; 1.1.0 Ad Libitum <br></td></tr>
            <tr><td class="diff-unchanged" >{note}Draft until official release
of [1.1.0|https://issues.apache.org/jira/browse/SYNCOPE/fixforversion/12322504#selectedTab=com.atlassian.jira.plugin.system.project%3Aversion-issues-panel]{note}
<br> <br>Some changes in the persistence layer need to be reflected in the database
used by Syncope as internal repository. <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">2</span>.</span> MD5
is not supported any more <br></td></tr>
            <tr><td class="diff-unchanged" >[SYNCOPE-51|https://issues.apache.org/jira/browse/SYNCOPE-51]
removed MD5 from supported password cipher algorithm. <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > # any row in SyncopeUser table with
{{cipherAlgorithm=MD5}} must be set to something different (say {{SHA1}}); moreover, all users
must change their own password <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">2</span>.</span> Quartz
upgraded to 2.1.X <br></td></tr>
            <tr><td class="diff-unchanged" >Syncope now features the latest version
of Quartz (as per [SYNCOPE-93|https://issues.apache.org/jira/browse/SYNCOPE-93]). <br>
<br>Remove any {{QRTZ_*}} table from the database: such tables will be re-created at
next startup. <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">2</span>.</span> New
mandatory conf param &#39;notificationjob.cronExpression&#39; <br></td></tr>
            <tr><td class="diff-unchanged" >As per [SYNCOPE-216|https://issues.apache.org/jira/browse/SYNCOPE-216],
you can specify when the {{NotificationJob}} will run. <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >Reference and some examples of cron
expressions are provided in [Quartz website|http://quartz-scheduler.org/documentation/quartz-2.1.x/tutorials/tutorial-lesson-06].
<br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">2</span>.</span> Changes
in Task table <br></td></tr>
            <tr><td class="diff-unchanged" > * [SYNCOPE-144|https://issues.apache.org/jira/browse/SYNCOPE-144]
introduced two additional columns in Task table: <br>{code} <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >Moreover, [SYNCOPE-186|https://issues.apache.org/jira/browse/SYNCOPE-186]
renamed {{jobActionsClassName}} to {{actionsClassName}} <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">2</span>.</span> Changes
in SyncopeRole table <br></td></tr>
            <tr><td class="diff-unchanged" >[SYNCOPE-225|https://issues.apache.org/jira/browse/SYNCOPE-225]
introduced three additional columns in SyncopeRole table: <br>{code} <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{code} <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">2</span>.</span> Changes
in ConnInstance table <br></td></tr>
            <tr><td class="diff-unchanged" >[SYNCOPE-279|https://issues.apache.org/jira/browse/SYNCOPE-279]
introduced an additional column in ConnInstance table: <br>{code} <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >{code} <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">3</span><span
class="diff-added-chars"style="background-color: #dfd;">2</span>.</span> Other
<br></td></tr>
            <tr><td class="diff-unchanged" > * ExternalResource.forceMandatoryConstraint
renamed to ExternalResource.enforceMandatoryCondition <br> * ExternalResource has now
an additional column {code}actionsClassName VARCHAR(255){code} <br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <style type='text/css'>/*<![CDATA[*/
div.rbtoc1364909708531 {margin-left: 1.5em;padding: 0px;}
div.rbtoc1364909708531 ul {list-style: decimal;margin-left: 0px;}
div.rbtoc1364909708531 li {margin-left: 0px;padding-left: 0px;}

/*]]>*/</style><div class='rbtoc1364909708531'>
<ul>
    <li><a href='#Upgradefrom1.0.Xto1.1.X-MD5isnotsupportedanymore'>MD5 is not
supported any more</a></li>
    <li><a href='#Upgradefrom1.0.Xto1.1.X-Quartzupgradedto2.1.X'>Quartz upgraded
to 2.1.X</a></li>
    <li><a href='#Upgradefrom1.0.Xto1.1.X-Newmandatoryconfparam%27notificationjob.cronExpression%27'>New
mandatory conf param 'notificationjob.cronExpression'</a></li>
    <li><a href='#Upgradefrom1.0.Xto1.1.X-ChangesinTasktable'>Changes in Task
table</a></li>
    <li><a href='#Upgradefrom1.0.Xto1.1.X-ChangesinSyncopeRoletable'>Changes in
SyncopeRole table</a></li>
    <li><a href='#Upgradefrom1.0.Xto1.1.X-ChangesinConnInstancetable'>Changes
in ConnInstance table</a></li>
    <li><a href='#Upgradefrom1.0.Xto1.1.X-Other'>Other</a></li>
</ul></div>

<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>Draft until official release of
<a href="https://issues.apache.org/jira/browse/SYNCOPE/fixforversion/12322504#selectedTab=com.atlassian.jira.plugin.system.project%3Aversion-issues-panel"
class="external-link" rel="nofollow">1.1.0</a></td></tr></table></div>

<p>Some changes in the persistence layer need to be reflected in the database used by
Syncope as internal repository.</p>

<h2><a name="Upgradefrom1.0.Xto1.1.X-MD5isnotsupportedanymore"></a>MD5 is
not supported any more</h2>
<p><a href="https://issues.apache.org/jira/browse/SYNCOPE-51" class="external-link"
rel="nofollow">SYNCOPE-51</a> removed MD5 from supported password cipher algorithm.</p>

<p>This means that:</p>
<ol>
	<li><tt>password.cipher.algorithm</tt> must be set to something different
(say <tt>SHA1</tt>) in <tt>SyncopeConf</tt> table</li>
	<li>any row in SyncopeUser table with <tt>cipherAlgorithm=MD5</tt> must
be set to something different (say <tt>SHA1</tt>); moreover, all users must change
their own password</li>
</ol>


<h2><a name="Upgradefrom1.0.Xto1.1.X-Quartzupgradedto2.1.X"></a>Quartz upgraded
to 2.1.X</h2>
<p>Syncope now features the latest version of Quartz (as per <a href="https://issues.apache.org/jira/browse/SYNCOPE-93"
class="external-link" rel="nofollow">SYNCOPE-93</a>).</p>

<p>Remove any <tt>QRTZ_*</tt> table from the database: such tables will
be re-created at next startup.</p>

<h2><a name="Upgradefrom1.0.Xto1.1.X-Newmandatoryconfparam%27notificationjob.cronExpression%27"></a>New
mandatory conf param 'notificationjob.cronExpression'</h2>
<p>As per <a href="https://issues.apache.org/jira/browse/SYNCOPE-216" class="external-link"
rel="nofollow">SYNCOPE-216</a>, you can specify when the <tt>NotificationJob</tt>
will run.</p>

<p>Add a row to <tt>SyncopeConf</tt> table with <tt>key</tt>
= <tt>notificationjob.cronExpression</tt> and your chosen cron expression as <tt>value</tt>.</p>

<p>Reference and some examples of cron expressions are provided in <a href="http://quartz-scheduler.org/documentation/quartz-2.1.x/tutorials/tutorial-lesson-06"
class="external-link" rel="nofollow">Quartz website</a>.</p>

<h2><a name="Upgradefrom1.0.Xto1.1.X-ChangesinTasktable"></a>Changes in
Task table</h2>
<ul>
	<li><a href="https://issues.apache.org/jira/browse/SYNCOPE-144" class="external-link"
rel="nofollow">SYNCOPE-144</a> introduced two additional columns in Task table:
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
name VARCHAR(255),
description VARCHAR(255)
</pre>
</div></div></li>
	<li>Change any value from <tt>org.apache.syncope.core.scheduling.SyncJob</tt>
to <tt>org.apache.syncope.core.sync.SyncJob</tt> of the <tt>jobClassName</tt>
column</li>
</ul>


<p>Moreover, <a href="https://issues.apache.org/jira/browse/SYNCOPE-186" class="external-link"
rel="nofollow">SYNCOPE-186</a> renamed <tt>jobActionsClassName</tt> to
<tt>actionsClassName</tt></p>

<h2><a name="Upgradefrom1.0.Xto1.1.X-ChangesinSyncopeRoletable"></a>Changes
in SyncopeRole table</h2>
<p><a href="https://issues.apache.org/jira/browse/SYNCOPE-225" class="external-link"
rel="nofollow">SYNCOPE-225</a> introduced three additional columns in SyncopeRole
table:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
inheritOwner INTEGER,
ROLEOWNER_ID BIGINT,
USEROWNER_ID BIGINT
</pre>
</div></div>

<h2><a name="Upgradefrom1.0.Xto1.1.X-ChangesinConnInstancetable"></a>Changes
in ConnInstance table</h2>
<p><a href="https://issues.apache.org/jira/browse/SYNCOPE-279" class="external-link"
rel="nofollow">SYNCOPE-279</a> introduced an additional column in ConnInstance table:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
connRequestTimeout INTEGER
</pre>
</div></div>

<h2><a name="Upgradefrom1.0.Xto1.1.X-Other"></a>Other</h2>
<ul>
	<li>ExternalResource.forceMandatoryConstraint renamed to ExternalResource.enforceMandatoryCondition</li>
	<li>ExternalResource has now an additional column 
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">actionsClassName VARCHAR(255)</pre>
</div></div></li>
</ul>

    </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/Upgrade+from+1.0.X+to+1.1.X">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=30739950&revisedVersion=15&originalVersion=14">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/SYNCOPE/Upgrade+from+1.0.X+to+1.1.X?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message