Skip to content

MyCoRe-Org/ubo

Repository files navigation

University Bibliography Online: Installation

Setup

Checkout source code from GitHub

git clone https://github.com/MyCoRe-Org/ubo.git

Build the web application

mvn install

Create configuration directory

ubo-cli/target/bin/ubo.sh create configuration directory
  • TODO: Build a database and edit persistence.xml
  • For example, in MySQL, do
create database ubo;
grant all privileges on ubo.* to ubo@localhost identified by 'ubo';
  • setup your database and JDBC configuration in persistence.xml, update mappings with:
ubo-cli/target/bin/ubo.sh reload mappings in jpa configuration file
vi ~/.mycore/ubo/resources/META-INF/persistence.xml
  • copy jdbc driver to ~/.mycore/ubo/lib, eg. for h2
cd ~/.mycore/ubo/lib
wget https://repo1.maven.org/maven2/com/h2database/h2/2.2.224/h2-2.2.224.jar
cd -

Solr

Setup SOLR 8

or use solr runner plugin for development

  • install solr with the command: mvn solr-runner:copyHome -pl ubo-webapp
  • run solr with the command: mvn solr-runner:start -pl ubo-webapp
  • stop solr with the command: mvn solr-runner:stop -pl ubo-webapp
  • update solr with the command: mvn solr-runner:stop solr-runner:copyHome solr-runner:start -pl ubo-webapp

Configure SOLR URL in mycore.properties

vi ~/.mycore/ubo/mycore.properties

MCR.Solr.ServerURL=http://localhost:8983/
MCR.Solr.Core.main.Name=ubo
MCR.Solr.Core.classification.Name=ubo-classifications

Setup Superuser

  • Create the superuser "administrator"
ubo-cli/target/bin/ubo.sh init superuser

Classifications

ubo-cli/target/bin/ubo.sh update all classifications from directory ubo-cli/src/main/setup/classifications

ACL

ubo-cli/target/bin/ubo.sh update permission create-mods for id POOLPRIVILEGE with rulefile ubo-cli/src/main/setup/acl/acl-rule-always-allowed.xml described by always allowed
ubo-cli/target/bin/ubo.sh update permission create-users for id POOLPRIVILEGE with rulefile ubo-cli/src/main/setup/acl/acl-rule-administrators-only.xml described by administrators only
ubo-cli/target/bin/ubo.sh update permission administrate-users for id POOLPRIVILEGE with rulefile ubo-cli/src/main/setup/acl/acl-rule-administrators-only.xml described by administrators only
ubo-cli/target/bin/ubo.sh update permission read for id default with rulefile ubo-cli/src/main/setup/acl/acl-rule-always-allowed.xml described by always allowed
ubo-cli/target/bin/ubo.sh update permission writedb for id default with rulefile ubo-cli/src/main/setup/acl/acl-rule-administrators-only.xml described by administrators only
ubo-cli/target/bin/ubo.sh update permission deletedb for id default with rulefile ubo-cli/src/main/setup/acl/acl-rule-administrators-only.xml described by administrators only
ubo-cli/target/bin/ubo.sh update permission read for id restapi:/ with rulefile ubo-cli/src/main/setup/acl/acl-rule-always-allowed.xml described by always allowed
ubo-cli/target/bin/ubo.sh update permission read for id restapi:/classifications with rulefile ubo-cli/src/main/setup/acl/acl-rule-always-allowed.xml described by always allowed

MyCoRe-Solr-Configuration

ubo-cli/target/bin/ubo.sh reload solr configuration main in core main

Run

  • local web application on port 8080 with tomcat 9:
mvn cargo:run -Dtomcat=9 -pl ubo-webapp
  • or jetty: (does not work currently)
mvn cargo:run -Djetty -pl ubo-webapp

Rebuild & Run (root directory)

mvn clean && mvn install -am -pl ubo-webapp && mvn -Dtomcat=9 org.codehaus.cargo:cargo-maven2-plugin:run -pl ubo-webapp -DskipTests