This project is based on Red Hat Quarkus and Optaplanner technologies and the purpose is to create an on line tool to model a timetable for the Italian High Schools.
Giuseppe Peano was an Italian mathematician and glottologist. When I started the project I thought it should be dedicated to a matematician, if possible to an Italian matematician, furthermore Peano is also the name of the institute where I have been studing my High School. That's why.
- frontend The module that contains the web interface of the application.
- orario The module that contains the engine for calculations.
The application uses mongodb to persist some data (the list of lessons calculated by the engine). The data are retrieved by the user interface to display the timetable.
steps to deploy DB
- Access your OCP 4 installation
- from developer view access or create the project for PEANO application and choose "add" from catalog
- choose Mongo DB and click instantiate
- in the properties page specify "connection username" & "connection password"
- specify the database name: orario
Wait for the instance creation then access the pod clicking on mongodb icon in the topology view, click on pod instance and click on terminal tab. This will open a shell in the container, enter > mongo -u mrt command, at the prompt asking for password enter the password (the username and relative password are those that you have specified at the point 3 of the above sequence) and enter "show collections;" command. Actually the first time you start the container this command will return nothing. You can try to enter an element in one of the collections the tool will use, to do it follow these steps:
- enter the following command to create an entry in the locations collaction: > db.lessons.insertOne({"subject":"matematica","teacher":"Leonardo Fibonacci"});
- repeat the command: > show collections;
- enter the command: > db.lessons.find();
the output should be the same object you specified at point 1. To clean the DB after the test enter the command:
> db.locations.drop();
If you are using podman as local container manager and you want to setup a local environment with the same containers used in OCP 4 you just need to start the container with the following command. [NOTE] This example assumes you are using podman in rootless mode.
> podman run --name mongodb -d -p 27017:27017 mongo:3.6
If you want to access the container (while running) to execute the same test of OCP Lab, use the following command:
> podman exec -it mongodb /bin/bash
When you start a Mongo DB instance using the template from the OCP catalog as specified above in this document you can choice between two templates, one is ephemeral. The ephemeral can be used in a test environment, but if you want to persist data you have to choose the other template. That template provisions the MongoDB container with a Persistent Volume Claim so that data enterd into the DB will be persisted.
In a local environment on the other hand if you want to persist data you have to manually mount a local volume to the running container. In this case use the following command instead the one specified in the previous paragraph:
> podman run -v /my/own/datadir:/data/db --name mongodb -d -p 27017:27017 mongo:3.6