Docker
The recommended way to run Emerald for basic development is to use the Docker image. This ensures a consistent development experience for all students.
- The image designed for this course is on Docker Hub: portoleks/in5570v19.
- If you prefer not to download software from Docker Hub, let Oleks know.
- There is a convenient Makefile for working with the Docker image here.
- A guide and tools for Windows users will become available after the first exercise session.
Compiling and running
- In bin directory the file ec is for compiling and emx is for launching a instance of the virtual machine.
Text-editor modes
Install Emerald Natively
Mac
- Download Mac-versjon
- Unpack the package to the location where you want to install emerald
(e.g., /opt - The package is then unpacked in the directory
emerald-PACKAGEVERSION under /opt) - Set EMERALDROOT in your environment to point to this directory (e.g.,
export EMERALDROOT=/opt/emerald )
Windows
- Download Windows-version
- Created by Stig Halvorsen. ec that can be copied to bin directory! her
- Set the path environment variable, read the README in ec download for instructions.
Linux
- Conceptually the same procedure as shown for mac, but because some problems with address space layout randomization some versions of linux want run the compiler. Feel free to try the mac-guide(it depends on which version of the linux kernel you run). Or you can download the 0.99 version of the compiler under here.
- Download Linux-version
Installing on Linux: (UiO user)
- There should be a .bashrc file in your home directory, add the following as in this example:
|
First type in : "gedit ~/.bashrc" in the terminal, eventually use whatever texteditor you want, but in this case I chose gedit! you first have to say where the emeraldroot path is, and add the given text below on your .bashrc file ! |
|---|
- For making the changes in .bashrc file to take effect, either open a new terminal or write "source .bashrc"