<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 01:14:27 CET 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>Magnolia - Issue tracker</title>
    <link>https://jira.magnolia-cms.com</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-uk</language>    <build-info>
        <version>9.4.2</version>
        <build-number>940002</build-number>
        <build-date>19-01-2023</build-date>
    </build-info>


<item>
            <title>[DOCU-1020] Document issue with site-app when following a custom upgrade path</title>
                <link>https://jira.magnolia-cms.com/browse/DOCU-1020</link>
                <project id="10190" key="DOCU">Documentation</project>
                    <description>&lt;p&gt;As mentioned by &lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=ahietala&quot; class=&quot;user-hover&quot; rel=&quot;ahietala&quot;&gt;ahietala&lt;/a&gt; in the comment section of &lt;a href=&quot;https://jira.magnolia-cms.com/browse/MGNLSITE-59&quot; title=&quot;Site app should automatically configure itself correctly when added to a project&quot; class=&quot;issue-link&quot; data-issue-key=&quot;MGNLSITE-59&quot;&gt;&lt;del&gt;MGNLSITE-59&lt;/del&gt;&lt;/a&gt;, we need to document how to get rid of the inconsistent configuration one might end up with when following a custom upgrade path in an installation with STK, multisite and site-app (for further details see the description of the related ticket). &lt;br/&gt;
The basic idea is to use a Groovy script which will do the required replacements and deletions. Not sure where exactly in the documentation all this could be mentioned. At any rate, here is the Groovy script to fix the borked config. One can simply execute it via GroovyApp in Magnolia.&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
session = ctx.getJCRSession(&lt;span class=&quot;code-quote&quot;&gt;&apos;config&apos;&lt;/span&gt;)
updatedConfig = &lt;span class=&quot;code-keyword&quot;&gt;false&lt;/span&gt;

def removeNode(absPath) {
  &lt;span class=&quot;code-keyword&quot;&gt;if&lt;/span&gt; (session.nodeExists(absPath)) {
      println &lt;span class=&quot;code-quote&quot;&gt;&quot;Removing config:$absPath ...&quot;&lt;/span&gt;
      session.removeItem(absPath)
      updatedConfig = &lt;span class=&quot;code-keyword&quot;&gt;true&lt;/span&gt;
  }
}

&lt;span class=&quot;code-keyword&quot;&gt;if&lt;/span&gt; (session.nodeExists(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/multisite&apos;&lt;/span&gt;) &amp;amp;&amp;amp; session.nodeExists(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/site-app&apos;&lt;/span&gt;) &amp;amp;&amp;amp; session.nodeExists(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/standard-templating-kit&apos;&lt;/span&gt;)) {
    println &lt;span class=&quot;code-quote&quot;&gt;&quot;Detected multisite, site-app and stk modules. Let&apos;s see &lt;span class=&quot;code-keyword&quot;&gt;if&lt;/span&gt; configuration needs some clean up...&quot;&lt;/span&gt;

    siteAppContentConnector = session.getNode(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/site-app/apps/site/subApps/browser/contentConnector&apos;&lt;/span&gt;)

    &lt;span class=&quot;code-keyword&quot;&gt;if&lt;/span&gt; (&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/site/config/site&apos;&lt;/span&gt;.equals(PropertyUtil.getString(siteAppContentConnector, &lt;span class=&quot;code-quote&quot;&gt;&apos;rootPath&apos;&lt;/span&gt;))) {
        println &lt;span class=&quot;code-quote&quot;&gt;&apos;Replacing config:/modules/site-app/apps/site/subApps/browser/contentConnector@rootPath value /modules/site/config/site with /modules/multisite/config/sites ...&apos;&lt;/span&gt;
        PropertyUtil.setProperty(siteAppContentConnector, &lt;span class=&quot;code-quote&quot;&gt;&apos;rootPath&apos;&lt;/span&gt;, &lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/multisite/config/sites&apos;&lt;/span&gt;)
        updatedConfig = &lt;span class=&quot;code-keyword&quot;&gt;true&lt;/span&gt;
    }
    removeNode(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/ui-admincentral/apps/stkSiteApp&apos;&lt;/span&gt;)
    removeNode(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/ui-admincentral/config/appLauncherLayout/groups/stk/apps/stkSiteApp&apos;&lt;/span&gt;)
    removeNode(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/ui-admincentral/apps/stkThemesApp&apos;&lt;/span&gt;)
    removeNode(&lt;span class=&quot;code-quote&quot;&gt;&apos;/modules/ui-admincentral/config/appLauncherLayout/groups/stk/apps/stkThemesApp&apos;&lt;/span&gt;)
    session.save()
}

&lt;span class=&quot;code-keyword&quot;&gt;if&lt;/span&gt; (updatedConfig) {
  &lt;span class=&quot;code-keyword&quot;&gt;return&lt;/span&gt; &lt;span class=&quot;code-quote&quot;&gt;&apos;Configuration cleaned up. Bye.&apos;&lt;/span&gt;
} &lt;span class=&quot;code-keyword&quot;&gt;else&lt;/span&gt; {
  &lt;span class=&quot;code-keyword&quot;&gt;return&lt;/span&gt; &lt;span class=&quot;code-quote&quot;&gt;&apos;Nothing to &lt;span class=&quot;code-keyword&quot;&gt;do&lt;/span&gt; here. Bye.&apos;&lt;/span&gt;
}
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;

&lt;p&gt;As to a way to reproduce the inconsistent situation originally reported I did this&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;first step: install magnolia 5.4.3 EE (STK 2.9.2) w/o site-app&lt;/li&gt;
	&lt;li&gt;second step: upgrade to 5.4.4 (STK 2.9.3) still w/o site-app&lt;/li&gt;
	&lt;li&gt;third step:
	&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
		&lt;li&gt;add site-app 1.0.5&lt;/li&gt;
		&lt;li&gt;upgrade to site-module 1.0.5&lt;/li&gt;
		&lt;li&gt;upgrade to imaging-support 3.2.5 (needed by site-module 1.0.5)&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;
</description>
                <environment></environment>
        <key id="59463">DOCU-1020</key>
            <summary>Document issue with site-app when following a custom upgrade path</summary>
                <type id="3" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10898&amp;avatarType=issuetype">Task</type>
                                            <priority id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/priorities/neutral.gif">Neutral</priority>
                        <status id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="11">Done</resolution>
                                        <assignee username="jlegendre">Julie Legendre</assignee>
                                    <reporter username="fgrilli">Federico Grilli</reporter>
                        <labels>
                            <label>core</label>
                    </labels>
                <created>Wed, 17 May 2017 13:52:27 +0200</created>
                <updated>Mon, 3 Jul 2017 11:46:46 +0200</updated>
                            <resolved>Fri, 26 May 2017 09:49:38 +0200</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>4</watches>
                                                                                                                <comments>
                            <comment id="143652" author="jlegendre" created="Wed, 24 May 2017 10:57:15 +0200"  >&lt;p&gt;Draft is here: &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS54/Updating+a+custom+Magnolia+bundle&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS54/Updating+a+custom+Magnolia+bundle&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="143737" author="jlegendre" created="Fri, 26 May 2017 09:50:21 +0200"  >&lt;p&gt;Comments from federico integrated, &lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=cmeier&quot; class=&quot;user-hover&quot; rel=&quot;cmeier&quot;&gt;cmeier&lt;/a&gt; would you like to review before I publish?&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>relation</name>
                                            <outwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="51658">MGNLSITE-59</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                            <customfield id="customfield_14166" key="com.okapya.jira.checklist:checklist">
                        <customfieldname>Acceptance criteria</customfieldname>
                        <customfieldvalues>
                            
        <checklist>
        <![CDATA[
                            




                
                                    <div class="o-completion" style="display: flex; flex-shrink: 0;"><span  class="aui-lozenge aui-lozenge-complete" style="font-size: 12px; font-weight: normal; display: flex; flex-direction: row; align-items: center;" ><span style="padding-right: 4px; vertical-align: middle;"><svg width="15" height="15" viewBox="0 0 15 15" xmlns="http://www.w3.org/2000/svg" fill="white"><path clip-rule="evenodd" d="m10.41037,3.42544l-7.86501,0c-0.72395,0 -1.31084,0.58688 -1.31084,1.31084l0,7.86508c0,0.7239 0.58689,1.3108 1.31084,1.3108l7.86501,0c0.724,0 1.3109,-0.5869 1.3109,-1.3108l0,-7.86508c0,-0.72396 -0.5869,-1.31084 -1.3109,-1.31084zm-7.86501,-0.65542c-1.08593,0 -1.96626,0.88032 -1.96626,1.96626l0,7.86508c0,1.0859 0.88033,1.9662 1.96626,1.9662l7.86501,0c1.086,0 1.9663,-0.8803 1.9663,-1.9662l0,-7.86508c0,-1.08594 -0.8803,-1.96626 -1.9663,-1.96626l-7.86501,0z" fill-rule="evenodd"/><path d="m5.09049,10.18526l-1.82767,-1.82766l-0.78479,0.78479l2.61246,2.61246l5.38758,-5.38754l-0.78483,-0.78479l-4.60275,4.60274z"/></svg></span><span>Empty</span></span></div>
                        ]]>
    </checklist>


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_10111" key="com.atlassian.jira.toolkit:reporterdomain">
                        <customfieldname>Company</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>magnolia-cms.com</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10031" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 18 May 2017 06:27:59 +0200</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_12730" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_14151" key="com.atlassian.jira.toolkit:message">
                        <customfieldname>Docu info</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_12130" key="com.atlassian.jira.plugin.system.customfieldtypes:multicheckboxes">
                        <customfieldname>Documentation update required</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="13300"><![CDATA[Yes]]></customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10061" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comm is not jira-dev</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10071" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last participant</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>cmeier</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            6 years, 38 weeks, 2 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10020" key="com.atlassian.jira.toolkit:attachments">
                        <customfieldname>Number of attachments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10150" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname>Number of comments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>fgrilli</customfieldvalue>
            <customfieldvalue>jlegendre</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|hzzzk4:jrv3ec</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10244" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10245" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="488">Docu Sprint 25</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_10242" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>8.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_14167" key="com.okapya.jira.checklist:checklist">
                        <customfieldname>Task DoR</customfieldname>
                        <customfieldvalues>
                            
        <checklist>
        <![CDATA[
                            




                
                                    <div class="o-completion" style="display: flex; flex-shrink: 0;"><span  class="aui-lozenge aui-lozenge-complete" style="font-size: 12px; font-weight: normal; display: flex; flex-direction: row; align-items: center;" ><span style="padding-right: 4px; vertical-align: middle;"><svg width="15" height="15" viewBox="0 0 15 15" xmlns="http://www.w3.org/2000/svg" fill="white"><path clip-rule="evenodd" d="m10.41037,3.42544l-7.86501,0c-0.72395,0 -1.31084,0.58688 -1.31084,1.31084l0,7.86508c0,0.7239 0.58689,1.3108 1.31084,1.3108l7.86501,0c0.724,0 1.3109,-0.5869 1.3109,-1.3108l0,-7.86508c0,-0.72396 -0.5869,-1.31084 -1.3109,-1.31084zm-7.86501,-0.65542c-1.08593,0 -1.96626,0.88032 -1.96626,1.96626l0,7.86508c0,1.0859 0.88033,1.9662 1.96626,1.9662l7.86501,0c1.086,0 1.9663,-0.8803 1.9663,-1.9662l0,-7.86508c0,-1.08594 -0.8803,-1.96626 -1.9663,-1.96626l-7.86501,0z" fill-rule="evenodd"/><path d="m5.09049,10.18526l-1.82767,-1.82766l-0.78479,0.78479l2.61246,2.61246l5.38758,-5.38754l-0.78483,-0.78479l-4.60275,4.60274z"/></svg></span><span>Empty</span></span></div>
                        ]]>
    </checklist>


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                    <customfield id="customfield_14145" key="com.intenso.jira.issue-templates:issue-templates-customfield">
                        <customfieldname>Template</customfieldname>
                        <customfieldvalues>
                            


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_15131" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Time in Discovery</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10032" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        </customfields>
    </item>
</channel>
</rss>