Skip to content

Installation on Windows

Jump to bottom
filak edited this page Jan 24, 2025 · 85 revisions

Command prompt = CMD

Apache Jena/Fuseki installation

Jena 4

Requires Java 8, or a later version of Java

Jena 5

Requires Java 17, or a later version of Java

Use OpenJDK Java distributions - https://adoptium.net/ - LTS releases

  • Check the Java installation - open CMD and run:

      java -version

  1. Download Jena and Fuseki binary files https://jena.apache.org/download/index.cgi

    • Apache Jena Fuseki - ie. apache-jena-fuseki-4.10.0.zip
    • Apache Jena Commands - ie. apache-jena-4.10.0.zip

  2. Unpack the distribution files to <JENA_HOME_DIR>, <FUSEKI_HOME_DIR>

  3. Create a directory to store your data <FUSEKI_DATA_DIR>

  4. Create/Set environmental (ENV) variables:

    JENAROOT <JENA_HOME_DIR>
    JENA_HOME <JENA_HOME_DIR>
    FUSEKI_HOME <FUSEKI_HOME_DIR>
    FUSEKI_BASE <FUSEKI_DATA_DIR>

    • open CMD and run according to your Jena version:
setx /M JENAROOT c:\Programs\apache-jena-4.10.0
setx /M JENA_HOME c:\Programs\apache-jena-4.10.0
setx /M FUSEKI_HOME c:\Programs\apache-jena-fuseki-4.10.0
setx /M FUSEKI_BASE d:\data\jena4

You need to rebuild all indexes when upgrading from Jena 4 to Jena 5 !

setx /M JENAROOT c:\Programs\apache-jena-5.3.0
setx /M JENA_HOME c:\Programs\apache-jena-5.3.0
setx /M FUSEKI_HOME c:\Programs\apache-jena-fuseki-5.3.0
setx /M FUSEKI_BASE d:\data\jena5

  1. Add to your PATH variable

     ;%JENA_HOME%\bat;%FUSEKI_HOME%

  2. Modify fuseki-server.bat in your <FUSEKI_HOME_DIR>

    Change:

     java -Xmx4G -cp fuseki-server.jar org.apache.jena.fuseki.main.cmds.FusekiServerCmd %*

    to (use 4 GB or more):

    Jena 4

     java -Xmx4G -jar %FUSEKI_HOME%\fuseki-server.jar %*

    Jena 5

     java --add-modules jdk.incubator.vector -Xmx4G -jar %FUSEKI_HOME%\fuseki-server.jar %*

  3. Test the installation - open CMD and run:

     fuseki-server --version

    The output shall be:

     Apache Jena Fuseki version ...

For production see Running Fuseki server

MTW Installation

SQLite database

  1. Download SQLite3 binary files at https://www.sqlite.org/download.html

    • use Precompiled Binaries for Windows for your platform

    • do not forget to download the sqlite-tools-... package

  2. Unpack the files to your <SQLITE_HOME_DIR>

  3. Create/Set environmental (ENV) variable

    SQLITE_HOME <SQLITE_HOME_DIR>

    Open CMD and run:

     setx /M SQLITE_HOME C:\Programs\sqlite3

  4. Add to your PATH variable

     ;%SQLITE_HOME%

  5. Test the installation - open CMD and run:

     sqlite3 --version

MTW binaries

  1. Download distribution file MTW-X.X.X.zip from Releases

  2. Unpack dist file to <MTW_HOME_DIR>

  3. Create/Set environmental (ENV) variable

    MTW_HOME <MTW_HOME_DIR>

    Open CMD and run (change the X.X.X to the current version):

     setx /M MTW_HOME C:\Programs\MTW-X.X.X

    Append to your PATH variable:

     ;%MTW_HOME%\tools

  4. Set Admin credentials using set-mtw-admin.exe - open CMD and run:

     set-mtw-admin --login <YOUR_ADMIN_LOGIN> --pwd <YOUR_ADMIN_PASSWORD>

  5. Create the management database - open CMD and run:

     cd %MTW_HOME%\instance\db

 sqlite3 mtw.db < mtw_schema.sql

  6. Customize the config file - important values are marked with !

    <MTW_HOME_DIR>\instance\conf\mtw-dist.ini

    https://github.com/filak/MTW-MeSH/blob/master/flask-app/instance/conf/mtw-dist.ini

Test/Start MTW

  • MTW Worker - open CMD and run:

      mtw-worker.exe

  • MTW Server - open CMD and run:

      mtw-server.exe --port 80 --relax

  • check the logs for any startup errors: <MTW_HOME_DIR>\instance\logs

  • open in your browser http://127.0.0.1/mtw/ and login with your Admin credentials [check the Admin login checkbox]

For production deployment see Running MTW as a service

Continue to Loading MeSH datasets

Clone this wiki locally