ISOWARE opdateringsvejledning

Version 16.0.0

Indhold

• Opdatering af trejdepartssoftware
• Opdatering til version 16.0.0
  • Backup af databasen
  • Installation af ny .war fil
  • Opdatering af databasen
  • Angivelse af licensoplysninger
  • Afinstallation af gammel .war fil
• Jeg har brug for hjælp
• Appendix I - Opdatering af Apache Tomcat
• Appendix II - Opdatering af PostGreSQL

Opdatering til version 16.0.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. 

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##1600.war, før den deployes på serveren.

Følgende trin skal udføres i opdateringen:

1. Backup af databasen
2. Installation af ny .war fil
3. Opdatering af databasen
4. Angivelse af licensoplysninger
5. Afinstallation af gammel .war fil

Udfør venligst trinene i ovenstående rækkefølge.

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:

1. Log på den server, hvor PostGreSQL er installeret, med administratorrettigheder
2. Åbn PGAdmin 4 programmet
   
   
   
   
3. Indtast Master adgangskoden
   
   
   
   
4. Klik på PostGreSQL 12 i menuen til venstre (under Servers)
   
   
   
   
5. Indtast adgangskoden til databaseserveren og klik på OK
   
   
   
   
6. Højre klik på databasen – isoware (eller evt. andet valgt navn) – og vælg Backup
   
   
   
   
7. Vælg en placering til backuppen og klik på Backup
8. Afvent, at backuppen afsluttes.
9. Luk PGAdmin 4

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. Klik her for at hente den nye .war fil og gem den et sted, hvor du nemt kan finde den igen
3. Åbn en browser og gå til http://localhost:8080/manager/html
   
   
   
   
4. Udfyld brugernavn og adgangskode og klik på OK
   
   
   
   
5. Gå ned til bunden af siden
   
   
   
   
6. Ud for Select WAR file to upload vælges Gennemse
7. Angiv stien til .war filen (den du hentede tidligere) og klik på OK
8. Klik på Deploy
9. Vent til filen er uploadet og du får en besked om, at upload er gennemført med succes
10. Tomcat serveren har som standard en upload grænse på 50 MB. Hvis du får nedenstående fejl, kan det skyldes, at denne upload grænse er overskredet, da ISOWARE .war filen er større end 50 MB. I så fald skal du udføre punkt 11, 12 og 13 og derefter prøve at uploade .war filen igen
    
    
    
    
11. Åbn Manager appens web.xml i Notepad og find den sektion, som er markeret i billedet nedenfor. På en standardinstallation ligger filen i denne mappe:
    C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\manager\WEB-INF
    
    
    
    
12. Rediger sektionen, så den ser ud som nedenstående og gem ændringerne.
    
    
    
    
13. Genstart derefter Apache Tomcat servicen og start igen fra punkt 1

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.

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 på Opdater database knappen og vent et øjeblik, mens systemet arbejder
4. 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
   
   
   
   
5. Klik på Afslut for at afslutte opdateringen

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.

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
   
   
   
   
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

5. Afinstallation af gammel .war fil

Den gamle version af ISOWARE fjernes ved at undeploye den gamle .war fil på Apache Tomcat webserveren.

Sådan gør du:

1. Log på den server, hvor Apache Tomcat er installeret, med administratorrettigheder
2. Åbn en browser og gå til http://localhost:8080/manager/html
   
   
   
   
3. Udfyld brugernavn og adgangskode og klik på OK
   
   
   
   
4. Find den version af ISOWARE i listen, som skal afinstalleres. Du kan se versionen i Version
5. Klik på Undeploy ud for den version, som skal afinstalleres

Appendix I - Opdatering af Apache Tomcat

1. Afinstaller den eksisterende Apache Tomcat installation vha. Tomcats Uninstall applikation
   
   
   
   
   
   
2. Klik på Uninstall
   
   
   
   
3. Svar Nej til at fjerne alle filerne
   
   
   
   
4. Klik på Close for at afslutte
5. Klik her for at hente Apache Tomcat
6. Kør den hentede exe fil
   
   
   
   
7. Klik på Next
   
   
   
   
8. Klik på I Agree
   
   
   
   
9. Klik på Next
   
   
   
   
10. Hvis du ønsker at ændre porten, som Tomcat lytter på, skal du ændre det i feltet http/1.1 Connector Port. Standardporten er 8080.
    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
    
    
    
    
11. Her skal du fortælle Tomcat, hvor din Java distribution er installeret. Feltet vil, i langt de fleste tilfælde, være udfyldt automatisk.
    Klik på Next
    
    
    
    
12. Klik på Browse hvis du ønsker at ændre lokationen på Tomcat folderen.
    Klik på Install
    
    
    
    
13. Klik Finish for at afslutte installationen
14. Apache Tomcat er nu opdateret til den anbefalede version og du mangler nu blot at kopiere din eksisterende ISOWARE installation til den nye Tomcat server.
15. Åbn en stifinder og åbn webapps folderen i den gamle Tomcat installation, på en standardinstallation findes den her:
    C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps
    
    
    
    
16. Kopier den folder hvor din eksisterende ISOWARE installation ligger, i dette tilfælde hedder den ISOWARE##800
17. Åbn webapps folderen i den nye Tomcat installation, på en standardinstallation findes den her: C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps
    Indsæt den kopierede ISOWARE folder i webapps folderen
    
    
    
    
18. Vent nogle minutter og derefter vil din eksisterende ISOWARE installation være installeret på den nye Tomcat server.