UPDATEHANDLEIDING CODEX CLIENT

Transcriptie

1 UPDATEHANDLEIDING CODEX CLIENT Van Brug Software versie: 23 juni 2017

2 2017 Van Brug Software Hoewel deze handleiding met zeer veel zorg is samengesteld, aanvaardt Van Brug Software geen aansprakelijkheid voor enige schade ontstaan door eventuele fouten en/of onvolkomenheden in dit document. Voor vragen of opmerkingen betreffende deze of andere documentatie gaarne contact opnemen met: Van Brug Software Kantooradres: Sportlaan 2h, 8181 BE Heerde Postadres: Postbus 123, 8180 AC Heerde Tel.: (0578) Fax: (0578) Web:

3 Inhoudsopgave 1 Inleiding 4 2 Update Vereisten Client Rechten Silent installatie Voorbeeld command client Windows authentication (Aanbevolen) Voorbeeld command client SQL User De update (met gebruikersinterface) Databaseupdater 9 3 Bijlage A: Opzoeken van Word locaties Word Startup locatie Word User Startup locatie 10 4 Bijlage B: Update Checklist 11 versie: 23 juni 2017

4 Inleiding 1 INLEIDING Deze handleiding geeft inzicht in de update van de Codex client en geeft antwoord hoe de update kan plaatsvinden. Deze updatehandleiding is bedoelt voor Systeembeheerders. 4 versie: 23 juni 2017

5 Update 2 UPDATE 2.1 Vereisten Gedurende de update zal u een aantal gegevens moeten invullen, zorg dat u deze bij de hand heeft. Het gaat hierbij om de volgende gegevens: Client SQL servernaam en inlogmethode; Huidige locatie van client installatie (standaard C:\Program Files (x86)\van Brug\) 2.2 Rechten De update van het bestand setup.msi zal meerdere bestanden plaatsen op locaties waarvoor administratorrechten nodig zijn. Deze installatie zal daarom met administratorrechten moeten worden uitgevoerd. 2.3 Silent installatie Bij het uitvoeren van een silent update m.b.v. de commandline, zal de MSI opnieuw uitgevoerd moeten worden met de parameters die zijn opgegeven tijdens de initiële installatie Voorbeeld command client Windows authentication (Aanbevolen) msiexec.exe -i "setup.msi" ADDLOCAL=Client CONFIGURATIE_LOCATIE="\\vanbrugsoftware\Configs\" MODEL_PATH="\\vanbrugsoftware\Modellen\" ODBC_SERVERNAME="DatabaseServer\SQL2014" ODBC_DATABASE="Codex" ODBC_TRUSTED="Yes" WORDSTARTUP_PATH="C:\Program Files (x86)\microsoft Office\Office14\STARTUP\" WORDUSERSTARTUP_PATH="C:\Users\Gebruiker\AppData\Roaming\Microsoft\Word\Startup\" OFFICE="1" /passive /L*V "C:\package.log" Voorbeeld command client SQL User msiexec.exe -i "setup.msi" ADDLOCAL=Client CONFIGURATIE_LOCATIE="\\vanbrugsoftware\Configs\" MODEL_PATH="\\vanbrugsoftware\Modellen\" ODBC_SERVERNAME="DatabaseServer\SQL2014" ODBC_DATABASE="Codex" ODBC_TRUSTED="No" ODBC_USER="Kaartenbak" WORDSTARTUP_PATH="C:\Program Files (x86)\microsoft Office\Office14\STARTUP\" WORDUSERSTARTUP_PATH="C:\Users\Gebruiker\AppData\Roaming\Microsoft\Word\Startup\" OFFICE="1" /passive /L*V "C:\package.log" versie: 23 juni

6 Update 2.4 De update (met gebruikersinterface) Na het opstarten van de setup.msi verschijnt als eerste het volgende scherm: Om verder te kunnen gaan, moet eerst de Ik ga akkoord met de Algemene Voorwaarden worden aangevinkt. Klik vervolgens op Volgende. Hierin kan de locatie van de Codexonderdelen worden opgegeven. Controleer of deze locatie klopt met de huidige installatie. In deze map zou u de huidige mappenstructuur (Codex/Kaartenbak etc.) moeten terugvinden. Klik vervolgens op Volgende. Vervolgens verschijnt het volgende scherm: Selecteer Client. 6 versie: 23 juni 2017

7 Update In dit scherm moeten een aantal directorypaden worden opgegeven: Configuratiemap: de locatie waar de configuratie-bestanden zijn op de Server. (ApplicationSettings.config en Kaartenbak.ini) 1 Modellenmap: de locatie waar de modellen zich bevinden op de server. 1 Als u de Outlook Add-In wilt installeren dient u dit bij de derde optie aan te geven. Word startup: de locatie waar de Startup binnen MS-Word zich bevind (Zie Bijlage A: Opzoeken van Word locaties); Geb. startup: de locatie waar de Word startup bestanden van de gebruiker zich bevinden (Zie Bijlage A: Opzoeken van Word locaties) Als laatste moeten de connectiegegevens voor de database (SQL-server) worden opgegeven. Selecteer hiervoor de server en de gewenste inlogmethode. Mocht u niet zeker zijn van de desbetreffende inlogmethode dan kunt u in de AppManager deze vinden. Deze bovenste instellingen zullen worden opgeslagen voor een volgende update. Wanneer er nu op Volgende en vervolgens op Installeren wordt geklikt, zal de update beginnen. 1 Windows Installer ondersteund onder Bladeren geen UNC paden. Om deze paden in te kunnen vullen zal u het pad in het inputveld moeten kopiëren. versie: 23 juni

8 Update Wanneer de update afgerond is, verschijnt het volgende scherm. Klik op Voltooien om het scherm af te sluiten. Mocht de databaseupdater verplicht zijn dan zal u deze nog moeten uitvoeren. Instructies hiervoor zijn te vinden in het volgende hoofdstuk. 8 versie: 23 juni 2017

9 Update 2.5 Databaseupdater LET OP: Dit onderdeel is verplicht indien anders aangegeven op NISUpdate site. Voor het updaten van de database moet bij grote aanpassingen de database updater verplicht worden uitgevoerd, bij kleinere updates zal Codex bij het opstarten deze scripts uitvoeren. De database updater is te vinden naast de installatiebestanden. Zorg ervoor dat voordat u aan dit proces begint een back-up maakt van de desbetreffende database. Na het opstarten van de applicatie zal het onderstaande scherm getoond worden. Klik op Stap 1 aan de linkerzijde van het scherm, het onderstaande scherm zal getoond worden. In dit scherm zullen de ApplicationSettings gespecificeerd moeten worden. Deze settings zijn een vorige keer opgeslagen in een zogenaamd.vbdb bestand. Dit bestand kan ingeladen worden d.m.v. de selectie knop in de balk Selecteer instellingen bestand:. Klik op Stap 2 aan de linkerzijde van het scherm. Controleer de ingelezen gegevens en zorg ervoor dat er back-ups zijn gemaakt van de desbetreffende databases. Als alle gegevens kloppen kan de update gestart worden door op Update starten te klikken. Eventuele fouten tijdens het updaten kunnen worden gevonden in de melding kolom aan de rechterkant. versie: 23 juni

10 3 BIJLAGE A: OPZOEKEN VAN WORD LOCATIES 3.1 Word Startup locatie De algemene Word Startup locatie is per Word versie anders. Office 2013 / 2016: C:\Program Files (x86)\microsoft Office\Root\OfficeXX\Startup\ Office 2007 and 2010: 32 bit Word: "C:\Program Files (x86)\microsoft Office\OfficeXX\Startup\" 3.2 Word User Startup locatie Updatehandleiding Codex client Bijlage A: Opzoeken van Word locaties Bij Word is dit normaal gesproken (C:) > Users > USERNAME > AppData > Roaming > Microsoft > Word > STARTUP. Bij Nederlandse installaties zou het kunnen zijn dat er i.p.v. STARTUP, OPSTARTEN staat. De Startup locatie zou ook via Word gevonden kunnen worden: 1. Start Microsoft Word. 2. Selecteer File Locations/Bestandslocaties: Word 2010, Word 2013 of Word 2016: Selecteer File/Bestand > Options/Opties > Advanced/Geavanceerd > General group / Algemeen groep> File Locations/Bestandslocaties (Onderaan het scherm). Word 2007: Selecteer de Office knop > Word Options/Opties > Advanced/Geavanceerd > General group/algemeen groep > File Locations/Bestandslocaties (Onderaan het scherm). Word 2003: Selecteer Tools > Options/Opties > File Locations/Bestandslocaties tabblad. 3. Selecteer de regel Startup/Opstarten in de lijst en selecteer Modify/Wijzigen om de locatie te openen. 10 versie: 23 juni 2017

11 Bijlage B: Update Checklist 4 BIJLAGE B: UPDATE CHECKLIST Omschrijving Backups maken van databases en mogelijk Terminal Server Uitvoeren client installatie Controleren van installatie (Staat alles op C:\Program Files (x86)\van Brug\?) Verplicht indien anders aangegeven op UpdateSite: Uitvoeren databaseupdater Controleer de release notes voor eventuele additionele instructies betreft inrichting van Applicatie Manager. Controleren van installatie door Codex eenmaal op te starten en het Zoeken/aanmaken scherm te openen. versie: 23 juni