Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gbv/digital-edition-archive


https://github.com/gbv/digital-edition-archive

dea mycore

Last synced: 19 days ago
JSON representation

Awesome Lists containing this project

README

        

# digital-edition-archive

## Installation instructions

### Version control
* deploy the generated project files to your own Git repository

### Build
* clone / checkout project from git repository
* run `mvn clean install`

### Create / find the directory with the MyCoRe Commandline interface
* unpack `digital-edition-archive-cli/target/digital-edition-archive-cli.tar` into a user defined CLI directory and change into it
* OR: use the generated CLI directory in `digital-edition-archive/digital-edition-archive-cli/target/appassembler`
* remember that you can start the CLI with `bin\digital-edition-archive.bat` on Windows and `bin/digital-edition-archive.sh` on MAC/Linux
* remember that you can exit the CLI with the command `exit`

### Configure and run Solr server
* Change to `digital-edition-archive-webapp` directory
* Install and configure solr with the commands:
* `mvn solr-runner:copyHome`
* `mvn solr-runner:installConfigSet@cs_main`
* `mvn solr-runner:installConfigSet@cs_classification`

* Run solr with the command `mvn solr-runner:start`
* (Solr is usually running at: http://localhost:8983/solr/#/)
* (To stop it return to this directory an run: `mvn solr-runner:stop`)

### Configure the application
* change into CLI directory and run:
`bin/digital-edition-archive.sh create configuration directory`
* The configuration directory is created in: `~/.mycore/digital-edition-archive`
* (ignore the CLI output `jakarta.persistence.PersistenceException: No Persistence provider for EntityManager named MyCoRe`,
because the database will be configured by the next steps)
* configure your database connection in `~/.mycore/digital-edition-archive/resources/META-INF/persistence.xml`
* (for first steps you can use the preconfigured H2 database)
* (if you leave the jdbc url unchanged, it will be updated by the next command, pointing to an H2 database file in your data directory)
* perhaps you need to download a driver to `~/.mycore/digital-edition-archive/lib/`
* run cli command `bin/digital-edition-archive.sh reload mappings in jpa configuration file`
* configure Solr cores in `~/.mycore/digital-edition-archive/mycore.properties`

```
MCR.Solr.ServerURL=http://localhost:8983/
MCR.Solr.Core.main.Name=main
MCR.Solr.Core.main.ServerURL=%MCR.Solr.ServerURL%
MCR.Solr.Core.classification.Name=classifications
MCR.Solr.Core.classification.ServerURL=%MCR.Solr.ServerURL%
```

### Initialize the application
* change into CLI directory (see above)
* load default data by running: `bin/digital-edition-archive.sh process resource setup-commands.txt`

### Run web server
* Change to `digital-edition-archive-webapp` directory
* Run Jetty with the command: `mvn jetty:run` (end with `ctrl+c`)
* Open your browser with: http://localhost:8080/
* (Fast rebuild and Jetty restart `mvn clean install && cd digital-edition-archive-webapp && mvn jetty:run` (End with ctrl+c))