13.1.3 Linux alapú installáció

A PVSR-t a parancssorból hívható installáló alkalmazás segítségével lehet támogatott Linux operációs rendszerre lehet feltelepíteni.

13.1.3.1 Általános információk

Indítási paraméterek

Az installációt root felhasználóként kell elvégezni. Amennyiben nem installációról, hanem frissítésről van szó, úgy a PVSR-t az installáció megkezdése előtt le kell állítani. Az installáció megkezdéséhez a PerformanceVisor.vVERZIÓ.hu.bin állományt indítsuk el. Az alkalmazásnak többféle opciója is létezik:

• -h vagy -help: a használható paramétereket írja ki
• -d vagy -debug: az installáló alkalmazás a futása során többféle szintű üzenet kiírására is képes. Az opció segítségével lehet bekapcsolni a részletes log-olást. Amennyiben az opció nincsen megadva, az ilyen szintű üzenetek akkor is megjelennek a log file-ban (/tmp/pvsr.install.log), de a parancsot futtató ablakban nem
• -c vagy -compatible: megjeleníti, hogy az installálót milyen operációs rendszereken és milyen Oracle verziókkal lehet használni
• -s vagy -silent: az installáló alkalmazás a futása során több kérdést is feltesz. Amennyiben az opció be van kapcsolva és egy nem eldöntendő kérdésre létezik alapértelmezett válasz, úgy az alkalmazás automatikusan továbbhalad, és nem kívánja meg, hogy a felhasználó azt elfogadja. Az opció bekapcsolása frissítés esetén bizonyos eldöntendő kérdések esetében is az installáló alkalmazás azonnali továbbhaladását jelenti a felhasználó megerősítése nélkül, ezekre a kérdésekre a későbbi leírás részletesen kitér
• -force_silent: mindig csak az alap választ fogadja el a rendszer. Ha valamilyen hibára fut, akkor sem vált vissza interaktív módba, hanem kilép
• -accept_licence_silent: kérdezés nélkül elfogadjuk a licensz feltételeket
• -collector_install: azt lehet vele jelezni az installernek, hogy adatgyűjtőt installálunk/upgrade-elünk. Ebben az esetben:
• Nem keresi az installer se az Apache-t se az Oracle SQLLDR parancsot
• Nem teszteli az adatbázis kapcsolatot tnsping paranccsal
• Nem teszteli az adatbázis kapcsolatot SID és SERVICE_NAME paraméterrel
• Nem kérdezi meg, hogy adatgyűjtőt installálunk-e
• -do_not_use_system: nem kérdezi az installer az Oracle SYSTEM jelszót. Ha ez az első installálás és nem upgrade, akkor a PVSR Oracle felhasználójának és a táblatereknek már létezniük kell
• -a=file_név: a megadott file-ból veszi az alapértelmezett válaszokat. Az installáló alkalmazás a futása során minden esetben a /var/pvsr/answer file-ba menti el a felhasználó válaszait (kivéve a jelszavakat)
• -p=path: a megadott értéket használja mint PATH környezeti változó az installáció során

Installálás megszakítása

Amennyiben az installációt meg akarjuk szakítani, úgy arra lehetőség van a Ctrl-C billentyű kombinációval. Amennyiben az installáló alkalmazás éppen valamilyen felhasználói bevitelre vár, úgy a Ctrl-C lenyomása után még először válaszolni kell a kérdésre, mielőtt lehetőség volna az installáló alkalmazás megszakítására. Amennyiben így megszakítjuk az installáló alkalmazást, vagy nem akarunk továbbhaladni az installációval, úgy az alkalmazás felajánlja az aktuálisan feltelepített modulok és opciók eltávolítását. Ilyenkor mindig dönthetünk úgy, hogy az eltávolítás ne történjen meg, mivel az installáló alkalmazás többször egymás után is futtatható. Sőt, amennyiben egy korábbi verziójú PVSR már fel van installálva, úgy az installáló alkalmazás onnan veszi az egyes konfiguráció értékeit, és installálás helyett frissítést végez. Fontos: amennyiben az installáló alkalmazás frissítést végez és az installáció befelyezése előtt kilépünk az installáló alkalmazásból, miközben már új file-ok felmásolásra kerültek, vagy adatbázis séma frissítés történt, úgy az installáló alkalmazás nem fogja ezeket semmissé tenni, azaz nem fog visszamásolni file-okat és nem fogja visszagörgetni az adatbázis sémában bekövetkezett változásokat.

Üzenetek, kérdések és válaszok az installálás során

Az installálás során látható üzeneteket az alkalmazás a /tmp/pvsr.install.log állományba menti el. Az állományban akkor is megjelennek a DEBUG szintű üzenetek, amennyiben a debug opció nem került megadásra az alkalmazás indításakor. Az alkalmazás az alábbi üzenet szinteket használja:

• ERROR: hibaüzenet
• WARNING: figyelmeztetés
• INFO: informálás
• DEBUG: debug üzenet
• QUESTION: kérdés

A kérdések esetében a rendszer mindig a szögletes zárójelek - [ és ] - között mutatja az alapértelmezett választ, ha van ilyen. Amennyiben jelszót kérdez és van alapértelmezett válasz, úgy az alapértelmezett érték helyett csillagokat ír ki az alkalmazás. Eldöntendő kérdés esetén kis vagy nagy Y karakterrel az igen, míg kis vagy nagy N karakterrel a nemleges választ jelölhetjük meg.

Operációs rendszer miatti különbségek az installálás során

Az installáló alkalmazás futása valamennyire különböző az operációs rendszernek és az Oracle verziónak megfelelően. A fő különbségek az alábbiak:

• Az operációs rendszertől függően más előre felinstallált alkalmazások jelenlétét vizsgálja az installáló alkalmazás
• Az operációs rendszernek megfelelő ún run-level könyvtárakba helyezi el a PVSR automatikus leállítására és elindítására szolgáló script-eket

A továbbikaban a Linux 8 alapú installálás során feltett kérdések kerülnek ismertetésre. Amennyiben már egy felinstallált PVSR esetében futtatjuk az installációs alkalmazást, úgy az frissítést fog végezni, és ennek megfelelően kevesebb kérdést fog feltenni.

13.1.3.2 Installálás

1. Alap ellenőrzések

Az installáló alkalmazás az indulása után többféle ellenőrzést is végez: megvizsgálja az operációs rendszer verzióját, a különböző alkalmazások meglétét, a perl verzióját és hogy milyen fordítási opciókkal készült, stb… A telepített csomagok ellenőrzése során megkülönböztet az installáló alkalmazás három esetet:

·       Olyan csomagok, amelyekre mindenképpen szükség van. Ezeknek kötelezően fent kell lenniük a rendszeren

·       Olyan csomagok, amelyekre csak bizonyos adatgyűjtők esetén van szükség. Nem kötelező a meglétük

·       Olyan csomagok, amelyek hasznosak lehetnek a PVSR későbbi üzemeltetése során. Nem kötelező a meglétük, de ajánlott

Amennyiben az ellenőrzés során hibát tapasztal, úgy a hiba súlyosságától függően vagy azonnal kilép, vagy csak figyelmeztet, és felajánlja a továbblépési lehetőséget.

2. Licensz információ

Miután megjelenítésre került a licensz információ, az alkalmazás megkérdezi, hogy elfogadjuk-e a feltételeket és csak igenlő válasz esetén lép tovább.

3. Szimbólikus linkek létrehozása és DNS/NTP ellenőrzés

A következő lépésben az installáló alkalmazás szimbólikus linkeket hoz létre. Alapesetben ilyenkor semmire sem kérdez rá, kivéve hogyha a /usr/local/bin/perl szimbólikus link már létezik és úgy érzékeli, hogy nem egyezik meg az installáló alkalmazás által talált elsődleges perl programmal. Az installálás folytatása ebben az esetben csak akkor ajánlott, ha az installáló által talált perl alkalmazás biztosan mégis megegyezik a /usr/local/bin/perl-lel.

Ezek után az installáló leellenőrzi, hogy van-e beállítva DNS szerver a rendszeren. PVSR többnyire képes DNS szerver nélkül is üzemelni, azonban bizonyos mérésekhez (például Windows és Hyper-V) szükséges lehet egy megfelelően beállított DNS szerver. Hasonlóan a PVSR nem követeli meg időszinkronizáció meglétét, de annak hiányában a mérési adatok hibás időponthoz kerülhetnek berögzítésre. Szintén problémát okozhat, hogyha több időszinkronizációs beállítás is van (például NTP és VMware). Ilyen esetben ajánlott úgy módosítani a konfigurációt, hogy csak egy időszinkronizációs beállítás maradjon.

4. Alap Oracle adatok

Az alkalmazás megkérdezi az Oracle installálásakor megadott operációs rendszer felhasználójának a nevét. Ez után megpróbálja megállapítani az ORACLE_HOME környezeti változó értékét az adott felhasználóval, de ha sikeres, akkor is megerősítést kér róla a felhasználótól. Az installer felismeri, hogyha Oracle Instant Client került telepítésre (ZIP vagy RPM formában) és felajánlja, hogy elvégzi a használatukhoz szükséges módosításokat (TNSNAMES.ORA, szimbólikus linkek, …). Ha az installer nem találja az sqlldr Oracle alkalmazást, akkor egy figyelmeztető üzenetet ad. Ha a felhasználó úgy dönt, hogy folytatja, akkor csak adatgyűjtő típusú installáció történik.

5. A PVSR-t futtató felhasználó adatai

Az alkalmazás megkérdezi, hogy milyen nevű operációs rendszer felhasználót hozzon létre, milyen operációs rendszer felhasználó csoportot hozzon létre, mi legyen a felhasználó jelszava (ez utóbbit csak Linux esetében), és hogy a /opt könyvtár alatt milyen könyvtárba legyen felinstallálva a PVSR. Amennyiben a felhasználó már létezik és a könyvtár is létezik, de nem talál az alkalmazás PVSR installációt, úgy megerősítést kér a folytatás előtt. Amennyiben talált PVSR installációt és futó PVSR modult is, úgy addig nem folyatja az installálást, amíg a modulok le nem lettek állítva.

6. Oracle adatok bekérdezése

Az installáló alkalmazás megkérdezi a használandó Oracle TNS nevet, hosztot, service nevet, SID-et és egy felhasználó/jelszó párost vagy a SYSTEM felhasználó jelszavát, amivel le tudja ellenőrizni az adatbázis kapcsolatot. Amennyiben a felhasználó úgy dönt, hogy a kapcsolatot nem SYSTEM felhasználóval akarja letesztelni és a későbbiekben az installer létre akar majd hozni megfelelő adatbázis felhasználót a PVSR számára, úgy meg fogja majd akkor megint kérdezni a SYSTEM felhasználó jelszavát. Amennyiben nem akarjuk az installer-nek ezt megadni, úgy a PVSR használandó Oracle felhasználónak már léteznie kell az installer futtatás előtt és használni kell a -do_not_use_system opciót. Amennyiben a megadott TNS nevet nem találja a TNSNAMES.ORA-ban, úgy felajánlja, hogy létrehozza azt. A PVSR elsődlegesen az Oracle TNS és service name alapú kapcsolódást támogatja, így amennyiben csak SID-del nem tud csatlakozni a rendszer, úgy nyugodtan folytatható az installálás.

7. PVSR installáció típusa és „nice” beállítás

A PVSR kitömörítése után az installáló alkalmazás megkérdezi, hogy adatgyűjtő szervert installálunk-e. A PVSR architektúrájának köszönhetően több gépen is képes futni. A kérdésre csak akkor válaszoljunk Y-nal, ha egy már létező PVSR-hez installálunk egy új adatgyűjtő szervert. Ez a kérdés egyike azoknak az eldöntendő kérdéseknek, amelyekre adott választ az installáló alkalmazás megjegyzi és a következő futtatás során az előző válaszunkat ajánlja fel, illetve silent üzemmódban megerősítés nélkül elfogadásra kerül a korábbi válaszunk.

Amennyiben egy új adatgyűjtőt installálunk, akkor fontos megjegyezni, hogy az installálás után kézzel kell majd beállítani, hogy az központi modul be tudjon lépni erre a gépre SSH segítségével. Fontos ilyenkor az is, hogy a központi PVSR gép PONTOSAN ugyanazzal a host névvel ismerje ezt a gépet, amilyennel az ismeri magát. Amennyiben ez utóbbi feltétel nem teljesül, úgy az adatgyűjtő gép indulása esetén a PVSR nem fog automatikusan elindulni.

A PVSR szintén beállítja az operációs rendszert úgy, hogy a ping-elést végző modulja nagyobb rendszer prioritást kapjon a pontosabb mérések érdekében.

8. Apache konfigurációja

Amennyiben nem adatgyűjtő szervert installálunk, úgy az installáló alkalmazás megkérdezi, hogy az Apache WEB szervert felkonfigurálja-e. Ez a kérdés egyike azoknak az eldöntendő kérdéseknek, amelyekre adott választ az installáló alkalmazás megjegyzi és a következő futtatás során az előző válaszunkat ajánlja fel, illetve silent üzemmódban megerősítés nélkül elfogadásra kerül a korábbi válaszunk.

Amennyiben Y-nal válaszolunk, úgy először megkérdezi a használandó TCP portot, majd a különböző Apache állományok helyét. A file-ok elhelyezkedésével kapcsolatos kérdések során az alapértelmezettként megadott válaszok megfelelnek az operációs rendszer alap Apache installációjának. Legvégül megkérdezi a használandó authentikációt, itt a lehetséges értékeket fel is sorolja a zárójelek között. Az egyes authentikációk leírását a 13.1.2 WEB felület authentikációjának a beállítása fejezet tartalmazza. Ezek után elvégzi az Apache konfigurálását.

Amennyiben ldap, radius, cas vagy keycloak authentikációt választottunk, úgy az Apache konfigurálás után a kiválasztott authentikációnak megfelelően további kérdéseket tesz fel az installáló alkalmazás. Minden ilyen kérdés egy-egy, az authentikáció leírásánál felsorolt paramétert kérdez meg. Azoknál a paramétereknél, ahol több érték is megadható, az érték lista megadásának a végét az üres érték megadásával, azaz egy sima ENTER-rel kell jelezni. A konfigurálás során feltett kérdések sorrendben az alábbi paraméterekre vonatkoznak (a paraméterek leírását lásd a 13.1.2 WEB felület authentikációjának a beállítása fejezetben):

·       LDAP

o   ldap_url

o   timeout

o   bind_dn

o   bind_pwd

o   base_dn

o   search_attr

o   auth_attr

o   admin_dn

o   group

o   user

o   dn

o   filter_attr

·       RADIUS

o   host

o   secret

o   timeout

o   admin

o   user

·       CAS

o   server

o   timeout

o   allow_logout

·       Keycloak

o   realm_url

o   timeout

o   client_id

o   client_secret

o   admin_username

o   create_pvsr_user

o   overwrite_pvsr_group

A paraméterek megadása után megmutatja az installáló alkalmazás azt is, hogy milyen konfigurációs adatokkal fogja létrehozni a pvsr_auth.cfg file-t; kivéve annak első sorát, amely az authentikáció típusát tartalmazza, illetve LDAP és Keycloak esetében le is ellenőrzi a kapott kapcsolódási paramétereket. Fontos megjegyezni, hogyha a pvsr_auth.cfg állomány létezik már az installáló alkalmazás futása során, akkor sem értelmezi annak a tartalmát, azaz az egyes paramétereket újra meg kell adni. Ilyenkor azonban mielőtt elkezdené az Apache konfigurálást, létrehoz egy biztonsági másolatot az eredeti file mellé pvsr_auth.cfg.backup néven.

9. Automatikus indítás

Az installáló alkalmazás automatikus indító és leállító script-eket helyez el a megfelelő ún. run-level könyvtárakban illetve 8-as vagy újabb operációs rendszer verzió esetében a systemctl parancs segítségével ún. service-t hoz létre. Amennyiben nem adatgyűjtő szervert installálunk, úgy az alkalmazás megkérdezi, hogy az Oracle szervert is elindítsa illetve leállítsa-e. A kérdésre csak akkor válaszoljunk Y-nal, ha az Oracle ugyanazon a gépen fut és nincsen neki külön automatikus indító és leállító script-je. Amennyiben ugyanazon a gépen fut, de ilyen script már létezik, úgy fontos az, hogy az Oracle korábban induljon el, mint a PVSR és később álljon le. Ez a kérdés egyike azoknak az eldöntendő kérdéseknek, amelyekre adott választ az installáló alkalmazás megjegyzi és a következő futtatás során az előző válaszunkat ajánlja fel, illetve silent üzemmódban megerősítés nélkül elfogadásra kerül a korábbi válaszunk.

10. PVSR táblaterületek és adatbázis séma létrehozása

Amennyiben nem adatgyűjtő szervert installálunk, és az adatbázis séma még nem lett létrehozva, úgy az installáló alkalmazás megkérdezi sorrendben a PVSR konfigurációs táblák helyéül szolgáló táblatér nevét, helyét és méretét, majd a mérési adatokat tároló táblatér nevét, helyét és méretét, legvégül pedig a létrehozandó adatbázis felhasználó nevét és jelszavát. Az installáló alkalmazás létrehozza saját maga a táblaterületeket az igényeinek megfelelően, de létre lehet hozni őket manuálisan is és itt csak megadni a nevüket. Ebben az esetben a szükséges információkat a 13.1.5.2 fejezet tartalmazza.

11. Installáció befejezése

Utolsó lépésként az installáló alkalmazás kilép

13.1.3.3 Eltávolítás

A PVSR eltávolítását az installálás könyvtárába elhelyezett UninstallPerformanceVisor alkalmazás segítségével lehet elvégezni. Az alkalmazás futtatása előtt minden PVSR modult le kell állítani és minden a PVSR által használt operációs rendszer felhasználóval ki kell lépni. Az eltávolítást root felhasználóként kell futtatni.

Az eltávolítás során először az alkalmazás megkérdezi, hogy a felsorolt operációs paraméterek helyesek-e.

Ez után megkérdezi, hogy a PVSR Oracle felhasználóját törölni akarjuk-e. Amennyiben igen, úgy megkérdezi az Oracle operációs rendszer felhasználóját és az ORACLE_HOME környezeti változó értékét, majd újra megerősítést kér, hogy törölni akarjuk-e a felhasználót. Amennyiben Y-nal válaszoltunk és a törlés megtörtént, úgy rákérdez, hogy törölni akarjuk-e a két Oracle táblaterületet.

Ezek után megkérdezi, hogy helyre akarjuk-e állítani a PVSR előtti Apache konfigurációt.

Legvégül megkérdezi, hogy törölni akarjuk-e a teljes installációs könyvtárat, és ha igen, akkor törölni akarjuk-e az operációs rendszerbeli felhasználót.