Nl/Terrasync: Difference between revisions

De HTTP terrascenery server bevat alle bekende bestanden die nodig zijn voor scenery, georganiseerd in de bekende directory-structuur (/Modellen, /Objects, /Terrain en /Airports) met al hun subdirectories. De inhoud van de map /Models bijvoorbeeld vind je hier: http://flightgear.sourceforge.net/scenery/Models/. Iedere map bevat een (verborgen) bestand genaamd .dirindex (bijv.  http://flightgear.sourceforge.net/scenery/Models/.dirindex). dat de inhoud van die map beschrijft door het overzicht van alle bestanden, submappen en checksums van de de bestanden en hun submappen' .dirindex files. Het terrasync. py script doet (vereenvoudigd) het volgende:

* b) gaat een submap in die in de. dirindex is opgenomen

Zelfs als alle scenerybestanden op de server aanwezig zijn, zijn er in eerste instantie nog ca. 40.000 .dirindexbestanden die ontbreken op jouw harde schijf en het downloaden zal uren duren. Om de procedure te versnellen, zodra je alle .dirindex bestanden lokaal hebt, kun je terrasync. py uitvoeren met de optie --quick. Dit zal terrasync. py vertellen om de berekende sha1sum van elk .dirindex bestand op jouw harde schijf te vergelijken met dat in de entry in de bovenliggende directories. dirindex. Als je een up-to-date mirror gebruikt zal deze vrij snel zijn omdat alleen de root. dirindex gedownload moet worden. Latere updates met de optie --quick  zullen ook zeer snel zijn, omdat alleen de bijgewerkte bestanden worden gedownload evenals de .dirindex bestanden van de bovenliggende mappen tot aan de hoofdmap.

Tot nu toe hebben we bestanden aan jouw harde schijf toegevoegd, maar hoe zit het met bestanden die van de server zijn verwijderd? Het script benadert ze meestal niet tenzij u aan de opdrachtregel de optie --remove-orphan toevoegt. Door dit te doen, vraagt u terrasync.py om alle bestanden (niet mappen) te verwijderen die in een subdirectory bestaan maar niet in het corresponderende. dirindex worden genoemd.

Als je niet alles in jouw huidige werkdirectory wilt downloaden, voeg dan --target=/map/bestand toe aan jouw opdrachtregel. Dit beschrijft vrijwel alles wat terrasync. py doet. Hieronder volgen enkele voorbeelden voor het gebruik:

Schakelen tussen SVN en HTTP terrasync is slechts een kwestie van het instellen van een opstart-eigenschap. De opdracht --prop: string: /sim/terrasync/http-server=automatisch maakt een keuze voor de HTTP, het niet opnemen van deze opdracht zal leiden tot het gebruik van de SVN-repository. De code lijkt robuust genoeg om heen en weer te kunnen schakelen tussen zonder verlies van data.<ref>{{cite web

Vanaf de release FlightGear 3.0 is TerraSync aanzienlijk veranderd. Standaard, wanneer ingeschakeld met <code>--enable-terrasync</code><ref name="enabling-TerraSync-with-specific-launchers>In FGRun, this can be done via the appropriate checkbox on the last page. In FFGo, just uncomment the <code>--enable-terrasync</code> option from the default configuration in the Options Window (the “big window” on the left, below the aircraft list).</ref> downloadt TerraSync nu naar downloaden_dir/TerraSync, waar download_dir de downloadmap van FlightGear is.

Vanaf FlightGear 2.4 is TerraSync geïntegreerd in het normale FlightGear menu, onder <tt>Omgeving > Scenery Download</tt> > Downloaden. Je kunt ook kiezen voor "Download scenery on the fly" in de GUI. Wees er wel op attent dat als je jouw vliegtuig wil laten starten in een nieuw gebied, waar je nog geen landschap van hebt gedownload, jouw vliegtuig eerst in het water kan lijken te staan totdat er voldoende landschap is gedownload. Via menu <tt>Omgeving > Scenery Download</tt> en "Manual Refresh" (Handmatig vernieuwen) kun je kiezen voor scenery-updates.

De -S optie maakt dat terrasync het SVN-protocol zal gebruiken om gegevens op te halen. Als je die optie weglaat zal terrasync in plaats daarvan het programma rsync gebruiken (maar dat moet dan wel op jouw systeem geïnstalleerd zijn).

# Controleer na het starten van FGRun of je je in het eerste scherm bevindt waar je directories kunt instellen. Eén keer "Terug" vanaf de vliegtuigkeuzepagina. U bent nu op de "Path" -pagina.

# Naast [[$FG_SCENERY|FG_SCENERY]] kun je een lijst met scenery directories aanmaken. Selecteer de lijn die TerraSync zal gebruiken en druk rechts op de knop "TerraSync directory". Op de geselecteerde regel verschijnt een kleine "T" die aangeeft dat deze is ingesteld als TerraSync-direcotry.

#* De directories worden van boven naar beneden geladen, dus zorg ervoor dat TerraSync bovenaan staat (tenzij je terrasync en scenes uit een andere directory wilt "passeren"). Wanneer twee directories landschappen bevatten voor dezelfde regio, zal FlightGear de scenery uit de directory halen die hoger in de lijst staat.

''Opmerking: Houd er rekening mee dat de firewall dit kan blokkeren zodra je het de eerste keer gebruikt; sta de firewall toe dat TerraSync de poort gebruikt.''

# Controleer na het starten van FGRun of je je in het eerste scherm bevindt, waar je directories kunt instellen. Eén keer "Terug" vanaf de vliegtuigkeuzepagina. Je bent nu hier:<br/>[[File:TerraSync 1.png|500px]]

# Om TerraSync te laten weten waar de gedownloade bestanden moeten worden opgeslagen, moet je het programma aangeven welke map de bestemmingsmap is. In bovenstaand voorbeeld is het de 3e in de lijst.

''Opmerking: Houd er rekening mee dat de firewall dit kan blokkeren zodra je het de eerste keer gebruikt; sta de firewall toe dat TerraSync de poort gebruikt.''

Als je op de commandline (zwart dialoogvenster) een fout krijgt, vergelijkbaar met het volgende:

en eventueel verschijnt de volgende popup:

=== Onberijkbare vliegveldmappen ===

Je krijgt een fout die aangeeft dat de map met vliegvelden onbereikbaar is,  terwijl TerraSync draait.

Zoek in de TerraSync-map naar bestanden met de naam lock en verwijder deze. Ze moeten automatisch worden verwijderd wanneer TerraSync wordt geupdate, maar soms mislukt dat.