Installeren en starten

TRAX Control is één bestand, trax-control-<versie>.jar. Het heeft Java 25 nodig (bijvoorbeeld OpenJDK 25) en verder niets: geen database en geen andere software. Het draait overal waar Java 25 draait: op Linux (ook op een Raspberry Pi), Windows en macOS.

Starten

1. Open een opdrachtvenster in de map waar het bestand staat en typ java -jar gevolgd door de naam van het bestand.

2. TRAX Control opent zelf geen venster. Het toont een startbericht; open daarna in een browser op die computer het adres http://localhost:8420.

3. In het startbericht staat achter “on the network” het adres voor je telefoon of tablet. Verder staan er de versie, de editie, de plaats van het logboek, de centrale, de geopende baan en het materieel.

Bij de eerste start is het de gratis editie, met een lege baan die “My layout” heet en de centrale “Loopback”; zie Je wilt uitproberen zonder centrale.

Waar alles wordt bewaard

Alles staat in één map: je materieel, je banen, je licentie, de rijregelaars en het logboek. Standaard is dat de map .trax-control in je persoonlijke map.

Met omgevingsvariabelen, die je instelt voordat je TRAX Control start, kies je iets anders:

• TRAX_CONTROL_HOME: een andere map.
• TRAX_CONTROL_PORT: een andere poort dan 8420.
• TRAX_CONTROL_STATION: een andere centrale dan de centrale die in het paneel “Command station” is gekozen.

Start het niet?

Meldt TRAX Control “port 8420 is already in use”, dan draait er waarschijnlijk al een TRAX Control op die computer.

Stop TRAX Control, vervang het bestand door het nieuwe en start het weer. Wat in de map van TRAX Control staat blijft bewaard. Welke versie er draait zie je in het paneel “Command station”.

Waar de pagina “Licence”; klik op het logo linksboven.

Zonder licentie is TRAX Control de gratis editie. Activeren zet de editie aan die je hebt. Je doet het één keer per installatie; daarna heeft TRAX Control er geen internet meer voor nodig.

Klik op het logo linksboven: dat opent de pagina “Licence”. Activeren kan alleen op de computer waarop TRAX Control draait. Er zijn drie manieren.

12345

1. 1 Je licentiesleutel
2. 2 “Activate”
3. 3 De code voor een ander apparaat (hier onleesbaar gemaakt)
4. 4 “Open the activation file”
5. 5 De code overtypen

Met je licentiesleutel

Typ je sleutel (1), twintig tekens in vier groepen van vijf, en kies “Activate” (2). Je sleutel staat op de website bij Mijn TRAX Control.

De browser waarmee je kijkt vraagt de licentie aan; dat apparaat heeft dus internet nodig. TRAX Control zelf gaat hiervoor niet online.

Met een ander apparaat

Heeft de computer geen internet, scan dan de code (3) met een telefoon, of open het adres dat ernaast staat op een computer die wel internet heeft. Je krijgt een klein bestand. Breng dat naar deze computer, desnoods op een USB-stick, en kies “Open the activation file” (4).

Door de code over te typen

In het uiterste geval (5): de activeringspagina op de website toont een code in regels. Typ die regels over; een typefout wordt in zijn regel aangewezen. Kies daarna “Activate with this code”.

Is het gelukt, dan meldt TRAX Control “Activated” met de naam van je editie, en het logo linksboven toont die editie.

Wat de pagina toont

123

1. 1 De editie
2. 2 De gegevens van de licentie en deze installatie (hier onleesbaar gemaakt)
3. 3 “Release this installation…”

Bovenaan staat de editie (1). Daaronder de gegevens (2): op wiens naam de licentie staat, het licentienummer, wanneer hij is geactiveerd, tot wanneer hij geldt (bij een licentie die afloopt), het nummer van deze installatie en de naam van de computer.

Waar de pagina “Licence”; klik op het logo linksboven.

Een testlicentie, een clublicentie en een lidmaatschap lopen af. Vanaf vier weken voor het einde wordt het logo oranje en staat de naam van de editie ernaast. De pagina toont dan “Renew”, met hoeveel dagen de licentie nog loopt, en twee knoppen: “Renew on the website” en “Fetch the renewal now”.

Heeft de computer internet, dan vraagt TRAX Control de vernieuwing ook zelf aan, elke vier uur. Zonder internet haal je een vernieuwing binnen zoals een activering.

Een afgelopen licentie blijft gelden tot je TRAX Control opnieuw start. Daarna is het de gratis editie, tot je vernieuwt.

Waar de pagina “Licence”; klik op het logo linksboven.

3

1. 3 “Release this installation…”

Met “Release this installation…” (3) wordt deze installatie de gratis editie, en kun je de licentie op een andere computer activeren. TRAX Control vraagt of je het zeker weet.

Heeft de computer geen internet, dan meldt TRAX Control dat de installatie hier is vrijgegeven. Geef hem dan ook vrij op de website, bij Mijn TRAX Control, zodat hij niet meer meetelt.

Bij de eerste start is de centrale “Loopback”: een denkbeeldige centrale. Er beweegt dan niets op de baan, maar al het andere werkt: je kunt je baan inlezen, materieel invoeren, diensten maken en treinen over het schema laten rijden.

Zolang er geen echte centrale is gekozen staat bovenin een oranje balk: “No real command station: nothing moves on the track.” Op een telefoon staat in plaats daarvan een oranje “Virtual” in de balk bovenaan.

Gebruik het om alles voor te bereiden voordat de centrale er is, om iets uit te proberen zonder dat er een trein rijdt, en om je ontwerp te testen voordat je bouwt; zie Je plan testen voordat je bouwt.

Een echte centrale kies je in het paneel “Command station”; zie Je wilt je centrale kiezen. Terug naar de denkbeeldige centrale ga je op dezelfde plaats: kies “Loopback”.