OGEMA runs almost everywhere, the basic requirement is the availability of a Java Virtual machine. In particular, Linux, Windows and Mac operating systems are supported. OGEMA has been successfully tested on all kinds of desktop systems, the Raspberry Pi, Beaglebone Black, Cubietruck, etc. For development, Maven must be installed as well, and we recommend the use of an IDE, like Eclipse or Netbeans, for convenient coding. See Instructions on how to set up Eclipse plugins for Maven and Git.
OGEMA requires Java 7 or higher. Developers need the Java Development Kit (JDK), if you do not intend to write your own applications then the Java Runtime Environment (JRE) is sufficient.
After the Java installation, you might need to update your environment variables. Open a command line (e.g. cmd or Git bash in Windows), and type java -version. If this prints command not found, or similar, you will need to modify the path variable, if it displays the Java version, then you are done. To adapt the path, proceed as follows:
- Windows 7: Press (Windows button + Pause), then go to Advanced and Environment Variables. If the shortcut does not work for you, go to the Start menu, right-click on Computer, select Properties, go to Advanced and Environment Variables. Then edit the PATH variable, appending to its value ;c:\Program Files\java\jdk8\bin (don't forget the semicolon, and adapt the path to your installation)
Linux: use for instance the ~/.bashrc script, add PATH="$PATH":/usr/local/jdk1.8.0/bin (adapt to your installation)
- Other OS: see for instance https://www.java.com/en/download/help/path.xml on how to modify the PATH variable, or consult your favourite web search engine.
Maven (not required for running the OGEMA demokit, but needed for development)
OGEMA uses Maven as its build tool, version 3 or newer.
- Linux: chances are that your distribution's standard package repository ships Maven. E.g. in Ubuntu you can get Maven by typing ''sudo apt-get install maven''.
- Other OS: Download Maven from the Apache pages, and follow their installation instructions.
If you intend to use Maven with Eclipse, you should install the Eclipse Maven plugin (it may come preinstalled with Eclipse already).
Git (not required for the OGEMA demokit, but for checking out the sources)
- Linux: git should typically be available from the standard package repository. Ubuntu: "sudo apt-get install git".
- Other OS: download here.
If you intend to connect git with Eclipse, you should install the Eclipse Git plugin, as well as the Eclipse Maven-git connector. Note that you could instead simply use git from the command line, and import the downloaded packages to Eclipse. This is usually the simpler option, unless you are familiar with using git in Eclipse already.