Présentation :
Après avoir testé Jira et décidé de le conserver pour la production, il est fortement recommandé de changer le type de base de données utilisé par Jira. La base de données par défaut au moment de la livraison est H2 (fichier local dB) et dans ce HOW-TO, je décris ce que j'ai dû faire pour exécuter ce changement sous Debian Jessie.
Étapes :
Références :
https://confluence.atlassian.com/jira062/switching-databases-588581557.html
https://confluence.atlassian.com/adminjiraserver072/connecting-jira-applications-to-mysql-828787562 .html
https://confluence.atlassian.com/jira060/connecting-jira-to-mysql-370705252.html
Base de données de sauvegarde :
(SprocketWheelIcon)==>>Système ==>>(Menu de gauche)Système de sauvegarde ==>>Nom du fichier :HP_JIRA_Backup_1.zip
Résultats :
ex. /var/atlassian/application-data/jira/export/HP_JIRA_Backup_1.zip
Créez la nouvelle base de données dans MySQL :
Suivez ces instructions :
1) Connectez-vous à mysql en tant que root :mysql -p -u root
PW: ******
2) Créer la BD, l'utilisateur et les droits d'accès utilisateur :CREATE DATABASE jiradb CHARACTER SET utf8 COLLATE utf8_bin;
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX on jiradb.* TO 'jiradbuser'@'localhost' IDENTIFIED BY '<DBpassword>';
flush privileges;
3) Astuce :Pour confirmer si les autorisations ont été accordées avec succès, connectez-vous au serveur de base de données avec l'utilisateur de la base de données JIRA et exécutez la commande ci-dessous :SHOW GRANTS FOR 'jiradbuser'@'localhost';
4) Quitter Mysql :quit;
Arrêtez le serveur Mysql et Jira : service mysql stop
service jira stop
Supprimer les fichiers journaux innoDB
IMPORTANT !! Assurez-vous qu'aucune autre application n'utilise le format innoDB pour ses bases de données, sinon cette suppression pourrait corrompre les données.rm /var/lib/mysql/ib_logfile?
Modifier /etc/mysql/my.cnf et ajoutez les lignes suivantes :
POUR Mysql 5.5 et inférieur [mysqld]
...
default_storage_engine=InnoDB
max_allowed_packet=256M
innodb_log_file_size=256M
POUR Mysql 5.6 [mysqld]
...
default_storage_engine=InnoDB
max_allowed_packet=256M
innodb_log_file_size=2G
Supprimez-le s'il existe sql_mode = NO_AUTO_VALUE_ON_ZERO
Démarrer le serveur MySQL : service mysql start
Installez le pilote MySQL JDBC dans le répertoire des pilotes Jira cd /tmp
wget http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.40.tar.gz
tar fvxz mysql-connector-java-5.1.40.tar.gz
cp mysql-connector-java-5.1.40/mysql-connector-java-5.1.40-bin.jar /opt/atlassian/jira/lib/
# Delete the not needed uncompressed directory
rm -rf mysql-connector-java-5.1.40
Connecter Jira à la base de données MySQL :
Renommer le dbconfig.xml fichier comme suit :
Remarque : ce changement de nom de fichier forcera Jira à démarrer l'assistant de configuration s'il ne trouve pas ce fichier.mv /var/atlassian/application-data/jira/dbconfig.xml /var/atlassian/application-data/jira/dbconfig.xml.H2
Redémarrez Jira :
Remarque : Il s'agit normalement d'un long processus qui peut prendre jusqu'à une minute avant que Jira ne soit vraiment prêt à être utilisé.service jira stop && service jira start && tail -f /var/atlassian/application-data/jira/log/atlassian-jira.log
Attention aux erreurs (comme 'exception…'
Lorsque les journaux affichent quelque chose comme ci-dessous, Jira est prêt à être utilisé pour poursuivre la migration de la base de données.---------------------------------------------------------------------------------
Heap memory : Used: 196 MiB. Committed: 482 MiB. Max: 733 MiB
Non-heap memory : Used: 57 MiB. Committed: 59 MiB. Max: 1264 MiB
---------------------------------------------------------------------------------
TOTAL : Used: 253 MiB. Committed: 541 MiB. Max: 1997 MiB
---------------------------------------------------------------------------------
Connecter Jira à la base de données MySQL :
– Utilisation du navigateur allez sur ce site Jira et l'assistant de configuration de Jira vous sera présenté.
– Sélectionnez la Configuration manuelle
– Sur la page de configuration de la base de données, sélectionnez :Ma propre base de données et remplissez les champs
– Cliquez sur Tester la connexion pour vérifier la validité des informations
– Si tout est ok, cliquez sur Continuer bouton.
– Saisissez le nom de l'entreprise et sélectionnez Privé , et indiquez l'URL dans la page "Configurer les propriétés de l'application"
– Sélectionnez J'ai une clé Jira et collez la clé dans le champ sous ID du serveur
– Et remplissez les pages suivantes etc.
Migration de la base de données
Importation à partir d'anciennes données H2 enregistrées dans un fichier de sauvegarde xml (.zip)
Dans le terminal :
Déplacez le fichier de sauvegarde vers le répertoire d'importation :mv /var/atlassian/application-data/jira/export/HP_JIRA_Backup_1.zip /var/atlassian/application-data/jira/import/HP_JIRA_Backup_1.zip
Sur le site Jira :
(SprocketWheelIcon )==>> Système ==>> (Menu de gauche )Restaurer le système
Entrez le nom de fichier (sans chemin) de la sauvegarde (y compris l'extension .zip)
Cliquez sur Restaurer bouton.
REMARQUE IMPORTANTE : Cette opération écrasera tous les paramètres (à l'exception de la connexion à la base de données) que vous avez déjà entrés dans le précédent Assistant de configuration comme votre mot de passe/utilisateur/email/langue etc. Par conséquent, si ces informations ne sont pas exactement les mêmes, vous devrez vous déconnecter et vous reconnecter.
Le Portfolio pour licence Jira devra peut-être être renouvelé à :
https://www.atlassian.com/purchase/cart
Afin de corriger l'erreur, cela apparaîtra si le FLAG pool-test-while-idle n'est pas défini dans le fichier dbconfig.xml, modifiez le fichier :
/var/atlassian/application-data/jira/dbconfig.xml et ajoutez la ligne suivante dans <pool-test-while-idle>true</pool-test-while-idle>
par exemple.<jdbc-datasource>
.....
<pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
<pool-test-while-idle>true</pool-test-while-idle>
<pool-test-on-borrow>false</pool-test-on-borrow>
.....
</jdbc-datasource>
Raison : L'assistant de configuration ne l'a pas défini (inexistant) lors de la configuration des paramètres de la base de données et l'interface se plaignait d'avoir échoué à un test de connexion à la base de données. J'ai dû effectuer cette modification manuellement plus tard et redémarrer Jira.
Redémarrez Jira et surveillez les erreurs. service jira stop && service jira start && tail -f /var/atlassian/application-data/jira/log/atlassian-jira.log
Vérification des erreurs dans les journaux :
Vous pouvez vérifier les erreurs via l'interface Jira Analyseur de journaux fonction dans :
(SprocketWheelIcon )==>>Système ==>>(Menu de gauche )Outils d'assistance ==>>Analyseur de journaux (TAB)==>>Actualiser (au milieu à droite)