Upgradehandleiding JOIN Integraties: verschil tussen versies

Uit JOIN wiki
Naar navigatie springen Naar zoeken springen
Regel 1: Regel 1:
 
https://joinsupport.decos.com/a/solutions/articles/17000075283
 
 
 
==Update koppelvlakken:==
 
==Update koppelvlakken:==
 
<br />De JOIN Integration Adminstration (JIA) biedt de beheerders van JOIN Zaak en Document met de bijbehorende koppelingen een eenvoudige manier om de koppelingen te updaten indien er bijvoorbeeld een nieuwe versie voor is. Gebruik '''altijd''' de meest recente versie van JIA (verderop op deze pagina vindt u informatie over de update van JIA. Kijk [[Releasenotes/JOIN Zaak & Document|hier]] om de meest recente versie te vinden. JOIN Integration Administration is onderdeel van de JOIN Koppelvlakken Suite. De volgende koppelvlakken kunt u met JOIN Integration Administration onderhouden:
 
<br />De JOIN Integration Adminstration (JIA) biedt de beheerders van JOIN Zaak en Document met de bijbehorende koppelingen een eenvoudige manier om de koppelingen te updaten indien er bijvoorbeeld een nieuwe versie voor is. Gebruik '''altijd''' de meest recente versie van JIA (verderop op deze pagina vindt u informatie over de update van JIA. Kijk [[Releasenotes/JOIN Zaak & Document|hier]] om de meest recente versie te vinden. JOIN Integration Administration is onderdeel van de JOIN Koppelvlakken Suite. De volgende koppelvlakken kunt u met JOIN Integration Administration onderhouden:

Versie van 3 jul 2020 16:07

Update koppelvlakken:


De JOIN Integration Adminstration (JIA) biedt de beheerders van JOIN Zaak en Document met de bijbehorende koppelingen een eenvoudige manier om de koppelingen te updaten indien er bijvoorbeeld een nieuwe versie voor is. Gebruik altijd de meest recente versie van JIA (verderop op deze pagina vindt u informatie over de update van JIA. Kijk hier om de meest recente versie te vinden. JOIN Integration Administration is onderdeel van de JOIN Koppelvlakken Suite. De volgende koppelvlakken kunt u met JOIN Integration Administration onderhouden:

  • StUF-DCR (Documentcreatie)
  • StUF-BG (Basisgegevens)
  • StUF-ZKN (Zaken)
  • StUF-LVO (Landelijke voorziening omgevingsloket)
  • BerichtenBox MOLZ (Mijn Overheid Lopende Zaken)

Hoe kom ik bij deze JIA website?

Daar zijn twee manieren voor:

  1. Door op integratie server een browser te openen en te navigeren naar http://localhost:81/Diaweb.
  2. Door vanaf de werkplek een browser te openen en te navigeren naar https://integratieservernaamwaarjiaisgeinstalleerd:8443/Diaweb.

Ik ben op de website. Wat nu?

Kies in het linkermenu de integratie die u wilt updaten en klik vervolgens op de knop Upgrade. JIA gaat dan verbinding maken met Decos om na te gaan welke nieuwe versies er voor de betreffende koppeling zijn. Bij een toegestane verbinding over poort 80 en 21 zal er in JIA een volgende scherm te zien zijn waar als voorbeeld StUFDCR versie 1.2 is gekozen en waar we zien dat versie 1.3 aanwezig is.

Let op! Indien de update een StUFZKN koppeling betreft lager dan versie 2.8.0 of een StUFBG koppeling lager dan 2.1.0 graag eerst contact met Decos om de configuratie zeker te stellen. Van alle moderne koppelingen worden de configuraties bijgehouden op https://config.decos.nl.

Let op! Indien de update een StUFBG koppeling is van versie 2.4.0 of lager vergeet dan niet de instructies te lezen in dit artikel.

Jia1.png

Indien JIA geen verbinding kan maken met Decos zie je als gebruiker het volgende scherm. Je kunt dan alleen kiezen voor Local Machine en dan navigeren naar het zip bestand dat je hebt kunnen downloaden die je van Decos Support hebt gekregen. Let op! Het zipbestand dat je hebt gedownload niet uitpakken. Bij het navigeren vanuit JIA naar het bestand, navigeer je dus naar het zipbestand. JIA draagt verder zorg voor het uitpakken en verwerken.

JIA2.png

Klik vervolgens op de knop Update en wacht totdat de update succesvol is uitgevoerd. Dat ziet er als volgt uit:

JIA3.png

Klik na het succes bericht op OK en zie dat het versienummer is opgehoogd van de koppeling:

JIA4.png


Installatie JOIN Integration Administration (JIA):

https://joinsupport.decos.com/a/solutions/articles/17000053139

Wat is JOIN Integration Administration?

Met JIA is het mogelijk om de upgrade naar de laatste versie van een integratie eenvoudig zelf uit te voeren. Tevens kunt u het berichtenverkeer van de verschillende koppelingen inzien.

In dit artikel worden de stappen beschreven die nodig zijn om JIA te updaten of te installeren.

Prerequisites

1. De applicatieserver moet toegang hebben tot het internet

JIA zal de Decos server benaderen om de benodigde installatiebestanden op te halen. Hiervoor zal het een uitgaande FTP (poort 21) en HTTP (poort 80) gebruiken.

2. Microsoft .Net framework 4.5 dient geïnstalleerd te zijn op de applicatieserver

De nieuwe versie van JIA vereist Microsoft .Net framework 4.5. U kunt deze versie downloaden vanaf de Microsoft website: https://www.microsoft.com/nl-nl/download/details.aspx?id=30653

3. De rol ‘Windows authentication’ dient geactiveerd te zijn in Microsoft IIS *

Deze rol kan het meest eenvoudig worden toegevoegd d.m.v. het uitvoeren van het volgende Powershell commando op een Windows server versie 2012 of nieuwer.

Install-WindowsFeature "Web-Windows-Auth" -IncludeManagementTools ;

Op oudere Windows Server versies wordt er gebruik gemaakt van Add-WindowsFeature.

Installatie

Stap 1: Download Powerschell script

Download het Powershell script waarmee u JIA en de benodigde vereisten kunt installeren. Voor klanten die onverhoopt nog gebruik maken van Windows 2008 of geen internet connectie van de Integratie server toestaan dient ook de meest recente JIA package gedownload te worden:

JIA Package: https://support.decos.nl/setups/integrations/index/downloadJIA.html

Vergeet na het downloaden de zip bestanden niet te unblocken.

Afbeelding: JIA6

Stap 2: Verwijder oude installatie (optioneel)

Indien er een Decos Integration Administration of JOIN Integration Administration van 2.2.0 of ouder/lager te vinden is in Add/Remove Programs moet deze eerst verwijderd worden a.d.h.v. de volgende stappen. Indien niet aanwezig, dan door met Stap 3.

  1. Stop in de Windows services de Decos.Integrations.Admin.BackgroundService en sluit weer het services scherm.
  2. Maak een copy van de map die normaal gesproken op de volgende locatie staat: D:\DECOS\apps\Decos Integration Administration. Er staat normaal gesproken, maar er zijn klanten die e.e.a. op C: of E hebben geïnstalleerd of zelfs een hele andere locatie.
  3. Via Add/Remove Programs kan dan de oude versie van Decos/JOIN Integration Administration verwijderd worden.


Stap 3: Pak het zip-bestand uit

Unzip het bestand jiainstall.zip naar een handige locatie. Een veelgebruikte suggestie: D:\_Install\Integrations\JIA. Plaats in deze map indien het een Windows 2008 server betreft of geen interverbinding ook het zip bestand jia.zip maar pak deze niet uit!


Stap 4: Voer x64 Powershell commandprompt uit

Let op: voer deze stap alleen uit wanneer u nog gebruik maakt van een Windows 2008 Server

Open een x64 Powershell commandprompt als Administrator (run as Administrator) en voer het volgende commando uit: Set-ExecutionPolicy unrestricted -Scope Process en antwoord met een hoofdletter Y.

Stap 5: Uitvoeren installatie

Navigeer in hetzelfde scherm naar de map waar je de zips hebt neergezet en voer het volgende commando uit: .\jiainstaller.ps1

Indien het een Windows 2008 server is, of er is geen internetverbinding voer dan het volgende commando uit: .\jiainstaller.ps1 jia.zip

Let op: door het deinstalleren van de oude Decos/JOIN Integration Administration software kan er een melding komen in het script dat de service ontbreekt. Dit klopt dus.

Het script zal nu een aantal prompts tonen. Kies altijd voor de hoogste versie JIA maar nooit de Development versie tenzij instructies hiervoor ontvangen van Decos.

Wanneer u upgrade naar versie 2.5 of hoger zal het script een aantal aanvullende vragen stellen:

Afbeelding: JIA5

1. Het IP adres van de JOIN Zaak & Document server

U kunt kiezen voor de standaardwaarde door op enter te drukken wanneer uw integraties op dezelfde separate server geïnstalleerd zijn als JOIN Zaak & Document. Wanneer JOIN Zaak & Document en uw integraties op eigen applicatieserver geïnstalleerd zijn, moet hier het IP adres van de JOIN Zaak & Document server worden ingegeven.

2. De REST api baseurl:

Sinds JOIN versie 6.25 is er een REST API beschikbaar. JIA maakt nu dan ook gebruik van JOIN authenticatie om in te loggen in JIA. Alleen medewerkers met het Recht "Administrator" in JOIN Zaak & Document mogen in JIA inloggen. De REST API url is dezelfde als de JOIN URL. Bijvoorbeeld https://zaaksysteem.meervoort.nl/ De gehele URL inclusief / moeten ingevuld worden.

Voorbeeld-URL: https://zaaksysteem.joinsuite.nl/aspx/swagger/ui/index

3. Een Connect systeemnaam van één van uw integraties

Vul hier de naam in van 1 van uw integratie Connect systemen. De standaardwaarde 'STUFBG' kan worden bevestigd door op enter te drukken. Wanneer dit systeem niet bestaat kunt u een andere waarde ingeven. Kijk voor beschikbare systemen in de lijst systemen in JOIN Beheer.

Afbeelding: JIA7


4. Het client-secret van het ingegeven Connect systeem

Vul hier de client-secret in van het in vraag 2 gekozen Connectsysteem. U kunt deze waarde terugvinden in JOIN Beheer bij het desbetreffende Connect systeem:

Afbeelding: JIA8


Stap 6: Afronden installatie

Zodra het script is afgelopen staat u weer in de prompt en deze kan dan, mits er geen foutmeldingen meer zijn, afgesloten worden. Er is nu een lokale groep DIA aangemaakt. Hier moeten alle gebruikers in die toegang willen hebben tot JIA. Windows 2008 Server: Indien het een Windows 2008 server betreft moet ook nog even nagegaan worden of de DIAWeb Application Pool in IIS wel .Net 4.0 als versie heeft i.p.v. de standaard 2.0.

Stap 7: Test de verbindingen

U kunt nu een webbrowser openen naar http://servernaam:81/Diaweb of https://servernaam:8443/Diaweb. Indien u op de server ingelogd bent mag de servernaam natuurlijk ook localhost zijn.

Vanaf versie 2.5 is de toegang tot JIA gekoppeld aan uw JOIN Zaak & Document login. Indien u aangemerkt bent als JOIN beheerder kunt u inloggen. Indien u nog niet bent ingelogd in JOIN Zaak & Document wordt u bij het benaderen van JIA wordt u doorverwezen naar de inlogpagina van JOIN.


De installatie is succesvol afgerond!

JOIN XML Import service

Maakt u gebruik van de JOIN XML Import service, dan vindt u de informatie over installatie en configuratie hier: https://joinsupport.decos.com/a/solutions/articles/17000103095

Troubleshooting

Is er iets misgegaan met de installatie? Neem dan contact op met een van onze technisch specialisten of de afdeling JOIN Support.