Jameica Installationsanleitung
Systemvoraussetzungen
SUN Java 1.5 oder höher (JRE oder JDK)
Ob und in welcher Version Java installiert ist, kann mit folgendem Befehl an der Kommandozeile (Windows: „Eingabeaufforderung“, Mac: „Terminal“) geprüft werden:
java -version
Die Ausgabe sollte dann in etwa so aussehen:
java version "1.5.0_18" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_18-b02) Java HotSpot(TM) Client VM (build 1.5.0_18-b02, mixed mode)
Falls die Systemvoraussetzung nicht erfüllt ist, kann Java von http://www.java.com heruntergeladen werden.
Nur OpenBSD
Installiere ausserdem bitte das Paket „swt-package“ über den OpenBSD-Paketmanager.
Nur OpenSolaris
Installiere ausserdem bitte das Paket „SUNWswt“ über den Package-Manager. Alternativ geht das auch an der Kommandozeile mittels „pkg install SUNWswt“.
Installation
Entpacke den Inhalt der ZIP-Datei „jameica.zip“ (bzw. „jameica-<plattform>.zip“ oder „jameica-<version>-nightly…zip“ in ein Verzeichnis deiner Wahl. Zum Beispiel:
| Betriebssystem | Typischer Installationspfad |
|---|---|
| Linux | /opt |
| Windows | C:\Programme |
| MacOS X | /Applications |
Anschliessend sollte dort ein neues Verzeichnis „jameica“ (unter MacOS X „Jameica.app“) existieren.
Jameica trennt streng zwischen Programm- und Benutzerdaten. Daher wird für das Programmverzeichnis kein Schreibzugriff vom User benötigt. Alle Benutzerdaten werden standardmäßig im Verzeichnis “.jameica“ innerhalb des Homebereichs des Users gespeichert. Abhängig vom verwendeten Betriebssystem sind das folgende Verzeichnisse (“<username>“ steht hierbei für den Namen des angemeldeten Benutzers):
| Betriebssystem | Verzeichnis |
|---|---|
| Linux | /home/<username>/.jameica |
| Windows 2000/XP | C:\Dokumente und Einstellungen\<username>\.jameica |
| Windows Vista | C:\Users\<username>\.jameica oder C:\Benutzer\<username>\.jameica |
| MacOS | /Users/<username>/.jameica oder /Users/<username>/Library/jameica (falls Jameica 1.7 die erste benutzte Version war, dann letzteres, sonst das erst-genannte) |
Erster Start
Linux/Unix
Wechsle in das Programm-Verzeichnis von Jameica und starte die Anwendung mit dem passenden Start-Script.
| Betriebssystem | Start-Script |
|---|---|
| Linux (32 Bit) | jameica.sh |
| Linux (64 Bit) | jameica-linux64.sh |
| OpenBSD | jameica-openbsd.sh |
| OpenSolaris | jameica-osol.sh |
Windows
Falls Jameica (und ggf. andere Plugins) via Windows-Setup installiert wurde, genügt ein Doppelklick auf das Desktop-Icon bzw. den Eintrag im Startmenü.
Starte Jameica alternativ manuell durch Aufruf des Startscripts „jameica.bat“. Achte bitte darauf, dass du dich beim Aufruf im Programmverzeichnis „jameica“ befindest. Andernfalls wird Jameica wichtige Programmbibliotheken nicht finden können und den Start mit einem Fehler abbrechen. Eine Verknüpfung im Startmenü oder auf dem Desktop kann manuell wie folgt angelegt werden:
- Klicke mit der rechten Maustaste auf den Desktop und wähle „Neu>Verknüpfung“
- Gib „C:\Programme\jameica\jameica.bat“ als Programmpfad ein
- Gib als Name „Jameica“ ein
- Klicke nun mit der rechten Maustaste auf die Verknüpfung und wähle „Eigenschaften“ im Kontextmenu
- Gib im Feld „Ausführen in“ den Wert „C:\Programme\jameica“ ein.
- Schließe das Fenster durch Klick auf „OK“.
Mac OS X
Nach dem Entpacken der ZIP-Datei im Programm-Ordner sollte automatisch ein passendes Programm-Symbol erstellt worden sein, mit dem Jameica gestartet werden kann.
Installation zusätzlicher Plugins
- Beende Jameica
- Entpacken das gewünschte Plugin in das Verzeichnis „plugins“ von Jameica
- Starte Jameica erneut
| Hinweis Konnte das Plugin nicht installiert werden (es erscheint dann nicht unter „Datei>Einstellungen→Plugins“), dann prüfe bitte die Log-Ausgaben in der Datei „jameica.log“ innerhalb Ihres Benutzer-Verzeichnisses und sende ggf. protokollierte Fehler an den Autor des Plugins. |
Optionale Startparameter
Beim Start von Jameica können dem Startscript „jameica.bat“, „jameica.sh“, usw. folgende Parameter angehängt werden:
- -h, –help
Zeigt einen Hilfe-Text mit allen möglichen Startparametern an
- -f <Verzeichnis>, –file=<Verzeichnis>
Mit diesem Parameter kann ein abweichendes Benutzer-Verzeichnis angegeben werden. Somit ist es z.Bsp. möglich, mehrere Systemkonfigurationen parallel zu benutzen. Beispiel:
| Windows | jameica.bat -f „d:\daten\.jameica“ |
| Linux | ./jameica.sh -f “/tmp/jameicatest“ |
Der Parameter kann genutzt werden, um das Benutzerverzeichnis auf einem USB-Stick zu speichern.
- -p <Passwort>, –password=<Passwort>
Mit diesen Parameter kann das Master-Passwort direkt beim Start angegeben werden. Dies kann zum Beispiel genutzt werden, wenn Jameica im Server-Modus automatisch beim Booten des Betriebssystem gestartet werden soll und keine Benutzerinteraktion möglich ist.
| WICHTIG Stelle sicher, dass das Passwort hierbei nicht für Dritte zugänglich wird |
- -d, –server
Server-Modus. Hierbei wird die grafische Benutzeroberfläche nicht gestartet. Der Parameter ist nur dann sinnvoll, wenn keine Benutzerinteraktion erfolgen soll.
Alternativ kann auch direkt das Start-Script (also „jameica.bat“, „jameica.sh“, „jameica-macos.sh“, ….) in einem Texteditor geöffnet und die Parameter dort eingetragen werden.
Experten-Einstellungen
Im Benutzer-Verzeichnis “.jameica“ befindet sich eine Datei „cfg/de.willuhn.jameica.system.Config.properties“. In dieser können unter anderem folgende Parameter angegeben werden:
- jameica.plugin.dir.[x]
Angabe zusaäzlicher Verzeichnisse für Plugins angeben. Somit ist es z.Bsp. möglich, auf einem Fileserver ein zentrales Repository von Jameica-Plugins bereitzustellen, welches von allen Clients in einem LAN gemeinsam benutzt werden kann. Fügen hierzu weitere Zeilen hinzu, indem du die Index-Nummer jeweils erhöhst. Beispiele:
jameica.plugin.dir.0=plugins jameica.plugin.dir.1=/opt/jameica/plugins2 jameica.plugin.dir.2=d:/jameica/externalplugins
