FinFamily

Asennus Mac - OSX - Catalina (7/2020)

• Asennus tehty alunperin Mavericks 3/2014. Ohjeissa viitattaessa katsomaan virheilmoitusta, katso oma otsikko "Ongelmia".

1. Asentaminen vaatii Javan ja tarvittaessa aiemmin asennetun Javan päivittämisen. Asenna viimeisin Javan JRE -versio. Katso Java asennus
2. Lataa asennusohje How_to_install_FinFamily.pdf osoitteesta http://sourceforge.net/projects/finfamily
3. Jos et käytä H2-tietokantaa, asenna PostgreSQL.
4. Lataa ja pura finfamilyXXXX.zip osoitteesta http://sourceforge.net/projects/finfamily
5. Siirry finfamilyXXX-hakemistoon.
   1. Jos hakemisto on iCloud Drivessä: Users/käyttäjänimi/Library/Mobile Documents/com~apple~CloudDocs/hakemistot/ esim. cd Library/Mobile\ Documents/com~apple~CloudDocs/
6. Anna hakemistossa FinFamilyn käynnistyskomento: sh SukuMac
7. Seuraa ohjeita kohdasta 'Kuinka luodaan H2 tietokanta FinFamilya varten ja luo johonkin hakemistoon H2 tietokanta. Tyhjä tietokanta on luotu ja voit aloittaa henkilöiden luomisen tietokantaan tai tuoda vanhoja sukutiedostoja.

• Normaalisti käynnistettäessä käynnistä FinFamily samalla komennolla: sh SukuMac ja valitse tietokannan tyypiksi H2 ja valitse se hakemisto, jossa tietokanta sijaitsee ja se tietokanta jonka haluat avata. Valitse mv.db-loppuinen tietokanta, jos käytät useita tietokantoja. Hakemiston ja tietokantojen sijaintia voi vaihtaa tiedostojärjestelmässä tai tietokoneesta toiseen.
  • Tietokantoja voi olla useita samassa tietokoneen hakemistossa. Ne ovat eri nimisiä, esim. nimi.mv.db ja nimi.trace.db
  • Uusi tietokanta luodaan käynnistettäessä tai ohjelman sisältä
    • Ohjelman sisältä: Tiedosto > Sulje tietokanta > Tiedosto > Kytke tietokanta, avautuu pieni ikkuna > Tyyppi H2 > H2 tietokanta, selataan haluttuun hakemistoon > Annetaan uusi nimi tietokannalle > Open > Ok, kysyy "Haluatko luoda uuden tyhjän sukutietokannan: nimi.mv.db > Yes, vastaa "Uusi sukutietokanta luotu".
• Päivitä aika ajoittain uuteen FinFamily-versioon.
• Ohjeita myös Sukuforum

PostgreSQL-tietokannan käyttäminen

Vanhoissa FinFamily-versioissa käytettiin PostgreSQL. Ohjelmaa ei saatu toimimaan MacOS Catalinassa 7/2020 PostgreSQL:n kanssa. Käyttäjän ja tietokannan lisäys "vaikutti" onnistuvan, mutta sukutietokannan lisääminen ei onnistunut ja ohjelmaa ei päässyt käyttämään ja vuosia vanhoja tiedostoja ei pystynyt tuomaan.

• Asentaminen vaatii PostgreSQL asennuksen. Katso PostgreSQL asennus.

PostgreSQL ensimmäinen käynnistyskerta

1. Varmista että postgresSQL-käyttäjällä on Superuser–oikeudet, joihin sisältyy käyttäjien (Create role) ja tietokannan luonti (Create DB). Katso alempaa kohta Ongelmia - Virheilmoitus 1.
   1. Avaa asennusohje sivulta 19.
2. Käynnistä pääteikkunassa PostgreSQL komennolla: postgres -D /usr/local/var/postgres
3. Käynnistä uusi pääteikkuna ja tee seuraavat muutokset postgres-käyttäjiin
   1. Tarkista mitä rooleja on olemassa: psql template1 -c '\du'
   2. Jos on rooli postgres ja sillä on vain oikeus Create DB, eikä Superuser, Create role ja Create DB, tällöin poista rooli: dropuser postgres
   3. Luo postgres-rooli: createuser -P -s -e postgres
4. Siirry finfamilyXXX-hakemistoon.
   1. Jos hakemisto on iCloud Drivessä: Users/käyttäjänimi/Library/Mobile Documents/com~apple~CloudDocs/hakemistot/ esim. cd Library/Mobile\ Documents/com~apple~CloudDocs/
5. Anna hakemistossa FinFamilyn käynnistyskomento: sh SukuMac
   1. Aukeaa iso ikkuna ja Kytke tietokanta -pieni-ikkuna.
6. Etene asennusohjeiden mukaan H2 tai PostgreSQL-tietokannan asennuksella a) luomalla käyttäjä b) luomalla tietokanta ja c) kytkemällä tietokanta FinFamilyyn.
   1. Luo uusi sukutietokanta tai ota käyttöön valmis sukutietokanta nimeltä public. Niin kauan kuin et tee näitä näkyy alareunassa Virheilmoitus 2.
      1. Valitse Tiedosto > Alusta sukutietokanta > Public TAI anna uusi nimi
         1. Jos ponnahdusikkuna, jossa virheilmoitus "Luo uusi tietokanta" ja punainen merkki": ???

PostgreSQL normaali käynnistys

1. Käynnistä pääteikkunassa PostgreSQL komennolla: postgres -D /usr/local/var/postgres
2. Käynnistä uusi pääteikkuna.
3. Siirry finfamilyXXX-hakemistoon.
   1. Jos hakemisto on iCloud Drivessä: Users/käyttäjänimi/Library/Mobile Documents/com~apple~CloudDocs/hakemistot/ esim. cd Library/Mobile\ Documents/com~apple~CloudDocs/
4. Anna hakemistossa FinFamilyn käynnistyskomento: sh SukuMac

PostgreSQL-ongelmia

• PostgreSQL pitää olla käynnissä eli jos se ei ole asetettu käynnistymään automaattisesti tietokoneen käynnistyessä, se on käynnistettävä joka kerta taustalle ennen FinFamily:n käynnistämistä.
• Jos Java on esim. 1.6 versio, niin asenna uusin Java eli 1.7. FinFamily ei käynnisty vaan pääteikkunaan tulostuu javavirheitä.
• Virheilmoitus 1: Error: ERROR: must be member of role "jokunimi"
  • Ilmenee FinFamily:stä käsin eli tietokantaan ei voi lisätä käyttäjää, eikä uutta tietokantaa. FinFamily:n käyttöönotto ei etene.
  • PostgresSQL roolilla nimeltä postgres täytyy olla oikeudet Superuser, Create role, Create DB: createuser -P -s -e postgres
  • Katso tarkempi ohje sivulta PostgreSQL asennus.
• Virheilmoitus 2: ERROR: relation "sukusettings" does not exist
  • Lisää sukutietokanta, katso ohjeen kohta Ensimmäinen käynnistyskerta.
• Virheilmoitus 3: Unable to access jarfile suku.jar
  • Siirry antamaan komento kansioon jossa sijaitsee suku.jar -tiedosto. Toisin sanoen polun käyttäminen ei välttämättä toimi.
• Error: ERROR: permission denied to create role
  • Yritettäessä ensimmäisellä kerralla luoda käyttäjää.

Tiedostojen tuonti

Suku 8, Sukutieto 8, Sukuohjelmisto 8

Vanhat tiedostot ovat esimerkiksi seuraavanlaisia: nimi.gdb tai nimi.MDB tai nimi.mdb tai nimi.ldb

• Vaihtoehto 1. Kysele henkilöä kenellä on vielä Suku 2000 tai 2004 -ohjelma käytössä ja pyydä muuntamaan tiedot sen avulla Gedcom-muotoon.
• Vaihtoehto 2. Asenna tältä sivulta löytyvästä linkistä Sukuohjelmisto 2004 johonkin Windows XP-käyttöjärjestelmällä varustettuun tietokoneeseen ja tuo/lataa siihen em. tiedostot ja vie tiedot Gedcom muodossa eli nimi.ged
• Tämän jälkeen voit tuoda ne FinFamily-ohjelmaan: Tiedosto > Tuo > Gedocom tiedosto
  • Uusi tuonti tuhoaa tietokannassa jo olevat tiedot, joten luo jokaiselle tuotavalle tiedostolle oma H2-tietokanta. Tietokantoja voi yhdistää, mutta ei ilmeisesti H2-tietokannassa?
  • Vuosia vanhat ged-tiedostot aukesivat H2-tietokantaan 7/2020.

• Sukuohjelmisto 2004 on lisenssin alainen, mutta siinä on ilman lisenssiä demomahdollisuus. Näin oli myös Suku 8 -ohjelmassa ja Suku 8 demoversiolla tehdyt tiedostot onnistui 15.3.2014 näillä ohjeilla tuoda. Muistaisin, että Suku 8 -ohjelman demo rajoitti sukupuun kokoa, joten epäselväksi jää voiko lisenssöimättömällä Sukuohjelmisto 2004 -versiolla tuoda lisenssöidyllä Suku 8 -ohjelmalla tehtyä demoversiota suurempaa tiedostoa.
• Epäselvyys on myös, asentuuko Sukuohjelmisto 2004 uudempiinkin Windows käyttöjärjestelmiin kuin XP.
  • "Siirryin aikoinaan Sukutieto 8:sta muuhun ohjelmaan. Pari irrallista mdb-tiedostoa jäi silloin siirtämättä. Nyt sain jo aiemmin vihjeen että Sukuohjelmisto 2004 lukee näitä mdb-tiedostoja. Demo-versiolla sainkin ne auki luetteloiksi, jotka saan paperille Wordin kautta ja sillä tavalla vertailuun."