Skip to content

Installation

Jump to bottom
Irene Vagionakis edited this page Feb 24, 2023 · 39 revisions

  1. Check that you have Java 7 or 8 (sometimes referred to also as '1.7' and '1.8') and a Java Development Kit (JDK) on your machine (e.g. following both 'Option 1' and 'Option 2' procedures that are explained here, including the final step related to javac). If not, download and install the JDK from http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html.

  2. Get the EFES software: either download the ZIP from https://github.com/EpiDoc/EFES/archive/master.zip or clone from Github if you have an account already.

  3. If you downloaded the ZIP file, unzip it in a directory of your choosing (e.g. on your Desktop), changing the folder name from 'EFES-master' into 'EFES'.

  4. Open up your Command prompt/Terminal:

    1. Windows: in the search box in the Start menu type: cmd
    2. GNU/Linux or Mac OS X: in the search box in the Menu bar on top type: terminal

  5. Start the EFES build process, navigating to your EFES folder (a) and then running a script that will start Jetty, a lightweight web server that is pre-configured to run all EFES components (b):

    1. Windows:

      1. navigate to your EFES folder typing the following command and then pressing Enter: cd Desktop\EFES
      2. type the following command and then press Enter: build.bat


    2. GNU/Linux or Mac OS X:

      1. navigate to your EFES folder typing the following command and then pressing Enter: cd Desktop/EFES
      2. type the following command and then press Enter: sh build.sh



At this point, many messages will appear in the Terminal, among which "Development server is running at http://127.0.0.1:9999/".

  1. Visit http://127.0.0.1:9999/ with your web browser. You’ll see a “Welcome to EFES” page (NB: be patient, since it can take dozens of seconds for server initialisation to complete)
  2. Congratulations! EFES is now all set up. You can start filling in your content. Remember to keep Jetty running on your Terminal/Command Line while working on EFES. To stop EFES: either type Ctrl+C in the Terminal or close it.
  3. In your file navigator navigate to /webapps/ROOT/content/xml/epidoc/. This is where you will put your EpiDoc XML files. When you first install EFES, this folder will contain several sample EpiDoc files to help you start off. (NB: to be able to see the files, you will need to create an RDF repository first)


Troubleshooting

  • The command cd ... above will work only if the 'EFES' folder has been saved directly on your Desktop (and not, e.g., inside another folder on your Desktop); if the folder has been saved in a different position, in the command above replace "Desktop" with the actual path of the EFES folder.
  • If the Terminal returns error messages concerning authorisation problems, type the following command in the Terminal and then press Enter: chmod +x build.sh
  • If the Terminal returns error messages concerning Java, go back to step 1 and ensure that you have installed the correct Java/JDK version.
  • Sometimes to apply changes it is needed to emtpy the browser cache, or to stop and restart EFES from the Terminal.
Clone this wiki locally