PowerFlex: Suorita komentosarja isännässä (eli käyttöjärjestelmän korjaus) -ominaisuuden selitys

Käyttöliittymä – Pre-PFMP (PowerFlex 4.x)

Edellytykset

Pakollinen - pääkomentosarja sijaitsee /opt/emc/scaleio/lia/bin/ hakemisto, jossa on suoritusoikeudet.

• Komentosarjan nimen on oltava patch_script 

Valinnainen – vahvistuskomentosarja sijaitsee kohteessa /opt/emc/scaleio/lia/bin/ hakemisto, jossa on suoritusoikeudet.

• Komentosarjan nimen on oltava verification_script

> Ominaisuutta tuetaan vain Linuxissa (RHEL ja SLES).
> Toiminto tarkistaa, onko poistumiskoodi 0 (nolla) suorituksen lopussa.
> Poistumiskoodit ja komentosarjasuoritukset näkyvät LIA-lokeissa.
> Asiakkaan vastuulla on testata patch_script ja verification_script ennen prosessin suorittamista yhdyskäytävän avulla.
> Ominaisuuden sijainti: Ylläpitää → järjestelmälokeja ja analysoida niitä → suorittaa komentosarjoja isännissä.

Vaiheet ja työnkulut

Komentosarjan suorittaminen:
1. Koko järjestelmä – kaikki PowerFlex-solmut
Komentosarja on oletusarvoisesti käynnissä ensimmäisen isännän Protection Domain (PD) -toimialueella, siirtyy sitten toiseen ja niin edelleen.
Samanaikaisesti eri suojaustoimialueilla poistettu käytöstä - oletusarvoisesti valintaruutu on poistettu.
 
Rinnakkain eri suojaustoimialueilla käytössä - valitsemalla tämän vaihtoehdon patch_script suoritetaan rinnakkain kaikissa PD-laitteissa.
PD:t, joissa ei ole MDM:ää, ovat ensimmäisiä ja klusterisolmut viimeisiä.


2. Protection Domain – tietyt PD-PD-PD-levyt
, joissa ei ole MDM:iä, ovat ensimmäisinä ja MDM-klusterisolmut viimeisinä.

3. Vikajoukko - tietty FS.
FS:t, joissa ei ole MDM:ää, ovat ensimmäisiä ja MDM-klusterisolmut viimeisiä.

4. SDS - yksi SDS-solmu


Käynnissä oleva kokoonpano:
1. Pysäyttää prosessin, jos komentosarja epäonnistuu.
1.1 Pysäytä prosessi, jos komentosarjavirhe on käytössä - oletusarvoisesti valintaruutu on valittuna.
Koko suoritus epäonnistuu ja pysähtyy, kun patch_script (ja verification_script, jos valittu) poistuu jollakin muulla koodilla kuin 0 (nolla).
 
1.2 Pysäytä prosessi komentosarjavirheen ollessa poissa käytöstä.
Jos patch_script epäonnistuu, kyseisen solmun suorittaminen epäonnistuu ja järjestelmä siirtyy seuraavaan solmuun suorittamaan patch_script kyseisessä solmussa.
 

2. Skriptin aikakatkaisu - Kuinka kauan patch_script päättymistä on odotettava?
Komentosarjan suorittamisessa on määritettävissä oleva aikakatkaisu, jonka käyttäjä valitsee.
Oletusarvon mukaan aikakatkaisu on määritetty 15 minuutiksi → virheen vuoksi, ja PowerFlex 3.6:ta vanhemmissa versioissa aikakatkaisu on 15 minuuttia.
Koko suoritus epäonnistuu ja loppuu, kun komentosarjan suoritus on aikakatkaistu.

3. Vahvistuskomentosarja - Haluatko suorittaa verification_scriptpatch_script suorittamisen jälkeen?
3.1 Suorita - patch_script suoritetaan ja kun se on tehty, verification_script suoritetaan riippuen siitä, käynnistetäänkö patch_script toiminnan jälkeen uudelleen vai ei (kohta #4).
3.2 Älä suorita - patch_script suoritetaan ja kun se on tehty, koko ajo pysähtyy ja päättyy yhtä onnistuneesti.
 

4. Post script -toiminto – Haluatko käynnistää solmun uudelleen patch_script suorittamisen jälkeen?
4.1 Käynnistä uudelleen - kun patch_script on suoritettu ja poistunut koodilla 0 (nolla), solmu käynnistyy uudelleen ja pysähtyy tai jatkuu riippuen siitä, valittiinko verification_script suoritettavaksi vai ei (osa #3).
Jos yhdyskäytävä on solmussa, joka käynnistetään uudelleen, se ei käynnisty uudelleen, toiminto onnistuu ja ponnahdusikkuna, joka muistuttaa meitä käynnistämään sen uudelleen manuaalisesti, näytetään.
4.2 Älä käynnistä uudelleen - kun patch_script lopettanut suorituksen ja poistunut koodilla 0 (nolla), solmu ei käynnisty uudelleen ja pysähtyy tai jatkuu riippuen siitä, valittiinko verification_script suoritettavaksi vai ei (kohta #3).
 


Komentosarjan suorittaminen isännissä:
Paina kohtaa Suorita komentosarja isännissä -->Vahvista vaiheen aloitukset.
Tämä vaihe lähettää pyynnön kunkin solmun LIA: lle tarkistaa patch_script- ja verification_script tiedostojen (jos valittu) olemassaolon kohdassa /opt/emc/scaleio/lia/bin/.
Koodilogiikka valitsee satunnaisen luettelon solmuista, joissa suoritetaan (mainittujen ehtojen mukaisesti).
 


Aloita toteutusvaihe:
Paina "Aloita suoritusvaihe" -painiketta.
1. Gateway tekee seuraavat tarkistukset:

a. Tarkista, että kapasiteetti ei ole viallinen.
b. Tarkista voimassa oleva käyttämätön kapasiteetti.
c. Tarkista kelvollinen klusterin tila.
d. Tarkista, ettei mikään muu käyttöturvallisuustiedote ole huoltotilassa.

2. Aseta käyttöturvallisuustiedote huoltotilaan.
3. Suorita patch_script - onnistuneen ajon jälkeen tiedosto poistetaan ja varmuuskopiotiedosto luodaan samaan hakemistoon.
Nimellä backup_patch_script
4. Käynnistä isäntä uudelleen (jos valittu)
5. Suorita verification_script (jos valittu) - onnistuneen ajon jälkeen tiedosto poistetaan ja sen varmuuskopiotiedosto luodaan samaan hakemistoon, jonka nimi on backup_verification_script.
6. Poistu SDS:stä huoltotilasta.
7. Toiminto on valmis.


 

RESTAPI – PFMP:n jälkeinen aika (PowerFlex 4.x)

• Suorita korjauskomentosarja kaikissa tai joissakin järjestelmän solmuissa valinnaisen uudelleenkäynnistyksen ja valinnaisen vahvistuskomentosarjan avulla. Operaatiolla on jonkin verran rinnakkaisuutta.
• Komentosarjatiedostot on tallennettava solmun kansioon: /opt/emc/scaleio/lia/bin Vaihtoehtoisesti GW voi ladata ne solmuun. Komentosarjan voi ottaa paikallisesta GW-kansiosta tai ladata jaetusta HTTP/HTTPS-resurssista.
• Käytettävissä on luettelo SDSId- ja/tai mdmId-tunnuksista, jotta voidaan nimenomaisesti valita suoritettavat solmut.
• Tiedostonimet ovat kovakoodattuja, eikä niitä voi muuttaa: patch_script ja verification_script

REST-komento

• /im/types/Configuration/actions/liaRunOsPatching

Vaaditut parametrit

• Jokin seuraavista parametreista on pakollinen: pdIds/fsIds/sdsIds/mdmIds / executeOnAllSdss / executeOnAllMdms
  • pdIds  - suorita kaikissa solmuissa, jotka kuuluvat seuraaviin suojaustoimialueisiin (PD-tunnuksiin) desimaalimuodossa
  • fsIds  - suorita kaikissa solmuissa, jotka ovat osa seuraavia vikajoukkoja (FS-tunnukset), desimaalimuodossa
  • sdsIds  - suorita kaikki IDS: n luettelemat käyttöturvallisuustiedotteet desimaalimuodossa
  • mdmIds  - suorita kaikki tunnusten mukaan luetellut MDM:t desimaalimuodossa
  • executeOnAllSdss  - suorita kaikki SDS: t (tosi / epätosi)
  • executeOnAllMdms  - suorita kaikki MDM: t (true/false)

Valinnaiset parametrit

• isRebootRequired - pitäisikö jokaisen solmun käynnistyä uudelleen korjausskriptin suorittamisen jälkeen (arvot: true/false)
• isVerificationScriptRequired - pitäisikö varmennusskripti suorittaa jokaisessa solmussa (arvot: true/false)
• isRunningInParallelOnPds - pitäisikö operaation toimia rinnakkain solmuissa, jotka kuuluvat eri PD-tiedostoihin (arvot: true/false)
• isStopProcessingOnScriptFailure - pitäisikö koko toiminnon pysähtyä skriptivirheen vuoksi (arvot: true/false)
• TimeoutMs - aikakatkaisu korjausskriptin suorittamiseen millisekunneissa
• isUploadFileNeeded  - Pitäisikö GW:n ladata skriptejä solmuihin (arvot: true/false)

Seuraavat kentät ovat merkityksellisiä, kun: isUploadFileNeeded  on 'tosi':

• patchScriptFilePath  - joko paikallisen kansion nimi tai korjausskriptin http/https-URL-osoite
• verificationScriptFilePath  - joko paikallisen kansion nimi tai vahvistusskriptin http/https-URL-osoite
• maintenanceModeType  - Ylläpitotilantyyppi (arvot: IMM/PMM)
• verificationScriptTimeoutSec  - vahvistusskriptin aikakatkaisu sekunneissa
• rebootTimeoutSec  - solmun uudelleenkäynnistyksen aikakatkaisu sekunneissa

Huomaa, että ennen kuin suoritat liaRunOsPatching-komennon, sinun on ensin kirjauduttava sisään ja hankittava järjestelmän kokoonpano, katso alla oleva esimerkki.
 

Komentoesimerkki

*token-muuttuja sisältää Keycloak-tunnuksen, joka palautettiin /auth/login tai /api/gatewayLogin.
**<ip-osoite> - suoritettavat komentosarjat

sisältävän http-palvelimen IP-osoite Hanki järjestelmän kokoonpanon json, joka on korjauskomennon hyötykuorma (on korvattava liaPassword ja mdmPassword manuaalisesti tyhjästä johonkin merkkijonoon).


Lisää tämän komennon tulos (kiinteillä salasanoilla) config.json tiedostoon:

curl -s -X POST -k -H  "Content-Type: application/json" -d '{ "mdmIps":["1.2.3.4","5.6,7,8"], "mdmUser":"<mdm_username>", "mdmPassword":"<mdm_password>", "securityConfiguration":{ "allowNonSecureCommunicationWithMdm":"true", "allowNonSecureCommunicationWithLia":"true", "disableNonMgmtComponentsAuth":"false" } }' -H "Authorization: Bearer ${token}"  https://<m&o-ip-address>/im/types/Configuration/instances

Suorita korjauskomento:

curl -v -k -X -i POST -H "Content-Type:application/json" -H "Authorization: Bearer ${token}" 

 "https:/<m&o-ip-address>/im/types/Configuration/actions/liaRunOsPatching?executeOnAllSdss=true &isRebootRequired=true&isVerificationScriptRequired=true&patchScriptFilePath=https://<ip-address>/patch_script&verificationScriptFilePath=https://<ip-address>/verification_script&maintenanceModeType=IMM&rebootTimeoutSec=30" -d @config.json

Lokit

yhdyskäytävä:

• /opt/emc/scaleio/gateway/logs/scaleio.log
• /opt/emc/scaleio/gateway/logs/scaleio-trace.log

LIA:
/opt/emc/scaleio/lia/logs/trc.x

Juomaraha- Erityinen kytkin, joka pitää komentosarjan solmussa vianmäärityksen tai testauksen aikana:

• Muokkaa tiedostoa /opt/emc/scaleio/gateway/webapps/ROOT/WEB-INF/classes/gatewayInternal.properties
• Etsi kenttä "ospatching.delete.scripts=false"
• Vaihda arvoon true vianmääritystä varten (oletus on false)