Dev

Launch your local instance of CiteLibre Rendezvous with Docker Compose

The given example features all functionnalities to make it complete, but you might as well want to add your own plugins, or remove some (for the specific documentation, click here). To do so, go into citelibre-rendezvous directory.

For this purpose, we use the make util to help you compile and deploy an updated instance of the web application. In case you are running on Windows and don't already have it available in your environment. It is stored under utils/make. There are two commands available.

Build and launch all containers

• If you have the make command available in your path

make test

• For Windows users, if you don't have make installed

.\utils\make\bin\make.exe test

Delete all apps containers

• If you have the make command available in your path

make test-down

• If not and using Windows

.\utils\make\bin\make.exe test-down

Run your own dataset

if you want to use your own updated database dump, simply replace 1-dump.sql in the mysql directory by the new one.

Then, you must:

• Check that your dump is correct for special characters (like ├⌐)

• In your dump file, at the beginning of the file add CREATE DATABASE/ USE instruction

CREATE DATABASE lutece;
USE lutece;

• Replace matomo info

	('matomo.site_property.server.http.url', 'http://localhost/'),
	('matomo.site_property.server.https.url', 'http://localhost/'),
	('matomo.site_property.site.id', '1'),
    ('matomo.site_property.widget.auth.token', 'cfa9a798abd584817e2eb94d7bc14bb0'),

• Update if needed the admin authentication instructions in the portal editorial, than can be found twice in the table html_portlet

• Reset the admin user with the default credentials and expiration date to force the update of the password at first login

	(1, 'admin', 'Admin', 'Admin', 'admin@citelibre.org', 0, 'PLAINTEXT:adminadmin', 'fr', 0, 0, 0, '1980-01-01 00:00:00', NULL, 0, '1980-01-01 00:00:00', 'all')

• Check that the admin user has all roles

Edit properties

You can edit properties in the citelibre-rendezvous/webapp folder.

If you edit in the citelibre-rendezvous/src you can loose these settings because the webapp replaces the src parameters with its own, and maven automaticaly rebuilds the project when any file of the src folder or the pom file has been modified.