Ero sivun ”Aprsg” versioiden välillä

Radioamatööriwikistä
Siirry navigaatioon Siirry hakuun
>Oh2gve
(Ak: Uusi sivu: <div class="floatright">__TOC__</div> '''aprsg''' on yksinkertainen iGate-ohjelma Linuxin kaltaisille käyttöjärjestelmille. Tärkeimmät ominaisuudet: * Pakettien v...)
 
>Oh2gve
(Ohjeet version 1.0 tasalle.)
 
(14 välissä olevaa versiota samalta käyttäjältä ei näytetä)
Rivi 1: Rivi 1:
<div class="floatright">__TOC__</div>
<div class="floatright">__TOC__</div>
'''aprsg''' on yksinkertainen [[APRS_iGate|iGate]]-ohjelma Linuxin kaltaisille käyttöjärjestelmille.
'''aprsg''' eli APRS Gateway on [[APRS_iGate|IGate]]ohjelma Windowsille ja Unixin kaltaisille käyttöjärjestelmille.


Tärkeimmät ominaisuudet:
Tärkeimmät ominaisuudet:
* Pakettien vastaanotto yhdeltä tai useammalta TNC:ltä sarjaportin kautta
* APRS-pakettien välittäminen lähetys ja vastaanotto sarjaporttiin kytkettyä KISS TNC:tä käyttäen
* Pakettien vastaanotto ja lähetys yhdeltä tai useammalta KISS TNC:ltä sarjaportin kautta
* Pakettien välittäminen netistä bandille tai portista toiseen kutsun ja/tai lähettäjän sijainnin mukaan suodatettuna
* Kuultujen pakettien lähettäminen annetulle [[APRS-IS]]-palvelimelle.
* Mahdollisuus vaihtaa APRS-IS-palvelinta automaattisesti, jos yhteyttä ensisijaiseen palvelimeen ei saada
* Välitettyjen pakettien kirjaus lokitiedostoihin


Ohjelmalla on myös virallinen kotisivu osoitteessa http://oh3tr.ele.tut.fi/~oh2gve/aprsg, mutta siellä ei ole juuri mitään nähtävää.
Ohjelman kotisivu on osoitteessa http://pakettiradio.net/aprsg/.


==Asentaminen==
==Asentaminen==


===Debianiin===
Tuorein versio on saatavilla osoitteesta http://pakettiradio.net/downloads/aprsg/.


'''aprsg'''n asentaminen Debian GNU/Linuxiin on helppoa, sillä sille on tarjolla valmiit asennuspaketit. Allakuvatussa asennusprosessissa mainitut komennot wgettiä lukuunottamatta vaativat ylläpitäjän (root) oikeudet järjestelmään.
===Windows===


Nouda tuorein zip-paketti, pura se ja lue README.txt.


Ensimmäiseksi järjestelmäsi pakettienhallinnalle pitää kertoa aprsg:n pakettivaraston sijainti ja avain, jotta se osaa asentaa sieltä paketteja. Sijainnin kertominen tapahtuu lisäämällä seuraavat rivit tiedostoon /etc/apt/sources.list.
===Debian ja Ubuntu===
deb <nowiki>http://oh3tr.ele.tut.fi/~oh2gve/aprsg/debian</nowiki> etch main
deb-src <nowiki>http://oh3tr.ele.tut.fi/~oh2gve/aprsg/debian</nowiki> etch main


Hae pakettivaraston allekirjoitukseen käytetty avain osoitteesta http://oh3tr.ele.tut.fi/~oh2gve/oh2gve-public_key.asc  komentamalla esimerkiksi
Nouda tuorein deb-paketti (i386 = 32-bittinen, amd64 = 64-bittinen) ja asenna se. Lisäksi tarvitset tuoreimman libfapin, joka löytyy osoitteesta http://pakettiradio.net/downloads/libfap/. Kummastakin riittää normaalikäytössä yksi paketti. Jos tarvitset -dev, -dbg, tai -doc -päätteisiä paketteja tarvitaan vain sovelluskehityksen yhteydessä.
wget <nowiki>http://oh3tr.ele.tut.fi/~oh2gve/oh2gve-public_key.asc</nowiki>
ja lisää se pakettienhallintasi luotettuihin avaimiin komennolla
apt-key add oh2gve-public_key.asc
Tiedoston oh2gve-public_key.asc voi tämän jälkeen poistaa.


Päivitä pakettienhallintasi komentamalla
Asennuksen yhteydessä saatat saada varoituksia puuttuvista paketeista, jotka aprsg tarvitsee. Katso tällöin pakettien nimet virheilmoituksesta ja asenna ne haluamallasi pakettienhallintatyökalulla, esim aptitudella tai Synapticsilla.
aptitude update


====Asetukset ja käynnistäminen====


Nyt pakettienhallinnalla on tieto aprsg:n paketeista, joten varsinainen asennus voi alkaa. Asenna aprsg komentamalla
Asennuksen jälkeen vuorossa on asetusten teko, joka tapahtuu luomalla asetustiedosto /etc/aprsg/aprsg.conf. Luominen tapahtuu helpoiten kopiomalla se jostain samassa hakemistossa olevasta esimerkkiasetustiedostostaja muokkaamalla sitä tiedostossa olevien kommenttien ja tarvittaessa [[#Konfigurointi|ohjeiden]] mukaan.
aptitude install aprsg
 
Asennus on nyt valmis. Tämän jälkeen vuorossa on asetusten teko, joka tapahtuu muokkaamalla asetustiedostoa /etc/aprsg.conf siellä olevien ohjeiden mukaan.


Konfiguroitu aprsg käynnistyy komennolla
Konfiguroitu aprsg käynnistyy komennolla
  /etc/init.d/aprsg start
  /etc/init.d/aprsg start


Tarkkaile igatesi toimintaa! Lokitiedostot ovat varmasti avuksi tässä vaiheessa, vaikka niiden keräämisestä myöhemmin haluaisit luopuakin.
Tarkkaile IGatesi toimintaa! Lokitiedostot ovat avuksi tässä vaiheessa, vaikka niiden keräämisestä myöhemmin haluaisit esimerkiksi levytilan säästämiseksi luopuakin. Pääteikkunaan tulostuvat vain muutamat käynnistymisen estävät virheet, kaikki muut tulevat lokitiedostoon.


====Poistaminen====
Koska aprsg on asennettuna pakettienhallinnan kautta, voit poistaa sen haluamallasi pakettienhallintatyökalulla. Esimerkiksi siis komentamalla roottina


Koska aprsg on nyt asennettuna Debianin pakettienhallinnan kautta, sen päivitykset asentuvat samalla kun muutenkin päivität järjestelmääsi. Siis esimerkiksi komentaessasi
aptitude update
aptitude upgrade
Ja mikä parasta, aprsg:n poistaminen on myös erittäin helppoa:
  aptitude purge aprsg
  aptitude purge aprsg


===Lähdekoodeista kääntämällä===
===Lähdekoodeista kääntämällä===


'''aprsg''' tarvitsee kääntyäkseen ja toimiakseen wxWidgets- ja Communication Toolbox -kirjastot. Kehitysalustassa on wxWidgetsin versio 2.6.3.2.1.5, mutta koodi saattaa kääntyä muitakin versioita vastaan. Kirjaston saat osoitteesta http://www.wxwidgets.org/downloads/. Jos joudut/päädyt kääntämään kirjaston itse, kannattanee jättää graafiset osat kääntämättä (--disable-gui), sillä aprsg ei niitä tarvitse. Communication Toolboxista (lyh. wxtcb) käytämme versiota 0.9, jonka saat osoitteesta http://downloads.sourceforge.net/wxcode/wxctb-0.9.tar.gz.
'''aprsg''' tarvitsee kääntyäkseen ja toimiakseen wxWidgets- ja libfap-kirjastot. WxWidgetsin versio on syytä olla 2.8.4 tai tuoreempi, libfapin 0.8 tai tuoreempi. Jos käyttöjärjestelmäsi ei sisällä valmiita paketteja kirjastoille, hae lähdekoodit osoitteista http://www.wxwidgets.org/downloads/ ja http://pakettiradio.net/downloads/libfap/. Jos joudut/päädyt kääntämään wxWidgets-kirjaston itse, kannattanee jättää graafiset osat kääntämättä (--disable-gui), sillä aprsg ei niitä tarvitse. Tarvittavat modulit ovat base ja net.


Kun edellämainitut kirjastot on asennettu ja tähdet ovat taivaalla oikeissa paikoissa, kääntämisprosessin pitäisi sujua normaaliin tapaan:
Kun edellämainitut kirjastot on asennettu ja tähdet ovat taivaalla oikeissa paikoissa, kääntämisprosessin pitäisi sujua normaaliin tapaan:
  tar xvzf aprsg-<versio>.tar.gz
  tar xvzf aprsg-<versio>.tar.gz
  cd aprsg-<versio>
  cd aprsg-<versio>
  ./configure
  ./configure [--prefix=/opt tai muita optioita]
  make
  make
  make install
  make install
Viimeinen komento tarvitsee kirjoitusoikeudet asennushakemistoon, mikä tarkoittaa usein sitä, että se pitää ajaa roottina.


== Konfigurointi ==
''Pikaopas kiireisille harrastajille''
#''Odota, että kiire menee ohi.''
#''Aloita konfigurointi kaikessa rauhassa ja ajatuksen kanssa ohjeen mukaan.''
'''aprsg'''n konfiguroinnissa kannattaa käyttää pohjana jotain mukana tulevista esimerkkiasetustiedostoista. Ensimmäiseksi kannattaa valita tarpeen mukaan joko sample.conf.rxonly- tai sample.conf.rxtx-tiedosto (Windowsissa conffin tilalla ini), lisätietoja voi katsoa advanced-tiedostosta hankkeen edetessä. Asetustiedoston risuaitamerkillä alkavat rivit ovat kommenttirivejä, joihin on kirjoitettu vinkkejä asetusten tekoon. Lisäksi tiedosto sisältää valmiita asetuksia ja joitakin poiskommentoituja esimerkkiarvoja. Vähimmäiskonfiguraation saa tehtyä helpoiten ottamalla poiskommentoidut asetukset käyttöön ja muokkaamalla esimerkkiarvon omaan käyttöön sopiviksi vinkkien mukaan.
Kun asetukset on tehty, ohjelma lähtee käyntiin komentamalla
aprsg --daemon
tai Windowsissa tuplaklikkaamalla exeä tai deb-paketteja käytettäessä
/etc/init.d/aprsg start
Ohjelman toimintaa on hyvä seurata pakettilokin avulla ainakin jonkin aikaa käynnistyksen jälkeen, jotta asetuksien toimivuudesta päästään varmuuteen. Jos ohjelman toiminnasta löytyy selkeä virhe, ota yhteyttä tekijöihin niin korjaamme asian. Kiitos jo etukäteen!


== Konfigurointi ==


Tuurilla menee.
[[Category:APRS]][[Category:Ohjelmat]]

Nykyinen versio 9. toukokuuta 2010 kello 20.47

aprsg eli APRS Gateway on IGateohjelma Windowsille ja Unixin kaltaisille käyttöjärjestelmille.

Tärkeimmät ominaisuudet:

  • APRS-pakettien välittäminen lähetys ja vastaanotto sarjaporttiin kytkettyä KISS TNC:tä käyttäen
  • Pakettien välittäminen netistä bandille tai portista toiseen kutsun ja/tai lähettäjän sijainnin mukaan suodatettuna
  • Mahdollisuus vaihtaa APRS-IS-palvelinta automaattisesti, jos yhteyttä ensisijaiseen palvelimeen ei saada

Ohjelman kotisivu on osoitteessa http://pakettiradio.net/aprsg/.

Asentaminen

Tuorein versio on saatavilla osoitteesta http://pakettiradio.net/downloads/aprsg/.

Windows

Nouda tuorein zip-paketti, pura se ja lue README.txt.

Debian ja Ubuntu

Nouda tuorein deb-paketti (i386 = 32-bittinen, amd64 = 64-bittinen) ja asenna se. Lisäksi tarvitset tuoreimman libfapin, joka löytyy osoitteesta http://pakettiradio.net/downloads/libfap/. Kummastakin riittää normaalikäytössä yksi paketti. Jos tarvitset -dev, -dbg, tai -doc -päätteisiä paketteja tarvitaan vain sovelluskehityksen yhteydessä.

Asennuksen yhteydessä saatat saada varoituksia puuttuvista paketeista, jotka aprsg tarvitsee. Katso tällöin pakettien nimet virheilmoituksesta ja asenna ne haluamallasi pakettienhallintatyökalulla, esim aptitudella tai Synapticsilla.

Asetukset ja käynnistäminen

Asennuksen jälkeen vuorossa on asetusten teko, joka tapahtuu luomalla asetustiedosto /etc/aprsg/aprsg.conf. Luominen tapahtuu helpoiten kopiomalla se jostain samassa hakemistossa olevasta esimerkkiasetustiedostostaja muokkaamalla sitä tiedostossa olevien kommenttien ja tarvittaessa ohjeiden mukaan.

Konfiguroitu aprsg käynnistyy komennolla

/etc/init.d/aprsg start

Tarkkaile IGatesi toimintaa! Lokitiedostot ovat avuksi tässä vaiheessa, vaikka niiden keräämisestä myöhemmin haluaisit esimerkiksi levytilan säästämiseksi luopuakin. Pääteikkunaan tulostuvat vain muutamat käynnistymisen estävät virheet, kaikki muut tulevat lokitiedostoon.

Poistaminen

Koska aprsg on asennettuna pakettienhallinnan kautta, voit poistaa sen haluamallasi pakettienhallintatyökalulla. Esimerkiksi siis komentamalla roottina

aptitude purge aprsg

Lähdekoodeista kääntämällä

aprsg tarvitsee kääntyäkseen ja toimiakseen wxWidgets- ja libfap-kirjastot. WxWidgetsin versio on syytä olla 2.8.4 tai tuoreempi, libfapin 0.8 tai tuoreempi. Jos käyttöjärjestelmäsi ei sisällä valmiita paketteja kirjastoille, hae lähdekoodit osoitteista http://www.wxwidgets.org/downloads/ ja http://pakettiradio.net/downloads/libfap/. Jos joudut/päädyt kääntämään wxWidgets-kirjaston itse, kannattanee jättää graafiset osat kääntämättä (--disable-gui), sillä aprsg ei niitä tarvitse. Tarvittavat modulit ovat base ja net.

Kun edellämainitut kirjastot on asennettu ja tähdet ovat taivaalla oikeissa paikoissa, kääntämisprosessin pitäisi sujua normaaliin tapaan:

tar xvzf aprsg-<versio>.tar.gz
cd aprsg-<versio>
./configure [--prefix=/opt tai muita optioita]
make
make install

Viimeinen komento tarvitsee kirjoitusoikeudet asennushakemistoon, mikä tarkoittaa usein sitä, että se pitää ajaa roottina.

Konfigurointi

Pikaopas kiireisille harrastajille

  1. Odota, että kiire menee ohi.
  2. Aloita konfigurointi kaikessa rauhassa ja ajatuksen kanssa ohjeen mukaan.

aprsgn konfiguroinnissa kannattaa käyttää pohjana jotain mukana tulevista esimerkkiasetustiedostoista. Ensimmäiseksi kannattaa valita tarpeen mukaan joko sample.conf.rxonly- tai sample.conf.rxtx-tiedosto (Windowsissa conffin tilalla ini), lisätietoja voi katsoa advanced-tiedostosta hankkeen edetessä. Asetustiedoston risuaitamerkillä alkavat rivit ovat kommenttirivejä, joihin on kirjoitettu vinkkejä asetusten tekoon. Lisäksi tiedosto sisältää valmiita asetuksia ja joitakin poiskommentoituja esimerkkiarvoja. Vähimmäiskonfiguraation saa tehtyä helpoiten ottamalla poiskommentoidut asetukset käyttöön ja muokkaamalla esimerkkiarvon omaan käyttöön sopiviksi vinkkien mukaan.

Kun asetukset on tehty, ohjelma lähtee käyntiin komentamalla

aprsg --daemon

tai Windowsissa tuplaklikkaamalla exeä tai deb-paketteja käytettäessä

/etc/init.d/aprsg start

Ohjelman toimintaa on hyvä seurata pakettilokin avulla ainakin jonkin aikaa käynnistyksen jälkeen, jotta asetuksien toimivuudesta päästään varmuuteen. Jos ohjelman toiminnasta löytyy selkeä virhe, ota yhteyttä tekijöihin niin korjaamme asian. Kiitos jo etukäteen!