Running the MAP

Prerequisites

Java 1.8 or above

A MySQL database, created like this:

create database map character set UTF8mb4 collate utf8mb4_bin;
grant all on map.* to 'map'@'localhost' identified by 'map123';

A recent (8.x.y) NodeJS install
A recent (3.x.y) Typescript install (sudo npm install npm typescript -g)

Setting up

The MAP system consists of a backend ("api") and a frontend ("ui"). You can set them up like this:

 # Install API dependencies
 $ api/bootstrap.sh

 # Install UI dependencies
 $ ui/bootstrap.sh

Once you have all the pieces, you'll just need a pair of config files. For development, they look like this (note that you might need to adjust the credentials/DB names in the db_url settings):

api/config/config.local.rb

    AppConfig[:db_url] = "jdbc:mysql://localhost:3306/map?useUnicode=true&characterEncoding=UTF-8&user=map&password=map123&serverTimezone=UTC"
    AppConfig[:aspace_db_url] = "jdbc:mysql://localhost:3306/archivesspace?useUnicode=true&characterEncoding=UTF-8&user=as&password=as123&serverTimezone=UTC"

    AppConfig[:session_secret] = "development"
    AppConfig[:development_admin_password] = "admin"

ui/config/config.local.rb

    AppConfig[:session_secret] = "development"

Finally, you can create the necessary DB tables:

 api/scripts/setup_database.sh

Then start the API backend:

api/scripts/devserver.sh

and the UI frontend:

ui/scripts/devserver.sh

You should then be able to hit http://localhost:3456/ in a browser and log in with admin/admin.

ColonelSanderson/MAP

Running the MAP

Prerequisites

Setting up