# Bithouse Actiweb käyttöönotto

# Esittely: Actiweb-ohjelmiston osat

<span lang="fi-FI">Actiweb-ohjelmisto koostuu seuraavista osista:</span>

[![image-1653907171470.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907171470.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907171470.png)

#####  

##### **Käyttöjärjestelmä (Linux)**

<span lang="fi-FI">Actiwebin käyttöjärjestelmä on Bithousen kääntämä Linux-jakelu</span>

<span lang="fi-FI">*Laillinen huomio:   
Järjestelmä käyttää seuraavia GNU General Public License -ohjelmia.*</span>

<table border="1" id="bkmrk-ohjelma-url-gnu-gene" style="border-collapse: collapse; width: 100%; height: 206.75px;"><tbody><tr style="height: 29.7969px;"><td style="width: 49.9383%; height: 29.7969px;">**Ohjelma**</td><td style="width: 49.9383%; height: 29.7969px;">**URL**</td></tr><tr style="height: 35.3906px;"><td style="width: 49.9383%; height: 35.3906px;">GNU General Public Lisenssi

</td><td style="width: 49.9383%; height: 35.3906px;">http://www.gnu.org/licenses/gpl-3.0.html

</td></tr><tr style="height: 35.3906px;"><td style="width: 49.9383%; height: 35.3906px;">Linux kernel

</td><td style="width: 49.9383%; height: 35.3906px;">https://github.com/beagleboard/linux

</td></tr><tr style="height: 35.3906px;"><td style="width: 49.9383%; height: 35.3906px;">BusyBox

</td><td style="width: 49.9383%; height: 35.3906px;">https://busybox.net/source.html

</td></tr><tr style="height: 35.3906px;"><td style="width: 49.9383%; height: 35.3906px;">Buildroot

</td><td style="width: 49.9383%; height: 35.3906px;">https://buildroot.uclibc.org/download.html

</td></tr><tr style="height: 35.3906px;"><td style="width: 49.9383%; height: 35.3906px;">U-Boot

</td><td style="width: 49.9383%; height: 35.3906px;">https://www.denx.de/wiki/U-Boot/SourceCode

</td></tr></tbody></table>

##### **SLC Engine**

<span lang="fi-FI">SLC Engine yhdistää järjestelmän muut osat toisiinsa. Se tekee seuraavia asioita:</span>

- <span lang="fi-FI">Käynnistää kohdekohtaisen sovellusohjelman ja varmistaa, että se on aina käynnissä</span>
- <span lang="en-US">Vastaa web-käyttöliittymän kyselyihin</span>
- <span lang="fi-FI">Siirtää dataa I/O-moduleille</span>
- <span lang="fi-FI">Siirtää dataa tietokantaan</span>

##### **<span lang="fi-FI">Sovellusohjelma</span>**

<span lang="fi-FI">Kohdekohtainen sovellusohjelma pyörii SLC Enginen päällä. Se koostuu seuraavista osista:</span>

- <span lang="fi-FI">Logiikkaohjelma Ohjaa mitä järjestelmä tekee</span>
- <span lang="fi-FI">Web-käyttöliittymäsivut Visualisointi järjestelmän seuraamista ja ohjaamista varten</span>

##### **<span lang="fi-FI">Tietokanta(SQLite)</span>**

<span lang="fi-FI">Tietokannan rakenne näkyy Admin-pääkäyttäjälle sivulla </span>*<span lang="fi-FI">Järjestelmä &gt; Tietokanta</span>*<span lang="fi-FI"> puumallisena, mutta objektit tallennetaan taulukkoon peräkkäin sarjana. Eri tasot erotetaan toisillaan objektin nimessä olevalla ”</span><span lang="fi-FI">**/**</span><span lang="fi-FI">”-merkillä.</span>

[![image-1653907367773.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907367773.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907367773.png)

<span lang="fi-FI">  
Esimerkiksi </span><span lang="fi-FI">**bacnetSettings**</span><span lang="fi-FI"> on objekti, jolla on viisi propertyä:</span>

[![image-1653907388377.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907388377.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907388377.png)

# Käyttöliittymään kirjautuminen

##### **Aseta tietokoneesi samaan aliverkkoon**

<span lang="fi-FI">Jotta käyttöliittymään pääsee käsiksi lähiverkostoa (LAN), niin tietokoneen (tai tabletin tms) täytyy olla samassa aliverkossa kuin Actiweb-CPU. Internet-käyttöä varten asetuksia ei tarvitse muuttaa, vaan se onnistuu menemällä urakoitsijan tarjoamaan osoitteeseen. Aliverkon oletusasetukset ovat:</span>

<table border="1" id="bkmrk-ip-192.168.0.128-gat" style="border-collapse: collapse; width: 100%; height: 100.578px;"><tbody><tr style="height: 35.3906px;"><td style="width: 49.9383%; height: 35.3906px;">IP

</td><td style="width: 49.9383%; height: 35.3906px;">192.168.0.128

</td></tr><tr style="height: 35.3906px;"><td style="width: 49.9383%; height: 35.3906px;">Gateway

</td><td style="width: 49.9383%; height: 35.3906px;">192.168.0.1

</td></tr><tr style="height: 29.7969px;"><td style="width: 49.9383%; height: 29.7969px;">Netmask

</td><td style="width: 49.9383%; height: 29.7969px;">255.255.255.0

</td></tr></tbody></table>

<span lang="fi-FI">Alla on esitetty esimerkkisetukset Windowsin verkkoyhteydelle.</span>

[![image-1653907480322.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907480322.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907480322.png)  
  
*<span style="font-size: small;"><span lang="en-US">(Control Panel\\Network and Internet\\Network Connections\\Properties\\IPv4\\Properties)</span></span>*

<span lang="fi-FI">Kun tietokone on samassa aliverkossa Actiweb-CPU:n kanssa, pääsee järjestelmän etusivulle osoitteesta </span>*<span lang="fi-FI">http:// 192.168.0.128</span>*<span lang="fi-FI">.</span>

##### **<span lang="fi-FI">  
Valitse kieli, käyttäjänimi ja salasana</span>**

<span lang="fi-FI">Kirjautumisruudussa näkyy kohteen verkkoyhteyden hostname (yleensä kohteen nimi, oletus </span><span lang="fi-FI">*slc-engine*</span><span lang="fi-FI">), sekä valinnat kieli, käyttäjä ja salasana. Kirjaudu valitsemalla ensin kieli, ja sitten käyttäjä/salasana ja painamalla Tervetuloa-nappia.</span>

<span lang="fi-FI">Oletussalasana on saatavilla Actiweb-urakoitsijoille ja partnereille.</span>

[![image-1653907549541.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907549541.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907549541.png)

#####  **Navigoi halutulle sivulle ylämenun avulla**

<span lang="fi-FI">Kirjautumisen jälkeen järjestelmässä näkyy kotisivu ja ylämenu. Ylämenu koostuu seuraavista osista:</span>

[![image-1653907580743.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907580743.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907580743.png)

<span lang="fi-FI">Esimerkkikuvassa kansion </span>*<span lang="fi-FI">Järjestelmä</span>*<span lang="fi-FI"> alla on sivu </span>*<span lang="fi-FI">Tietokanta</span>*<span lang="fi-FI">. Kansiot erottuvat sivuista painikkeen oikeassa laidassa olevan nuolen avulla.</span>

<span lang="fi-FI">Jotkut kansiot/sivut eivät näy kaikille käyttäjille käyttäjän tason mukaan.</span>

# Järjestelmän asetukset

##### **Verkkoasetukset**

<span lang="fi-FI">Verkkoasetusten muokkaamisen jälkeen paina </span>*<span lang="fi-FI">Muuta</span>*<span lang="fi-FI">-painiketta, jollain järjestelmä ottaa heti käyttöön uudet verkkoasetukset. Yhteys järjestelmään siis katkeaa.</span>

<span lang="fi-FI">Järjestelmää ei pidä kytkeä suoraan internetiin – eli ei ilman palomuuria tai reititintä. BACnet-standardin mukaisesti UDP-portti 47808 on täysin avoin, ja siihen saa kirjoittaa mikä tahansa laite.</span>

<span lang="fi-FI">Järjestelmään kannattaa ohjata seuraavat portit käyttäen reitittimen portinohjaustoimintoa:</span>

- <span lang="fi-FI">80 HTTP-käyttöliittymä</span>
- <span lang="fi-FI">22 SSH- ja SFTP-yhteys</span>

##### **<span lang="fi-FI">  
Muut asetukset</span>**

<span lang="fi-FI">Asetusten muokkaamisen jälkeen paina painiketta </span>*<span lang="fi-FI">Tallenna tietokanta</span>*<span lang="fi-FI">. Tietokanta tallentuu myös itsestään tietyn ajanjakson välein.</span>

<span lang="fi-FI">Voit käynnistää järjestelmän uudelleen painikkeesta </span>*<span lang="fi-FI">Uudelleenkäynnistä laite</span>*<span lang="fi-FI">, tai pelkän SLC Enginen painikkeesta </span>*<span lang="fi-FI">Uudelleenkäynnistä ohjelma</span>*<span lang="fi-FI">.</span>

[![image-1653907688416.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907688416.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907688416.png)

# Käyttäjähallinta

<span lang="fi-FI">Käyttäjiä pääsee muokkaamaan kohdasta </span>*<span lang="fi-FI">Järjestelmä &gt; Käyttäjähallinta</span>*<span lang="fi-FI">.</span>

<span lang="fi-FI">Käyttäjälle voi antaa käyttäjätason ja -ryhmän. Niillä voidaan rajoittaa mitä sivuja (tai sivun osia) käyttäjälle näkyy.</span>

[![image-1653907715174.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907715174.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907715174.png)

# Historia

##### **Pikatrendit (lyhyen ajan trendit)**

<span lang="fi-FI">Jokaiselle järjestelmän objektille, jolla on property ”pv” (present value) tehdään pikatrendi. Pikatrendissä on vain viimeisimmät tiedot, eikä se ulotu pitkälle historiaan.</span>

<span lang="fi-FI">Pikatrendit näkee kohdasta </span>*<span lang="fi-FI">Historia &gt; Pikatrendit:</span>*

[![image-1653907748501.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907748501.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907748501.png)

##### **Raportit (pidemmän ajan trendit)**  


<span lang="fi-FI">Jotta historiaa voidaan tarkastella pidemmältä aikajaksolta, pitää tehdä kaksi asiaa:</span>

1. <span lang="fi-FI">Järjestelmä pitää erikseen määritellä tallentamaan pidemmän ajan historiaa, eli </span><span lang="fi-FI">**trendilokia**</span><span lang="fi-FI">.</span>
2. <a name="_GoBack"></a> <span lang="fi-FI">Trendilokiin tallennetuista tiedoista tehdään </span><span lang="fi-FI">**raportteja**</span><span lang="fi-FI">.</span>

##### **<span lang="fi-FI">Uuden trendilokin luominen</span>**

<span lang="fi-FI">Uusi trendiloki luodaan luomalla </span>*<span lang="fi-FI">trendlog</span>*<span lang="fi-FI">-tyyppinen tietokantaobjekti kohdassa </span>*<span lang="fi-FI">Järjestelmä &gt; Tietokanta</span>* painikkeesta *<span lang="fi-FI">+ new</span>*<span lang="fi-FI">.</span>

[![image-1653907966428.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907966428.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907966428.png)

<span lang="fi-FI">Kyseiseen trendilokiin saa lisättyä pisteitä luodun tietokantaobjektin propertyssä </span>*<span lang="fi-FI">pointList</span>*<span lang="fi-FI">.</span>

[![image-1653907978599.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653907978599.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653907978599.png)

#####   


##### **<span lang="fi-FI">Uuden raportin luominen</span>**

<span lang="fi-FI">Uusi raportti luodaan samalla tavalla, mutta objekti on tyyppiä </span>*<span lang="fi-FI">report</span>*<span lang="fi-FI">.</span>

[![image-1653908013176.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653908013176.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653908013176.png)

<span lang="fi-FI">Raporttiin voidaan määritellä pisteitä uuden tietokantapisteen kohdasta </span>*<span lang="fi-FI">dataSeries</span>*<span lang="fi-FI">.</span>

[![image-1653908024713.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653908024713.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653908024713.png)

[![image-1653908051675.png](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/scaled-1680-/image-1653908051675.png)](https://wiki.bithouse.fi/uploads/images/gallery/2022-05/image-1653908051675.png)