-
Notifications
You must be signed in to change notification settings - Fork 0
installation
The PURL server is implemented in Java 11 and based on the Spring Boot Framework. The data is stored in a MySQL database.
For
Install a recent version of MySQL Community Edition Server and create a new user for the PURL server database.
> CREATE SCHEMA 'purl_server';
At first you should make sure, that you have installed a recent Java Version. It is recommended to install the current long time support version (LTS) OpenJDK 11.
After that you may look into the documentation Deploying Spring Boot Applications for further information on installation and deployment.
The PURL server application is provided as stand-alone JAR file.
At first you need to override some properties to configure database and e-mail server.
You may follow the Spring recommendation and create an applications.properties file in the current directory (where the JAR file is located).
# MySQL database parameter
spring.datasource.url=jdbc:mysql://localhost:3306/purl_server?serverTimezone=Europe/Berlin
spring.datasource.username=the_user
spring.datasource.password=the_password
# E-mail server configuration
spring.mail.host=email.my-institution.de
spring.mail.username=email_user
spring.mail.password=email_password
purl_server.mail.from=email_user@my-institution.de
Now you may start the application for the first time:
java -jar purl_server-0.x.y.jar
The PURL server application was build as fully executable jar. To install it in a production enviroment you may follow the Spring Boot guidelines and register it as a service.
At the beginning you should modify the admin user!
The initial login is admin / admin.
Goto User / Seach for a User search for admin and provider a proper name, institution and e-mail address. After that you may reset the password through the "reset password" link on the login page.
=== TODO
- configure as service
- support for HTPPS a) application on port 443 + certificate configuration with Spring b) Apache as proxy server