Nightscout telepítése

A Nightscout webalkalmazás tetszőleges Node.js + MongoDB környezetben telepíthető, az alábbiakban található Heroku környezetben való telepítési mód a javasolt nem IT szakemberek számára.

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.

A telepítés során létrehozott minden fiókhoz (mongoDB Atlas, Heroku, Github) tartozó felhasználónevet és jelszót jegyezzünk fel!

1. MongoDB Atlas fiók létrehozása

A MongoDB Atlas adatbáziszolgáltatásban létrehozott fiók fog szolgálni a saját Nightscout webalkalmazás adatbázisának.

1.1 MongoDB Atlas kezdőoldalának megnyitása böngészőben: https://www.mongodb.com/cloud/atlas

1.2 Kattintás a „Start free” gombra (ingyenes fiók létrehozása)

1.3 Megjelenő regisztráció oldalon adatok megadása és Kattintás a „Get started free” gombra

1.4 Kattintás a Shared Clusters / „Create a cluster” gombra (FREE fölötti!)

1.5 Megjelennek a létrehozásra kerülő Cluster jellemzői

1.6 Felhőszolgáltató és régió kiválasztása (nem kötelező módosítani az alapértelmezett értékeket)

1.7 Cluster Tier-nél M0 Sandbox legyen kiválasztva

Ez az ingyenes szint, ha a megfelelő típusú Cluster lett kiválasztva, akkor automatikusan ez került kiválasztásra.

1.8 Cluster Name (Cluster neve) szabadon megadható (nem kötelező módosítani, de segíthet az eligazodásban)

1.9 Cluster létrehozása „Create Cluster” gombra kattintva

1.10 Megjelenik a Cluster létrehozása folyamatban (cluster is being created…), ez több percig eltarthat!

1.11 Létrejött a Cluster, megjelennek a Cluster főbb adatai

1.12 Kattintás a „CONNECT” gombra

1.13 Kattintás az „Allow Access from Anywhere” gombra

1.14 Kattintás az „Add IP Address” gombra

1.15 Tetszőleges adatbázis felhasználónév és jelszó megadása, majd kattintás a „Create Database User” gombra

1.16 Kattintás a „Choose a connection method” gombra

1.17 Kattintás a „Connect your application” gombra

1.18 Driver típusa „Node.js” legyen (ez az alapértelmezett)

1.19 Kattintás „Copy” gombra, ezzel az adatbáziselérési útvonal másolásra kerül a vágólapra

1.20 Valamilyen szövegszerkesztő (pl. jegyzettömb) megnyitása

1.21 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

1.22 Jelszót és adatbázisnevet is tartalmazó adatbázis elérési útvonal összeállítása

<password> : korábban megadott adatbázis felhasználó jelszava
<dbname> : tetszőleges adatbázisnév, pl. nightscout
Ha például a beillesztett adatbázis útvonal:
mongodb+srv://nightscout:<password>@nightscout.iqbic.mongodb.net/<dbname>?retryWrites=true&w=majority
és a korábban megadott adatbázis jelszó pedig:
jelszo123456
a választott adatbázisnév pedig:
nightscout
akkor a jelszót is tartalmazó adatbázis elérési útvonal:
mongodb+srv://nightscout:jelszo123456@nightscout.iqbic.mongodb.net/nightscout?retryWrites=true&w=majority

Az adatbázis elérési útvonalban nem lehet szóköz, sem előtte, sem benne, sem a végén, az összes „<” és „>” jelet törölni kell. Amennyiben nem sikerült beilleszteni a vágólapról vagy véletlenül törölésre kerül egy része, akkor akár később is bármikor újra belépve a MongoDB Atlas fiókba és azon belül a létrehozott Cluster-nél a “Connect” gombra kattintva újra el tudunk jutni az adatbázis elérési útvonal megjelenítéséhez és onnan újra ki tudjuk azt másolni.

1.23 Jelszót és adatbázisnevet is tartalmazó adatbázis elérési útvonal elmentése szövegfájlként

Az elérési útvonalra a Nightscout webalkalmazás létrehozásánál lesz később szükség, ezt kell majd megadni MONGODB_URI paraméter értékének, ezért célszerű azt elmenteni.

2. Heroku fiók létrehozása

A Heroku felhőszolgáltatónál való fiók fog szolgálni a saját Nightscout webalkalmazás futtatására.

A Heroku fiók létrehozása és ebben a Nightscout alkalmazás használata jelenleg teljesen ingyenes, ugyanakkor telepítéskor bankkártyaadatok megadására szükség lesz, enélkül nem lesz telepíthető a Nigthscout webalkalmazás!

2.1 Heroku kezdőoldalának megnyitása böngészőben: https://www.heroku.com

2.2 Kattintás „SIGN UP FOR FREE” gombra (ingyenes regisztráció)

2.3 Megjelenő regisztrációs oldalon adatok megadása

keresztnév
vezetéknév
emailcím (létező emailcím, erre fog érkezni a regisztráció visszaigazolási email)
szerep (tetszőleges, pl. Student)
ország
elsődleges programozási nyelv (tetszőleges, pl. Java)
nem vagyok robot megjelőlése és szükség esetén ehhez kapcsolódó feladatok elvégzése
kattintás a „CREATE FREE ACCOUNT” gombra

2.4 Megjelenik az értesítő oldal regisztráció visszaigazolási email elküldéséről

2.5 Regisztrációnál megadott emailfiók megnyitása

2.6 Beérkezett emailcím visszaigazolási levél megnyitása

2.7 Kattintás beérkezett levélben a visszaigazolási link-re

2.8 Linkre való kattintás után megjelenik a létrehozott új fiókhoz való jelszómegadási oldal

2.9 Jelszó megadása és kattintás a „SET PASSWORD AND LOG IN” gombra

2.10 Üdvözlő oldalon kattinás a „CLICK HERE TO PROCEED” gombra

2.11 Megjelenik a Heroku alkalmazáskezelő oldala

2.12 Kattintás avatar ikonra

2.13 Személyes beállítások listában kattintás „Account settings” gombra

2.14 Kattintás a bankkártya ikonra

2.15 Kattintás az „Add credit card” gombra

2.16 Bankkártya adatok megadása és kattintás a „Save Details” gombra

A megadott bankkártya nem kerül megterhelésre, mivel a Nightscout webalkalmazás erőforráshasználata belefér az ingyenes Heroku limitbe.

3. Github fiók létrehozása

3.1 Github kezdőoldalának megnyitása böngészőben: https://github.com/

3.2 Regisztrációs ablakban adatok megadása

felhasználónév: választott felhasználónév
emailcím: létező emailcím, erre fog érkezni a regisztráció visszaigazolási email
jelszó
kattintás a „Sign up for GitHub” gombra

3.3 Valós regisztráció igazolása, ingyenes fiók létrehozása

ember által történő regisztráció bizonyításához feladat megoldása
kattintás a „Join a free plan” gombra

3.4 Görgetés oldal aljára és kattintás „Complete setup” gombra

3.5 Regisztrációnál megadott emailfiók megnyitása

3.6 Beérkezett emailcím visszaigazolási levél megnyitása

3.7 Kattintás beérkezett levélben a visszaigazolási linkre

3.8 Linkre való kattintás után megtörténik az emailcím visszaigazolása

4. Nightscout webalkalmazás létrehozása

4.1 Eredeti Nightscout GitHub forrás megnyitása böngészőben: https://github.com/nightscout/cgm-remote-monitor

4.2 Bejelentkezés saját GitHub felhasználóval, amennyiben a GitHub regisztráció visszaigazolásakor való bejelentkezés időközben már lezáródott

Kattintás „Sign in” (Bejelentkezés) linkre

4.3 Github bejelentkezési adatok megadása

Emailcím vagy felhasználónév
Jelszó
Sign in (Bejelentkezés) gomb lenyomása

4.4 Saját másolat létrehozása a „Fork” gombra való kattintással

4.5 Megjelenik a másolat létrehozása folyamatban oldal

4.6 Másolás végén megjelenik a saját másolat oldala

4.7 Görgetés az oldal végére és kattintás a „Deploy to Heroku” gombra

4.8 Bejelentkezés saját Heroku felhasználóval, amennyiben a Heroku regisztráció visszaigazolásakor való bejelentkezés időközben már lezáródott

Kattintás „Log In” gombra

4.9 Bejelentkezési adatok megadása

Emailcím
Jelszó
“Log In” (Bejelentkezé) gomb lenyomás

4.10 Megjelenik az új webalkalmazás létrehozási oldal

4.11 Alkalmazás alapadatainak megadása

alkalmazás neve: egy egyedi, még nem létező nevet kell választani, ezt a rendszer automatikusan ellenőrzi és csak akkor fogadja el, ha valóban nincs még egy ugyanilyen nevű alkalmazás, ezt egy zöld pipával jelzi
Europa régió kiválasztása

4.12 Alkalmazás paramétereinek megadása

API_SECRET: szabadon választott Nightscout API jelszó, aminek legalább 12 karakter hosszúnek kell lennie

Fontos! Erre a jelszó később szükség lesz a weboldal beállításánál és a mobiltelefon alkalmazásban is meg kell ezt adni.

DISPLAY_UNIT: vércukor mértékegysége, értéke: mmol

ENABLE: használni kíván funkciók, értéke
Paraméterek részletes leírása és javasolt értékei a Nightscout paraméterek oldalakon.
Minimed 640G esetén jellemzően: careportal upbat devicestatus bage basal iob cage sage iage pump cors dbsize
Guardian Connect esetén jellemzően: careportal upbat devicestatus basal iob sage cors dbsize

MONGODB_URI: a MongoDB Atlas telepítése során összeállított adatbáziselérési útvonal

4.13 Görgetés az oldal aljára és alkalmazás létrehozásának elindítása a „Deploy app” gombra való kattintással

4.13 Alkalmazás létrehozása megkezdődik

4.14 Értesítés alkalmazás sikeres telepítéséről

5. Saját Nigthscout weboldal megnyitása és beállítása

5.1 Saját Nightscout oldal megnyitása böngészőben: alkalmazásnév.herokuapp.com

A Heroku alkalmazás létrehozásának elején megadott egyedi alkalmazásnév + .herokuapp.com, pl. ha az alkalmazás neve nightscoutdemo, akkor a böngészőben a következőt kell beírni: nightscoutdemo.herokuapp.com

5.2 Figyelmeztető ablak jelenik meg profil létrehozására

Ez az ablak mindig megjelenik, amíg nem kerül beállításra és elmentésre a profil.