Léim go dtí an t-ábhar

Uasghrádú le linn oibríochta ar an bhfreastalaí Mediation Controller

Tábhachtach

Tá an doiciméadú maidir le huasghrádú le linn oibríochta ar an bhfreastalaí Mediation Controller dírithe ar aon fhreastalaí Mediation Controller a ritheann Debian 11. Is féidir leagan Debian a sheiceáil leis an ordú seo a leanas (le rith trí SSH nó trí rochtain consóil):

1
cat /etc/debian_version

Faisnéis

Mar mheabhrúchán, ní mór aistriú go root ar ríomhairí Debian a dhéanamh leis an ordú seo a leanas:

1
su -

Pleanáil agus ullmhúchán

Sreafaí líonra a oscailt

Agus an táirge á uasghrádú, ní mór go leor pacáistí a íoslódáil ó stórtha Debian mar gheall ar an aistriú ó leagan 11 go leagan 12 de Debian. Ní mór rochtain TCP 80 a oscailt chuig security.debian.org agus ftp.fr.debian.org.

Chun oscailt na sreafaí ar an ríomhaire a thástáil, is féidir sioncrónú stórtha Debian a thosú. Má thaispeántar teachtaireachtaí earráide maidir le rochtain ar stórtha Debian, níl an sreabhadh líonra oscailte, agus is dócha go bhfuil sé blocáilte ag balla dóiteáin na cuideachta. Is féidir sioncrónú na stórtha a thosú leis an ordú seo a leanas:

1
apt update

An scáthán agus na huirlisí riachtanacha a íoslódáil

Is féidir scáthán CyberElements Cleanroom 4.6 a íoslódáil ón nasc seo (ní mór cuntas custaiméara a chruthú): Systancia Marketplace

Ní mór an eochair systancia.gpg, a fhíordheimhníonn stór CyberElements Bastion, a íoslódáil ó Systancia Marketplace freisin.

Chomh maith leis an scáthán, beidh uirlisí tríú páirtí ag teastáil don phróiseas uasghrádaithe:

  • Cliant SSH (ar Windows, is féidir an uirlis PuTTY a úsáid)
  • Cliant SCP (ar Windows, is féidir na huirlisí WinSCP nó FileZilla a úsáid)

An uirlis screen a shuiteáil agus a úsáid

Ligeann an uirlis screen duit roinnt teirminéal blaoisce a oscailt in aon chonsól amháin. Tá sé riachtanach an uirlis seo a úsáid chun uasghrádú leagain CyberElements Bastion a dhéanamh, ionas nach mbeidh tú ag brath ar chobhsaíocht na nascachta líonra. Go deimhin, gan an uirlis screen, stopfaí an tsuiteáil dá mbrisfí an nascacht SSH leis na freastalaithe CyberElements Bastion.

Leis an uirlis screen, nuair a athcheanglaíonn tú le consól blaoisce an trealaimh CyberElements Bastion, is féidir an teirminéal inar ritheadh an próiseas nuashonraithe a fháil ar ais.

Ba cheart an pacáiste screen a shuiteáil leis an líne ordaithe seo a leanas:

1
apt install --no-install-recommends screen

Chun teirminéal nua screen a oscailt, ní mór an t-ordú seo a leanas a rith:

1
screen -S <ID>

Cuir ainm a shainaithníonn an seisiún in ionad <ID>.

Sampla

Maidir le huasghráduithe leagain CyberElements, is furasta an t-aitheantóir cye-upgrade a aithint. Mar sin, bheadh an t-ordú mar seo a leanas:

1
screen -S cye-upgrade

Chun teirminéal a osclaíodh le screen a aisghabháil, níl le déanamh ach an t-ordú seo a leanas a rith:

1
screen -r <ID>

Cuir an t-ainm a sainíodh nuair a osclaíodh an seisiún in ionad <ID>.

Sampla

Is féidir an teirminéal a osclaíodh roimhe seo leis an aitheantóir cye-upgrade a aisghabháil leis an ordú seo a leanas:

1
screen -r cye-upgrade

Chun an teirminéal a dhúnadh nuair a bheidh an t-uasghrádú críochnaithe, iontráil an t-ordú exit nó an t-aicearra méarchláir ctrl+d sa teirminéal.

Fillfidh tú ar an gconsól ansin. Deimhníonn an teachtaireacht “screen is terminating” go bhfuil an teirminéal dúnta.

Síneadh ar spás diosca d'fhearais fhíorúla

Ní mór síneadh diosca 4 GB a chur leis an deighilt /usr ar fhearais fhíorúla Systancia Cleanroom 4.4 nó 4.5. Tá an oibríocht seo riachtanach chun go mbeidh go leor spáis diosca ann don uasghrádú agus chun nach rachaidh an oibríocht i bhfostú.

Nuair a cheanglaíonn tú leis an bhfreastalaí Mediation Controller, trí SSH nó i mód consóil, cuirfidh teachtaireacht fáilte in iúl duit go bhfuil tú ceangailte le ríomhaire Systancia. Léiríonn líne bhreise leagan an fhearais.

Sampla

Seo an toradh a thabharfaidh fearas fíorúil Mediation Controller a ritheann leagan 4.5:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
            ____            _                   _
        / ___| _   _ ___| |_ __ _ _ __   ___(_) __ _
        \___ \| | | / __| __/ _  | '_ \ / __| |/ _  |
            ___) | |_| \__ \ || (_| | | | | (__| | (_| |
        |____/ \__, |___/\__\__,_|_| |_|\___|_|\__,_|
                |___/
#################################################################
# WARNING:                                                      #
# You must have specific authorization to access this machine.  #
# Unauthorized access to this machine is prohibited and will be #
# considered as intrusion.                                      #
# Unauthorized users will be logged, monitored, and could be    #
# prosecuted.                                                   #
#################################################################
Systancia Cleanroom 4.5.0 B77

Mura fearas fíorúil a soláthraíodh le leagan 4.4 nó 4.5 é an ríomhaire, is féidir an chaibidil seo a scipeáil chun leanúint ar aghaidh leis an uasghrádú.

Cúltaca molta go láidir

Athróidh na céimeanna seo a leanas deighiltiú diosca an fhreastalaí Mediation Controller. Má rinneadh athruithe de láimh, b'fhéidir nach mbeidh na treoracha seo a leanas oiriúnach, agus d'fhéadfadh an ríomhaire a bheith blocáilte dá bharr.

Sula leanfaidh tú ar aghaidh, déan cúltaca den ríomhaire nó, más gá, dúblaigh an meaisín fíorúil. Ní féidir léargais a úsáid mar go gcuireann siad bac, go háirithe le VMware, ar dhiosca a leathnú.

Ag leibhéal an hipearmhaoirseora, leathnaigh spás diosca an mheaisín fhíorúil 4 GB breise. Murar féidir an diosca a leathnú, seiceáil nach bhfuil aon léargais ann, agus mura bhfuil, múch an meaisín fíorúil mura dtacaítear le síneadh le linn oibríochta.

Nuair a bheidh spás an diosca leathnaithe ag leibhéal an mheaisín fhíorúil, tá na horduithe seo a leanas, le rith mar root, riachtanach chun an deighilt /usr a leathnú:

1
2
3
4
5
6
echo 1 > /sys/class/block/sda/device/rescan
start_lvm_partition=`fdisk -l /dev/sda | grep LVM | awk '{print $2}'`
echo -e "d\n2\nn\ne\n2\n\n\nn\n$start_lvm_partition\n\nt\n5\n8E\nw" | fdisk /dev/sda
pvresize /dev/sda5
lvresize -l +100%FREE /dev/mapper/SystanciaLVMGroup-usr
resize2fs /dev/mapper/SystanciaLVMGroup-usr

Uasghrádú

Pacáistí Debian a nuashonrú

Ós rud é go n-éilíonn uasghrádú CyberElements Bastion uasghrádú ar Debian, moltar duit pacáistí Debian 11 a nuashonrú i gceart sula n-aistríonn tú go Debian 12. Chun é seo a dhéanamh, rith na horduithe seo a leanas mar root (nuashonrú an chórais agus ansin baint na bpacáistí neamhriachtanacha):

1
2
3
apt update
apt upgrade -y
apt autoremove -y

D'fhéadfadh teachtaireachtaí a bheith le feiceáil a iarrann ort cumraíocht roinnt comhad cumraíochta a athrú. Sna cásanna sin, roghnaigh an rogha chun an chumraíocht reatha a choinneáil.

Tiománaithe Microsoft SQL Server a ullmhú

Teastaíonn céimeanna breise má tá tiománaithe Microsoft SQL Server suiteáilte (is amhlaidh atá ar na fearais fhíorúla a sholáthraíonn CyberElements).
Chun a sheiceáil an bhfuil siad ar an bhfreastalaí, is féidir an t-ordú seo a leanas a rith mar root:

1
apt list --installed ms*

Mura bhfeictear aon fhreagra, níl na tiománaithe suiteáilte agus is féidir leat dul ar aghaidh chuig céim ullmhúcháin an scátháin.
Seachas sin, má tá na tiománaithe suiteáilte, ba cheart go mbeadh dhá phacáiste liostaithe: msodbcsql17 agus mssql-tools. Lean na treoracha sa chaibidil seo.

Samplaí

Seo an toradh a bheadh ón ordú roimhe seo ar fhreastalaí nach bhfuil na tiománaithe suiteáilte air:

1
Listing... Done

Beidh toradh cosúil leis seo ar fhreastalaí a bhfuil na tiománaithe suiteáilte air (d'fhéadfadh leaganacha na bpacáistí a bheith difriúil):

1
2
3
Listing... Done
msodbcsql17/bullseye,now 17.10.6.1-1 amd64 [installed]
mssql-tools/bullseye,now 17.10.1.1-1 amd64 [installed]

Tá na horduithe seo a leanas riachtanach chun leagan sonrach de na pacáistí a shuiteáil, ionas go n-éireoidh leis an uasghrádú:

1
env ACCEPT_EULA=Y apt install -y --allow-downgrades odbcinst=2.3.6-0.1+b1 odbcinst1debian2=2.3.6-0.1+b1 libodbc1=2.3.6-0.1+b1 unixodbc=2.3.6-0.1+b1 mssql-tools=17.9.1.1-1 msodbcsql17=17.9.1.1-1

Cumraigh stór Microsoft atá oiriúnaithe do Debian 12 chun ullmhú don uasghrádú:

1
echo "deb [arch=amd64] https://packages.microsoft.com/debian/12/prod bookworm main" > /etc/apt/sources.list.d/mssql-release.list

Scáthán CyberElements Cleanroom 4.6 a ullmhú

Ní mór an scáthán a fuarthas le linn na céime ullmhúcháin (comhad leis an iarmhír tgz) a sheoladh chuig an bhfreastalaí trí SCP. Ba cheart é a chur san eolaire /tmp/.

Ansin, ullmhaigh an scáthán trí na horduithe seo a leanas a rith mar root (scriosfar na comhaid iarmharacha ó uasghrádú leagain níos sine):

1
2
3
mkdir -p /opt/systancia/repository
rm -rf /opt/systancia/repository/*
tar xvzf /tmp/*.tgz -C /opt/systancia/repository/

Cumraíocht APT

Tá bainisteoir pacáistí APT cumraithe chun pacáistí Debian 11 a fháil; ní mór é a athchumrú chun pacáistí Debian 12 a fháil. Ní mór freisin an tagairt don scáthán logánta CyberElements Bastion a nuashonrú. Chun é seo a dhéanamh, rith na horduithe seo a leanas mar root:

1
2
echo -e 'deb http://security.debian.org/debian-security/ bookworm-security main contrib non-free non-free-firmware\ndeb http://ftp.fr.debian.org/debian bookworm main contrib non-free non-free-firmware\ndeb http://ftp.fr.debian.org/debian bookworm-updates main contrib non-free non-free-firmware' > /etc/apt/sources.list
echo "deb file:///opt/systancia/repository/ bookworm ipdiva" > /etc/apt/sources.list.d/systancia.list

Fíordheimhnítear an scáthán logánta leis an eochair systancia.gpg a íoslódáladh le linn na céime ullmhúcháin. Seol chuig an bhfreastalaí í trí SCP, sa chomhadlann /tmp/, ansin suiteáil í leis an ordú seo a leanas mar root:

1
mv /tmp/systancia.gpg /etc/apt/trusted.gpg.d/

Chomh maith leis na stórtha nua a chumrú, molaimid go láidir an socrú seo a leanas a chur i bhfeidhm chun a chur in iúl do APT gan spleáchais mholta nach bhfuil fíor-riachtanach a shuiteáil, chun líon na gcomhpháirteanna suiteáilte a laghdú. Cuireann an t-ordú seo a leanas an socrú seo i bhfeidhm marroot:

1
echo -e 'APT::Install-Recommends false;\nAPT::Install-Suggests false;' > /etc/apt/apt.conf.d/99norecommends

Ar deireadh, ní mór liosta na bpacáistí sna stórtha a nuashonrú leis an ordú seo a leanas:

1
apt update

An t-uasghrádú leagain a spreagadh

Faigh rochtain ar an bhfreastalaí Mediation Controller trí SSH agus athraigh go root, ansin oscail seisiún screen mar a léirítear thuas.

Tosaigh trí phacáistí sonracha áirithe a nuashonrú ionas gur féidir an t-uasghrádú leagain a dhéanamh. Táthar ag súil le teachtaireacht earráide nuair a ritear an chéad ordú, ach ceartófar an earráid leis an dara hordú:

1
2
apt install -y python3-cleanroom-django-mssql python3-ipdiva-ua-parser python3-ipdiva-user-agents python3-ipdiva-django2
apt install -y --fix-broken

Agus freastalaí Mediation Controller á uasghrádú ó Debian 11 go Debian 12, nuashonraítear an pacáiste collectd agus éiríonn sé neamh-chomhoiriúnach leis an gcomhad cumraíochta a ghineann CyberElements Bastion (/etc/collectd/collectd.conf). D'fhéadfadh sé seo earráid a ghiniúint le linn an nuashonraithe.

Chun é seo a sheachaint, díchumasaigh collectd:

1
2
systemctl stop collectd 
systemctl disable collectd

Ina dhiaidh sin, is féidir an t-uasghrádú a thosú leis an ordú seo a leanas:

1
apt dist-upgrade -y

Le linn an uasghrádaithe, cuirfear roinnt ceisteanna ort faoi cé acu ar cheart na comhaid chumraíochta a nuashonrú de réir chumraíocht chaighdeánach Debian 12 nó an chumraíocht shonrach atá i bhfeidhm a choinneáil. Seo ár moltaí don chuid is mó de na comhaid a d'fhéadfá a fheiceáil:

Comhad cumraíochta Gníomh molta
/etc/issue Chun é a choinneáil, freagair N
/etc/issue.net Chun é a choinneáil, freagair N
/etc/security/limits.conf Chun é a choinneáil, freagair N
/etc/login.defs Chun é a choinneáil, freagair N
/etc/shibboleth/shibboleth2.xml Chun é a choinneáil, freagair N
/etc/shibboleth/shibd.logger Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/default/ntpsec Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/snmp/snmpd.conf Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/logrotate.d/IPdivaServer Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/ssh/sshd_config Chun é a choinneáil, freagair Keep the local version currently installed
/etc/ssh/ssh_config Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/apache2/ports.conf Chun é a choinneáil, freagair N
/etc/init.d/apache2 Chun é a choinneáil, freagair N
/etc/modsecurity/modsecurity.conf-recommended Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/ipdiva/httpd/commonParameters.conf Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/ipdiva/care/djangosettings.ini Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/crontab Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/openssl.cnf Chun na hathruithe a chur i bhfeidhm, freagair Y
/etc/audit/rules.d/audit.rules Chun é a choinneáil, freagair N
/etc/pam.d/su Chun é a choinneáil, freagair N
/etc/sysctl.conf Chun é a choinneáil, freagair N

Glac le teachtaireacht chumraíochta an phacáiste glibc:

Glac le hatosú uathoibríoch na seirbhísí:

Nuair a bheidh an t-uasghrádú críochnaithe, rith na horduithe seo a leanas chun collectd a athghníomhachtú, chun na pacáistí nach bhfuil gá leo a bhaint, agus chun an ríomhaire a atosú:

1
2
3
4
systemctl start collectd
systemctl enable collectd
apt autoremove -y
reboot

Gníomhartha a bhaineann go sonrach le freastalaithe Mediation Controller i mbraisle

Ar an bhfreastalaí Mediation Controller SLAVE, rith na horduithe seo a leanas chun an rún comhroinnte idir an freastalaí Mediation Controller MASTER agus an freastalaí SLAVE a athshioncrónú:

1
2
hostManagerCtl masterSynchro /etc/ipdiva/secure/secret /etc/ipdiva/secure/secret
systemctl restart apache2

Uasghrádú ásc an bhunachair shonraí PostgreSQL

Ar an bhfreastalaí Mediation Controller, nuashonraigh ásc an bhunachair shonraí PostgreSQL ó leagan 13 go leagan 15. Chun é sin a dhéanamh, rith na treoracha seo a leanas leis na cearta root cuí.

Seiceáil stádas na n-ásc PostgreSQL roimh an imirce:

1
pg_lsclusters

Rith na horduithe seo a leanas chun ásc an bhunachair shonraí a nuashonrú go leagan 15 de PostgreSQL:

1
2
3
4
pg_dropcluster --stop 15 main
systemctl stop postgresql
pg_upgradecluster 13 main
systemctl start postgresql

Seiceáil gur éirigh le huasghrádú ásc an bhunachair shonraí. Ba cheart go mbeadh dhá ásc le feiceáil, ceann i leagan 13 agus an ceann eile i leagan 15, arb é an t-aon cheann gníomhach é. Déantar an fíorú leis an ordú seo a leanas:

1
pg_lsclusters

Má d'éirigh leis an uasghrádú, is féidir ásc an bhunachair shonraí i leagan 13 a scriosadh:

1
pg_dropcluster 13 main

Is féidir tús a chur le scriosadh na bpacáistí PostgreSQL i leagan 13:

1
apt -y --purge autoremove postgresql-client-13 postgresql-13

Imirce an bhunachair shonraí CyberElements Bastion

Stóráiltear cumraíocht an táirge sa bhunachar sonraí, agus ní mór imirce a dhéanamh air ionas go mbeidh sé in ann cumraíochtaí na n-athruithe a thug an leagan nua isteach a choinneáil. Déantar an oibríocht ar an bhfreastalaí Mediation Controller mar root.

Ailtireacht Cluster

I gcás ailtireachta Cluster, ní mór an oibríocht a dhéanamh ó fhreastalaí Mediation Controller amháin, is cuma cé acu.

Ní mór an t-ordú seo a leanas a rith freisin:

1
python3 /var/lib/ipdiva/care/manage.py migrate

Cuirtear tús le himirce na sonraí le hordú atá coibhéiseach leis an gceann seo:

1
python3 /var/lib/ipdiva/care/manage.py migrate --database=<org_clr>

Ní mór ainm na heagraíochta atá le himirce a chur in ionad <org_clr>. Tabhair faoi deara, má tá roinnt eagraíochtaí ar an bhfreastalaí Mediation Controller (iltionónta), go mbeidh ort an t-ordú a rith an oiread uaireanta agus atá eagraíochtaí le himirce.

Sampla

I gcás ardáin CyberElements Bastion a bhfuil na heagraíochtaí systancia agus systancia-test aige, beidh ort na horduithe seo a leanas a rith:

1
2
python3 /var/lib/ipdiva/care/manage.py migrate --database=systancia
python3 /var/lib/ipdiva/care/manage.py migrate --database=systancia-test

Tar éis imirce an bhunachair shonraí, ní mór an tseirbhís Apache2 a atosú:

1
systemctl restart apache2

Cumraíochtaí a athchóiriú

Forscríobhadh roinnt cumraíochtaí le linn an phróisis uasghrádaithe agus ní mór iad a athchóiriú.

Comhad commonParameters.conf:

Bog na clibeanna <Location> a bhaineann leis na comhpháirteanna HTML5 Gateway, a bhíonn de ghnáth ag deireadh an chomhaid, ón gcomhad /etc/ipdiva/httpd/commonParameters.conf.dpkg-old go /etc/ipdiva/httpd/commonParameters.extra.conf (cruthaigh an comhad mura bhfuil sé ann). Mura bhfuil aon chlib <Location> ann, is féidir na samplaí seo a leanas a chóipeáil.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
<Location /HTML5/>
    Order allow,deny
    Allow from all
    ProxyPass http://127.0.0.1:1234/systanciaHTML5-6.0/ flushpackets=on
    ProxyPassReverse http://127.0.0.1:1234
</Location>

<Location /HTML5/websocket-tunnel>
    Order allow,deny
    Allow from all
    ProxyPass ws://127.0.0.1:1234/systanciaHTML5-6.0/websocket-tunnel
    ProxyPassReverse ws://127.0.0.1:1234/systanciaHTML5-6.0/websocket-tunnel
</Location>

 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
<Location /HTML5-1/>
    Order allow,deny
    Allow from all
    ProxyPass http://127.0.0.1:1234/systanciaHTML5-6.0/ flushpackets=on
    ProxyPassReverse http://127.0.0.1:1234
</Location>

<Location /HTML5-1/websocket-tunnel>
    Order allow,deny
    Allow from all
    ProxyPass ws://127.0.0.1:1234/systanciaHTML5-6.0/websocket-tunnel
    ProxyPassReverse ws://127.0.0.1:1234/systanciaHTML5-6.0/websocket-tunnel
</Location>

<Location /HTML5-2/>
    Order allow,deny
    Allow from all
    ProxyPass http://127.0.0.1:1235/systanciaHTML5-6.0/ flushpackets=on
    ProxyPassReverse http://127.0.0.1:1235
</Location>

<Location /HTML5-2/websocket-tunnel>
    Order allow,deny
    Allow from all
    ProxyPass ws://127.0.0.1:1235/systanciaHTML5-6.0/websocket-tunnel
    ProxyPassReverse ws://127.0.0.1:1235/systanciaHTML5-6.0/websocket-tunnel
</Location>

Comhad djangosettings.ini:

Cóipeáil an fhaisnéis ó líne 2 “allowed_hosts” den chomhad /etc/ipdiva/care/djangosettings.ini.dpkg-old chuig an gcomhad /etc/ipdiva/care/djangosettings.ini. Is féidir é seo a uathoibriú leis an ordú seo a leanas mar root:

1
sed -i "2c\\`sed -n '2p' /etc/ipdiva/care/djangosettings.ini.dpkg-old`" /etc/ipdiva/care/djangosettings.ini

Na hathchóiriúcháin a chur i bhfeidhm:

Chun na hathchóiriúcháin a chur i bhfeidhm, ní mór an tseirbhís Apache2 a atosú mar root:

1
systemctl restart apache2

Bailíochtú

Nuair a bheidh an t-uasghrádú curtha i gcrích, ní mór bonneagar CyberElements Bastion a bhailíochtú chun a chinntiú go bhfeidhmíonn sé i gceart sula bhfillfear ar an táirgeadh. Má theipeann ar an mbailíochtú, smaoinigh ar rolladh siar trí chúltacaí na bhfreastalaithe CyberElements Bastion a athchóiriú.

Oscail comhéadan riaracháin eagraíochta, agus ansin téigh chuig an roghchlár “About” sa bharra rialúcháin chun a sheiceáil gur uasghrádaíodh leagan an fhreastalaí Mediation Controller go 4.6.

Is féidir tús a chur leis na chéad tástálacha ar fheidhmiúlacht an ardáin, ach molaimid leagan 4.6 den chomhpháirt Edge Gateway a úsáid chun an fheidhmíocht is fearr a chinntiú d'fheidhmchláir CyberElements Bastion.