4 Gebruikersinterface en werking

BRWebUpdate starten

Dubbelklik op het BRWebUpdate -pictogram op uw bureaublad of navigeer via [Start] - [BrControls] naar de applicatie [BRWebUpdate]. BRWebUpdate zal vervolgens starten en direct uw lokale mappen scannen voor aanwezige applicaties, instellingsbestanden en bibliotheken

Het hoofdscherm van BRWebUpdate bestaat uit 6 gedeelten;

1. Vensterrand

• In de vensterrand staat links de applicatienaam [BRWebUpdate] en het huidige versienummer. Aan de rechterkant staan de welbekende Windows vensterbesturingselementen.

2. Hoofdmenu

Het hoofdmenu bestaat uit 6 knoppen, zijn onderverdeeld in 4 groepen op het lint:

• Lintgroep: View
  • [Home]
  • [Logging]
• Lintgroep: Scan for Files
  • [Rescan]
    • dropdownmenu: [Passive mode]
• Lintgroep: Setup
  • [WebUpdate]
    • dropdownmenu: [Check on startup]
• Lintgroep: Options
  • [Scan subfolders]
  • [UserFiles]

3. Versieboom

De versieboom bestaat uit 4 delen;

1. Huidige software- en bibliotheekversie;
2. Beschikbare softwareversies op het lokale werkstation;
3. De 3 recentste softwareversies op de updateserver;
4. Archief van vorige versies op de updateserver.

4. Bovenste informatiescherm

Het bovenste deel van het informatiescherm biedt gedetailleerde lokatie- en linkinformatie over de in de vensterboom geselecteerde softwareversie

5. Onderste informatiescherm

Dit deel van het informatiescherm toont diverse tabbladen met informatie van de in de versieboom geselecteerde updateversie;

6. Logscherm

Het logscherm biedt informatie over de acties die BRWebUpdate sinds het starten heeft uitgevoerd. Tevens worden hier eventuele foutmeldingen en looptijden van uitgevoerde acties getoond. Met de knop [Logging] in het hoofdmenu kan het gehele scherm worden gebruikt om de logging te raadplegen.

Wanneer BRWebUpdate is opgestart is de knop [Home] automatisch geactiveerd. Het startscherm zoals bij de paragraaf Applicatie overzicht is beschreven, is dan zichtbaar.

Als er een ander scherm actief is, bijvoorbeeld het Logging scherm, dan kan met de knop [Home] weer naar het startscherm worden teruggekeerd.

De knop [Logging] opent het volledige Logging-scherm. Dit scherm toont de acties, verbindingen en eventuele foutmeldingen die BRWebUpdate sinds het opstarten of sinds de vorige scan heeft uitgevoerd.

Een volledige uitleg van alle mogelijke logregels valt buiten de scope van dit document.

Tijdens gebruik van BRWebUpdate kunnen er mutaties op uw werkstation of op de server hebben plaatsgevonden. Door de knop [Rescan] te gebruiken vlak voor een download van een nieuwe versie of een andere bestandsbewerking die van invloed kan zijn geweest op de BRControls tooling, verzekert u zich ervan dat er altijd met actuele informatie wordt gewerkt.

Om het correct functioneren van de BRControls tooling te kunnen waarborgen is het van groot belang dat BRWebUpdate zelf ook up-to-date wordt gehouden. Vanzelfsprekend worden ook in de BRWebUpdate applicatie met enige regelmaat aanpassingen doorgevoerd en verbeteringen aangebracht.

Indien het selectievakje bij is geselecteerd in het dropdownmenu van de WebUpdate-knop dan zal BRWebUpdate bij elke start van de applicatie controleren of er een nieuwe versie beschikbaar is. U wordt dan via een pop-up geattendeerd op de nieuwe versie. Het verdient aanbeveling om een nieuwe versie zo snel mogelijk te installeren.

AIs het selectievakje niet is geselecteerd dan dient u zelf regelmatig op nieuwe versies te controleren door op de knop [WebUpdate] te klikken.

Indien deze optie is geselecteerd wordt het scannen voor applicaties, instellingsbestanden en bibliotheken gedaan op de hoofdmap en alle onderliggende mappen. Indien deze optie NIET is geselecteerd wordt het scannen voor applicaties, instellingsbestanden en bibliotheken gedaan op alleen de hoofdmap.

De mappen die worden gescand, zijn:

C:\Users\[jouw gebruikersnaam]\AppData\Roaming\brcontrols

C:\Program Files (x86)\BrControls

C:\BRControls\

Indien deze optie is geselecteerd worden de bestanden in de volgende map geïnstalleerd;

C:\Users\[jouw gebruikersnaam]\AppData\Roaming\BrWebUpdate

Indien deze optie NIET is geselecteerd worden de bestanden in de volgende map geïnstalleerd;

C:\Users\[jouw gebruikersnaam]\AppData\Local\Programs\[Applicatienaam]

óf

C:\Program Files (x86)\BrControls\[Applicatienaam]

Voordat u BRWebUpdate gebruikt dienen ALLE BRControls applicaties te worden afgesloten.

Het downloaden van een nieuwe versie van BRControls kan aanzienlijke hoeveelheden dataverkeer veroorzaken. De huidige release heeft, zelfs in gecomprimeerde vorm, een omvang van ruim 400 MB. Na het uitpakken en installeren kan de benodigde opslagruimte bovendien verder toenemen.

Het wordt daarom aanbevolen om updates niet of zo beperkt mogelijk via een 4G-mobiele verbinding uit te voeren. Dit voorkomt onnodig verbruik van de databundel, lange downloadtijden en mogelijke onderbrekingen tijdens het binnenhalen van installatiebestanden.

Stel het actualiseren van BRControls-applicaties bij voorkeur uit totdat een betrouwbare verbinding met voldoende bandbreedte beschikbaar is, zoals een vaste internetverbinding, een stabiel wifi-netwerk of een 5G-mobiele verbinding. Controleer vooraf of de verbinding voldoende stabiel is, zodat de download en installatie zonder datacorruptie of incomplete bestanden kunnen worden voltooid.

Voor versiebeheer gebruikt u vooral de versieboom en het informatiescherm.

De Versieboom toont bij [1] de huidige software- en bibliotheekversie, bij [2] de op het werkstation aanwezige versies, bij [3] de 3 meest recente versies op de updateserver en bij [4] het versiearchief op de updateserver

Het infoscherm toont bij [5] de diverse locatieinformatie van de updatebestanden en het tijdstempel van de update.

Bij [6] wordt, afhankelijk van het bij [7] gekozen tabblad, de volgende informatie getoond:

In onderstaande voorbeelden is het werkstation voorzien van Update_363_430_583_422 en wordt de softwareupdate Update_363_430_583_424 opgehaald en geïnstalleerd. Er wordt vanuit gegaan dat de gewenste update nog niet eerder van de updateserver is opgehaald en dus niet onder [2] zichtbaar is.

• Controleer de huidige softwareversie bovenin de vensterboom naast het Home-pictogram. In dit voorbeeld is dat Update_363_430_583_422
• Klap eventueel de boom bij [Latest WebUpdates available on server] open
• Klik met de linkermuisknop op het mapje met de gewenste update om deze te selecteren
• Klik vervolgens met de rechtermuisknop op de geselecteerde update en klik vervolgens in het pop-upmenu [Download version].

  

• Het WebUpdate-scherm wordt nu getoond met daarin de What's new informatie.
• Klik op [Next]

• Accepteer de licentie-overeenkomst door het keuzerondje [I accept] te selecteren en klik vervolgens op [Next]

• De bestanden die worden gedownload, worden nu getoond. Klik op [Next]

• De downloadvoortgang wordt getoond. Afhankelijk van de snelheid van de verbinding kan dit enige tijd in beslag nemen.
• Zodra de bestanden zijn gedownload, wordt er geen additioneel venster meer getoond maar zal de nieuwe versieupdate nu zichtbaar zijn in de vensterboom bij de lokale installaties (blauwe kader).

Nu alle benodigde bestanden op het werkstation beschikbaar zijn, dienen deze nog naar de correcte bestandslokaties gekopieerd te worden.

• Selecteer hiervoor met de linkermuisknop de lokale versie die u wilt gaan gebruiken. In dit voorbeeld is dat versie [Update363430583424].
• Zodra de versie geselecteerd is klikt u op de rechtermuisknop en in het pop-upmenu vervolgens op [Extract libraries and use as default].

• Voor het daarwerkelijke uitpakken en installeren verschijnt er een informatiescherm met de acties die uitgevoerd gaan worden.

• Klik op [OK] om door te gaan.
• Er verschijnt vervolgens een waarschuwingsscherm waarin wordt aangegeven dat de huidige applicatie-instellingen en bibliotheken zullen worden verwijderd.

• Klik op [Yes] om door te gaan en de installatie te starten.
• Tijdens de installatie zal het voortgangsscherm worden getoond.

• Na afronding (zonder verdere melding) zal de nieuwe bibliotheek- en softwareversie worden getoond en geselecteerd.

De update is nu volledig geïnstalleerd en alle betrokken applicaties zijn voorzien van de nieuwe softwaremodules en bibliotheken.

U kunt BRWebUpdate nu afsluiten en de gewenste BRControls applicaties weer opstarten.

Bij het uitvoeren van een WebUpdate worden niet uitsluitend bestanden overschreven. De applicatie voert feitelijk een volledige versieomschakeling uit van de betreffende kernelcomponenten en bijbehorende bibliotheken.

Het overschakelen naar een andere kernelversie verloopt volgens hetzelfde proces als de hierboven beschreven reguliere update.

Eerst verwijdert de applicatie alle bestanden die bij de momenteel geïnstalleerde kernelversie horen. Dit omvat niet alleen de kernelbestanden zelf, maar ook alle versieafhankelijke onderdelen, zoals:

• configuratiebestanden, waaronder .ini-bestanden;
• ondersteunende programmabestanden;
• bibliotheken;
• directorystructuren;
• overige onderdelen in de betrokken toolmappen.

Nadat de bestaande versie volledig is verwijderd, wordt het updatepakket van de geselecteerde kernelversie uitgepakt. Vervolgens kopieert de applicatie de aanwezige bestanden volgens de voorgeschreven directorystructuur naar de juiste locaties.

Omdat een kernelpakket uit een grote hoeveelheid gecomprimeerde gegevens en veel afzonderlijke bestanden kan bestaan, kan dit proces enige tijd duren.

Tijdens de WebUpdate wordt een knop [Abort] weergegeven. Deze functie is uitsluitend bedoeld voor noodsituaties en moet normaal gesproken niet worden gebruikt.

De updateprocedure is namelijk niet transactioneel: er is geen gegarandeerde rollback naar de vorige toestand wanneer de actie wordt afgebroken.

Op het moment dat [Abort] wordt gebruikt, kunnen bestanden van de oude kernelversie al zijn verwijderd, terwijl de nieuwe versie nog niet volledig is uitgepakt en geïnstalleerd. Hierdoor ontstaat een inconsistente installatie, waarbij bestanden, configuraties of directorystructuren ontbreken of niet meer met elkaar overeenkomen.

In deze toestand kan de BRControls-tooling mogelijk niet meer correct starten of functioneren.

Wanneer een WebUpdate is onderbroken met [Abort], moet altijd opnieuw een volledige update worden uitgevoerd. Start daarbij de update voor de gewenste kernelversie opnieuw en laat deze zonder onderbreking afronden.

De updateprocedure plaatst dan opnieuw alle benodigde binaries, configuratiebestanden en overige versieafhankelijke componenten in de juiste mappen. Pas nadat de update succesvol is voltooid, is de installatie weer consistent en kan de BRControls-tooling betrouwbaar worden gebruikt.