Frequently asked questions:
F: Was ist Java und wozu ist es gut?
A: Java ist die Programmiersprache mit der Magellan geschrieben ist. Das Besondere an Java ist, dass es auf verschiedenen Plattformen läuft (Windows, Linux, Mac, ...). Um Magellan auszuführen, muss Java vorher installiert sein. Eine der einfachsten Möglichkeiten, Java zu installieren ist der Download von AdoptOpenJDK. Wir empfehlen zum Beispiel Open JDK oder Oracle Java SE.
F: Was bedeutet Installer JAR?
A: Ab Version 2 von Magellan ist das Programm nicht mehr nur eine Datei. Wir haben
Magellan in viele Dateien aufgeteilt. So sieht man jetzt im Dateisystem alle Bilder und
Icons, die Magellan verwendet oder auch alle Sprachdateien für die Internationalisierung
(sogenannte Resources). Damit die Installation von Magellan nicht so aufwendig wird, liefern
wir das Programm jetzt in einem Paket aus, dass man als Installer JAR bezeichnet. Es ist ein
Java Programm, genauso wie Magellan. Es entpackt sich selbst an einen beliebigen Ort, den du
während der Installation festlegen kannst.
Ab Version 2.0 ist es übrigens einfach
möglich, eine neue Version über eine alte Version zu installieren ohne vorher die alte
Version zu deinstallieren. Die Konfiguration bleibt erhalten und wird während des ersten
Starts angepasst.
F: magellan-client.jar? Müßte die Datei nicht magellan.exe heißen?
A: Nein. Um ehrlich zu sein, ist das (fast) nur eine umbenannte ZIP-Datei, aber eine, mit der Java etwas anfangen kann und die du deshalb auch nicht mit WinZip oder ähnlichen Programmen dekomprimieren musst. Magellan besteht eigentlich aus sehr vielen Programmdateien, die einfach nur in magellan-client.jar zusammengefasst sind, trotzdem sollte Magellan nach einem Doppelklick auf die JAR-Datei starten.
F: Warum startet ein anderes Programm (z.B. WinZip oder PowerArchiver), wenn ich Magellan per Doppelklick starte?
A: Weil es sich statt Java mit der Dateiendung .jar verknüpft hat. Bei PowerArchiver und WinZip kann man das in den Optionen wieder rückgängig machen, ansonsten ist Handarbeit angesagt:
F: Warum startet Magellan nicht, wenn ich auf die Datei magellan-client.jar klicke?
A: Eine mögliche Ursache dafür ist, dass sich die Datei magellan-client.jar in einem Ordner befindet, dessen Name Leerzeichen enthält. Dieses Problem wird nicht durch einen Fehler in Magellan verursacht sondern durch eine ungeschickte Verknüpfung von .jar -Dateien mit java.
Die einfache Lösung ist natürlich, Magellan in einen anderen Ordner zu verschieben. Die komplizierte Lösung sieht folgendermaßen aus:
Hintergrund: Liegt Magellan im Ordner C:\Eigene Dateien\magellan-client.jar bewirkt der regedit-Eintrag einen Aufruf von java in der Form (Pfad zu Java)\javaw.exe -jar C:\Eigene Dateien\magellan-client.jar , das heißt, java würde versuchen, die Datei C:\Eigene mit dem Parameter Dateien\magellan-client.jar zu starten, was nicht so richtig gut klappen kann. Mit den Anführungszeichen sieht es dann so aus: (Pfad zu java)\javaw.exe -jar "C:\Eigene Dateien\magellan-client.jar" , es wird hier also wirklich die Datei magellan-client.jar gestartet.
Sollte das nicht geholfen haben, kann man versuchen, Magellan von der Kommandozeile aus zu starten, um eventuelle Fehlermeldungen sehen zu können.
F: Wie verknüpfe ich unter Windows2000/XP CR-Dateien mit Magellan?
Dafür muss man für den Dateityp "CR" einen entsprechenden Vorgang definieren. Das geht im Dateimanager (Explorer) unter Extras, Ordneroptionen, Dateitypen:
F: Wie starte ich Magellan von der Kommandozeile?
A: Magellan (bzw. Java) gibt Fehlermeldungen oft nur in der Eingabeaufforderung aus, deshalb kann es nützlich sein, Magellan von der Kommandozeile aus zu starten, um solche Fehlermeldungen zu sehen.
Dazu startet man zunächst die MS-DOS-Eingabeaufforderung (unter Windows ME im Startmenü den Punkt 'Ausführen' öffnen, command eingeben und auf OK klicken, bei Windows 2000/XP lautet das Kommando cmd ). Danach gibt man folgenden Befehl ein: javaw -jar "(Pfad zu Magellan)\magellan-client.jar" also z.B. javaw -jar "C:\Eigene Dateien\magellan-client.jar" .
Die Kommandozeilen-Parameter von Magellan sind in der Referenz beschrieben.
F: Wie bekomme ich Magellan auf einem Mac zum laufen?
A: Leider hat Apple erst mit dem Mac OS X eine aktuelle Java-Version veröffentlicht, unter der auch Magellan funktioniert. Zum Laden von Magellan geht man an der Konsole so vor, wie unter Windows an der Kommandozeile.
F: Wie gehe ich mit Resourcenpfaden um?
A: Die Resourcenpfade sind auf einer eigenen Seite beschrieben.
F: Obwohl ich genug RAM habe, meldet Magellan Speichermangel. Wieso?
A: Du mußt der Java-VM einfach etwas mehr Speicher zubilligen. Magellan fordert den Speicher von der VM an, wenn die ihm den Speicher nicht geben will, guckt Magellan in die Röhre.
Die Speicherzuteilung kannst Du folgendermaßen machen:
Unter Windows:
Erstelle eine Verknüpfung von Magellan, klicke mit der rechten
Maustaste drauf und geh auf "Eigenschaften". Dort trägst Du unter "Ziel" folgende Zeile ein
(die Pfade müssen natürlich an Deine Installation angepasst werden):
"C:\Programme\Java\jre6/bin/javaw.exe" -Xms128M -Xmx512M -jar
"c:\Programme\Eressea\Magellan\magellan-client.jar"
oder einfach
javaw.exe -Xms128M -Xmx512M -jar
"c:\Programme\Eressea\Magellan\magellan-client.jar"
Unter Linux einfach (in der Shell, im Magellan-Verzeichnis):
java -Xms128M -Xmx512M -jar magellan-client.jar
Dies weist die Java-VM an, sich mindestens 128MB und maximal 512MB RAM zu sichern. Je nach Speicherausbau kannst Du die Werte auch verändern.
F: Warum verwendet Magellan plötzlich keine Base-36 Nummern mehr für die Einheiten?
A:Im CR fehlt vermutlich das Tag 36;Basis . Das Basis-Tag definiert die Zahlenbasis mit der Magellan arbeitet. Bei Eressea-CRs ist das normalerweise 36, andere PBeMs die ältere CR-Versionen benutzen (z.B. Verdanon) arbeiten mit Dezimalzahlen (Basis 10) und kennen dieses Tag nicht. Daher nimmt Magellan Basis 10 an, wenn im CR nichts anderes definiert ist.
F: Wie kann ich mit Vorlage die Befehle von Einheiten automatisch bestätigen?
A: Mit // #tag EINHEIT ejcOrdersConfirmed 1
F: Ich komme mit dem ATR, dem ARR oder den Tooltips nicht zurecht!
A: Eine gute Hilfe zum ATR, ARR und den Tooltips findet sich hier.