# Context pack: Installatie, gegevensmap en logboeken Source: https://nordvec.com/nl/docs/guides/desktop/install-and-data Pack: https://nordvec.com/nl/docs/packs/desktop/install-and-data This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Installatie, gegevensmap en logboeken](https://nordvec.com/nl/docs/guides/desktop/install-and-data) (this guide) 2. [Bekende problemen desktop-app](https://nordvec.com/nl/docs/guides/desktop/known-issues) (linked from this guide) --- # Installatie, gegevensmap en logboeken Source: https://nordvec.com/nl/docs/guides/desktop/install-and-data Wat de Nordvec-desktopapp installeert op Windows, macOS en Linux, elk bestand dat het naar de schijf schrijft, en waar het logbestand zich bevindt. Deze pagina geeft aan waar de desktop-app schrijft op elk besturingssysteem, voor jouw eigen administratie of een IT-beoordeling. Hij wordt gegenereerd vanuit de buildconfiguratie van de app en de bestandsnamen die de code schrijft, dus wijzigt wanneer deze veranderen. De app is **Nordvec Desktop**, applicatie-id `com.nordvec.desktop`. ## Windows [#windows] * **Installatieprogramma:** een `.exe` setup-programma voor x64. * **Installeren voor:** het installatieprogramma vraagt of je het alleen voor jezelf of voor iedereen op de computer wilt installeren. Alleen voor jou is voorgeselecteerd en vereist geen beheerdersrechten. * **Installatiemap:** je kunt deze kiezen in het installatieprogramma. * **Deïnstalleren** verwijdert de onderstaande gegevensmap samen met de app. Bijwerken doet dit niet. * **Gegevensmap:** `%APPDATA%\Nordvec Desktop` * **Logbestand:** `%APPDATA%\Nordvec Desktop\logs\nordvec-.log` ## macOS [#macos] * **Download:** een schijfkopie (`.dmg`) of een `.zip` archief, voor Apple silicon en Intel Macs (één universele build). * **Vereist:** macOS 13.0 of hoger. * **De app verwijderen** laat de onderstaande gegevensmap intact; verwijder deze om de lokale syncgegevens te wissen. * **Gegevensmap:** `~/Library/Application Support/Nordvec Desktop` * **Logbestand:** `~/Library/Application Support/Nordvec Desktop/logs/nordvec-.log` ## Linux [#linux] * **Download:** een AppImage voor x64. Deze draait onder jouw gebruikersaccount, zonder systeembrede installatie. * **De app verwijderen** laat de onderstaande gegevensmap intact; verwijder deze om de lokale syncgegevens te wissen. * **Sleutelbos:** de app heeft een actieve gnome-keyring of KWallet nodig om de lokale syncgegevens te versleutelen, en synchroniseert niet zonder. * **Gegevensmap:** `~/.config/Nordvec Desktop` * **Logbestand:** `~/.config/Nordvec Desktop/logs/nordvec-.log` * Wanneer `XDG_CONFIG_HOME` is ingesteld, is de gegevensmap `$XDG_CONFIG_HOME/Nordvec Desktop` in plaats daarvan. ## Wat er in de gegevensmap staat [#wat-er-in-de-gegevensmap-staat] Alles wat de app op jouw computer bewaart, staat in de gegevensmap voor jouw besturingssysteem, hierboven. Elk ingelogd account heeft een eigen syncopslag. | Naam | Wat het bevat | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sync-state-.sqlite` | De syncstore voor één ingelogd account: bewaakte mappen, uitsluitingen, de wachtrijen voor uploaden en verwijderen, en wat gesynchroniseerd is. Bestandsnamen en paden hierin zijn versleuteld met een sleutel die de sleutelbos van het besturingssysteem beveiligt. | | `logs/nordvec-.log` | Het logboek van de app voor één dag. Het registreert gebeurtenissen, tellingen en foutcodes, en elke regel vermeldt de appversie die deze heeft geschreven. Het is zo geschreven dat het geen bestandsnamen, paden of bestandsinhoud bevat. | | `logs/nordvec-.1.log` | Het eerdere deel van het logboek van een dag, bewaard wanneer het logboek van die dag zijn groottelimiet bereikt. Maximaal één per dag. | | `window-state.json` | De laatste grootte en positie van het venster. | | `ui-locale` | De taal van de laatste pagina die de app heeft getoond, zodat het systeemvakmenu en meldingen deze gebruiken. | | `update-health.json` | Wanneer de app voor het laatst heeft gecontroleerd op updates en of de controles mislukken. | | `whats-new-version` | De laatste versie waarvan de app de lijst met wijzigingen heeft getoond, zodat de wijzigingen van elke update één keer worden getoond. | | `first-run-done` | Markeert dat de eerste start is uitgevoerd, zodat automatisch opstarten bij inloggen alleen voor een nieuwe installatie wordt ingeschakeld. | | `crash-ledger.json` | Wanneer de app voor het laatst is gestopt door een fout, alleen als tijdstippen, zodat een tweede stop kort na het heropenen ervoor zorgt dat de app gesloten blijft in plaats van opnieuw te openen. | Terwijl de syncopslag open is, bewaart SQLite `-wal`, `-shm`, `-journal` bestanden naast `sync-state-.sqlite`; deze horen bij de opslag. De app bewaart ook de cookies en sitelocalstorage van de ingelogde sessie in de gegevensmap. De cookiewinkel is versleuteld met een sleutel die de sleutelhanger van het besturingssysteem beveiligt. Op een computer die een vroege build heeft uitgevoerd, kun je ook het volgende aantreffen: | Naam | Wat het bevat | | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sync-state.json` | Status geschreven door een vroege build. Bij het inloggen geeft de app deze door aan het account dat er eigenaar van is, en behoudt deze wanneer het niet kan vaststellen van wie deze is. | | `logs/nordvec.log` | Het logboek dat een vroege build heeft geschreven. Het wordt verwijderd samen met de dagelijkse logboeken zodra het oud genoeg is. | | `logs/nordvec.log.old` | Het vorige logboek dat een vroege build naast het huidige bewaarde, verwijderd onder dezelfde voorwaarden. | | `sync-state-.json` | Per-accountstatus geschreven door een vroege build. Bij het inloggen kopieert de app deze naar de syncstore en hernoemt deze zodra de kopie is teruggelezen. | | `sync-state-.json.imported` | Dezelfde vroege status nadat de inhoud ervan is gekopieerd naar de syncstore. Het bevat onversleutelde bestandsnamen en paden en niets leest het opnieuw, dus het is veilig om te verwijderen. | ## Logbestand [#logbestand] De app schrijft één logbestand per dag, `logs/nordvec-.log` in de gegevensmap, waarbij de datum de dag op jouw computer is. Om hun map vanuit de app te openen, kies je **Help > Logbestand weergeven**. Wanneer het logboek van een dag 5 MB bereikt, worden de eerdere regels verplaatst naar `nordvec-.1.log`, zodat één dag maximaal twee bestanden bevat. De app bewaart de laatste 14 dagen, inclusief vandaag, en maximaal 50 MB aan logboeken in totaal, waarbij de oudste dagen als eerste worden verwijderd. Het verwijdert nooit het logboek van vandaag en verwijdert alleen bestanden met deze namen. Elke regel vermeldt de build die deze heeft geschreven, als `v= sha=` na de tijd en het niveau. ## Welke versie je hebt [#welke-versie-je-hebt] * Windows: kies **Help > Over Nordvec Desktop**. * macOS: kies **Nordvec Desktop > Over Nordvec Desktop**. * Linux: kies **Help > Over Nordvec Desktop**. * Bij elke start schrijft de app ook een regel die begint met `app_ready version=` naar het logbestand, gevolgd door de versie. ## Een probleem melden [#een-probleem-melden] Controleer eerst de [bekende problemen](/docs/guides/desktop/known-issues). Om een bug te melden, neem je de appversie op en, als je kunt, het logbestand. De app is zo geschreven dat het geen bestandsnamen, paden of bestandsinhoud logt, maar lees het logbestand voordat je het deelt en verwijder alles wat je niet wilt verzenden. --- # Bekende problemen desktop-app Source: https://nordvec.com/nl/docs/guides/desktop/known-issues Waarom de Nordvec desktop-app een map weigert, een bestand overslaat, een verwijdering vasthoudt of stopt met synchroniseren, en wat je daaraan kunt doen. Elke vermelding hieronder is een beslissing die de desktop-app met opzet neemt. Deze pagina wordt gegenereerd vanuit de codes waarmee de app beslist, dus elke weigeringscode die hij kan rapporteren, staat hier vermeld met de oorzaak en een oplossing. Als wat je ziet hier niet staat, [meld het](/docs/guides/desktop/install-and-data#reporting-a-problem) met jouw appversie en logbestand. ## Mappen die de app niet toevoegt [#mappen-die-de-app-niet-toevoegt] De app weigert deze mappen wanneer je ze selecteert, en geeft aan waarom. ### Een volledige schijf kan niet worden toegevoegd [#een-volledige-schijf-kan-niet-worden-toegevoegd] Wat je ziet: **Een volledige schijf is te breed om te synchroniseren. Kies in plaats daarvan een map erop.** **Oorzaak:** De hoofdmap van een schijf bevat veel meer dan alleen documenten, en het bewaken ervan zou elke scan en verwijdering de hele schijf laten doorlopen. **Oplossing:** Voeg de mappen op die schijf die jouw documenten bevatten één voor één toe. ### Jouw thuismap kan niet worden toegevoegd [#jouw-thuismap-kan-niet-worden-toegevoegd] Wat je ziet: **Jouw accountmap bevat appgegevens en instellingen naast documenten, en de naam ervan is de accountnaam van jouw computer. Kies Documenten, Bureaublad of een andere map erin.** **Oorzaak:** Jouw thuismap bevat appgegevens, instellingen en caches naast documenten, dus het bewaken ervan zou al deze gegevens in Nordvec plaatsen. De naam is ook de naam van jouw computeraccount. **Oplossing:** Voeg in plaats daarvan Documenten, Bureaublad of een andere map binnen jouw thuismap toe. ### Een map binnen of rondom een bewaakte map kan niet worden toegevoegd [#een-map-binnen-of-rondom-een-bewaakte-map-kan-niet-worden-toegevoegd] Wat je ziet: **Deze map overlapt met een map die je al bewaakt.** **Oorzaak:** Een bestand in twee bewaakte mappen zou twee eigenaren hebben, en een uitsluitingsinstelling op de ene map zou niet gelden via de andere. **Oplossing:** Bestanden in een map binnen een bewaakte map synchroniseren al, dus er valt niets toe te voegen. Om een bredere map te bewaken, stop je eerst met het bewaken van de smallere: de documenten verdwijnen uit Nordvec totdat de bredere map ze opnieuw synchroniseert. ## Bestanden die niet worden gesynchroniseerd [#bestanden-die-niet-worden-gesynchroniseerd] Deze bestanden blijven op jouw computer staan en worden op de Desktop-syncpagina vermeld met de reden, zodat antwoorden ze niet kunnen citeren. ### Het pad van een bestand is te lang [#het-pad-van-een-bestand-is-te-lang] Wat je ziet: **Het pad is te lang voor dit systeem** **Oorzaak:** Het volledige pad is langer dan wat dit besturingssysteem toelaat om door de app te worden gelezen. **Oplossing:** Verkort de map- of bestandsnamen, of verplaats de map dichter naar de bovenkant van de schijf. Het bestand synchroniseert zodra het pad kort genoeg is. ### Een bestand kon niet worden gelezen [#een-bestand-kon-niet-worden-gelezen] Wat je ziet: **Dit bestand kon niet worden gelezen** **Oorzaak:** Het besturingssysteem weigerde de app leestoegang tot het bestand. **Oplossing:** Geef jouw gebruikersaccount leestoegang tot het bestand. Op macOS laat je Nordvec Desktop toe onder Systeemvoorkeuren, Privacy & Beveiliging, Bestanden en mappen. De app leest het bestand opnieuw wanneer het verandert en elke keer dat de app start. ### Een item is geen gewoon bestand [#een-item-is-geen-gewoon-bestand] Wat je ziet: **Dit is geen gewoon bestand** **Oorzaak:** Het is een symbolische link, een apparaat, een pipe of een ander speciaal bestand. De app leest alleen gewone bestanden, dus een link kan hem nooit naar een bestand leiden dat je niet hebt geselecteerd. **Oplossing:** Voeg de map toe die het echte bestand bevat in plaats van de link. ### Een bestand heeft meer dan één naam op schijf [#een-bestand-heeft-meer-dan-één-naam-op-schijf] Wat je ziet: **Dit bestand heeft meer dan één naam op schijf** **Oorzaak:** Het bestand is een harde link: dezelfde gegevens hebben een tweede naam, die buiten de map kan staan die je hebt gekozen. De app kan niet bepalen bij welke map de gegevens horen, dus leest hij ze niet. Back-uptools die op deze manier ruimte besparen, produceren dergelijke bestanden. **Oplossing:** Vervang het bestand door een gewone kopie ervan, die één naam heeft. ### Een bestand leidt buiten de bewaakte map [#een-bestand-leidt-buiten-de-bewaakte-map] Wat je ziet: **Dit bestand leidt buiten de bewaakte map** **Oorzaak:** Het pad van het bestand wordt, via een link of een junction, omgezet naar een locatie buiten de map die je hebt gekozen. **Oplossing:** Voeg de map toe waar het bestand echt in staat. ### Een bestand staat in een map die je hebt uitgesloten [#een-bestand-staat-in-een-map-die-je-hebt-uitgesloten] Wat je ziet: **Dit bestand staat in een map die je hebt uitgesloten** **Oorzaak:** Je hebt een submap van een bewaakte map uitgesloten, en een bestand dat je daarin selecteert, blijft uitgesloten. **Oplossing:** Zet de submap weer aan in de kaart van de map op de Desktop-syncpagina, en de bestanden synchroniseren. ### Een bestand is groter dan de limiet voor het type [#een-bestand-is-groter-dan-de-limiet-voor-het-type] Wat je ziet: **Dit bestand is groter dan de limiet voor het type** **Oorzaak:** Elk bestandstype heeft een groottelimiet, die wordt gecontroleerd voordat het bestand wordt gelezen. Als een eerdere, kleinere versie was gesynchroniseerd, wordt de kopie verwijderd zodat antwoorden nooit inhoud citeren die het bestand niet meer heeft. **Oplossing:** Splits het bestand op in kleinere bestanden, of sla het op in een compacter formaat. ### Een bestand is leeg [#een-bestand-is-leeg] Wat je ziet: **Dit bestand is leeg, dus er valt niets te doorzoeken** **Oorzaak:** Een bestand zonder inhoud heeft niets om te doorzoeken. Als een eerdere versie inhoud had, wordt de kopie verwijderd om dezelfde reden als een te groot bestand. **Oplossing:** Niets te doen: het bestand synchroniseert zodra het inhoud heeft. ### Een bestandstype kan niet worden doorzocht [#een-bestandstype-kan-niet-worden-doorzocht] Wat je ziet: **Dit bestandstype kan niet worden doorzocht** **Oorzaak:** De extensie van het bestand is er geen die de app synchroniseert. **Oplossing:** Sla het bestand op of exporteer het als een van de typen in de groottelimiettabel aan het einde van deze pagina. ### Een bestand kon niet worden toegevoegd [#een-bestand-kon-niet-worden-toegevoegd] Wat je ziet: **Dit bestand kon niet worden toegevoegd** **Oorzaak:** Het lezen van het bestand is mislukt om een andere reden dan de bovenstaande, bijvoorbeeld omdat het veranderd of vergrendeld was terwijl de app het las. **Oplossing:** Sluit wat het bestand geopend heeft. De app leest het bestand opnieuw wanneer het verandert en elke keer dat de app start. Als hetzelfde bestand steeds mislukt, meld het dan met jouw logbestand bijgevoegd. ## Verwijderingen die op jou wachten [#verwijderingen-die-op-jou-wachten] Er wordt niets uit Nordvec verwijderd zolang de app een verwijdering niet kan onderscheiden van een map die alleen onbereikbaar is. ### Veel bestanden die tegelijk zijn verwijderd, blijven in Nordvec totdat je bevestigt [#veel-bestanden-die-tegelijk-zijn-verwijderd-blijven-in-nordvec-totdat-je-bevestigt] Wat je ziet: **Grote verwijdering vastgehouden voor beoordeling** **Oorzaak:** Wanneer meer dan 25% van de bestanden van een map binnen 7 dagen verdwijnt (in een map van minimaal 20 bestanden), houdt de app hun verwijdering uit Nordvec tegen in plaats van deze uit te voeren, omdat een verplaatste of losgekoppelde map er hetzelfde uitziet als een verwijdering. **Oplossing:** Bevestig de verwijdering op de kaart van de map op de Desktop-syncpagina, of zet de bestanden terug. Een vastgehouden verwijdering die je niet bevestigt, wordt uitgevoerd op de datum die de pagina toont. ### Een map die niet kan worden gelezen, houdt zijn documenten in Nordvec [#een-map-die-niet-kan-worden-gelezen-houdt-zijn-documenten-in-nordvec] Wat je ziet: **Een gesynchroniseerde map ontbreekt** **Oorzaak:** Wanneer een bewaakte map helemaal niet kan worden gelezen, bijvoorbeeld op een losgekoppelde schijf of netwerkshare, behandelt de app deze als onbereikbaar in plaats van leeg en verwijdert niets. **Oplossing:** Sluit de schijf opnieuw aan en het synchroniseren wordt hervat. Om de documenten van de map uit Nordvec te verwijderen, stop je met het bewaken van de map. ## Documenten die Nordvec verlaten [#documenten-die-nordvec-verlaten] Een document in Nordvec volgt zijn bestand op jouw computer. Dit zijn de twee manieren waarop er een wordt verwijderd. ### Een document verliet Nordvec nadat het bestand werd verplaatst, hernoemd of verwijderd [#een-document-verliet-nordvec-nadat-het-bestand-werd-verplaatst-hernoemd-of-verwijderd] **Oorzaak:** Een document staat in Nordvec omdat het bestand in een bewaakte map staat. Wanneer het bestand wordt verwijderd of buiten de map wordt verplaatst, wordt de kopie verwijderd. Een hernoemd of verplaatst bestand is een nieuw pad, dus het synchroniseert opnieuw als een nieuw document. **Oplossing:** Zet het bestand terug, of wacht tot het verplaatste bestand synchroniseert. Een bestand dat terug is op schijf voordat de verwijdering wordt uitgevoerd, behoudt zijn document. ### Documenten verlieten Nordvec nadat je stopte met het bewaken of uitsluiten van een map [#documenten-verlieten-nordvec-nadat-je-stopte-met-het-bewaken-of-uitsluiten-van-een-map] **Oorzaak:** Het stoppen met het bewaken van een map, of het uitsluiten van een submap, verwijdert de documenten uit Nordvec. De bestanden op jouw computer worden niet aangeraakt. **Oplossing:** Voeg de map opnieuw toe, of verwijder de uitsluiting, en de bestanden synchroniseren opnieuw. ## Wanneer synchronisatie uitstaat [#wanneer-synchronisatie-uitstaat] Elk van deze stopt de synchronisatie voor het ingelogde account totdat het is opgelost, en de app geeft aan welke het is. ### Synchronisatie staat uit omdat de computer geen sleutelbos heeft [#synchronisatie-staat-uit-omdat-de-computer-geen-sleutelbos-heeft] Wat je ziet: **Nordvec versleutelt jouw lokale synchronisatiegegevens met een sleutel uit jouw systeemsleutelbos, en deze computer heeft er geen beschikbaar. Installeer en ontgrendel een sleutelbos (gnome-keyring of kwallet), en log opnieuw in.** **Oorzaak:** De app versleutelt zijn lokale synchronisatiegegevens met een sleutel die de sleutelbos van het besturingssysteem beschermt, en valt nooit terug op het onversleuteld opslaan van bestandsnamen. Op Linux zonder een actieve gnome-keyring of KWallet is er geen sleutelbos om de sleutel in op te slaan. **Oplossing:** Installeer en ontgrendel gnome-keyring of KWallet, en log opnieuw in. ### Synchronisatie staat uit omdat een nieuwere versie de lokale gegevens heeft geschreven [#synchronisatie-staat-uit-omdat-een-nieuwere-versie-de-lokale-gegevens-heeft-geschreven] Wat je ziet: **Jouw synchronisatiegegevens zijn geschreven door een nieuwere versie van Nordvec. Werk de app bij om het synchroniseren te hervatten.** **Oorzaak:** De lokale synchronisatiegegevens zijn geschreven door een nieuwere versie van de app, meestal omdat een oudere versie eroverheen is geïnstalleerd. **Oplossing:** Installeer de nieuwste versie. ### Synchronisatie staat uit omdat de lokale synchronisatiegegevens niet kunnen worden gelezen [#synchronisatie-staat-uit-omdat-de-lokale-synchronisatiegegevens-niet-kunnen-worden-gelezen] Wat je ziet: **Jouw lokale synchronisatiestatus kon niet worden gelezen. Synchroniseren is gepauzeerd; opnieuw installeren kan nodig zijn.** **Oorzaak:** De synchronisatiewinkel kon niet worden geopend of gelezen, bijvoorbeeld omdat het bestand beschadigd is of de sleutel niet kan worden ontgrendeld door dit gebruikersaccount. **Oplossing:** Meld het met jouw logbestand bijgevoegd. Verwijder de gegevensmap niet eerst: deze kan verwijderingen bevatten die Nordvec nog niet hebben bereikt. ## Bestandsgrootte limieten [#bestandsgrootte-limieten] De app synchroniseert deze bestandstypen, elk tot de weergegeven grootte. Een groter bestand wordt vermeld als te groot, en een type dat niet in deze tabel staat als een type dat niet kan worden doorzocht. | Grootste bestand | Bestandstypen | | ---------------- | ------------------------------------------------------------------ | | 50 MB | `.csv`, `.docx`, `.htm`, `.html`, `.pdf`, `.pptx`, `.xls`, `.xlsx` | | 20 MB | `.json`, `.xml` | | 15 MB | `.gif`, `.jpeg`, `.jpg`, `.png`, `.svg`, `.webp` | | 10 MB | `.md`, `.txt` | | 5 MB | `.js`, `.jsx`, `.py`, `.sql`, `.ts`, `.tsx` |