Versio Päiväys Muokkaaja Kuvaus 0.9 16.2.2006 Tuukka Laakso Korjattu versio 0.1 Antti Kettunen Alustava versio
Sisällysluettelo 1 Johdanto...2 2 Valppaan asennus...3 2.1 Valppaan kääntäminen...3 2.2 Valmiiksi käännetty asennus...3 2.3 Tietokannan konfigurointi...4 2.3.1 JDBC...4 2.4 Valppaan konfigurointi...5 3 Valppaan Web-käyttöliittymän asennus...6 3.1 Kääntäminen...6 3.2 Asennus...6 4 Valppaan käynnistys ja käyttö...7 5 Valppaan hallintatyökalut...8 5.1 Web käyttöliittymä...8 5.2 Komentorivikäyttöliittymä...8 1
1 Johdanto Valpas ja siihen liitetyt hallintatyökalut muodostavat järjestelmän, jonka tarkoitus on ilmoitinlaitteiden tarkkailu TETRA-verkon yli. Valpas on oma palvelimensa ja se tarjoaa RMIrajapinnat hallintatyökaluille. Hälyttimien tietojen ja tarkkailun tilan tallentamiseen Valpas käyttää tietokantaa. Valppaan ensisijainen hallintatyökalu on sen web-käyttöliittymä. Lisäksi Valpasta voidaan myös hallita käyttäen vastaavaa komentorivityökalua. Valppaan kokoonpano määritellään kokonaan asetustiedostoissa, joilla sen toimintaa voidaan muuttaa ja laajentaa tarvittaessa. Tässä dokumentissa on esitetty vain Valppaan käynnistäminen puuttumatta rakenteellisiin muutoksiin ja laajennettavuuteen. 2
2 Valppaan asennus 2.1 Valppaan kääntäminen Valppaan kääntäminen vaatii oikeat kehitysympäristön asetukset. JDK 5.0:n ja Apache Ant:n tulee olla oikein asennettu. Valppaan kääntäminen tapahtuu ajamalla seuraava komento Valppaan juurihakemistossa: Juurihakemistossa oleva build.xml-skripti kääntää Valppaan juurihakemiston alla olevaan -hakemistoon, jonka sisältö vastaa valmiiksi käännettyä asennusta. 2.2 Valmiiksi käännetty asennus Pura -tiedoston sisältö sopivaan hakemistoon. Hakemistorakenteen tulisi näyttää seuraavalta: Valppaan asetustiedostot Valppaan kokoonpanoasetukset kirjastot Hakemisto plugin-komponentteja varten valpas.jar, Valppaan luokkakirjasto 3
2.3 Tietokannan konfigurointi 2.3.1 JDBC Valpas on testattu käyttäen PostgreSQL:n versiota 7.4.7 ja konfigurointiohje olettaa, että käytössä on kyseinen kanta tai sen uudempi versio. Valpas toimii todennäköisesti ongelmitta myös muilla kannoilla, mutta tätä ei voida taata eikä tässä dokumentissa puututa niiden konfiguroimiseen. Valpas käyttää kannan saantiin JDBC:tä, jonka konfiguraatiot löytyvät hakemistosta JDBC:n ja käytettävän kannan dokumentaatiosta löytyy tarkempia ohjeita, mutta esimerkkinä PostgreSQL-konfiguraatio, joka käyttää osoitteessa olevaa -nimistä kantaa.!" #$ # " %& 4
2.4 Valppaan konfigurointi Valppaan konfigurointiin käytetään -hakemiston alla olevia - tiedostoja. Näistä lähinnä :ssa oleviin asetuksiin tarvitsee koskea tavallisessa käytössä. Valpas tarvitsee viestien välitykseen EPA-järjestelmää, joka tarjoaa Web Service rajapinnat viestien välitykseen TETRA-verkossa. Valppaalla on oma numeronsa TETRA-verkossa samoin kuin muilla verkon päätelaitteilla. Lisäksi Valpas tarvitsee tunnukset EPA:n käyttämiseen. EPA tarjoaa kaksi Web Service rajapintaa, jotka molemmat tarvitaan viestien välitykseen. Rajapinnoille täytyy määrittää osoitteet ja nimiavaruudet. Esimerkkinä tavallinen konfiguraatio: '()*+(,,, ) ' (&" -... '/ 0, ( 123.42 '(,)0,,,*+( " 5 6 -... '*+(,,, 7 6 '*+( +%% '*+( "87 " 7 95:-2-.41-*+(7 *+(7 ";<% $95:-2-.41-*+($*+($";<% 7!" 0650**+( $!" 0650**+( 5
3 Valppaan Web-käyttöliittymän asennus 3.1 Kääntäminen Käyttöliittymän kääntäminen vaatii oikeat kehitysympäristön asetukset. JDK 5.0:n ja Apache Ant:n tulee olla oikein asennettu. Käyttöliittymän saa käännettyä - moduulin juurihakemistosta komennolla: ant package-all Web-sovellus löytyy kääntämisen jälkeen -hakemistosta. 3.2 Asennus Sovellus on pakattu tavalliseen war-pakettiin, joka täytyy ladata johonkin sovelluspalvelimeen. Esimerkiksi Tomcatiin sovelluksen saa asennettua sijoittamalla war-paketin hakemiston % alle ja käynnistämällä palvelimen. Sovelluspalvelimien oletusasennus toimii yleensä osoitteessa http://localhost:8080 ja Valppaan web-käyttöliittymä löytyy tällöin osoitteesta http://localhost:8080/valpas-ui. Sovelluspalvelimien omissa dokumentaatioissa on tarkempaa tietoa palvelinkohtaisista asetuksista. 6
4 Valppaan käynnistys ja käyttö Valpas käynnistyy komentoriviltä seuraavilla komennolla: = (Unix) =>8%? Windowsissa käynnistysskripti toimii myös normaalisti esim. resurssienhallinnan kautta. Jos EPA ei ole suoraan saatavilla vaan tarvitaan välityspalvelinta voi käynnistysskripteille antaa parametrina välityspalvelimen osoitteen ja portin. Esim. Windowsissa komennolla: =3.3- Jos asetukset ovat kunnossa, niin Valppaan konsolin tulosteen tulisi näyttää seuraavalta: 9;-... 9;3.3 60 6 0 + ; Esimerkissä on käytetty välityspalvelinta. Valpas ei itsessään tarjoa mitään käyttöliittymää toimintansa ohjaamiseen vaan tähän tarvitaan jokin erillisistä työkaluista. Nämä työkalut on kuvattu seuraavassa kappaleessa 7
5 Valppaan hallintatyökalut 5.1 Web käyttöliittymä Web-käyttöliittymän mukana on online-ohje, jossa kerrotaan tarkemmin mitä käyttöliittymällä voi tehdä. Ohjeet löytyvät Web-käyttöliittymästä -linkin takaa. 5.2 Komentorivikäyttöliittymä Komentorivikäyttöliittymä on tarkoitettu lähinnä testaamiseen ja se tarjoaa hieman laajemman toiminnallisuuden kuin web-käyttöliittymä. Komentorivikäyttöliittymän saa käynnistettyä Valppaan asennushakemistosta ajamalla skriptin " " (Unix) (Windows) Komentorivikäyttöliittymä toimii komentopohjaisesti ja myös sen mukana tulee suppeat online-ohjeet mahdollisista toiminnoista. Käynnistyttyään onnistuneesti komentorivikäyttöliittymän tuloste näyttää seuraavalta: 6"") @ @ 8