Vejledning i opdatering af ISOWARE til seneste version.

Opdatering af ISOWARE til version 6.1.0
September 2015
Indhold
Kontaktoplysninger............................................................................................................................................ 1
VIGTIGT .............................................................................................................................................................. 2
Opdatering af trejdepartssoftware ................................................................................................................... 2
Opdatering til version 6.1.0. .............................................................................................................................. 2
1. Backup af databasen.............................................................................................................................. 3
2. Installation af ny war fil ......................................................................................................................... 5
3. Opdatering af Databasen....................................................................................................................... 7
4. Angivelse af licensoplysninger ............................................................................................................... 9
Jeg har brug for hjælp...................................................................................................................................... 12
Appendix I - Opdatering af Apache Tomcat .................................................................................................... 12
Appendix II - Opdatering af PostGreSQL ......................................................................................................... 18
Kontaktoplysninger
Aabogade 15
8200 Århus
Danmark
CVR: 28 27 85 51
Telefon: +45 70 22 00 34
Internet: www.isoware.dk
E-mail: [email protected]
VIGTIGT
ISOWARE 6.1.0 understøtter ikke Internet Explorer 9 eller tidligere versioner af Internet Explorer.
Opdatering af trejdepartssoftware
ISOWARE afhænger af, at følgende tredjepartssoftware er installeret på serveren:
Anvendelse
Navn
Version
Webserver
Apache Tomcat
7.0.42
Databaseserver
PostGreSQL
9.3
Virtual Machine
Java
Nyeste
Den nuværende version af ISOWARE er optimeret til at blive afviklet på Apache Tomcat version
7.0.42 og PostGreSQL version 9.3.
Hvis ISOWARE er installeret på tidligere versioner af Apache Tomcat er det nødvendigt at opdatere
denne, da ISOWARE ikke kan afvikles på tidligere versioner.
Hvis PostGreSQL anvendes i en tidligere version anbefales det at gennemføre en opdatering af
denne til den anbefalede version.
Følg venligst instrukserne i afsnittene Appendix I - Opdatering af Apache Tomcat og Appendix II Opdatering af PostGreSQL for at opdatere disse til de anbefalede versioner.
Java henter automatisk løbende opdateringer.
Opdatering til version 6.1.0.
I de følgende afsnit antages det, at Apache Tomcat er installeret på den server, som der logges på,
at Apache Tomcat er indstillet til at køre på port 8080 og ISOWARE applikationen er deployet med
navnet ISOWARE. Hvis ikke dette er tilfældet, skal den anvendte adresse
(http://localhost:8080/ISOWARE) udskiftes med http://server:port/applikation, hvor server er
netværksnavnet eller ip adressen på den anvendte server, port er den port, som Apache Tomcat
lytter på og applikation er det valgte navn for ISOWARE applikationen, f.eks.
http://server01:8080/kvalitetsstyring. Hvis Apache Tomcat er indstillet til at lytte på port 80, kan
:port delen udelades, f.eks. http://server01/kvalitetsstyring.
Opdatering af ISOWARE til version 6.1.0
Side 2 af 27
Hvis man, som i ovenstående eksempel ønsker, at applikationen skal hedde /kvalitetsstyring i
stedet for /ISOWARE, skal man omdøbe den downloadede war fil til kvalitetsstyring.war, før den
deployes på serveren.
Desuden antages det, at Apache Tomcat og ISOWARE applikationen ligger på følgende fysiske
placering på serveren:
C:\Programmer\Apache Software Foundation\Tomcat 7\webapps\ISOWARE\.
Her repræsenterer ISOWARE delen igen det navn, som man har givet war filen, før deployment. I
ovenstående eksempel, hvor navnet kvalitetsstyring blev valgt, vil stien derfor i stedet være:
C:\Programmer\Apache Software Foundation\Tomcat 7\webapps\kvalitetsstyring.
Stien til selve Apache Tomcat kan også være anderledes, hvis der er angivet en anden sti under
installationen af denne.
Følgende trin skal udføres i opdateringen:
1.
2.
3.
4.
Backup af databasen
Installation af ny war fil
Opdatering af databasen
Angivelse af licensoplysninger
Udfør venligst trinene i ovenstående rækkefølge.
De følgende afsnit indeholder links til filer, som skal downloades i forbindelse med opdateringen.
Disse filer kan også findes på ISOWAREs hjemmeside, klik her for at åbne download siden.
1. Backup af databasen
Det kan stærkt anbefales, at der tages backup af den eksisterende database, da det giver mulighed
for at rulle systemet tilbage til den oprindelige konfiguration.
Sådan gør du:




Log på den server, hvor PostGreSQL er installeret, med administratorrettigheder
Åbn Start -> Alle Programmer -> PostgreSQL -> PGAdminIII
Klik på PostGreSQL database server i menuen til venstre (under Servers)
Indtast adgangskoden til databaseserveren og klik på OK
Opdatering af ISOWARE til version 6.1.0
Side 3 af 27

Højre klik på databasen – isoware (eller evt. andet valgt navn) – og vælg Backup

Vælg en placering til backuppen og klik på Backup
Vælg Tar i feltet Format
Afvent, at backuppen afsluttes.
Luk PGAdminIII



Opdatering af ISOWARE til version 6.1.0
Side 4 af 27
2. Installation af ny war fil
ISOWARE opdateres ved deploye en ny war (Web Archive) fil på Apache Tomcat webserveren.
Sådan gør du:
1. Log på den server, hvor Apache Tomcat er installeret, med administratorrettigheder
2. Tag en kopi af folderen C:\Programmer\Apache Software Foundation\Tomcat
7\webapps\ISOWARE\ og lig den et sikkert sted. I det følgende vil notationen
[ISOWARE_kopi] blive anvendt til at referere den kopi, som du opretter
3. Klik her for at hente den nye war fil og gem den et sted, hvor du nemt kan finde den igen
4. Åbn en browser og gå til http://localhost:8080/manager/html
5. Udfyld brugernavn og adgangskode og klik på OK
Opdatering af ISOWARE til version 6.1.0
Side 5 af 27
6. I linjen hvor der i venstre side står ISOWARE – Klik på Undeploy og bekræft valget
7. Vent, indtil der i toppen af siden skrives: ISOWARE was undeployed sucessfully
8. Opdater Apache Tomcat til version 7.0.42 ved at følge instruktionerne i Appendix I Opdatering af Apache Tomcat
9. Åbn en browser og gå til http://localhost:8080/manager/html
10. Udfyld brugernavn og adgangskode og klik på OK
Opdatering af ISOWARE til version 6.1.0
Side 6 af 27
11. Gå ned til bunden af siden
12. Ud for Select war file to upload vælges Gennemse
13. Angiv stien til war filen (den du hentede tidligere) og klik på OK
14. Klik på Deploy
15. Vent til filen er uploadet og du får en besked om, at upload er gennemført med success
16. Test, om ISOWARE virker, ved at åbne http://localhost:8080/ISOWARE i din browser
17. Overskriv indholdet af folderen C:\Programmer\Apache Software Foundation\Tomcat
7\webapps\ISOWARE\FileManager\userfiles\ med indholdet af folderen
[ISOWARE_Kopi]\FileManager\userfiles\
Hvis systemet ikke virker, skyldes det muligvis, at ISOWARE ikke er blevet fjernet korrekt fra
Apache Tomcat webserveren.
Dette løses på følgende måde:
1.
2.
3.
4.
5.
Stop Apache Tomcat webserveren (Stop servicen Apache Tomcat 7)
Slet folderen C:\Programmer\Apache Software Foundation\Tomcat 7\webapps\ISOWARE\
Slet filen C:\Programmer\Apache Software Foundation\Tomcat 7\webapps\ISOWARE.war
Start Apache Tomcat webserveren (Start servicen Apache Tomcat 7)
Udfør trin 9 - 17 i ovenstående vejledning
3. Opdatering af Databasen
Når du er færdig med at deploye den nye war fil, skal der foretages en opdatering af ISOWARE
databasen.
Opdatering af ISOWARE til version 6.1.0
Side 7 af 27
Sådan gør du:
1. Åbn en browser og gå til http://localhost:8080/ISOWARE/Setup
2. Indtast brugernavn og adgangskoden til databaseserveren og klik på Log ind
3. Klik Næste
Opdatering af ISOWARE til version 6.1.0
Side 8 af 27
4. Klik på Opdater database knappen og vent et øjeblik, mens systemet arbejder
5. Opdatering afsluttes med, at der vises en liste over udførte opgaver. Hvis en af opgaverne
ikke kan udføres, rulles hele opdateringen tilbage. Kontakt venligst ISOWARE, hvis
databaseopdateringen fejler
6. Klik på Afslut for at afslutte opdateringen
7. Klik på Gå til ISOWARE startsiden for at logge på ISOWARE
4. Angivelse af licensoplysninger
For at kunne anvende ISOWARE efter opdatering skal der, hvis det ikke allerede er gjort i
forbindelse med tidligere opdateringer, indtastes licensoplysninger. Licensoplysningerne
modtages fra ISOWARE A/S.
Opdatering af ISOWARE til version 6.1.0
Side 9 af 27
Ovenstående vindue vises, når brugerne forsøger at logge ind, hvis licensen ikke er gældende for
den ISOWARE version, som du har installeret.
Sådan gør du:
1. Log på ISOWARE som Systemadministrator (sysadm)
2. Klik på Indstillinger i toppen af menuen til venstre
3. Klik på Licens i System folderen
Opdatering af ISOWARE til version 6.1.0
Side 10 af 27
4. Hvis der ikke tidligere er angivet licensoplysninger, skal du klikke på Aktiver licens
Hvis der tidligere er angivet licensoplysninger, skal du i stedet klikke på knappen Reaktiver
licens
5. Indtast det brugernavn og den licenskode, som du har modtaget fra ISOWARE og klik på
Aktiver
Opdatering af ISOWARE til version 6.1.0
Side 11 af 27
Jeg har brug for hjælp
Skriv venligst til [email protected] eller ring på tlf. 70 22 00 34, hvis du ønsker at rekvirere
assistance til at udføre opdateringen.
Appendix I - Opdatering af Apache Tomcat
1. Find Apache Tomcat x.x inde i Start->Alle programmer
2. Klik på Uninstall Tomcat x.x
3. Klik på Uninstall
Opdatering af ISOWARE til version 6.1.0
Side 12 af 27
4. Svar Nej til at fjerne alle filerne
5. Klik på Close for at afslutte
6. Klik her for at hente Apache Tomcat 7.0.42
Opdatering af ISOWARE til version 6.1.0
Side 13 af 27
7. Kør apache-tomcat-7.0.42.exe
8. Klik på Next
9. Klik på I Agree
Opdatering af ISOWARE til version 6.1.0
Side 14 af 27
10. Klik på Next
11. Hvis du ønsker at ændre porten, som Tomcat lytter på, skal du ændre det i feltet http/1.1
Connector Port. Standardporten er 8080.
Opdatering af ISOWARE til version 6.1.0
Side 15 af 27
Indtast et selvvalgt brugernavn og adgangskode i felterne User Name og Password.
Brugernavnet og adgangskoden skal bruges, når ISOWARE senere skal
installeres/opdateres.
Klik på Next
12. Her skal du fortælle Tomcat, hvor din Java distrubution er installeret. Feltet vil, i langt de
fleste tilfælde, være udfyldt automatisk.
Klik på Next
Opdatering af ISOWARE til version 6.1.0
Side 16 af 27
13. Klik på Browse hvis du ønsker at ændre lokationen på Tomcat folderen.
Klik på Install
14. Klik Finish for at afslutte installationen
Opdatering af ISOWARE til version 6.1.0
Side 17 af 27
Apache Tomcat er nu opdateret til den anbefalede version.
Appendix II - Opdatering af PostGreSQL
1. Tag en backup af databasen ved at følge instrukserne i afsnittet Backup af databasen
2. Afinstaller den eksisterende PostGreSQL installation (Kontrolpanel->Tilføj/Fjern
programmer el. Kontrolpanel->Programmer og funktioner)
3. Klik her for at hente PostGreSQL 9.3 til 64 bit systemer (Windows 2008 R2, Windows 2012)
Klik her for at hente PostGreSQL 9.3 til 32 bit systemer (Windows 2003, Windows 2008 R1)
4. Kør den hentede .exe fil
5. Klik Next
Opdatering af ISOWARE til version 6.1.0
Side 18 af 27
6. Hvis PostGreSQL skal installeres i en anden folder end den der foreslås af
installationsprogrammet, skal det angives i feltet Installation Directory.
Klik Next
Opdatering af ISOWARE til version 6.1.0
Side 19 af 27
7. Hvis databasefilerne ønskes placeret i en anden folder end den der foreslås af
installationsprogrammet, skal det angives i feltet Data Directory.
Klik Next
Opdatering af ISOWARE til version 6.1.0
Side 20 af 27
8. Indsæt adgangskoden til postgres brugerkontoen og klik Next
Opdatering af ISOWARE til version 6.1.0
Side 21 af 27
9. Indsæt værdien 5432 i feltet Port og klik Next
Opdatering af ISOWARE til version 6.1.0
Side 22 af 27
10. Klik Next
Opdatering af ISOWARE til version 6.1.0
Side 23 af 27
11. Klik Next
Opdatering af ISOWARE til version 6.1.0
Side 24 af 27
12. Vent et øjeblik, mens programmet bliver installeret
Opdatering af ISOWARE til version 6.1.0
Side 25 af 27
13. Fjern markeringen i fluebenet Launch Stack Builder at exit? og klik Finish
14. PostGreSQL er nu opdateret til den anbefalede version
15. OBS: Hvis du har opdateret fra PostGreSQl version 8.4.x eller tidligere, skal du udføre
følgende trin for at færdiggøre opdateringen:
a. Åbn PostGreSQL serverens data bibliotek. Data biblioteket er placeret på den
placering, som blev valgt i trin 7, f.eks. C:\Program Files\PostgreSQL\9.3\data
b. Åbn filen postgresql.conf i en teksteditor, f.eks. NotePad.
c. Find værdien ”bytea” og opdater værdien, så den ser således ud:
d. Husk, at hvis der er et # tegn foran ”bytea” værdien, så skal det fjernes
e. Find nu værdien ”datestyle” og opdater værdien, så den ser således ud:
Opdatering af ISOWARE til version 6.1.0
Side 26 af 27
f. Gem postgresql.conf filen og genstart PostGreSQL serveren
Opdatering af ISOWARE til version 6.1.0
Side 27 af 27