Version: GSB 7Migrationsleitfaden
Migration GSB 7.1 auf GSB 7.2
Eine Migration des GSB 7.0 auf den GSB 7.1 ist nur für die Webeditor Konfiguration erforderlich. Die Konfiguration der Richtext-Editoren ist am Release angepasst worden. Die entsprechenden Konfigurationsdokumente im Mandanten müssen wie folgt angepasst werden.
Die Konfigurationen der Richtexteditoren liegen im Mandanten im Ordner /<CUSTOMER>/__EditorConfig/PropertyEditor/HtmlEditor und enthalten Definitionen für Überschriften (einzeiliger Richtext mit wenigen "Inline"-Auszeichnungsmöglichkeiten) im Dokument SingleLine und eine Standard Richtextkonfiguration (mehrzeiliger Richtext mit "Block"- und "Inline-Auszeichnungsmöglichkeiten) im Dokument Standard.
Der GSB Kern enthält eine Default-Konfiguration, so dass die beiden angesprochenen Dokumente gelöscht werden können falls hier keine mandantenspezifischen Anpassungen vorgenommen worden sind. In dem Fall greift beim Start des Editors die Default-Konfiguration.
Alternativ können die Dokumente auf den im 7.2er Stand aktualisiert werden. Hierzu sind die entsprechenden Definitionen aus der Standardlösung als Grundlage und Ausgangsbasis für mandantenspezifische Versionen zu verwenden. Die Standardlösung enthält die entsprechenden Dokumente, die bspw. über einen Contentimport in eine 7.2er Installation importiert udn von dort in die GSBEditor Mandanten übernommen werden kann. Der Vollständigkeithalber sind in den beiden folgenden Unterkapiteln die Inhalte der betreffenden Konfigurationsdokumente aufgeführt, so dass diese auch auf Basis dieser Dokumentation aktualisiert werden kann. Die Konfigurationen sind hierzu per Copy&Paste in die die Property HTML-Code der jeweiligen Dokumente zu übernehmen.
Nach Anpassung der Konfigurationen in den Mandanten muss der GSBEditor Tomcat (Webapplikation Rest-Interface) durchgestartet werden, damit die Änderungen greifen.
Dokument: /<CUSTOMER>/__EditorConfig/PropertyEditor/HtmlEditor/SingleLine
<syntaxhighlight lang="xml" enclose="div"> {
"@type": "PropertyEditorConnection$PropertyEditorResponse", "tinymce":{ "singleselects": { "webEditorLanguage": { "textLabel": "gsb.tinymce.languageButton.text", "tooltipLabel": "gsb.tinymce.languageButton.tooltip", "formats": [{ "name": "lang-de", "textLabel": "gsb.tinymce.languageButton.de", "classes": "xmllang--de", "inline": "span" },{ "name": "lang-en-GB", "textLabel": "gsb.tinymce.languageButton.en-GB", "classes": "xmllang--en-GB", "inline": "span" }] } }, "extensions":{ "webEditorBITV":{ "textLabel":"gsb.tinymce.bitvButton.text", "tooltipLabel":"gsb.tinymce.bitvButton.tooltip", "image":"images/tinymce/bitv-icon.png" } }, "base":{ "toolbar1":"undo redo | nonbreaking | webEditorLanguage | spellchecker | styleselect | removeformat | webEditorBITV", "inline":true, "object_resizing":false, "theme":"modern", "skin":"lightgray", "element_format":"xhtml", "language":"de", "menubar":false, "formats":{ "removeformat":[ { "selector":"b,strong,em,i,font,u,strike,abbr,q,cite,samp,dfn,var,kbd,code,sup,sub", "remove":"all", "split":true, "expand":false, "block_expand":true, "deep":true }, { "selector":"span", "attributes":[ "style", "class" ], "remove":"empty", "split":true, "expand":false, "deep":true }, { "selector":"*", "attributes":[ "style" ], "split":false, "expand":false, "deep":true } ] }, "plugins":"paste spellchecker searchreplace nonbreaking", "valid_elements":"span[class|style],p[style],br,abbr[class]", "paste_word_valid_elements":"span[style],p[style],br,abbr", "paste_retain_style_properties":"text-align", "entity_encoding":"raw", "force_br_newlines":false, "force_p_newlines":true, "style_formats":[ { "title":"Abkürzung", "inline":"abbr", "wrapper":false } ] } }
} </syntaxhighlight>
Dokument: /<CUSTOMER>/__EditorConfig/PropertyEditor/HtmlEditor/Standard
<syntaxhighlight lang="xml" enclose="div"> {
"@type": "PropertyEditorConnection$PropertyEditorResponse", "tinymce": { "multiselects": { }, "singleselects": { "webEditorLanguage": { "textLabel": "gsb.tinymce.languageButton.text", "tooltipLabel": "gsb.tinymce.languageButton.tooltip", "formats": [{ "name": "lang-de", "textLabel": "gsb.tinymce.languageButton.de", "classes": "xmllang--de", "inline": "span" },{ "name": "lang-en-GB", "textLabel": "gsb.tinymce.languageButton.en-GB", "classes": "xmllang--en-GB", "inline": "span" }] } }, "formatbuttons": { }, "custom": { }, "extensions": { "webEditorBITV": { "textLabel": "gsb.tinymce.bitvButton.text", "tooltipLabel": "gsb.tinymce.bitvButton.tooltip", "image": "images/tinymce/bitv-icon.png" }, "webEditorImage": { "textLabel": "gsb.tinymce.imageButton.text", "tooltipLabel": "gsb.tinymce.imageButton.tooltip", "icon": "image" }, "webEditorLink": { "textLabel": "gsb.tinymce.linkButton.text", "tooltipLabel": "gsb.tinymce.linkButton.tooltip", "icon": "link" }, "webEditorNavigation": { "textLabel": "gsb.tinymce.navigationButton.text", "tooltipLabel": "gsb.tinymce.navigationButton.tooltip", "image": "images/tinymce/toolbar/toc.svg" } }, "base": { "toolbar1": "undo redo | nonbreaking | bold italic | styleselect | webEditorLanguage | spellchecker | webEditorImage webEditorLink anchor | webEditorBITV | table | removeformat | pastetext | searchreplace", "toolbar2": "alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | formatselect", "contextmenu": "bold italic | anchor webEditorImage webEditorLink | inserttable | cell row column deletetable", "inline": true, "debug": true, "object_resizing": false, "theme": "modern", "skin": "lightgray", "element_format": "xhtml", "language": "de", "spellchecker_language": "de", "spellchecker_languages": "Englisch=en-GB,Deutsch=de", "menubar": false, "formats": { "removeformat": [ { "selector": "b,strong,em,i,font,u,strike,abbr,q,cite,samp,dfn,var,kbd,code,sup,sub", "remove": "all", "split": true, "expand": false, "block_expand": true, "deep": true },{ "selector": "span", "attributes": [ "style", "class" ], "remove": "empty", "split": true, "expand": false, "deep": true },{ "selector": "*", "attributes": [ "style" ], "split": false, "expand": false, "deep": true } ] }, "plugins": "paste table spellchecker contextmenu anchor lists searchreplace nonbreaking", "valid_elements": "a[id|name|class|title|data*],span[class|data*|style],img[class|alt|src|style|title|data*],strong/b,em/i,p[style],-ol,-ul,li[class],h2,h3,h4,h5,h6,table[class],caption,tr[class],td[style|rowspan|colspan|class|valign],th,thead,tfoot,tbody,sub,sup,br,abbr[class],q[class],cite[class],samp[class],var[class],kbd[class],code[class],blockquote,address,pre,dfn,acronym", "extended_valid_elements": "a[id|name|class|ondblclick|title],span[class]", "invalid_styles": { "td": "width,height", "tr": "width,height", "table": "width,height" }, "paste_word_valid_elements": "strong,b,em,i,span[style|data*],p[style],ol,ul,li[class],h2,h3,h4,h5,h6,table,tr,td[style|rowspan|colspan|valign],th,thead,tfoot,tbody,sub,sup,br,abbr,q,cite,samp,var,kbd,code,dfn,pre,acronym", "paste_retain_style_properties": "text-align", "block_formats": "Absatz=p;Überschrift 2=h2;Überschrift 3=h3;Überschrift 4=h4;Überschrift 5=h5;Überschrift 6=h6;Absatzzitat=blockquote;Vorformatiert=pre;Adresse=address", "entity_encoding": "raw", "force_br_newlines": false, "force_p_newlines": true, "table_advtab": false, "table_cell_advtab": false, "table_row_advtab": false, "table_class_list": [ { "title": "Tabelle", "value": "" },{ "title": "Definitionsliste", "value": "table-status--definitionlist" } ], "table_cell_class_list": [ { "title": "Keine", "value": "" },{ "title": "Spaltenüberschrift", "value": "td-status--headercol" },{ "title": "Zeilenüberschrift", "value": "td-status--headerrow" } ], "table_row_class_list": [ { "title":"gerade Zeile", "value":"css-trclass--even" },{ "title":"ungerade Zeile", "value":"css-trclass--odd" },{ "title":"Spaltenbreite", "value":"tr-status--colgroup" } ], "style_formats": [ { "title": "Abkürzung", "inline": "abbr", "wrapper": false },{ "title": "Zitat", "inline": "q", "wrapper": false },{ "title": "Quelle", "inline": "cite", "wrapper": false },{ "title": "Beispiel", "inline": "samp", "wrapper": false },{ "title": "Definition", "inline": "dfn", "wrapper": false },{ "title": "Variable", "inline": "var", "wrapper": false },{ "title": "Keyboardeingabe", "inline": "kbd", "wrapper": false },{ "title": "Quellcode", "inline": "code", "wrapper": false },{ "title": "Hochgestellt", "inline": "sup", "wrapper": false },{ "title": "Tiefgestellt", "inline": "sub", "wrapper": false } ] } }
} </syntaxhighlight>
Migration GSB 7.0 auf GSB 7.1
Eine Migration des GSB 7.0 auf den GSB 7.1 ist nur für die Webeditor Konfiguration erforderlich. Die erforderlichen Schritte für die Aktualisierung werden im Folgenden beschrieben:
Am einfachsten können die erforderlichen Änderungen durch einen Import der 7.1er Standardlösung in die 7.0er Standardlösung und anschließendem Versionsvergleich ermittelt werden.
Dokumenttyp: ResponsiveImage
Anpassung der Editor-Konfiguration in den Dateien
- /standardlsg/__EditorConfig/Roles/editor_stdlsg_admin/ResponsiveImage
- /standardlsg/__EditorConfig/Roles/editor_stdlsg_redakteur/ResponsiveImage
Der Block zwischen den Properties source und dateOfIssue muss durch den folgenden Block ausgetauscht werden. Zur einfacheren Identifizierung sind die Defintionen der Properties source und dateOfIssue mit aufgeführt.
<syntaxhighlight lang="xml" enclose="div">
<Row> <Property col="12" name="source" type="String" visible="true"/> </Row> <Row> <Property class="ImageBlobEditor" col="12" name="normal" type="Blob" visible="true"/> </Row> <Row> <Property class="ImageBlobEditor" col="12" name="thumbnail" type="Blob" visible="true"/> </Row> <Row> <Property class="ImageBlobEditor" col="12" name="banner" type="Blob" visible="true"/> </Row> <Row> <Property class="ImageBlobEditor" col="12" name="poster" type="Blob" visible="true"/> </Row> <Row> <Property class="ResponsiveRegion" col="12" name="cl2NormalSizes" type="ClassifiedLinkList" visible="true" imageProperty="normal" formatLinkClassifierPath="$ResponsiveImage-path"/> </Row> <Row> <Property class="ResponsiveRegion" col="12" name="cl2ThumbnailSizes" type="ClassifiedLinkList" visible="true" imageProperty="thumbnail" formatLinkClassifierPath="$ResponsiveImage-path"/> </Row> <Row> <Property class="ResponsiveRegion" col="12" name="cl2BannerSizes" type="ClassifiedLinkList" visible="true" imageProperty="banner" formatLinkClassifierPath="$ResponsiveImage-path"/> </Row> <Row> <Property class="ResponsiveRegion" col="12" name="cl2PosterSizes" type="ClassifiedLinkList" visible="true" imageProperty="poster" formatLinkClassifierPath="$ResponsiveImage-path"/> </Row> <Row> <Property col="12" name="dateOfIssue" type="DateTime" visible="true"> <Initializer class="DateInitializer" offset=""/> </Property> </Row>
</syntaxhighlight>
Module-Konfiguration
Die Konfiguration der einzelnen Editor-Funktionen ist in der Datei /standardlsg/__EditorConfig/Modules/ModuleConfiguration definiert. Diese Konfiguration muss so in den jeweiligen Mandanten übernommen werden. Die jeweils zu verwendenden Gruppen müssen anschließend an die Anforderungen des Mandanten angepasst werden.
PropertyEditor: DateTime
Zur Verwendung des DateTime-PropertyEditors muss folgende Definition anstelle der ursprünglichen Definition gesetzt werden (exemplarische Konfiguration am Beispiel der Property dateOfIssue):
<syntaxhighlight lang="xml" enclose="div">
<Row> <Property col="12" name="dateOfIssue" type="DateTime" visible="true"> <Initializer class="DateInitializer" offset=""/> </Property> </Row>
</syntaxhighlight>
Richtext-Konfiguration
Die folgenden Dateien müssen in den jeweiligen Mandanten kopiert werden:
- standardlsg/__EditorConfig/PropertyEditor/HtmlEditor/SingleLine
- standardlsg/__EditorConfig/PropertyEditor/HtmlEditor/Standard
Migration GSB 6.0 auf GSB 7.0
Dieses Kapitel des Migrationsleitfaden dokumentiert die durchzuführenden Änderungen für Hosting-Plattform Betreiber als auch GSB-Mandanten bei einer Migration ihrer GSB6.0 Umgebung auf die GSB-Version 7.0.
Ausgangssituation
Grundlage und Ausgangsbasis für die im Migrationsleitfaden beschriebenen Schritte ist der Auslieferungsstand der GSB Version 6.0.
Migration Hosting-Plattform
Die Anpassung der CoreMedia Content-DB kann durch Setzen der folgenden Properties /opt/gsb/active/cms-tomcat/webapps/contentmanagementserver/WEB-INF/properties/corem/sql.properties durchgeführt werden.
sql.schema.alterTable=true
sql.schema.createDropIndexes=true
Nach Setzen der Properties muss der Contentmanagment-Tomcat gestartet werden. Nachdem der Tomcat erfolgreich gestartet worden ist, können die Werte wieder auf false gesetzt werden.