IUCLID 5 Neuvonta ja tuki

IUCLID 5 Neuvonta ja tuki IUCLID 5 -asennusopas Erillinen sovellus Microsoft Windows -asennusohjelma Joulukuu 2011

Oikeudellinen huomautus Euroopan kemikaalivirasto tai kukaan virastoa edustava henkilö vastaa siitä, miten seuraavia tietoja käytetään. Lisätietoja Euroopan unionista saa internetissä. Tietoja on seuraavissa osoitteissa: http://iuclid.echa.europa.eu. http://echa.europa.eu. http://europa.eu. VASTUUVAPAUSLAUSEKE Tämä on työkappaleeksi tarkoitettu käännös alun perin englanninkielisestä asiakirjasta. Se on käännetty Euroopan unionin elinten käännöskeskuksessa, jossa on myös tarkistettu, että käännös on tehty kokonaisuudessaan. Asiakirjan tieteelliset ja tekniset sanamuodot tullaan tarkastamaan. On syytä huomata, että vain englanninkielinen versio jonka saa myös tältä sivustolta on alkuperäinen teksti. Euroopan kemikaalivirasto Tekstin jäljentäminen on sallittua edellyttäen, että lähde mainitaan.

Sisällys 1. Johdanto... 1 1.1. Laitteistovaatimukset... 1 1.2. Ohjelmistovaatimukset... 1 2. Uusi IUCLID 5:n asennus... 2 2.1. IUCLID 5:n vaatimien ohjelmistojen asentaminen... 2 2.1.1. Javan asentaminen... 2 2.1.2. PostgreSQL:n asentaminen... 4 2.2. IUCLID 5:n asentaminen... 8 2.3. Käyttäjätilien suojausasetukset... 12 2.3.1. Salasanan vähimmäispituus... 13 2.3.2. Merkistöjen vähimmäismäärä salasanoissa... 13 2.3.3. Turvallisuuskysymys... 13 3. Päivitys... 14 3.1. Päivitys, jossa vain IUCLID 5:n aliversion numero muuttuu (ei IUCLID 5.0/1)... 14 3.1.1. Asennusohjelman käynnistäminen... 14 3.1.2. Päivitysprosessin valitseminen... 15 3.1.3. Päivitettävän asennuksen ja uuden asennuksen sijainnit... 15 3.1.4. IUCLID 5 -sovellustiedostojen asentaminen... 16 3.1.5. IUCLID 5:n käynnistäminen... 18 3.2. Päivitys, jossa IUCLID 5:n pääversion numero muuttuu (ei IUCLID 5.0/1)... 18 3.2.1. Asennusohjelman käynnistäminen... 19 3.2.2. Päivitysprosessin valitseminen... 19 3.2.3. Päivitettävän asennuksen ja uuden asennuksen sijainnit... 20 3.2.4. IUCLID 5 -sovellustiedostojen asentaminen... 21 3.2.5. Siirtotyökalu... 22 3.2.6. IUCLID 5:n käynnistäminen... 23 3.3. Päivitys IUCLID 5.0:sta tai 5.1:stä IUCLID 5.2:een tai uudempaan... 24 3.3.1. Tietojen siirto IUCLID 5:n uuteen versioon... 24 3.3.2. Tietokantamääritys IUCLID 5:n uuden ja vanhan version samanaikaiseen käyttöön... 24 3.3.3. IUCLID 5.0/1 asennettiin asennuspaketin avulla... 24 3.3.4. IUCLID 5.0/1 asennettiin manuaalisesti... 25 4. IUCLID 5:n asennuksen alustaminen... 26 4.1. IUCLID 5:n käynnistäminen... 26 4.2. First steps -aloitusohjelma... 26 4.3. Käyttäjien hallinta... 35 5. IUCLID 5:n asennuksen poistaminen... 36 A. Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista... 37 iii

Luku 1. Johdanto IUCLID 5:n voi asentaa erillisenä sovelluksena tai monikäyttäjäympäristöön, jossa käytetään asiakas-palvelinarkkitehtuuria. Asiakirjassa kuvataan asennusohjelman käyttöä IUCLID 5:n asentamiseen erillisenä sovelluksena tietokoneeseen, jossa on Microsoft Windows (jäljempänä Windows). Asennusohjelman voi ladata IUCLID 5 -verkkosivustolta. Asennus suoritetaan varmistamalla ensin, että vaaditut ohjelmistot on asennettu, ja suorittamalla sen jälkeen asennusohjelma, yleensä kaksoisnapsauttamalla sitä. Jos tämän asiakirjan ohjeita noudatetaan huolellisesti, IUCLID 5 -ohjelmiston tai sen käyttämiseen vaadittujen ohjelmistokomponenttien erityistuntemusta ei tarvita. Jos asennuksen aikana ilmenee ongelmia, jotka eivät ratkea tämän oppaan tai kolmannen osapuolen ohjelmistojen asiakirjoissa olevien ohjeiden avulla, tutustu osoitteessa http://iuclid.eu IUCLID-verkkosivustolla oleviin IUCLID:n usein kysyttyihin kysymyksiin ennen kuin otat yhteyttä ECHAn neuvontapalveluun. 1.1. Laitteistovaatimukset Seuraavat vaatimukset ovat viitteellisiä. Vähintään 1 Gt emolevyn RAM-muistia (2 Gt Windows Vistalle ) Pentium Core 2 duo tai vastaava IUCLID 5:n asennus toimii todennäköisesti myös hitaammalla koneella, mutta suorituskyky ei välttämättä ole riittävä. Vaatimuksiin vaikuttavat myös käytetyt Windowsin ja IUCLID-lisäosien versiot. Esimerkiksi Query Tool (kyselytyökalu) -lisäosan käyttö kasvattaa sopivan käyttönopeuden vaatimien resurssien tarvetta erityisesti suurta tietokantaa käytettäessä. 1.2. Ohjelmistovaatimukset Asennuksen ohjelmistovaatimukset ovat seuraavat: Windows ja käyttöoikeus käyttäjätiliin, jolla voi suorittaa asennusohjelman ja luoda tarvittavat hakemistot. Java: J2SE Runtime Environment, versio 6 Tietokanta: PostgreSQL 8.2, 8.3, 8.4 (suositeltu) tai 9. IUCLID 5:n Windows-asennusohjelman uusin versio. Sen voi ladata maksutta IUCLID 5 -verkkosivustolta. Kun IUCLID 5:n asennus on valmis, testaa asennus käynnistämällä ja tekemällä konfiguroinnit. Konfigurointiin vaaditaan vähintään yksi oikeushenkilön tiedosto (LEOX). LEOX-tiedoston luonti kuvataan IUCLID 5 -verkkosivustolla, josta asennusohjelmiston voi ladata. Lisäksi vertailuaineiden ja EY-luettelon lataaminen on suositeltavaa. Myös nämä saa samalta verkkosivustolta kuin IUCLID 5 -ohjelmiston. Vihje Aikaa ja tietoteknisiä resursseja voi säästää tuomalla IUCLID-järjestelmään vain tarvittavat vertailuaineet. IUCLID-verkkosivustosta voi ladata erikokoisia vertailuaineiden luetteloja. Vaihtoehtoja ovat full set (kaikki), reduced list (rajattu luettelo) ja toiminto, jonka avulla voit luoda oman luettelon käyttämällä valintaperusteina yleisiä tunnisteita, kuten EC-numeroa ja IUPAC-nimeä. Ennen kuin valitset vaihtoehdon full set (kaikki), harkitse, onko se todella tarpeen. Vertailuaineet, joita ei tuoda alustusprosessin aikana, voidaan tuoda myöhemmin. Kannattaa aloittaa valitsemalla vaihtoehto reduced list (rajattu luettelo). 1

Luku 2. Uusi IUCLID 5:n asennus Jos Java ja PostgreSQL on jo asennettu vaatimusten mukaisesti, siirry kohtaan IUCLID 5:n asentaminen. 2.1. IUCLID 5:n vaatimien ohjelmistojen asentaminen Kolmannen osapuolen ohjelmistojen asennusohjeet saa ohjelmistojen julkaisijoilta. Katso tarkat ohjeet julkaisjoiden sivustoista. 2.1.1. Javan asentaminen 1. Tarkista, onko Javan (JRE) oikea versio asennettu tietokoneeseen, johon IUCLID asennetaan: Avaa komentorivi (Start (käynnistä) Run (suorita...) Open (avaa): cmd). Syötä komentoriville seuraava komento: java -version Kuva 2.1. Tarkista Javan versio 2. Jos näkyviin ei tule yllä olevassa kuvassa näkyvän kaltaista viestiä, tai jos Javan versio ei ole 1.6 tai uudempi, asenna uusin versio. Sen voi ladata Sunin sivustosta osoitteesta www.java.com. 2

Kuva 2.2. Javan asennuopas Kuva 2.3. Valitse Javalle asennushakemisto 3

Kuva 2.4. Javan asennus on valmis 2.1.2. PostgreSQL:n asentaminen Jos PostgreSQL:n versio 8.2, 8.3 tai 8.4 on jo asennettu ja käytössä postgres-käyttäjän palveluna, olemassa olevaa asennusta voi käyttää. Palvelinta ei tarvitse päivittää versioon 9, vaikka versiota 9 tuetaan. Jos PostgreSQL-palvelinta ei ole vielä asennettu tietokoneeseen tai jos haluat päivittää versioon 9, lataa se osoitteesta www.postgresql.org/ download ja asenna. PostgreSQL-verkkosivusto tarjoaa eri vaihtoehtoja PostgreSQL-ohjelmiston lataamiseen ja asentamiseen. Oheisissa kuvissa käytetään PostgreSQL-verkkosivustolta saatavaa one click installer -asennusta. Asennuksessa käytettävä tiedostonimi voi olla esimerkiksi postgresql-9.0.4-1-windows.exe. PostgreSQL:n oletusarvoisessa uudessa asennuksessa, joka tehdään one click installer -asennuksena, PostgreSQL käynnistetään automaattisesti palveluna, luodaan tarvittaessa postgres-käyttäjä ja tarjotaan hallintatyökalut (esim. pgadmin III), joita voi käyttää tietokantojen hallintaan. Jos asennettaessa luodaan postgres-pääkäyttäjä, sitä varten annetaan one click installer -asennuksen neljännessä vaiheessa salasana oheisissa kuvissa esitetyn mukaisesti. Muista salasana, koska sitä tarvitaan myöhemmin IUCLID 5:n konfiguroinnissa. Jos et ole varma one click installer -asennuksessa syötettävistä merkeistä, käytä esitäytettyjä oletusarvoja. Kuva 2.5. PostgreSQL-asennusohjelma 4

Kuva 2.6. PostgreSQL:n asennushakemisto Kuva 2.7. PostgreSQL:n tietohakemisto 5

Kuva 2.8. Tietokannan pääkäyttäjän (postgres) ja Windows-palvelutilin (postgres) salasana Kuva 2.9. PostgreSQL:n porttinumero 6

Kuva 2.10. Määritä PostgreSQL:n oletusalue Kuva 2.11. Vahvista PostgreSQL:n asennus 7

Kuva 2.12. PostgreSQL:n asennus käynnissä Kuva 2.13. PostgreSQL:n asennus valmis Ellet nimenomaisesti halua Stack Builderin suorittamista, poista valinta ruudusta yllä näkyvässä näytössä. Lopeta asennus napsauttamalla Finish (valmis) -painiketta. 2.2. IUCLID 5:n asentaminen Kun olet ladannut IUCLID 5:n Windows-asennusohjelman asennuspaketin, pura sen sisältö sopivaan kansioon. Asennusohjelma toimitetaan suoritettavana Java-tiedostona, jonka nimi on iuclid5_install.jar. Sen voi käynnistää joko kaksoisnapsauttamalla tiedostoa tai suorittamalla sen komentoriviltä komentosarjan tapaan. Huomaa, että käyttäjätilillä, jolla asennusohjelma suoritetaan, on oltava oikeus kirjoittaa kansioon, johon IUCLID 5 asennetaan. Jos asennusohjelman suorittamisessa ilmenee ongelmia, asiakirjan kohdasta Liite A, Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista voi etsiä ratkaisuja. 8

Asennusohjelman ensimmäisessä näytössä annetaan mahdollisuus valita IUCLID 5:n uusi asennus tai päivitys uusimpaan versioon. Jos kyseessä on päivitys, tutustu asiakirjan kohtaan Upgrade. Ohessa on esimerkki ensimmäisestä näkymästä. Siniset tekstit ovat linkkejä PostgreSQL-verkkosivustoon ja IUCLID-verkkosivustossa oleviin asennusoppaisiin. Jos kyseessä on IUCLID 5:n uusi asennus ja tyhjä tietokanta, valitse ensimmäinen vaihtoehto. Oheisessa esimerkissä vaihtoehto on Make a fresh installation of IUCLID 5.3.2 (IUCLID 5.3.2:n uusi asennus). Uudessa asennuksessa menettely on sama asennettavasta versiosta riippumatta. Napsauta Continue (jatka) -painiketta. Kuva 2.14. Uusi IUCLID 5:n asennus Asennusohjelman seuraavalla sivulla voit määrittää, mitä asennat. Asennusohjelma luo automaattisesti uuden kansion, johon se asentaa IUCLID 5:n. Kansion nimi on sama kuin IUCLID 5:n koko versionumero ja nimi. Tällä asennusohjelman sivulla voit määrittää kyseisen kansion sijainnin. Oletusarvo näkyy näytössä. Voit muuttaa sitä napsauttamalla kansiokuvaketta ja muuttaa selaamalla sijaintia. Seuraavassa esimerkissä uusi kansio IUCLID 5.3.2 luodaan kansioon C:\Program Files\iuclid5. Varmista, että asennusohjelman suorittamiseen käytettävällä Windows-käyttäjätunnuksella on oikeus kirjoittaa kohdekansioon, ja napsauta sitten Continue (jatka) -painiketta. 9

Kuva 2.15. Kohdekansio Asennusohjelman kolmannessa näytössä annetaan tiedot, joilla määritetään, miten IUCLID 5 muodostaa yhteyden PostgreSQL-tietokantaan. Oletusarvot vastaavat tyypillisen käyttäjän tarpeita, joten jos arvoja ei puutu tai tiedossa ei ole muita tarvittavia arvoja, jätä oletusarvot ennalleen. Voit käyttää database user password (tietokantakäyttäjän salasana) -kohdassa mitä tahansa haluamaasi arvoa. Kohtaan PostgreSQL superuser password (PostgreSQLpääkäyttäjän salasana) on annettava sama arvo, jota käytettiin PostgreSQL-tietokannan asennuksessa. Kun arvot on annettu, näytön pitäisi näyttää oheisen esimerkin mukaiselta. Napsauta Continue (jatka) -painiketta. Kuva 2.16. Tietokantayhteys Jos näkyviin tulee virheilmoitus password authentication failed for user postgres (postgres-käyttäjän salasanatodennus epäonnistui), anna PostgreSQL-asennuksen yhteydessä annettu PostgreSQL-tietokannan pääkäyttäjän salasana ja yritä sitten uudelleen. 10

Kuva 2.17. Väärä salasana Jos näkyviin tulee jompikumpi virheilmoituksista Cannot create destination folder (kohdekansiota ei voi luoda) tai Access denied (käyttö estetty), asiakirjan kohdasta Liite A, Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista voi etsiä ratkaisua. Varsinainen asennusprosessi vie muutaman sekunnin. Kuva 2.18. IUCLID 5:n asentaminen Kun asennusohjelma on asentanut sovelluksen, ohjatun toiminnon voi sulkea napsauttamalla Close (sulje) -painiketta. 11

Kuva 2.19. Asennus onnistui Windowsin työpöydälle luodaan automaattisesti uusi pikakuvake. Pikakuvake viittaa asennuskansiossa olevaan tiedostoon iuclid5.cmd. Jos pikakuvaketta ei luoda, voit etsiä syytä kohdasta Liite A, Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista. Pikakuvakkeen voi lisätä manuaalisesti. Seuraava vaihe on asennuksen alustaminen, joka on kuvattu asiakirjan kohdassa Luku 4, IUCLID 5:n asennuksen alustaminen. Jos sinulla on tietoja, jotka vietiin IUCLID-ohjelmistosta sisäisellä varmuuskopiointi- ja palautustoiminnolla, tiedot voidaan tuoda uuteen IUCLID 5 -asennukseen. Kuva 2.20. Esimerkki IUCLID 5 -pikakuvakkeesta 2.3. Käyttäjätilien suojausasetukset IUCLID 5:ssä on ominaisuuksia, joiden avulla hallitaan käyttäjätilien todentamisen suojaustasoa. Suojaustaso voidaan räätälöidä IUCLID 5:n asennuksen vaatimusten mukaisesti. Esimerkiksi käyttäjätilien salasanojen määrityksessä käyttäjät voidaan pakottaa syöttämään vähimmäisvahvuuden mukaiset arvot. Suojaustason määrittävien parametrien arvot määritetään workstation.properties-asetustiedostossa, joka on asennuskansion conf-kansiossa. Arvojen muutokset tulevat voimaan, kun IUCLID 5 käynnistetään uudelleen. Suojausominaisuudet on kuvattu alla. Asetukset näkyvät alla muodossa, jossa ne ovat IUCLID 5:n asennuksen mukana toimitetussa asetustiedostossa. Arvot on määritetty koodissa annetuiksi oletusarvoiksi ja kommentoitu pois käytöstä. Jos rivi on kommentoitu pois käytöstä, koodissa annettua oletusarvoa käytetään. Jos arvona on nolla (0), ominaisuus on pois käytöstä. # The minimum length for a new password # password.min.length=6 # The minimum number of character sets used in the password # password.min.charsets=2 # If a secure question system is enabled # password.use.secure.question=true 12

Alla olevassa esimerkissä suojausominaisuudet on poistettu käytöstä. # The minimum length for a new password password.min.length=0 # The minimum number of character sets used in the password password.min.charsets=0 # If a secure question system is enabled password.use.secure.question=0 2.3.1. Salasanan vähimmäispituus Tällä ominaisuudella estetään liian heikkojen salasanojen käyttäminen käyttäjätileissä. Käyttäjätilin salasanassa on oltava vähintään tämä määrä merkkejä. Jos käyttäjä yrittää luoda salasanan, jossa on vähemmän merkkejä, näkyviin tulee virheilmoitus, ja käyttäjä saa mahdollisuuden yrittää uudelleen. Suojauskäytäntöä sovelletaan salasanoihin vain niiden luontivaiheessa. Jos salasanojen vähimmäispituutta lisätään, käyttäjät voivat edelleen kirjautua olemassa olevilla salasanoilla, vaikka niitä pidettäisiin liian lyhyinä. Järjestelmänvalvoja voi pakottaa käyttäjän luomaan uuden salasanan valitsemalla IUCLID 5 -sovelluksessa tilin valintaruudun. Käyttäjää vaaditaan luomaan uusi salasana seuraavan kirjautumisen yhteydessä. 2.3.2. Merkistöjen vähimmäismäärä salasanoissa Tällä ominaisuudella estetään liian heikkojen salasanojen käyttäminen käyttäjätileissä. Käyttäjätilin salasanassa on oltava vähintään yksi merkki jokaisesta merkistöstä. Arvo on kokonaisluku väliltä 1-4. Arvo 1 tarkoittaa pelkkää merkistöä 1, arvo 2 merkistöjä 1 ja 2 jne. Neljä merkistöä ovat seuraavat: 1 = pieni kirjain [a-z], 2 = iso kirjain [A-Z], 3 = numero [0-9], 4 = muu kuin aakkosnumeerinen symboli [!@#$%^&*-_=+]. Jos arvo on esimerkiksi 3, salasana "AdkbScfw" hylätään liian heikkona, mutta "AdkbSc37" hyväksytään, koska se sisältää vähintään yhden merkin merkistöistä 1, 2 ja 3. Jos käyttäjä yrittää luoda salasanan, joka ei noudata vaatimusta, näkyviin tulee virheilmoitus, ja käyttäjä saa mahdollisuuden yrittää uudelleen. Suojauskäytäntöä sovelletaan salasanoihin vain niiden luontivaiheessa. Jos salasanojen merkistöjen vähimmäismäärää lisätään, käyttäjät voivat edelleen kirjautua olemassa olevilla salasanoilla, vaikka niissä ei olisi käytetty riittävän montaa merkistöä. Järjestelmänvalvoja voi pakottaa käyttäjän luomaan uuden salasanan valitsemalla IUCLID 5 -sovelluksessa tilin valintaruudun. Käyttäjää vaaditaan luomaan uusi salasana seuraavan kirjautumisen yhteydessä. 2.3.3. Turvallisuuskysymys Tämä ominaisuus tarjoaa vaihtoehtoisen menetelmän käyttäjän todentamiseen käyttäjätunnuksen ja salasanan yhdistelmän lisäksi. Se voi auttaa vähentämään käyttäjähallinnan vaatimia resursseja estämällä unohtuneista salasanoista johtuvia tilien lukitsemisia. Kukin käyttäjä voi määrittää oman turvallisuuskysymyksensä ja sen salaisen vastauksen. Tämä tehdään sovelluksen graafisessa käyttöliittymässä sen jälkeen, kun käyttäjä on kirjautunut. Käyttäjä voi kirjautua vastaamalla oikein kysymykseen sen sijaan, että hän käyttäisi salasanaa. Kysymykseen vastataan käyttämällä kirjautumissivun Forgot your password? (Unohtuiko salasana?) -linkkiä. Ominaisuus otetaan käyttöön tai poistetaan käytöstä IUCLID 5:n koko instanssissa käyttämällä arvoa true (tosi) tai false (epätosi). 13

Luku 3. Päivitys Ennen päivitystä on tärkeää varmuuskopioida tietokanta. Käytä IUCLID:n sisäistä varmuuskopiointitoimintoa ja/tai tietokannan varmuuskopiointitoimintoa. Pelkkä IUCLID:n asennukseen käytetyn tiedostojärjestelmän kopiointi ei ole suositeltu tapa tehdä varmuuskopiota. Tässä luvussa kuvataan aiemman version päivitys IUCLID 5:een. IUCLID 5:n koko versionumerossa 5:n jälkeen annetaan pisteillä erotettuina pää- ja aliversio. Esimerkiksi IUCLID 5.3.2:ssa pääversion numero on 3 ja aliversion numero 2. Päivitettävän IUCLID 5:n versiosta riippuen on olemassa kolme erilaista päivitysprosessia. Jokainen niistä on kuvattu tässä luvussa omassa alakohdassaan. Vaihtoehdot: 1. Vain aliversion numeron muutos. Esimerkki: päivitys IUCLID 5.3.1:stä IUCLID 5.3.2:een. Asennusohjelma siirtää kaikki tiedot aiemmasta tietokannasta uuteen tietokantaan automaattisesti. 2. Pääversion numeron muutos. Esimerkki: päivitys IUCLID 5.2.1:stä IUCLID 5.3.2:een. Tietokannan muutokset on tehtävä erillisellä siirtovaiheella. Asennusohjelma voi siirtää tiedot puolestasi. 3. Päivitys joko IUCLID 5.0:sta tai IUCLID 5.1:stä. Windows-asennusohjelmaa ei voi käyttää tähän päivitykseen. Valitse päivitystä vastaava vaihtoehto ja jatka lukemalla sitä koskeva kohta. Jos et tiedä, mitä versiota käytät tällä hetkellä, voit tarkistaa sen IUCLID 5:n käyttöliittymästä. Käynnistä IUCLID 5, kirjaudu sisään, valitse Help (ohje) ja About (tietoja). 3.1. Päivitys, jossa vain IUCLID 5:n aliversion numero muuttuu (ei IUCLID 5.0/1) Asennusohjelma tarjoaa helpon tavan päivityksen suorittamiseen, ja ohjeet siihen annetaan seuraavissa alaluvuissa. Kun IUCLID 5:n uusi versio käynnistetään, se voi muodostaa yhteyden aiempaan tietokantaan ilman erillistä siirtovaihetta. 1. Varmuuskopioi tietokanta. Käytä IUCLID 5:n sisäistä varmuuskopiointitoimintoa ja/tai PostgreSQL-tietokannan varmuuskopiointitoimintoa. 2. Suorita asennusohjelma, valitse järjestelmää vastaava päivitysvaihtoehto ja jatka asennusta. Tärkeää Windows-asennusohjelman päivitystoimintoa voi käyttää vain siinä tapauksessa, että IUCLID 5 on asennettu Windows-asennusohjelmalla. Ohjeet IUCLID 5:n päivitykseen ilman Windows-asennusohjelmaa ovat tietokoneen asennusoppaassa. 3.1.1. Asennusohjelman käynnistäminen Kun olet ladannut Windows-asennusohjelman asennuspaketin, pura sen sisältö sopivaan kansioon. Asennusohjelma toimitetaan suoritettavana Java-tiedostona, jonka nimi on iuclid5_install.jar. Sen voi käynnistää joko kaksoisnapsauttamalla tiedostoa tai suorittamalla sen komentoriviltä kirjoittamalla. Huomaa, että käyttäjätilillä, jolla asennusohjelma suoritetaan, on oltava oikeus kirjoittaa kansioon, johon IUCLID 5 asennetaan. 14

Jos asennusohjelman suorittamisessa ilmenee ongelmia, tämän asiakirjan liittteestä Liite A, Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista voi etsiä ratkaisuja. 3.1.2. Päivitysprosessin valitseminen Valitse asennusohjelman ensimmäisessä näytössä toinen vaihtoehto. Seuraavassa esimerkissä ja tämän kohdan muissa kuvakaappauksissa vaihtoehto on Upgrade from IUCLID 5.3.x to 5.3.2 (päivitys IUCLID 5.2.x:stä 5.3.2:een). Kuva 3.1. IUCLID 5:n päivitys, jossa vain aliversion numero muuttuu Napsauta Continue (jatka) -painiketta. 3.1.3. Päivitettävän asennuksen ja uuden asennuksen sijainnit Asennusohjelma luo kansion, johon se asentaa IUCLID 5:n uuden version. Kansio on samassa ylemmän tason kansiossa kuin päivitettävä asennus. Ylemmän tason kansio määritetään asennusohjelman toisella sivulla. Siinä voidaan käyttää joko oletusarvoa C:\Program Files\iuclid5, joka näkyy seuraavassa kuvakaappauksessa, tai sille voidaan antaa muu arvo. Valitun kansion on kuitenkin sisällettävä päivitettävä asennus. Asennusohjelma lukee määritysparametrit uusimmasta löytämästään IUCLID 5:n aiemman version asennuskansiosta ja kopioi ne sitten uuteen asennukseen. Asennusohjelma ei muokkaa päivitettävää asennusta. Oheisessa esimerkissä päivitettävän asennuksen kohdekansion nimi on IUCLID 5.3.2. 15

Kuva 3.2. Asennuskansio Kun olet varma, että arvot ovat oikein, napsauta Continue (jatka) -painiketta. Seuraava virheilmoitus tulee näkyviin, jos Windows-asennusohjelma ei löydä IUCLID 5:n versiota, jonka se voisi päivittää antamiesi valintojen mukaisesti. Kuva 3.3. Asennusohjelma ei löydä sopivaa aiempaa asennusta Näkyviin voi tulla myös kaksi muuta virheilmoitusta: Cannot create destination folder kohdekansiota ei voi luoda) ja Access denied (käyttö estetty). Jos jompikumpi näistä tulee näkyviin, asiakirjan kohdasta Liite A, Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista voi etsiä ratkaisua. 3.1.4. IUCLID 5 -sovellustiedostojen asentaminen Uuden kansion luominen ja tietojen kopioiminen siihen vievät muutaman sekunnin, kuten oheisessa esimerkissä on esitetty. 16

Kuva 3.4. IUCLID 5:n asentaminen Asennusprosessin aikana suoritetaan seuraavat toimet: Sovellustiedostojen uudet versiot kopioidaan uuden version asennuskansioon. IUCLID 5:n aiempaan versioon asennetut lisäosat kopioidaan IUCLID 5:n uuteen versioon, mutta vain siinä tapauksessa, että ne ovat yhteensopivia uuden version kanssa. Asennusohjelma havaitsee lisäosan yhteensopivuuden automaattisesti. Jos lisäosaa ei enää näy IUCLID 5:n käyttöliittymässä päivityksen jälkeen, tarkista IUCLIDverkkosivustosta osoitteessa http://iuclid.eu, onko yhteensopiva versio saatavilla. Aiemman asennuksen määritystiedostot kopioidaan uuteen asennukseen. IUCLID 5:n pikakuvake luodaan sen Windows-tilin työpöydälle, jolla asennus suoritettiin, alla esitetyn mukaisesti. Kuva 3.5. IUCLID 5:n pikakuvake Kun päivitys on suoritettu onnistuneesti, näkyviin tulee seuraava näyttö. 17

Kuva 3.6. IUCLID 5:n päivitys onnistui Napsauta Close (sulje) -painiketta. 3.1.5. IUCLID 5:n käynnistäminen Päivitetyn IUCLID 5:n voi nyt käynnistää kaksoisnapsauttamalla asennusohjelman työpöydälle luomaa kuvaketta. IUCLID 5:n voi käynnistää myös suorittamalla asennushakemistossa olevan iuclid5.cmd-tiedoston. Alustusprosessia ei tarvita. Kaikki päivitetyssä järjestelmässä olleet tiedot ovat mukana uudessa järjestelmässä. Näin ollen on mahdollista kirjautua kaikkiin aikaisemman järjestelmän käyttäjätileihin. Kuva 3.7. IUCLID 5:n pikakuvake 3.2. Päivitys, jossa IUCLID 5:n pääversion numero muuttuu (ei IUCLID 5.0/1) Tässä prosessissa Windows-asennusohjelma tarjoaa helpon tavan IUCLID 5:n olemassa olevan asennuksen päivitykseen, ja ohjeet siihen on annettu seuraavissa kappaleissa. Päivitysprosessissa on seuraavat kolme vaihetta: 1. Varmuuskopioi tietokanta. Käytä IUCLID:n sisäistä varmuuskopiointitoimintoa ja/tai PostgreSQL-tietokannan varmuuskopiointitoimintoa. 2. Suorita asennusohjelma, valitse päivitysvaihtoehto ja jatka asennusta. 3. Suorita siirtotyökalu. Tämä on komentosarja, joka toimitetaan asennusohjelman mukana. Se siirtää IUCLID 5:n olemassa olevat tiedot. IUCLID 5:ttä ei voi käynnistää ennen kuin siirtotyökalu on suoritettu onnistuneesti. Tärkeää Windows-asennusohjelman päivitystoimintoa voi käyttää vain siinä tapauksessa, että IUCLID 5 on asennettu Windows-asennusohjelmalla. 18

Ohjeet IUCLID 5:n asennukseen ilman Windows-asennusohjelmaa ovat tietokoneen asennusoppaassa. 3.2.1. Asennusohjelman käynnistäminen Kun olet ladannut Windows-asennusohjelman asennuspaketin, pura sen sisältö sopivaan kansioon. Asennusohjelma toimitetaan suoritettavana Java-tiedostona, jonka nimi on iuclid5_install.jar. Sen voi käynnistää joko kaksoisnapsauttamalla tiedostoa tai suorittamalla sen komentoriviltä komentosarjan tapaan. Huomaa, että käyttäjätilillä, jolla asennusohjelma suoritetaan, on oltava oikeus kirjoittaa kansioon, johon IUCLID asennetaan. Jos asennusohjelman suorittamisessa ilmenee ongelmia, tämän asiakirjan liittteestä Liite A, Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista voi etsiä ratkaisuja. 3.2.2. Päivitysprosessin valitseminen Valitse asennusohjelman ensimmäisessä näytössä toinen vaihtoehto. Seuraavassa esimerkissä ja tämän kohdan muissa kuvakaappauksissa vaihtoehto on Upgrade from IUCLID 5,2.x to 5.3.2 (päivitys IUCLID 5.2.x:stä 5.3.2:een). Napsauta Continue (jatka) -painiketta. Kuva 3.8. IUCLID 5:n päivitys, jossa pääversion numero muuttuu Seuraavassa näytössä on muistutuksia tämän päivitystyypin koko prosessista, kuten oheisessa esimerkissä on esitetty. 19

Kuva 3.9. Päivitysprosessin yhteenveto 3.2.3. Päivitettävän asennuksen ja uuden asennuksen sijainnit Asennusohjelma luo kansion, johon se asentaa IUCLID 5:n uuden version. Kansio on samassa ylemmän tason kansiossa kuin päivitettävä asennus. Ylemmän tason kansio määritetään asennusohjelman toisella sivulla. Siinä voidaan käyttää joko oletusarvoa C:\Program Files\iuclid5, joka näkyy seuraavassa kuvakaappauksessa, tai sille voidaan antaa muu arvo. Valitun kansion on kuitenkin sisällettävä päivitettävä asennus. Asennusohjelma lukee määritysparametrit uusimmasta löytämästään IUCLID 5:n aiemman version asennuskansiosta ja kopioi ne sitten uuteen asennukseen. Asennusohjelma ei muokkaa päivitettävää asennusta. Oheisessa esimerkissä päivitettävän asennuksen kohdekansion nimi on IUCLID 5.3.2. Kuva 3.10. Asennuskansio Kun olet varma, että arvot ovat oikein, napsauta Continue (jatka) -painiketta. 20

Seuraava virheilmoitus tulee näkyviin, jos Windows-asennusohjelma ei löydä IUCLID 5:n versiota, jonka se voisi päivittää antamiesi valintojen mukaisesti. Kuva 3.11. Asennusohjelma ei löydä sopivaa aiempaa asennusta Näkyviin voi tulla myös kaksi muuta virheilmoitusta: Cannot create destination folder (kohdekansiota ei voi luoda) ja Access denied (käyttö estetty). Jos jompikumpi näistä tulee näkyviin, asiakirjan kohdasta Liite A, Vinkkejä asennusohjelman käynnistämisestä ja käyttöoikeuksista voi etsiä ratkaisua. 3.2.4. IUCLID 5 -sovellustiedostojen asentaminen Uuden kansion luominen ja tietojen kopioiminen siihen vievät muutaman sekunnin, kuten oheisessa esimerkissä on esitetty. Kuva 3.12. IUCLID 5:n asentaminen Asennusprosessin aikana suoritetaan seuraavat toimet: Sovellustiedostojen uudet versiot kopioidaan uuden version asennuskansioon. IUCLID 5:n aiempaan versioon asennetut lisäosat kopioidaan IUCLID 5:n uuteen versioon, mutta vain siinä tapauksessa, että ne ovat yhteensopivia uuden version kanssa. Asennusohjelma havaitsee lisäosan yhteensopivuuden automaattisesti. Jos lisäosaa ei enää näy IUCLID 5:n käyttöliittymässä päivityksen jälkeen, tarkista IUCLIDverkkosivustosta osoitteessa http://iuclid.eu, onko yhteensopiva versio saatavilla. Aiemman asennuksen määritystiedostot kopioidaan uuteen asennukseen. IUCLID 5:n pikakuvake luodaan sen Windows-tilin työpöydälle, jolla asennus suoritettiin, alla esitetyn mukaisesti. 21

Kuva 3.13. IUCLID 5:n pikakuvake Kun ohjelmiston uuden version asennus on suoritettu onnistuneesti, seuraava näyttö tulee näkyviin. Kuva 3.14. IUCLID 5:n asennus onnistui Tällä sivulla on tietoja tietokannan varmuuskopioinnista ja painike, joka käynnistää siirtoprosessin. Voit käynnistää siirtoprosessin napsauttamalla migrate (siirrä) -painiketta tai tehdä sen myöhemmin. Jos et missään tapauksessa aio käyttää tätä näyttöä siirron käynnistämiseen, voit sulkea asennusohjelman napsauttamalla Close (sulje) -painiketta. Tämän oppaan seuraavassa luvussa on lisätietoja siirtoprosessista. 3.2.5. Siirtotyökalu Siirtotyökalun suorittamiseen on kaksi tapaa. Yksi tapa on suorittaa update.bat-komentosarja, joka asennettiin IUCLID 5:n uuden version mukana asennuskansioon. Toinen tapa on käynnistää siirto asennusohjelman viimeiseltä sivulta. Tämä tehdään valitsemalla valintaruutu kohdassa I made a back-up of my database (tein varmuuskopion tietokannasta) ja napsauttamalla sitten migrate (siirrä) -painiketta alla esitetyn mukaisesti. 22

Kuva 3.15. IUCLID 5 -ohjelmiston asennus onnistui, suorita siirtotyökalu Kun siirtotyökalua suoritetaan, cmd-ohjelmalle näytetään ikkuna, jossa näkyy Windowsin komentorivi-ikkuna. Oheinenon esimerkki on tyypillinen: Kuva 3.16. Siirtotyökalu on käynnissä Älä tee mitään, mikä keskeyttäisi tämän prosessin. Älä sulje ikkunaa. Kun prosessiointi on päättynyt, ikkunassa näkyy hetken ajan viesti Database update successfully finished (tietokannan päivitys onnistui) ja ikkuna sulkeutuu automaattisesti. Jos prosessi keskeytyy, kokeile aloittaa se uudelleen alusta. Jos tämä ei toimi, palauta alkuperäinen tietokanta varmuuskopiosta ja yritä uudelleen. 3.2.6. IUCLID 5:n käynnistäminen Kun siirto on suoritettu onnistuneesti, päivitetyn IUCLID 5:n voi käynnistää kaksoisnapsauttamalla asennusohjelman työpöydälle luomaa kuvaketta. IUCLID 5:n voi käynnistää myös suorittamalla asennushakemistossa olevan iuclid5.cmd-tiedoston. Alustusprosessia ei tarvita. Kaikki IUCLID 5:n aiemmassa versiossa olleet tiedot ovat mukana uudessa versiossa. Näin ollen on mahdollista kirjautua kaikkiin aikaisemman version käyttäjätileihin. 23

Kuva 3.17. IUCLID 5:n pikakuvake 3.3. Päivitys IUCLID 5.0:sta tai 5.1:stä IUCLID 5.2:een tai uudempaan Tärkeää IUCLID 5.0:sta tai 5.1:stä IUCLID 5.2:een tai uudempiin versioihin ei ole automaattista tietokannan päivitystä. Tiedot on siirrettävä manuaalisesti vanhasta tietokannasta uuteen tietokantaan seuraavassa luvussa olevien ohjeiden mukaisesti. IUCLID 5:n jokaisella asennuksella on oltava oma tietokanta. Tietokantaohjelmiston yksittäisessä instanssissa voi olla useampi tietokanta. 3.3.1. Tietojen siirto IUCLID 5:n uuteen versioon Ennen IUCLID 5:n uuden version asennuksen aloittamista kaikki tiedot on vietävä vanhasta IUCLID 5:stä Backup (Varmuuskopiointi) -ohjelmalisäkkeellä, joka on saatavilla IUCLID-verkkosivustossa. Vientiprosessi on keskeisen tärkeä, koska viedyt tiedot tuodaan myöhemmin IUCLID 5:n uuteen versioon. Kun Back-up (Varmuuskopiointi) - ohjelmalisäke ajetaan, se pyytää käyttäjää luomaan ja syöttämään salasanan. Tätä salasanaa käytetään kaikissa uuden asennuksen käyttäjätileissä. Poikkeuksena on SuperUser-tili, jonka oletussalasana on root. Tuo viedyt tiedot IUCLID 5:n uuteen versioon käyttämällä IUCLID 5:n sisäistä Restore (Palautus) -ominaisuutta, joka on File / Administrative tools (Tiedosto / Hallintatyökalut) -valikossa. Tämän ominaisuuden avulla voidaan ladata tiedot, jotka vietiin IUCLID 5:n vanhan version Back-up (Varmuuskopiointi) -ohjelmalisäkkeellä. 3.3.2. Tietokantamääritys IUCLID 5:n uuden ja vanhan version samanaikaiseen käyttöön Jos käytössä on jo IUCLID 5:n aiempi versio, suosittelemme säilyttämään sen toistaiseksi. Sen voi poistaa myöhemmin, kun olet täysin varma, ettei sitä enää tarvita. Ohessa on joitakin ohjeita siihen, miten voidaan hallita useampaa kuin yhtä IUCLID 5:n versiota. Kuten edellä todettiin, IUCLID 5:n jokaisella asennuksella on oltava oma tietokanta. Kun päivitetään IUCLID 5.0:sta tai 5.1:stä IUCLID 5.2:een tai uudempaan versioon, IUCLID 5:lle on luotava uusi tietokanta, koska tietokannan rakenne on erilainen kuin aiemmissa versioissa. Vaatimuksen täyttämiseen on eri tapoja. Seuraavissa luvuissa kuvataan kaksi yleistä tapausta. IUCLID 5:n uuden version tietokanta voi olla samassa tietokantaohjelmiston instanssissa kuin IUCLID 5:n aiemman version tietokanta, mutta sillä on kuitenkin oltava tietokantaohjelmiston instanssissa yksilöivä nimi. Kun IUCLID 5 suoritetaan ensimmäistä kertaa tyhjällä tietokannalla, se luo automaattisesti kaikki oikeat taulut, ja ohjattu alustustoiminto käynnistyy. 3.3.3. IUCLID 5.0/1 asennettiin asennuspaketin avulla IUCLID 5 -asennuspaketti sisälsi PostgresSQL-tietokantaohjelmiston. Asennuspaketilla asennettiin PostgreSQL-tietokantaohjelmisto ja IUCLID 5 -ohjelmisto sekä tallennettiin tietokannan tiedot, ja kaikki nämä ovat samassa IUCLIDkansiossa. Asennuspaketti loi IUCLID 5:n asennukset, jotka käyttävät PostgreSQL-tietokantaa muussa kuin vakioportissa (5433). Jos IUCLID 5 asennetaan niin, että se käyttää PostgreSQL-tietokannan erillistä asennusta, joka toimiii vakioportissa (5432), sitä voi käyttää samanaikaisesti sellaisen asennuksen kanssa, joka tehtiin asennuspaketilla. Esimerkiksi jos IUCLID 5:n uusi versio asennetaan tämän oppaan ohjeiden mukaisesti asennusohjelmalla ja oletusasetuksilla, uutta asennusta voi käyttää samanaikaisesti asennuspaketilla asennetun aiemman asennuksen 24