Skip to content

Installation on Windows

Jump to bottom
filak edited this page Sep 27, 2023 · 72 revisions

Command prompt = CMD

Apache Jena/Fuseki installation

Apache Jena/Fuseki 3 requires Java 8 - use ie. https://adoptopenjdk.net/

  • Test the 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.9.0.zip
    • Apache Jena libraries - ie. apache-jena-4.9.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:
setx /M JENAROOT c:\Programs\apache-jena-4.9.0
setx /M JENA_HOME c:\Programs\apache-jena-4.9.0
setx /M FUSEKI_HOME c:\Programs\apache-jena-fuseki-4.9.0
setx /M FUSEKI_BASE d:\apache-jena-data

  1. Add to your PATH variable

     ;%JENA_HOME%\bat;%FUSEKI_HOME%

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

    Change:

     java -Xmx1200M -jar fuseki-server.jar %*

    to (use 4096 MB or more):

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

  3. Test the installation

    Go to your <FUSEKI_DATA_DIR>

    • open CMD and run:
jena_version.bat

fuseki-server --version
  1. For production see https://github.com/filak/MTW-MeSH/wiki/Running-Fuseki-server

MTW Installation

MTW uses 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

Install MTW

  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:

     setx /M MTW_HOME C:\Programs\...\dist

    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

    Go to <MTW_HOME_DIR>\instance\db

    Open CMD and run:

     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

  7. Test the installation

  • open CMD and run:

      mtw-worker.exe

  • 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 https://127.0.0.1/mtw/ and login with your Admin credentials [check the Admin login checkbox]

Run MTW as Windows service

Install the MTW services - MTW-Server and MTW-Worker

Use the NSSM service manager

  1. Go to your <MTW_HOME_DIR> open CMD and run for both server and worker:

       nssm install <SERVICE_NAME>-<PORT>

    • Application - Path - select the EXE file ie.:

      C:\Programs\...\dist\mtw-server.exe

C:\Programs\...\dist\mtw-worker.exe

    • Application - Startup dir:

      C:\Programs\...\dist

    • (optional) Application - Arguments - you can change host, port, threads count and config file:

        --config CONFIG    Config file path - default: conf/mtw-dist.ini
  --host HOST        Host - default: 127.0.0.1
  --port PORT        Port number - default: 55930 (server), 55933 (worker)
  --threads THREADS  Number of threads - default: 64
  --debug            Run in debug mode - DO NOT use in production !

  2. Start the services using Windows Services manager

  3. Check the logs for any startup errors: <MTW_HOME_DIR>\instance\logs

Continue to Loading MeSH datasets

Clone this wiki locally