L'application est disponible sur github. Il est conseillé d'utiliser git pour télécharger les sources :
git clone https://github.com/EsupPortail/esup-smsu-api-admin.git |
N'hésitez pas également à utiliser GIT en interne pour exploiter et maintenir à jour vos instances.
Vous pouvez aussi trouver des zip sur cette page : https://github.com/EsupPortail/esup-smsu-api-admin/tags.
L'administration du back office utilise la même base de données que celle du back office, mais smsu-api-admin utilise quelques tables supplémentaires.
Pour créer ces tables :
mysql -u root -p smsuapi < src/main/resources/database/create_tables.sql |
Il faut premièrement configurer le premier super utilisateur de l'application.
Pour ce faire, éditer le fichier « src/main/resources/database/populate_tables.sql », puis modifier la ligne suivante
-- Ajout du premier super administrateur INSERT INTO user_bo_smsu VALUES (1, 3, "admin"); |
Il faut remplacer admin par le login de l'utilisateur qui sera le super administrateur.
Puis faire :
mysql -u root -p < src/main/resources/database/populate_tables.sql |
Le back office se déploie en mode servlet ou portlet.
Créez src/main/resources/properties/config.properties en s'inspirant de config.sample.properties. Si vous utilisez git pour l'exploitation et la mise à jour, il est conseillé de faire :
ln -s config.sample.properties src/main/resources/properties/config.properties git add src/main/resources/properties/config.properties git commit -m 'utiliser config.sample.properties comme base de configuration' |
Vérifier la configuration des fichiers :
ant download-webjars |
mvn jetty:run # ou ant jetty.run |
mvn package |
puis copiez le war dans webapps (servlet) ou utilisez de commande uPortal "ant deployPortletApp".
ou si vous préférez vous pouvez utiliser ant en configurant préalablement le chemin de déploiement dans build.properties
ant deploy |
Ajouter l'application dans le contexte du serveur du portail par le biais du fichier conf/Catalina/localhost/esup-smsu-api-admin.xml
<Context ... /> |
NB : le déploiement est conforme à un déploiement portlet dans le portail esup-uportal.
La portlet d'administration du back office se déploie par le biais du gestionnaire de canaux.
La configuration utilisée est la suivante :
Un fichier de propriété permet aux exploitants de paramétrer l'administration du Back Office.
Voici la liste des paramètres disponibles :
Url d'accès à la base de donnée :
hibernate.connection.jdbc.url=jdbc:mysql://<host>:3306/smsuapi |
Ce paramètre défini l'url de la base de donnée du back office
Login d'accès à la base de donnée :
hibernate.connection.jdbc.username=root |
Ce paramètre défini le login pour l'accès à la base de donnée du back office
Mot de passe d'accès à la base de donnée :
hibernate.connection.jdbc.password=xxxx |
Ce paramètre défini le mot de passe pour l'accès à la base de donnée du back office
Méthode d'accès à la base de donnée :
hibernate.useJndi=false |
Défini le mode d'accès à la base de donnée du front office.
L'url du serveur cas :
cas.url=https://<host>:<port>/cas |
Défini l'adresse du serveur cas.
Nom de la machine et port pour accéder au front-office :
tomcat.host=localhost tomcat.port.string=:8080 |