{"id":7205,"date":"2021-05-11T17:00:00","date_gmt":"2021-05-11T15:00:00","guid":{"rendered":"https:\/\/u-labs.de\/portal\/?p=7205"},"modified":"2021-12-16T16:40:51","modified_gmt":"2021-12-16T14:40:51","slug":"hcl-connections-cumulative-fix-cfix-installieren-neue-monatliche-updates-fuer-connections-7","status":"publish","type":"post","link":"https:\/\/u-labs.de\/portal\/hcl-connections-cumulative-fix-cfix-installieren-neue-monatliche-updates-fuer-connections-7\/","title":{"rendered":"HCL Connections Cumulative Fix (CFix) installieren: Neue monatliche Updates f\u00fcr Connections 7"},"content":{"rendered":"<p>Seit Mai 2021 gibt es <a href=\"https:\/\/support.hcltechsw.com\/csm?id=kb_article&amp;sysparm_article=KB0086997&amp;sys_kb_id=21496167db73241055f38d6d1396195d\" target=\"_blank\" rel=\"nofollow\"><strong>Cumulative Fixes<\/strong> f\u00fcr HCL Connections<\/a>, kurz <strong>CFix<\/strong>. Sie sollen zu Beginn jedes Monats als ein Paket aus prim\u00e4r Fehlerkorrekturen erscheinen und beziehen sich auf den Kern von Connections, also nicht das <em>Component Pack<\/em>. Scheinbar soll damit die Installation von einzelnen kleineren Updates zwischen einem neuen CR geb\u00fcndelt und vereinfacht werden. Au\u00dferdem enth\u00e4lt ein neuerer CFix immer die Aktualisierungen des vorherigen. Auch das Connections 7.0 Update vom Februar 2021 ist darin enthalten, obwohl es sich hierbei noch um keinen CFix handelt. Es liefert u.a. die Mehrsprachigkeit nach, die beim initialen Release von 7.0 noch fehlte.<\/p>\n<p>Diesese Ank\u00fcndigung kommt zwar \u00fcberraschend. Konzeptionell finde ich das eine sehr gute Idee. Teilweise gab es einzelne Fixes, die nicht ver\u00f6ffentlicht wurden. Man musste also irgendwoher davon erfahren, und diese anschlie\u00dfend einzeln beim Support anfragen. Bis diese Fixe ihren Weg in das n\u00e4chste CR-Release finden, dauert es eine ganze Weile. Auch wenn sich die CFixe nur auf Fehlerkorrekturen beziehen, ist das in meinen Augen ein sinnvoller Schritt.<\/p>\n<p>Der erste <strong>CFix.7.0.2105<\/strong> wurde am 03.05.2021 ver\u00f6ffentlicht. Im KB-Artikel <em><a href=\"https:\/\/support.hcltechsw.com\/csm?id=kb_article&amp;sysparm_article=KB0088085&amp;sys_kb_id=9f63bf001bccf010f37655352a4bcbb9\" target=\"_blank\" rel=\"nofollow\">Connections 7.0 Cumulative Fix (CFix) List<\/a> <\/em> ist dokumentiert, welche Probleme er behebt. Im folgenden installieren wir diesen ersten CFix auf einer Connections 7.0 installation. Das Februar 2021 Update ist darauf noch nicht installiert und wird bewusst \u00fcbersprungen, da es im CFIX.70.2105 enthalten ist. Die Installation wird zum Verst\u00e4ndnis noch h\u00e4ndisch auf einem CentOS 7-Server durchgef\u00fchrt. Im n\u00e4chsten Schritt folgt eine Ansible-Rolle, um CFixes zuk\u00fcnftig ebenfalls automatisiert deployen zu k\u00f6nnen.<\/p>\n<p><strong>Wichtig<\/strong>: Bei der Installation eines CFixes werden Anpassungen \u00fcberschrieben! Wer seine Anpassungen nicht mit Ansible o.\u00c4. automatisiert wieder einspielen kann, sollte diese daher vorher sichern.<\/p>\n<h2 class=\"wp-block-heading\">Download des <em>UpdateInstallers <\/em>und <em>CFixes<\/em><\/h2>\n<p>Um einen CFix installieren, wird ein neuer <em>UpdateInstaller<\/em> ben\u00f6tigt. Im Flexnet wird er als <strong>HCL Connections V7.0 Update Wizard (2104)<\/strong> bezeichnet und findet sich in der Gruppe <strong><a href=\"https:\/\/hclsoftware.flexnetoperations.com\/flexnet\/operationsportal\/entitledDownloadFile.action?downloadPkgId=HCL_Connections_7.0_Updates&amp;orgId=HCL17813\" target=\"_blank\" rel=\"nofollow\">HCL Connections v7.0 Updates<\/a><\/strong> als ZIP-Archiv. Diese Gruppe enth\u00e4lt auch das erste Mai 2021 CFix. Es m\u00fcssen somit folgende beide Dateien heruntergeladen werden:<\/p>\n<ul class=\"wp-block-list\">\n<li>HCL_Connections_70_updateInstaller_2104.zip<\/li>\n<li>CFIX.70.2105-IC7.0.0.0-Common-Fix.jar<\/li>\n<\/ul>\n<p>In der Zukunft kann man &#8211; wie oben beschrieben &#8211; das neuste CFix herunterladen. Es enth\u00e4lt alle vorherigen CFixes, sodass diese nicht h\u00e4ndisch nacheinander installiert werden m\u00fcssen.<\/p>\n<h2 class=\"wp-block-heading\">UpdateInstaller entpacken<\/h2>\n<p>Der UpdateInstaller muss nicht installiert werden. Es reicht aus, ihn zu entpacken:<\/p>\n<pre class=\"wp-block-prismatic-blocks\"><code class=\"language-bash\" data-line=\"\">mkdir \/opt\/HCL\/UpdateInstaller_2104\ncd \/opt\/HCL\/UpdateInstaller_2104\nunzip \/opt\/cnx-install\/cnx\/HCL_Connections_70_updateInstaller_2104.zip -d .\ncd .\/HCL_Connections_Install\/tools\/updateInstaller\nchmod +x updateSilent.sh<\/code><\/pre>\n<h2 class=\"wp-block-heading\">CFix mittels UpdateInstaller installieren<\/h2>\n<p>Vorbereitend sollten alle Anwendungsserver in der ISC heruntergefahren werden. Zur installation m\u00fcssen wir zun\u00e4chst mit <strong>source<\/strong> oder <strong>.<\/strong> die WebSphere-Umgebungsvariablen in unsere Shell laden:<\/p>\n<pre class=\"wp-block-prismatic-blocks\"><code class=\"language-bash\" data-line=\"\">. \/opt\/IBM\/WebSphere\/AppServer\/profiles\/Dmgr01\/bin\/setupCmdLine.sh<\/code><\/pre>\n<p>Die Jar-Datei des Updates selbst befindet sich in <strong>\/opt\/cnx-install\/cnx<\/strong><\/p>\n<pre class=\"wp-block-prismatic-blocks\"><code class=\"language-bash\" data-line=\"\"># ls -lh \/opt\/cnx-install\/cnx\/*.jar\n-rwxr-xr-x 1 root root 1.3G May  7 22:42 \/opt\/cnx-install\/cnx\/CFIX.70.2105-IC7.0.0.0-Common-Fix.jar<\/code><\/pre>\n<p>Um das update zu installieren, f\u00fchren wir <strong>updateSilent.sh<\/strong> mit dem Schalter <strong>-install<\/strong> aus:<\/p>\n<pre class=\"wp-block-prismatic-blocks\"><code class=\"language-bash\" data-line=\"\">.\/updateSilent.sh -fix -installDir \/opt\/HCL\/Connections\/ -fixDir \/opt\/cnx-install\/cnx  -install -fixes &quot;CFIX.70.2105&quot; -wasUserId wasadmin -wasPassword cnx -featureCustomizationBackedUp yes<\/code><\/pre>\n<p><strong>-installDir<\/strong> ist der Installationsordner von HCL Connections, standardm\u00e4\u00dfig <strong>\/opt\/HCL\/Connections<\/strong>. In <strong>-fixDir<\/strong> sucht der Installer nach Jar-Dateien der Updates. Hier wird keine einzelne Datei, sondern ein Ordner erwartet. <strong>-fixes<\/strong> gibt einen oder mehrere Fixe an, die sich in diesem Ordner befinden und installiert werden sollen. Durch <strong>-install<\/strong> wird die Installation gestartet. Ohne diesen Schalter listet das Skript lediglich auf, welche Fixe verf\u00fcgbar bzw. in der Connections-Installation bereits eingespielt sind. <strong>-wasUserId\/-wasPassword<\/strong> sind die Zugangsdaten eines WebSphere Administrator-Kontos. Schlussendlich m\u00fcssen wir mit <strong>-featureCustomizationBackedUp<\/strong> noch best\u00e4tigen, dass die Anpassungen durch die Updateinstallation verloren gehen k\u00f6nnen. Man sollte diese daher sichern, sofern sie nicht automatisiert via Ansible o.\u00c4. eingespielt werden k\u00f6nnen.<\/p>\n<p>Wurde die Installation ohne Fehler abgebrochen, sollte der CFix installiert sein. Wir k\u00f6nnen dies mit dem gleichen Skript auch pr\u00fcfen:<\/p>\n<pre class=\"wp-block-prismatic-blocks\"><code class=\"language-bash\" data-line=\"\">[root@cnx updateInstaller]# .\/updateSilent.sh -fix -installDir \/opt\/HCL\/Connections\/\nStart of [ .\/updateSilent.sh ]\nBuild 20210424_1321\n\nAttempting to locate setupClient.sh\n\n**** WAS_CELL = CnxCell\n**** USER_INSTALL_ROOT = \/opt\/IBM\/WebSphere\/AppServer\/profiles\/Dmgr01\nUnknown Linux Architechture: x86_64. Native file libraries will not be loaded.\nFix update specified\nTarget product directory: \/opt\/HCL\/Connections\nCopyright (c) IBM Corporation 2007, 2015; All rights reserved.\nIBM Connections\nUpdate Installer Version 7.0.0.0, Dated 4\/24\/21\n\nListing installed fixes:\n  Fix name:label.details.description=Detailed description:CFIX.70.2105\nUpdateInstaller.puiReturnCode is 0\nEnd of [ .\/updateSilent.sh ]<\/code><\/pre>\n<p>Falls der Fix nicht erfolgreich installiert worden w\u00e4re, w\u00fcrde die Ausgabe wie folgt lauten:<\/p>\n<pre class=\"wp-block-prismatic-blocks\"><code class=\"language-bash\" data-line=\"\">...\nListing installed fixes:\nNo fixes are currently installed.\n...<\/code><\/pre>\n<p>Damit l\u00e4sst sich per Ansible pr\u00fcfen, ob der Fix bereits eingespielt wurde, oder noch installiert werden muss.<\/p>\n<h2 class=\"wp-block-heading\">Aufr\u00e4umen, synchronisieren und starten<\/h2>\n<p>Abschlie\u00dfend m\u00fcssen wir den Node stoppen, sein tempor\u00e4res Verzeichnis leeren, neu synchronisieren und ihn wieder starten. Das vorherige stoppen der Anwendungsserver ist nicht notwendig, da diese f\u00fcr das Update bereits <\/p>\n<pre class=\"wp-block-prismatic-blocks\"><code class=\"language-bash\" data-line=\"\">cd \/opt\/IBM\/WebSphere\/AppServer\/profiles\/CnxNode01\/bin\/\n.\/stopNode.sh -stopservers -username wasadmin -password cnx\nrm -rf ..\/temp\/*\n.\/syncNode.sh 127.0.0.1 -username wasadmin -password cnx\n.\/startNode.sh<\/code><\/pre>\n<p>Wird in Connections die URL <strong>cnx.host\/homepage\/web\/jsp\/about.jsp<\/strong> aufgerufen, sollte die Release-Version am unteren Ende nun &#8211; entsprechend des installierten CFix &#8211; ebenfalls aktualisiert worden sein:<\/p>\n<p>Release v7.0.0.0 Build IC7.0_Integration_<strong>20210423-1915<\/strong> (7.0 mit CFix.7.0.2105)\r\nRelease v7.0.0.0 Build IC7.0_Integration_<strong>20201119-2038<\/strong> (zuvor mit 7.0 ohne Updates)\r\n<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Seit Mai 2021 gibt es Cumulative Fixes f\u00fcr HCL Connections, kurz CFix. Sie sollen zu Beginn jedes Monats als ein Paket aus prim\u00e4r Fehlerkorrekturen erscheinen und beziehen sich auf den Kern von Connections, also nicht das Component Pack. Scheinbar soll damit die Installation von einzelnen kleineren Updates zwischen einem neuen CR geb\u00fcndelt und vereinfacht werden. &#8230;<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[765],"tags":[872,871,870],"class_list":["post-7205","post","type-post","status-publish","format-standard","hentry","category-hcl-connections","tag-cfix","tag-hcl-connections-7","tag-updates"],"_links":{"self":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7205","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/comments?post=7205"}],"version-history":[{"count":5,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7205\/revisions"}],"predecessor-version":[{"id":8117,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7205\/revisions\/8117"}],"wp:attachment":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media?parent=7205"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/categories?post=7205"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/tags?post=7205"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}