Átállás MongoDB Atlas adatbázisra
A Nightscotut webalkalmazás minden adatot egy adatbázisban tárol, mely 2020.09.01-ig az mLab által biztosított MongoDB volt.
Ez a szolgáltatás azonban megszűnik és helyette az MongoDB Atlas szolgáltatásában biztosított MongoDB adatbázisra kell átállni 2020.11.10-ig.
Ehhez szükséges egy MongoDB Atlas regisztráció létrehozása, a korábbi adatok átvitele az új adatbázisba és az új adatbázis beállítása a Nightscout webalkalmazásban a régi mLab adatbázis helyett.
- Nightscout webalkalmazás frissítése
- MongoDB Atlas fiók létrehozása
- Korábbi adatok átvitele mLab MongoDB adatbázisból MongoDB Atlas adatbázisba
- Nightscout webalkalmazásban új MongoDB Atlas adatbázis beállítása
- Korábbi mLab MongoDB adatbázissal való kapcsolat megszüntetése, adatbázis törlése
A telepítést javasolt számítógépen (asztali gépen vagy laptopon) elvégezni! Bizonyos lépéseket egyszerűbb így megtenni, illetve a weboldalak felületei is eltérően néznek ki mobilon.
1. Nightscout webalkalmazás frissítése
Amennyiben a Nightscout webalkalmazás már frissítésre került korábban legalább a 14.0.6 verzióra, akkor ezek a lépések kihagyhatóak.
1.1 Github kezdőoldalának megnyitása böngészőben https://github.com és kattintás a „Sign in” gombra
1.2 Github fiókhoz tartozó emailcím vagy felhasználónév és jelszó megadása, majd bejelentkezés a „Sign in” gombbal
1.3 Saját Nightscout oldal forrásának megnyitása a „Repositories” alatt lévő saját github felhasználónév /cgm-remote-monitor linkkel
1.4 Megjelennek a saját oldalhoz tartozó forráskódot tartalmazó mappák és fájlok
1.5 Kattintás a „Settings” gombra
1.6 A megjelenő beállítások oldalon görgetés lefelé a „Danger Zone” részhez és kattintás a „Delete this repository” gombra
1.7 Törlés jóváhagyásához a felugró ablakban a saját github felhasználónév/cgm-remote-monitor begépelése és kattintás az „I understand the consequences, delete this repository” gombra
1.8 Eredeti Nightscout GitHub forrás megnyitása böngészőben: https://github.com/nightscout/cgm-remote-monitor
1.9 Új saját másolat létrehozása a legújabb verzióból a „Fork” gombra való kattintással
1.10 Megjelenik a másolat létrehozása folyamatban oldal
1.11 Másolás végén megjelenik a saját másolat
ALÁBBI KIEGÉSZÍTŐ KERETEZETT LÉPÉSEK CSAK MEDTRONIC GUARDIAN CONNECT (“TELEFONOS SZENZOR”) HASZNÁLATA ESETÉN SZÜKSÉGESEK (GUARDIAN LINK – “PUMPA + SZENZOR” – ESETÉN NEM KELL)! Medtronic Guardian Connect-et nem használók esetén a keretes rész átléphető, vannak még elvégzendő lépések utána. Átmeneti javítás a Medtronic szerverfrissítés óta nem működő CareLink Connect adatátvételre a Nightscout oldalon lévő MiniMed Connect modul lecserélésével egy módosított, az eddigi tesztek alapján a Medtronic CareLink rendszerrel is már működőképes MiniMed Connect verzióra. Ez egy nem “hivatalos” javítása a problémának, az majd várhatóan egy új NS verzió lesz. MGC – 1. Görgetés lefelé a „package.json” fájlhoz és kattintás a fájlra  MGC – 2. A „package.json” fájl tartalmának módosítása a ceruza ikonra kattintva  MGC – 3. Görgetés lefelé a “minimed-connect-to-nightscout” sorig (jelenlegi Nightscout verziónál ez a 82. sornál van)  MGC – 4. A sor teljes tartalmának lecserélése pontosan az alábbira (fontos a sor végén lévő vessző is!): "minimed-connect-to-nightscout": "nightscoutdemo/minimed-connect-to-nightscout#dev",  MGC – 5. Görgetés az oldal aljára és a módosítások mentése a „Commit changes” gombbal  |
1.12 A böngészőben egy új lapon a Heroku kezdőoldalának megnyitása: https://www.heroku.com
1.13 Kattintás a „Log in” linkre
1.14 Bejelentkezés Heroku fiókba
1.15 Kattintás a saját Nightscout alkalmazásra
1.16 Kattintás „Deploy” linkre
1.17 Amennyiben össze van kötve már a Heroku alkalmazás a Github forráskóddal (Connected to …), akkor kattintás a „Disconnect…” gombra
Ha a Nightscout alkalmazás nincs összekötve a Github forráskóddal, akkor ez a rész nem található meg a Deploy oldalon.
1.18 Szétcsatlakoztatás megerősítése a „Disconnect” gombra kattintással
Ha a Nightscout alkalmazás nincs összekötve a Github forráskóddal, akkor ez a rész nem található meg a Deploy oldalon.
1.19 Deployment method résznél kattintás GitHub ikonra
1.20 Connect to GitHub résznél kattintás a „Connect to GitHub” gombra
Ha a Nightscout alkalmazás nem volt összekötve a Github forráskóddal, akkor ezt a lépést nem kell végrehajtani.
1.21 Felugró ablakban kattintás az „Authorize heroku” gombra
Ha a Nightscout alkalmazás össze volt kötve a Github forráskóddal, akkor ezt a lépést nem kell végrehajtani, nem jelenik meg ez a felugró ablak.
1.22 Megjelenik a GitHub fiók felhasználónév
Ha a GitHub weboldal be lett korábban zárva (nem egy új fülön lett csak megnyitva a Heroku), akkor először a GitHub bejelentkezési adatokat kell megadni és csak utána jelenik meg a GitHub fiók.
1.23 Kattintás a „Search” gombra
1.24 Kattintás a cgm-remote-monitor melletti „Connect” gombra
1.25 Github Nightscout programkód összekötésre került a Heroku Nightscou alkalmazással
1.26 Görgetés lefelé a Manual deploy részhez és kattintás a master melletti „Deploy Branch” gombra
1.27 Megkezdődik az új verzió telepítése (a telepítés pár percig is eltarthat)
1.28 Megjelenik az értesítés az alkalmazás sikeres telepítéséről
1.29 A sikeres telepítés után pár újraindul a Nightscout webalkalmazás új verziója, ez pár percet igényel
1.30 Saját Nightscout webalkalmazás megnyitása a böngészőben egy új lapon
1.31 Nightscout webalkalmazás verziójának ellenőrzése a Nightscout menüben a verziószámhoz lefelé görgetve (a leírás készítésekor az aktuális verzió: 14.0.6)
Ezzel lezárult az adatbázisátállás első fázisa, később akár innen folytatható, de ebben az esetben újra be kell lépni a Heroku fiókba, mielőtt a következő fázis megkezdésre kerül. A továbbiakat csak egyben lehet elvégezni megszakítás nélkül!
2. Átállás MongoDB Atlas adatbázisrendszerre
2.1 Visszatérés Heroku lapra a böngészőben és kattintás „Settings” linkre
2.2 Görgetés lefelé a Maintenance Mode részhez és kattintás a Maintenance mode váltó gombra
Ezzel a lépéssel a Nightscout webalkalmazás átáll karbantartási módra, az adatbáziscsere végéig, amíg nem kerül kikapcsolásra a karbantartási mód, a Nightscout webalkalmazás nem lesz elérhető!
2.3 Felugró ablakban kattintás az „Enable Maintenance Mode” gombra
2.4 Görgetés vissza az oldal tetejére és kattintás a „Resources” gombra
2.5 Add-ons részben kattintás az „mLab MongoDB” linkre
2.6 Egy új lapon megjelenik a Nightscout alkalmazáshoz tartozó mLab MongoDB fiók
2.7 A böngészőben egy új lapon a MongoDB Atlas kezdőoldalának megnyitása böngészőben: https://www.mongodb.com/cloud/atlas
2.8 Kattintás a „Start free” gombra (ingyenes fiók létrehozása)
2.9 Megjelenő regisztráció oldalon adatok megadása és kattintás a „Get started free” gombra
2.10 Kattintás az oldal alján a „Skip” linkre
2.11 Kattintás az oldal alján a „Dismiss” linkre
2.12 Megjelenik a MongoDB Atlas áttekintő oldala
2.13 Kattintás az oldal tetején a beállítások (fogaskerék) ikonra
2.14 Megjelenik a szervezeti beállítások oldal
2.15 Görgetés lefelé az oldalon a Connect to mLab részhez és kattintás a „Connect to mLab” gombra
2.16 Megjelenő mLab kapcsolódási oldalon kattintás az „Authorize” gombra
2.17 Kattintás az mLab adatbázis másolása sor végén a „…” ikonra, majd a „Configure Migration” gombra
2.18 Kattintás a Target Project résznél a „Create or Select Target Project” gombra
2.19 Kattintás a Project alatti lefele nyílra, majd kattintás a lenyíló listában a „Create New Project” elemre
2.20 Tetszőleges megnevezés begépelése a projektnek (pl. nightscout), majd kattintás a „Confirm Project And Continue” gombra
2.21 Kattintás az „Import Database Users And Continue” gombra
2.22 Az „Allow all IP addresses …” opció legyen kipipálva és kattintás az „Allow All And Continue” gombra
2.23 Kattintás a Cluster alatti lefele nyílra, majd kattintás a lenyíló listában a „Create most equivalent cluster” elemre
2.24 A Cluster Name (cluster neve) szabadon módosítható (nem kötelező módosítani, de segíthet az eligazodásban), a Cluster Tier az M0 legyen (ingyenes szint), majd kattintás a „Confirm Target And Continue” gombra
2.25 Megjelenik a Cluster létrehozása folyamatban, ez néhány percig is eltarthat
2.26 Cluster létrehozva figyelmeztetésekkel
2.27 Görgetés lefelé a Migrate Deployment részhez és a Confirm résznél kattintás a „Confirm Source and Target” gombra
2.28 Felugró ablakban kattintás a „Confirma and Continue” gombra
2.29 Kattintás a „Begin Test Run” gombra
2.30 Megkezdődik a teszt másolási fut, ez percekig tarthat
2.31 Teszt másolás befejeződése után kattintás a „Confirm Connectivity” gombra
2.32 Felugró ablakban kattintás „Copy” gombra, ezzel az adatbáziselérési útvonal másolásra kerül a vágólapra
2.33 Valamilyen szövegszerkesztő (pl. jegyzettömb) megnyitása
2.34 Atlas adatbáziselérési útvonal beillesztése szövegszerkesztőbe vágólapról pl. CTRL+V vagy jobb klikk és beillesztésre kattintás
2.35 Atlas adatbáziselérési útvonalat tartalmazó szövegfájl mentése (később lesz rá szükség)
2.36 Kattintás az oldal alján a „Confirm And Continue” gombra
2.37 Kattintás az oldalán alján a lefele nyilra és a lenyíló listából a „Confirm And Close” elem kiválasztása
2.38 Kattintás a Migrate résznél a „Review Process and Begin” gombra
2.39 A felugró ablak alján az „I understand that ..” résznél lévő jelölőmező legyen bejelölve és kattintás a „Begin Migration” gombra
2.40 Megkezdődik a tényleges másolás, ez percekig tarthat
2.41 A másolás befejezése után kattintás a Change Connectio String résznél a „Start Using Atlas” gombra
2.42 Kattintás az „I’m done gombra”
2.43 Az „I understand …”, továbbá a „I am not …” jelölőmezők bejelölése és kattintás a „Confirm And Close” gombra
2.44 Megjelenik a másolási projekt befejeződött státusszal
2.45 Visszatérés Heroku lapra a böngészőben és kattintás „Settings” linkre
2.46 A Config Vars résznél kattintás a „Reveal Config Vars” gombra
2.47 A megjelenő Nightscout paraméterek között görgetés lefelé a MONGODB_URI paraméterig
2.48 Jobb klikk a paraméter értékét tartalmazó mezőn (mongodb://…) és kattintás a böngésző funkciólistában „Másolás” („Copy”) funkcióra, ezzel a korábbi mLab adatbáziselérési útvonal másolásra kerül a vágólapra
2.49 Valamilyen szövegszerkesztő (pl. jegyzettömb) megnyitása
2.50 Vágólapra helyezett mLab adatbáziselérési útvonal beillesztése szövegszerkesztőbe vágólapról pl. CTRL+V vagy jobb klikk és beillesztésre kattintás
2.51 mLab adatbáziselérési útvonalat tartalmazó szövegfájl mentése
2.52 mLab adatbáziselérési útvonalban az adatbázisjelszó meghatározása és kijelölése
Az mLab adatbáziselérési útvonalban az adatbázisjelszó a „:” és „@” jelek közötti rész, ezt kell kijelölni a szövegfájlban a „:” és „@” jelek nélkül!
2.53 mLab adatbázisjelszó másolása vágólapra pl. jobb klikk + másolás funkció kiválasztása vagy CTRL+C billentyűkombinációval
2.54 Atlas adatbáziselérési útvonalat tartalmazó szövegfájl megnyitása
Az Atlas adatbáziselérési útvonal „mongodb+srv://”-el kezdődik.
2.55 Atlas adatbáziselérési útvonvalban a jelszó helyét jelző <password> rész megkeresése
2.56 Atlas adatbáziselérési útvonvalban a jelszó helyét jelző <password> törlése
2.57 mLab adatbáziselérési útvonvalból kimásolt adatbázisjelszó beillesztése az Atlas Atlas adatbáziselérsi útvonvalba a kitörölt a jelszó helyét jelző <password> helyére
Az Atlas adatbáziselérési útvonalban az adatbázisjelszó ugyanúgy a „:” és „@” jelek közötti rész, mint az mLab adatbáziselérési útvonalban!
2.58 Az összeállított jelszót is tartalmazó teljes Atlas adatbáziselérési útvonal kijelölése és másolása vágólapra pl. jobb klikk + másolás funkció kiválasztása vagy CTRL+C billentyűkombinációval
A teljes Atlas adatbáziselérési útvonalat kell a vágólapra másolni, tehát a „mongodb+srv://”-el kezdődően egészen a „w=majority”-ig bezárólag!
2.59 Visszatérés a Heroku MONGODB_URI paraméterhez és kattintás a ceruza ikonra
2.60 MONGODB_URI paraméterben az mLab adatbáziselérési útvonal kitörlése
2.61 Az összeállított jelszót is tartalmazó teljes Atlas adatbáziselérési útvonal beillesztése az mLab adatbáziselérési útvonal helyére a vágólapról pl. jobb klikk és beillesztés vagy CTRL+V billentyűkombinációval
2.62 Kattintás a „Save changes” gombra
2.63 Görgetés lefelé a Maintenance Mode részhez és kattintás a Maintenance mode váltó gombra
2.64 Felugró ablakban kattintás a „Disable Maintenance Mode” gombra
2.65 Görgetés vissza az oldal tetejére és kattintás a „More” gombra
2.66 Felugró listában kattintás a „Restart all dynos” elemre
2.67 Felugró ablakban a „Restart all dynos” gombra
2.68 Kb. 5 – 10 percet érdemes várni, amíg újraindul a Nightscout webalkalmazás
2.69 Nightscout webalkalmazás megnyitása
Ha minden lépés megfelelően végrehajtásra került, akkor megjelenik a Nightscout weboldal.