Boxwise brengt ongeveer 1 update per kwartaal uit (4 per jaar). Boxwise updates worden lokaal op de boxwise server van de klant geïnstalleerd. Deze server wordt vaak door de klant zelf gehost, maar dit kan ook een boxwise private cloud server zijn die door boxwise zelf wordt gehost.
Ter voorbereiding van de update zijn er verschillende zaken die geregeld of ingericht moeten zijn. In dit artikel geven wij een overzicht van alles dat geregeld en ingericht moet zijn door de klant om een boxwise update te kunnen uitvoeren.
Het update proces
- Boxwise communiceert dat er een nieuwe update beschikbaar is.
- De klant vraagt via een ticket de update aan.
- Boxwise geeft een ureninschatting af indien de klant (veel) maatwerk heeft.
- Bij akkoord op de uren plant boxwise een maatwerk controle in. Tijdens deze maatwerk controle wordt bestaand maatwerk bijgeschaafd of herschreven om compatibel te zijn met de nieuwe versie.
- Nadat de maatwerk controle is uitgevoerd kan de update ingepland worden via www.boxwise.nl/update. Boxwise geeft ook de nodige instructies af die door de klant opgevolgd dienen te worden ter voorbereiding.
-
- Indien er een test server aanwezig is zal de update eerst op de testserver worden geïnstalleerd.
-
- Boxwise voert de update op het afgesproken tijdstip uit. Tijdens de update ligt boxwise eruit en zal niemand met boxwise kunnen werken. Vlak voor en na de werkzaamheden zal er contact plaatsvinden met de klant voor aankondigingen.
- Na de update kan de klant gaan testen of alles werkt en de werkzaamheden hervatten. Als het gaat om een test omgeving kan de klant het proces uitgebreid gaan testen en de update voor de productie omgeving inplannen via een ticket.
Update vereisten
Om de boxwise update uit te kunnen voeren moet er aan alle vereisten worden voldaan. De klant dient ervoor te zorgen dat er aan deze vereisten wordt voldaan. Als er tijdens de update blijkt dat er toch problemen zijn loopt de klant het risico op vertraging of zelfs uitstel van de update.
Tijdens de update installeren / update wij de onderstaande boxwise services op de server:
- Boxwise Pro Server
- Boxwise API
- Boxwise Print Agent
Server/database gerelateerde vereisten
Gebruikersrechten
Wij loggen remote in met de gebruiker die bij ons bekend is. Vaak is dit de gebruiker waaronder de "Boxwise Pro Server" service draait. Er moet aan de volgende vereisten worden voldaan:
- De gebruiker moet open staan of op korte termijn opengezet kunnen worden via contact de IT servicedesk zodat wij remote kunnen inloggen.
- De gebruiker moet een domein gebruiker zijn met local admin rechten. Het is belangrijk dat de gebruiker bestanden kan uitvoeren en installeren en ook services kan aanmaken, stoppen, starten en bijwerken.
- De gebruiker kan idealiter bestanden vanaf een boxwise werkplek kunnen kopiëren naar de boxwise server. Zo niet, dan dient de klant de installatie setup zelf op de server beschikbaar te stellen voor de gebruiker.
- Indien nodig zullen wij via Microsoft SQL Server Management Studio of Query Express query's op de boxwise database uitvoeren. Dat betekent dat deze gebruiker toegang moet hebben tot een van deze 2 programma's op de boxwise of database server. Als dat programma alleen beschikbaar is op de database server moet de gebruiker de rechten hebben om op die server kunnen komen.
- Aanvullend daarop moeten wij ook de rechten hebben om een back-up te kunnen maken van de boxwise database. Dat doen wij in het geval er niet door de IT afdeling dagelijks een back-up of snapshot wordt gemaakt.
Database
- De SQL Server moet minstens versie 2014 zijn. Lagere versie wordt niet meer ondersteund door Boxwise.
Netwerk
- De endpoints uit dit artikel dienen gewhitelist te zijn: Standaard netwerk poorten. Meestal is dat tijdens de implementatie al door de IT afdeling geregeld. Om maatwerkaanpassingen binnen te halen moeten wij in "git" het endpoint bitbucket.org via poort 22 of altssh.bitbucket.org over poort 443 kunnen bereiken. Git wordt tijdens de implementatie al geïnstalleerd op de server.
- Aanvullend daarop moeten er Microsoft .NET updates uitgevoerd kunnen worden. Indien het .NET framework op de server achterloopt zal er tijdens de installatie een officiële Microsoft URL aangeroepen worden om de update te downloaden. Indien dat dicht staat moet het mogelijk zijn om het .NET framework update bestand op de server te zetten zodat het lokaal geïnstalleerd kan worden.
Virusscanner
Tijdens de update worden er eerst bestanden verwijderd en daarna geïnstalleerd door de installer. Helaas houden sommige virusscanners het bijwerken van bestanden tegen tijdens het uitvoeren van een boxwise update. Het gevolg hiervan is dat boxwise is verwijderd en vervolgens niet geïnstalleerd kan worden. Hierdoor kan de klant, totdat de virusscanner is uitgeschakeld, helemaal geen gebruik maken van boxwise. Wij vragen daarom de klant uit voorzorg om de virusscanner uit te zetten.
De volgende virusscanners hebben in het verleden voor problemen gezorgd bij een boxwise update:
- Sentinel One
- Webroot
- ESET
- Cortex
Door de volledige boxwise folder te whitelisten in de configuratie van deze virusscanners is het mogelijk om de update alsnog succesvol uit te voeren. Deze configuratie is niet bij ons bekend, maar we weten dat het wel mogelijk is. Onderstaand het adres van de boxwise folder:
- C:\Program Files (x86)\Trancon\BoxwisePro\Server
- Let op: niet bij alle klanten zal boxwise op de C schijf geïnstalleerd zijn.
AFAS vereisten (niet van toepassing voor Exact klanten)
Onze AFAS gebruiker (tranconsupport) moet de onderstaande rechten hebben:
- Getconnectoren mogen importeren en bijwerken
- Toegang tot de management tool inclusief importeer rechten
- Toegang tot de appconnector
Update instructies
Boxwise zal in het ticket instructies geven aan de klant over boxwise handelingen die voor- en na de update doorlopen moeten worden. Ook deze instructies zijn belangrijk om ervoor te zorgen dat de update goed zal verlopen.
Instructies voorafgaand aan de update
- Alle gebruikers dienen uit te loggen uit boxwise, zowel scanners, touch applicaties als management portals.
- Er mogen geen batches meer in boxwise staan.
- Alle inkooporders waaraan al in boxwise werd gewerkt dienen te worden verwerkt.
- Op de werkstations waar wordt gewerkt met de touch applicatie dient minimaal Microsoft .NET Framework 4.8 actief te zijn. Doorgaans is dit het geval als de Windows updates netjes worden uitgevoerd.
- Indien aanwezig moeten de automatisch batch taken uitgezet worden.
Instructies na de update
- Indien de touch applicatie zichzelf niet automatisch update dient deze eenmalig verwijderd te worden en opnieuw geïnstalleerd te worden. Lees dit artikel voor meer details: Hoe verwijder ik de touch applicatie?
- Start de scanners op, deze zullen eenmalig vanzelf de nieuwe versie van boxwise downloaden. Als dat niet lukt kunnen deze stappen worden gevolgd: Updaten van de Warehouse app
- Gebruikers mogen pas inloggen in de applicatie nadat de medewerkers van boxwise hebben aangegeven dat de update is uitgevoerd.
- Indien je scripttaken hebt die automatisch batchen, kun je deze weer inschakelen nadat wij het signaal hebben gegeven dat alles goed is.