Titjib tal-verżjoni waqt it-tħaddim tal-komponent Mediation Controller¶
Importanti
Id-dokumentazzjoni għat-titjib tal-verżjoni waqt it-tħaddim tal-komponent Mediation Controller hija maħsuba għal kwalunkwe komponent Mediation Controller li jaħdem b’Debian 11. Il-verżjoni ta’ Debian tista’ tiġi vverifikata permezz tal-kmand li ġej (li għandu jitħaddem f’aċċess SSH jew mill-konsol):
1 | |
Informazzjoni
Bħala tfakkira, il-qlib għal root fuq kompjuters Debian għandu jsir bil-kmand li ġej:
1 | |
Ippjanar u preparazzjoni¶
Ftuħ tal-flussi¶
Waqt it-titjib tal-verżjoni tal-prodott, ħafna pakketti jridu jitniżżlu mir-repożitorji ta’ Debian minħabba t-tranżizzjoni mill-verżjoni 11 għall-verżjoni 12 ta’ Debian. L-aċċess TCP 80 irid jinfetaħ lejn security.debian.org u ftp.fr.debian.org.
Biex tittestja l-ftuħ tal-flussi fuq il-kompjuter, tista’ tniedi sinkronizzazzjoni tar-repożitorji ta’ Debian. Jekk jidhru messaġġi ta’ żball dwar l-aċċess għar-repożitorji ta’ Debian, il-fluss tan-netwerk mhuwiex miftuħ, probabbilment għax huwa mblukkat mill-firewall korporattiv. Is-sinkronizzazzjoni tar-repożitorji tista’ tinbeda bil-kmand li ġej:
1 | |
Tniżżil tal-mirror u tal-għodod meħtieġa¶
Il-mirror ta’ CyberElements Cleanroom 4.6 jista’ jitniżżel minn dan il-link (jeħtieġ il-ħolqien ta’ kont ta’ klijent): Systancia Marketplace
Iċ-ċavetta systancia.gpg, li tawtentika r-repożitorju ta’ CyberElements Bastion, għandha titniżżel ukoll minn Systancia Marketplace.
Minbarra l-mirror, għall-proċess tat-titjib tal-verżjoni se jkunu meħtieġa għodod ta’ partijiet terzi:
- Klijent SSH (fuq Windows, tista’ tintuża l-għodda PuTTY)
- Klijent SCP (fuq Windows, jistgħu jintużaw l-għodod WinSCP jew FileZilla)
Installazzjoni u użu tal-għodda screen¶
L-għodda screen tippermettilek tiftaħ diversi terminals shell f’konsol wieħed. Huwa essenzjali li tuża din l-għodda biex twettaq it-titjib tal-verżjoni ta’ CyberElements Bastion, sabiex tneħħi d-dipendenza fuq l-istabbiltà tal-konnettività tan-netwerk. Fil-fatt, mingħajr l-użu tal-għodda screen, l-installazzjoni titwaqqaf f’każ ta’ interruzzjoni fil-konnettività SSH mas-servers ta’ CyberElements Bastion.
Bl-użu tal-għodda screen, meta terġa’ tikkonnettja mal-konsol shell tat-tagħmir ta’ CyberElements Bastion, it-terminal li fih ġie eżegwit il-proċess tal-aġġornament jista’ jiġi rkuprat.
Il-pakkett screen għandu jiġi installat bil-linja tal-kmand li ġejja:
1 | |
Biex tiftaħ terminal screen ġdid, irid jiġi eżegwit il-kmand li ġej:
1 | |
Ibdel <ID> b’isem li jidentifika s-sessjoni.
Eżempju
Għat-titjib tal-verżjoni ta’ CyberElements, l-identifikatur cye-upgrade jingħaraf faċilment. Għalhekk il-kmand ikun dan li ġej:
1 | |
Biex terġa’ tikseb terminal miftuħ minn screen, sempliċement mexxi l-kmand li ġej:
1 | |
Ibdel <ID> bl-isem iddefinit meta nfetħet is-sessjoni.
Eżempju
It-terminal miftuħ qabel bl-identifikatur cye-upgrade jista’ jerġa’ jinkiseb bil-kmand li ġej:
1 | |
Biex tagħlaq it-terminal ladarba jitlesta t-titjib tal-verżjoni, daħħal il-kmand exit jew ix-shortcut tat-tastiera ctrl+d fit-terminal.
Dan iġibek lura għall-konsol. Il-messaġġ “screen is terminating” jikkonferma li t-terminal ingħalaq.
Estensjoni tal-ispazju fuq id-diska għall-apparati virtwali¶
L-apparati virtwali Systancia Cleanroom 4.4 jew 4.5 jeħtieġu estensjoni tad-diska ta’ 4 GB li għandha tiżdied mal-partizzjoni /usr. Din l-operazzjoni hija meħtieġa biex ikun hemm biżżejjed spazju fuq id-diska għat-titjib tal-verżjoni u biex l-operazzjoni ma teħilx f’nofsha.
Meta tikkonnettja mal-komponent Mediation Controller, kemm permezz ta’ SSH kif ukoll fil-modalità konsol, messaġġ ta’ merħba jinfurmak li int ikkonnettjat ma’ kompjuter ta’ Systancia. Linja addizzjonali tindika l-verżjoni tal-apparat.
Eżempju
Apparat virtwali Mediation Controller li jħaddem il-verżjoni 4.5 se jagħti r-riżultat li ġej:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | |
Jekk il-kompjuter mhuwiex apparat virtwali pprovdut bil-verżjoni 4.4 jew 4.5, dan il-kapitolu jista’ jinqabeż biex tgħaddi għat-titjib tal-verżjoni.
Kopja ta’ riżerva rakkomandata ħafna
Il-passi li ġejjin se jagħmlu bidliet fil-partizzjonament tad-diska tal-komponent Mediation Controller. Jekk saru bidliet manwali, l-istruzzjonijiet li ġejjin jistgħu ma jkunux adattati, u l-kompjuter jista’ jiġi bblukkat.
Qabel ma tkompli, agħmel kopja ta’ riżerva tal-kompjuter jew, jekk meħtieġ, idduplika l-magna virtwali. Ma jistgħux jintużaw snapshots għaliex, b’mod partikolari ma’ VMware, dawn jimblukkaw il-possibbiltà li tiġi estiża diska.
Fil-livell tal-ipervisur, estendi l-ispazju fuq id-diska tal-magna virtwali b’4 GB addizzjonali. Jekk ma jkunx possibbli li tiġi estiża d-diska, iċċekkja li ma hemmx snapshots, u jekk le, itfi l-magna virtwali jekk l-estensjoni waqt it-tħaddim mhijiex appoġġata.
Ladarba l-ispazju fuq id-diska jkun ġie estiż fil-livell tal-magna virtwali, il-kmandi li ġejjin, li għandhom jitħaddmu bħala root, huma meħtieġa biex tiġi estiża l-partizzjoni /usr:
1 2 3 4 5 6 | |
Titjib tal-verżjoni¶
Aġġornament tal-pakketti ta’ Debian¶
Peress li t-titjib tal-verżjoni ta’ CyberElements Bastion jeħtieġ titjib tal-verżjoni ta’ Debian, huwa rrakkomandat li taġġorna sew il-pakketti ta’ Debian 11 qabel ma taqleb għal Debian 12. Biex tagħmel dan, ħaddem il-kmandi li ġejjin bħala root (aġġornament tas-sistema u mbagħad tneħħija tal-pakketti mhux meħtieġa):
1 2 3 | |
Jistgħu jidhru messaġġi li jitolbuk timmodifika l-konfigurazzjoni ta’ diversi fajls tal-konfigurazzjoni. F’dawn il-każijiet, agħżel l-opzjoni li żżomm il-konfigurazzjoni attwali.
Preparazzjoni tad-drivers ta’ Microsoft SQL Server¶
Huma meħtieġa passi addizzjonali jekk id-drivers ta’ Microsoft SQL Server huma installati (dan huwa l-każ fl-apparati virtwali pprovduti minn CyberElements).
Biex tiċċekkja jekk humiex preżenti fuq is-server, il-kmand li ġej jista’ jitħaddem bħala root:
1 | |
Jekk ma tidher l-ebda risposta, id-drivers mhumiex installati u tista’ tgħaddi għall-pass tal-preparazzjoni tal-mirror.
Inkella, jekk id-drivers huma installati, għandhom jidhru elenkati żewġ pakketti: msodbcsql17 u mssql-tools. Segwi l-istruzzjonijiet f’dan il-kapitolu.
Eżempji
Server li fih id-drivers mhumiex installati jkollu r-riżultat li ġej mill-kmand preċedenti:
1 | |
Server li fih id-drivers huma installati se jkollu riżultat simili għal dan (il-verżjonijiet tal-pakketti jistgħu jvarjaw):
1 2 3 | |
Il-kmandi li ġejjin huma meħtieġa biex tiġi installata verżjoni speċifika tal-pakketti ħalli jiġi żgurat titjib tal-verżjoni b’suċċess:
1 | |
Ikkonfigura r-repożitorju ta’ Microsoft adattat għal Debian 12 biex tipprepara għat-titjib tal-verżjoni:
1 | |
Preparazzjoni tal-mirror ta’ CyberElements Cleanroom 4.6¶
Il-mirror miksub matul il-fażi tal-preparazzjoni (fajl bl-estensjoni tgz) irid jintbagħat lis-server permezz ta’ SCP. Għandu jitqiegħed fid-direttorju /tmp/.
Imbagħad, ipprepara l-mirror billi tmexxi l-kmandi li ġejjin bħala root (il-fajls residwi ta’ titjib tal-verżjoni antik se jitħassru):
1 2 3 | |
Konfigurazzjoni ta’ APT¶
Il-maniġer tal-pakketti APT huwa kkonfigurat biex jikseb il-pakketti ta’ Debian 11; irid jiġi kkonfigurat mill-ġdid biex jikseb il-pakketti ta’ Debian 12. Huwa meħtieġ ukoll li tiġi aġġornata r-referenza għall-mirror lokali ta’ CyberElements Bastion. Biex tagħmel dan, eżegwixxi l-kmandi li ġejjin bħala root:
1 2 | |
Il-mirror lokali huwa awtentikat biċ-ċavetta systancia.gpg imniżżla matul il-fażi tat-tħejjija. Ibgħatha lis-server permezz ta’ SCP, fid-direttorju /tmp/, imbagħad installaha bil-kmand li ġej bħala root:
1 | |
Minbarra l-konfigurazzjoni tar-repożitorji l-ġodda, nirrakkomandaw bil-qawwa li tapplika s-setting li ġej biex tgħid lil APT biex ma jinstallax dipendenzi rakkomandati li mhumiex strettament meħtieġa, sabiex jitnaqqas l-għadd ta’ komponenti installati. Il-kmand li ġej japplika dan is-setting bħala root:
1 | |
Fl-aħħar, huwa meħtieġ li taġġorna l-lista tal-pakketti fir-repożitorji bil-kmand li ġej:
1 | |
Tnedija tat-titjib tal-verżjoni¶
Aċċessa s-server Mediation Controller permezz ta’ SSH u aqleb għal root, imbagħad iftaħ sessjoni screen kif indikat hawn fuq.
Ibda billi taġġorna ċerti pakketti speċifiċi sabiex ikun jista’ jsir it-titjib tal-verżjoni. Huwa mistenni messaġġ ta’ żball meta jitħaddem l-ewwel kmand, iżda l-iżball se jiġi kkoreġut bit-tieni kmand:
1 2 | |
Meta jsir titjib tal-verżjoni ta’ komponent Mediation Controller minn Debian 11 għal Debian 12, il-pakkett collectd jiġi aġġornat u jsir inkompatibbli mal-fajl tal-konfigurazzjoni ġġenerat minn CyberElements Bastion (/etc/collectd/collectd.conf). Dan jista’ jiġġenera żball waqt l-aġġornament.
Biex tevita dan, iddiżattiva collectd:
1 2 | |
Wara dan, it-titjib tal-verżjoni jista’ jinbeda bil-kmand li ġej:
1 | |
Waqt it-titjib tal-verżjoni, se ssirlek diversi mistoqsijiet dwar jekk għandekx iżżomm il-fajls tal-konfigurazzjoni u taġġornahom skont il-konfigurazzjoni standard ta’ Debian 12, jew iżżomm il-konfigurazzjoni speċifika eżistenti. Hawn huma r-rakkomandazzjonijiet tagħna għall-biċċa l-kbira tal-fajls li tista’ tiltaqa’ magħhom:
| Fajl tal-konfigurazzjoni | Azzjoni rakkomandata |
|---|---|
| /etc/issue | Żommu, wieġeb N |
| /etc/issue.net | Żommu, wieġeb N |
| /etc/security/limits.conf | Żommu, wieġeb N |
| /etc/login.defs | Żommu, wieġeb N |
| /etc/shibboleth/shibboleth2.xml | Biex iżżomm il-fajl, wieġeb N |
| /etc/shibboleth/shibd.logger | Applika l-bidliet, wieġeb Y |
| /etc/default/ntpsec | Applika l-bidliet, wieġeb Y |
| /etc/snmp/snmpd.conf | Applika l-bidliet, wieġeb Y |
| /etc/logrotate.d/IPdivaServer | Applika l-bidliet, wieġeb Y |
| /etc/ssh/sshd_config | Biex iżżomm il-fajl, wieġeb Keep the local version currently installed |
| /etc/ssh/ssh_config | Applika l-bidliet, wieġeb Y |
| /etc/apache2/ports.conf | Biex iżżomm il-fajl, wieġeb N |
| /etc/init.d/apache2 | Biex iżżomm il-fajl, wieġeb N |
| /etc/modsecurity/modsecurity.conf-recommended | Applika l-bidliet, wieġeb Y |
| /etc/ipdiva/httpd/commonParameters.conf | Applika l-bidliet, wieġeb Y |
| /etc/ipdiva/care/djangosettings.ini | Applika l-bidliet, wieġeb Y |
| /etc/crontab | Applika l-bidliet, wieġeb Y |
| /etc/openssl.cnf | Applika l-bidliet, wieġeb Y |
| /etc/audit/rules.d/audit.rules | Biex iżżomm il-fajl, wieġeb N |
| /etc/pam.d/su | Biex iżżomm il-fajl, wieġeb N |
| /etc/sysctl.conf | Biex iżżomm il-fajl, wieġeb N |
Aċċetta l-messaġġ tal-konfigurazzjoni tal-pakkett glibc: 
Aċċetta l-bidu mill-ġdid awtomatiku tas-servizzi: 
Meta jitlesta t-titjib tal-verżjoni, ħaddem il-kmandi li ġejjin biex terġa’ tattiva collectd, tneħħi l-pakketti mhux meħtieġa u terġa’ tibda l-kompjuter:
1 2 3 4 | |
Azzjonijiet speċifiċi għall-komponenti Mediation Controller f’Cluster¶
Fuq is-server Mediation Controller SLAVE, ħaddem il-kmandi li ġejjin biex terġa’ tissinkronizza s-sigriet kondiviż bejn il-komponent Mediation Controller MASTER u s-server SLAVE:
1 2 | |
Titjib tal-verżjoni tal-istanza tad-database PostgreSQL¶
Fuq is-server Mediation Controller, aġġorna l-istanza tad-database PostgreSQL mill-verżjoni 13 għall-verżjoni 15. Biex tagħmel dan, eżegwixxi l-istruzzjonijiet li ġejjin bid-drittijiet root xierqa.
Iċċekkja l-istatus tal-istanzi PostgreSQL qabel il-migrazzjoni:
1 | |
Ħaddem il-kmandi li ġejjin biex taġġorna l-istanza tad-database għall-verżjoni 15 ta’ PostgreSQL:
1 2 3 4 | |
Iċċekkja li l-istanza tad-database għaddiet b’suċċess minn titjib tal-verżjoni. Għandhom jidhru żewġ istanzi, waħda fil-verżjoni 13 u l-oħra fil-verżjoni 15, li hija l-unika waħda attiva. Il-verifika ssir bil-kmand li ġej:
1 | |
Jekk it-titjib tal-verżjoni rnexxa, l-istanza tad-database tal-verżjoni 13 tista’ titħassar:
1 | |
Tista’ tibda t-tħassir tal-pakketti PostgreSQL tal-verżjoni 13:
1 | |
Migrazzjoni tad-database ta’ CyberElements Bastion¶
Il-konfigurazzjoni tal-prodott hija maħżuna fid-database, li trid tiġi migrata sabiex tkun tista’ tinkludi l-konfigurazzjonijiet tal-bidliet introdotti mill-verżjoni l-ġdida. L-operazzjoni ssir fuq il-komponent Mediation Controller bħala root.
Arkitettura Cluster
Għal arkitettura Cluster, huwa meħtieġ li l-operazzjoni ssir minn komponent Mediation Controller wieħed biss, ikun liema jkun.
Huwa meħtieġ ukoll li tħaddem il-kmand li ġej:
1 | |
Il-migrazzjoni tad-data titnieda b’kmand ekwivalenti għal dan:
1 | |
Fejn <org_clr> għandu jiġi sostitwit bl-isem tal-organizzazzjoni li trid tiġi migrata. Innota li jekk il-komponent Mediation Controller għandu diversi organizzazzjonijiet (multi-tenants), ikollok tħaddem il-kmand daqs kemm hemm organizzazzjonijiet li jridu jiġu migrati.
Eżempju
Għal pjattaforma CyberElements Bastion li għandha l-organizzazzjonijiet systancia u systancia-test, ikollok tħaddem il-kmandi li ġejjin:
1 2 | |
Wara l-migrazzjoni tad-database, is-servizz Apache2 irid jerġa’ jinbeda:
1 | |
Restawr tal-konfigurazzjonijiet¶
Xi konfigurazzjonijiet inkitbu fuqhom matul il-proċess tat-titjib tal-verżjoni u jridu jiġu restawrati.
Fajl commonParameters.conf:
Mexxi t-tikketti <Location> relatati mal-komponenti HTML5 Gateway, li normalment jinsabu fl-aħħar tal-fajl, mill-fajl /etc/ipdiva/httpd/commonParameters.conf.dpkg-old għal /etc/ipdiva/httpd/commonParameters.extra.conf (oħloq il-fajl jekk ma jeżistix). Jekk ma hemm l-ebda tikketta <Location>, l-eżempji li ġejjin jistgħu jiġu kkupjati.
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 | |
Fajl djangosettings.ini:
Ikkopja l-informazzjoni mil-linja 2 “allowed_hosts” tal-fajl /etc/ipdiva/care/djangosettings.ini.dpkg-old għall-fajl /etc/ipdiva/care/djangosettings.ini. Dan jista’ jiġi awtomatizzat bil-kmand li ġej bħala root:
1 | |
Applikazzjoni tar-restawri:
Biex jiġu applikati r-restawri, huwa meħtieġ bidu mill-ġdid tas-servizz Apache2 bħala root:
1 | |
Validazzjoni¶
Ladarba jitlesta t-titjib tal-verżjoni, l-infrastruttura CyberElements Bastion trid tiġi vvalidata biex jiġi żgurat li qed taħdem sew qabel ma terġa’ lura fil-produzzjoni. Jekk il-validazzjoni tfalli, ikkunsidra li terġa’ lura għall-istat preċedenti billi tirrestawra l-kopji ta’ riżerva tas-servers CyberElements Bastion.
Aċċessa l-interfaċċja tal-amministrazzjoni ta’ organizzazzjoni, imbagħad mur fil-menu “About” fl-istrixxa tal-kontroll biex tiċċekkja li l-verżjoni tal-komponent Mediation Controller għaddiet b’suċċess għal 4.6.
Jistgħu jinbdew l-ewwel testijiet tal-funzjonalità tal-pjattaforma, iżda nirrakkomandaw li tuża l-verżjoni 4.6 tal-komponent Edge Gateway biex tiżgura prestazzjoni ottimali tal-applikazzjonijiet CyberElements Bastion.