Administration

Update Server Version

Upload the new java archive (.jar file) to the server and execute the following script from the archive directory.

You need to update the VERSION variable with the new version number.

#!/bin/bash VERSION=dm4-8.17.2 # replace by the new version set -x DATAMAESTRO_ARCHIVE="datamaestro-app-${VERSION}-jar-with-dependencies.jar" sudo mv ${DATAMAESTRO_ARCHIVE} /home/datamaestro-server/ sudo chown datamaestro-server:datamaestro-server /home/datamaestro-server/${DATAMAESTRO_ARCHIVE} sudo rm /home/datamaestro-server/datamaestro-app.jar sudo ln -s /home/datamaestro-server/${DATAMAESTRO_ARCHIVE} /home/datamaestro-server/datamaestro-app.jar sudo chown -h datamaestro-server:datamaestro-server /home/datamaestro-server/datamaestro-app.jar sudo systemctl restart datamaestro

Renew License

Simply replace the content of the license.lic file located in the application folder ($PEPITE_DIR/DATAmaestro/) with the new one. Then restart the datamaestro service sudo systemctl restart datamaestro.

Logs

The LogControl.json file is created automatically by the server. It contains the default log configuration. Datamaestro's is

{ "org.eclipse.jetty":"error", "be.pepite":"info" }

Log levels are those of log4J : debug, info, warn, error.

The logs file can be fould inside the log directory from the application directory (e.g. .PEPITe/DATAmaestro/logs/)

The server parameters rotateLog set the number of days the file are kept.

Logs API

/api/log : Displays the memory buffer associated with the log (i.e. the last x messages written to the log, x is 500 by default).

/api/log?action=clear  : clear the buffer

/api/log?action=size&value=y : changes buffer size, i.e. the number of messages stored in memory

/api/log/files : Returns a list of available log files.

/api/log/files?file=log20220916 : Get specific log file

/api/log/files?from=log20220916&to=log20220922 : Get multiple log files