Introduction
There is a new ESUP Helpdesk version (4.2.0) which can be found on the github repository. This version is divided in 2 branches :
- One branch without any change in the UI (called AMU)
- One branch with a massive UI change (called AMU_IHM)
3.29 to 4.2 AMU
Here is the documentation which allows you to migrate from the old 3.29 version to the new 4.2 version (the AMU branch, with the same UI) :
[test-helpdesk@helpdesk src]$ git clone https://github.com/EsupPortail/esup-helpdesk.git [test-helpdesk@helpdesk src]$ cd esup-helpdesk/ [test-helpdesk@helpdesk esup-helpdesk]$ git checkout AMU [test-helpdesk@helpdesk esup-helpdesk]$ git branch -d master
After that, we have to configure this new version (using the config.properties file) and copy the previous files below :
[test-helpdesk@helpdesk esup-helpdesk]$ cp src/main/resources/properties/config.properties.sample src/main/resources/properties/config.properties [test-helpdesk@helpdesk ~]$ cp src/v3.92/build.properties src/esup-helpdesk/build.properties [test-helpdesk@helpdesk ~]$ cp src/v3.92/src/main/resources/properties/logging/log4j.properties src/esup-helpdesk/src/main/resources/properties/logging/log4j.properties [test-helpdesk@helpdesk ~]$ cp src/v3.92/src/main/resources/properties/i18n/bundles/Custom_fr.properties src/esup-helpdesk/src/main/resources/properties/i18n/bundles/
Then, we can make the DB upgrade and add couple of additionnal queries :
[test-helpdesk@helpdesk esup-helpdesk]$ ../../ant.sh upgrade | [test-helpdesk@helpdesk esup-helpdesk]$ mysql -u helpdesk_db_user -p helpdesk_db < src/main/resources/properties/dao/hibernate/updateBase-v3tov4.sql
We can now make the deploy :
[test-helpdesk@helpdesk esup-helpdesk]$ ../../ant.sh deploy |
Misc
Here is our .service file needed to run our helpdesk via systemctl (but it may be unnecessary with a unique tomcat instance).
[root@helpdesk:~]$ cat /usr/lib/systemd/system/test-helpdesk.service [Unit] Description=Test Helpdesk After=syslog.target network.target mariadb.service [Service] Type=forking User=test-helpdesk PIDFile=/home/test-helpdesk/tomcat-test-helpdesk.pid ExecStart=/home/test-helpdesk/start.sh ExecStop=/home/test-helpdesk/stop.sh [Install] WantedBy=multi-user.target