jProject Business Suite Git
Status: Beta
Brought to you by:
jconcepts
Menu
▾
▴
Tree [6128f4] master / History
ogries
Oliver Gries
Read Me
Prerequistites for build
maven variable to define docker.url for building docker images: docker.url e.g. in settings.xml
<properties>
<docker.url>dockerhost:port</docker.url>
</properties>
Configuration
All params are optional.
jproject.applicationName: jProject Business - Suite
Name of the application
jproject.languages: de_DE,en_US,en_GB
Supported languages
jproject.policy.profile.standard.name: simple
Standard policy definition if creating new users
jproject.policy.profile.file: policy.xml
Standard policy file; check the format to provide your own permission profile settings
Passing params via -D on project start within an IDE like:
-Dspring.profiles.active=$anyName$
the standard profile name is 'default' you can start the application with different profiles, each holding its own database setup
-Dspring.config.additional-location=/anyDir/.jproject-config/
define additionional directory where spring configs are located
-Djproject.config.dir=/anyDir/.jproject-config/
parameter where during setup the config file will be written to; standard is ./config
-Duser.timezone="Europe/Berlin"
standard time zone is the server time zone; you can provide any own timezone via this property
for the docker image you need to pass the timezone via the TZ parameter as shown below
Timezone Issues
You have to make sure that the database timezone and the application timezone are in sync otherwise you might getting issues during daylight saving changes.
Use the TZ parameter for the docker image or the -Duser.timezone parameter for an IDE or application server to set the application timezone.
Database Support
- MySql Server Version > 8.0
- PostgreSQL > 9.5
- MariaDB Server Version > 10.2 (via standard mysql database setup)
Start docker image
If you running jProject in a docker container you might want to store the database setup externally.
Create a volume and map the volume to the internal config directory. You can change the internal config directory with the parameters shown above.
If you start the project via an IDE, the config params needs to have the format as shown above. However, passing parameter to an docker container the params changes to uppercase with hyphen as shown below.
Minimum command to start the docker image with external volume mapping is:
docker run --name jproject -d \
-v jproject-config:/usr/local/tomcat/config \
-p 8088:8080 --restart always -t jconcepts/jproject-web:$version$
You can pass more parameters as show below:
docker run --name jproject -d
-v jproject-config:/config
-e "SPRING_PROFILES_ACTIVE=development" \
-e "JPROJECT_CONFIG_DIR=/config/" \
-e "SPRING_CONFIG_ADDITIONAL_LOCATION=/config/" \
-e "TZ=Europe/Berlin" \
-p 8088:8080 --restart always -t jconcepts/jproject-web:latest
Start Application
Navigate to http://$serverName$:8088, run through the setup if done for the first time and login with the standard user admin and password admin.
