Sync4j SyncServer 4.0 – palvelimen käyttöönotto- ja käännösohje

10.6.2004, Jaakko Hyvärinen ja Maunu Tuomainen.

Ympäristömuuttuja

Aseta J2EE-ympäristömuuttujan arvoksi palvelimen “kotihakemisto”, esimerkiksi /usr/local/SyncServer.

Asetustiedostot

Palvelin on esiasennettu JBoss-sovelluspalvelimen päälle. Ennen käyttöönottoa tulee kuitenkin tehdä muutoksia muutamiin asetustiedostoihin. Tiedostojen sijainti on ilmoitettu suhteessa palvelimen kotihakemistoon.

Muokattavat tiedostot ovat seuraavat:

syncserver-4.0.1/install.properties -tiedostosta tulee muokata asetukset server-namen ja JDBC:n osalta.

Tiedostossa syncserver-4.0.1/lib/logging/common/logging.properties voi muuttaa lokitukseen liittyviä asetuksia, mm. lokituksen tason.

syncserver-4.0.1/output/korppi/etc/korppi.conf on Korpin asetustiedosto.

Palvelimen hakemistorakenne

Palvelimen moduulihakemistossa syncserver-4.0.1/modules on Korppi-moduuli korppi.s4j.

Hakemistossa syncserver-4.0.1/default on palvelimen oletusasetustiedostot. Kun palvelin tai moduuleita asennetaan, tämän hakemiston tiedostot korvaavat palvelimen vastaavat työtiedostot.

Hakemisto syncserver-4.0.1/default/sql/postgresql sisältää seuraavat palvelimen toimintaan liittyvät SQL-lauseet:

create_engine.dll,

drop_engine.dll ja

init_engine.dll.

Lauseet suoritetaan automaattisesti palvelimen asennuksessa.

syncserver-4.0.1/default/lib -hakemisto sisältää palvelimen käyttämiä kirjastoja. Mikäli palvelimen käännetään uudestaan, tulee ne korvata uusilla käännössä syntyneillä jarreilla ja earreilla.

syncserver-4.0.1/default/config -hakemisto sisältää palvelimen toimintaan liittyviä konfigurointitiedostoja. Kyyhky-projektiin liittyviä muutoksia on tehty seuraaviin:

syncserver-4.0.1/default/config/common/beans/sync4j/

server/store/EnginePersistentStore.xml määrittää mm., mitä SQL-lausetta käyttäen käyttäjätiedot haetaan tietokannasta.

syncserver-4.0.1/default/config/common/properties/

config/Sync4j.properties määrittää mm. käytetyt luokat, joista huomion arvoisia ovat ainakin

engine.strategy,

engine.store ja

security.officer.

Tiedostossa syncserver-4.0.1/default/config/common/properties

/jboss/users.properties määritetään tiedostoautentikointiin liittyvät käyttäjätunnukset ja salasanat.

syncserver-4.0.1/default/config/common/properties

/jboss/roles.properties määrittää käyttäjäroolit tiedostoautentikoinnissa.

Asennus ja käyttö

Hakemistosta syncserver-4.0.1/bin löytyvät palvelimen asennus- ja käynnistysskriptit.

Palvelin asennetaan käyttöön palvelimen kotihakemistosta komennolla

bin/install.sh jboss,

joka alustaa sekä palvelimen että moduulit.

Asennettu palvelin käynnistetään palvelimen kotihakemistosta komennolla

bin/start.sh.

Palvelimen generoimat lokitiedostot löytyvät hakemistosta server/sync4j/log.

Lisätietoa palvelimesta löytyy osoitteesta http://www.sync4j.org/.

Kääntäminen

Mikäli palvelimeen halutaan tehdä muutoksia, tulee muutetut Java-tiedostot luonnollisesti kääntää ja asettaa palvelimen saataville. Tämän helpottamiseksi on palvelimessa mukana käännösskriptejä.

jbproject/KorppiSync4jTuotanto/dummy/

buildKorppiSyncSource.xml on Korppi-moduulin kääntämiseen tarvittava Ant-skripti. Se rakentaa moduulin hakemistoon jbproject/KorppiSync4jTuotanto/dummy/korppiSourceOutput, josta se tulee kopioida palvelimen syncserver-4.0.1/modules -hakemistoon.

Palvelin käännetään skriptillä jbproject/KorppiSync4jTuotanto/dummy/buildServer.xml. Se rakentaa palvelimen käyttämät jarrit ja earrit hakemistoon jbproject/KorppiSync4jTuotanto/dummy/output, josta ne on kopioitava palvelimen syncserver-4.0.1/default/lib -hakemistoon.

Hakemistossa jbproject/KorppiSync4jTuotanto/dummy/src/java/sync4j/framework/engine on tehty muutoksia (määritelty uusia vakioita) seuraaviin kahteen palvelimen lähdekooditiedostoon:

SyncItemState.java ja

SyncOperation.java.

Mikäli palvelin esimerkiksi päivitetään uudempaan versioon, tulee ko. tiedostoihin tehdyt muutokset säilyttää.

Seuraaviin Korpin luokkiin on tehty sovelluksen vaatimia muutoksia:

kotkabeans.AutoNumber: otettu transaktiot pois käytöstä,

kotkabeans.DB: määritetty JBoss connection spoolerin tiedot,

kotkabeans.Common: mm. muutoksia tiedostojen korppi.conf- sekä kotka.log sijaintiin,

kolibribeans.Appointment: Hillebrandin tekemiä muutoksia ja

kolibribeans.QueryContainer: Hillebrandin tekemiä muutoksia.

2004-06-06T14:38:04