Jira est un programme Java doté d'une interface web. Lorsque le Java situé en dessous change ou disparaît, Jira échoue plus rapidement qu'il ne peut même écrire un journal - et cette vitesse est votre indice.
Certains échecs de démarrage de Jira produisent de longs journaux. Les échecs Java ne produisent presque rien, car si Java ne peut pas démarrer, Jira ne peut pas s'exécuter - et ne peut pas se connecter. L'histoire habituelle : quelqu'un a mis à niveau le JDK, un nettoyage de Windows a supprimé un ancien Java, ou JAVA_HOME a été modifié pour une autre application, et le service de Jira pointe désormais vers un Java manquant, 32 bits alors qu'il devrait être 64 bits, ou simplement une version que votre version Jira ne prend pas en charge. Cette page montre comment trouver quel Java Jira utilise réellement et le configurer correctement.
Jira n'utilise pas simplement ce que Java Windows préfère. Ses scripts de démarrage examinent d'abord JAVA_HOME, puis JRE_HOME, et le service Windows utilise le Java enregistré dans sa propre configuration. C'est pourquoi « Java est installé » et « Jira échoue toujours » sont tous deux vrais en même temps : ils parlent de différentes installations Java.
bin dans le répertoire d'installation et recherchez setenv.batJAVA_HOME ou JRE_HOME - notez le dossier exact auquel elles nommentbin avec java.exe existe réellement à l'intérieur.java -version depuis son dossier bin et notez la version.C’est l’étape à laquelle les gens devinent, et deviner coûte cher. Chaque version de Jira prend en charge un ensemble spécifique de versions Java : les anciennes versions de Jira fonctionnent sur Java 8 ou 11, les plus récentes nécessitent Java 11 ou 17 et les plus récentes nécessitent Java 17 ou version ultérieure. Un Java trop récent échoue aussi durement qu'un Java trop ancien - les modifications des fichiers de classe et des modules sont réelles et non compliquées.
atlassian-jira.log de travail.Une fois que vous connaissez le bon JDK, assurez-vous que chaque pointeur soit d'accord. Changer uniquement la variable d'environnement système est la demi-correction classique : le service peut continuer à utiliser le Java stocké dans ses propres paramètres de wrapper, et l'échec survit à votre réparation.
setenv.bat pour que JAVA_HOME nomme le dossier JDK pris en charge - pas de bin de fin, juste la racine du JDKJAVA_HOME conflictuel y serait défini.bin et confirmez que le chemin Java correspond.Les problèmes Java ont des conséquences. Le service échoue en quelques secondes. L'Observateur d'événements Windows affiche les erreurs du service ou de la JVM avant même que les journaux de Jira ne commencent. Et lorsque des journaux existent, des expressions telles que UnsupportedClassVersionError (Java trop ancien pour le code) ou des erreurs d'accès au module (Java trop nouveau et strict) nomment directement la non-concordance. Cependant, un message « Impossible de créer la machine virtuelle Java » concerne généralement les paramètres de mémoire, et non la version – qui appartient au correctif de tas, pas à celui-ci.
UnsupportedClassVersionError ou java.lang en haut de l'échec.La réparation complète du démarrage de Jira, étape par étape, avec les écrans et les lignes de journal exacts affichés en direct.
▶️ Watch Full VideoParce que Jira n'utilise probablement pas ce Java. Jira suit JAVA_HOME dans son propre setenv.bat et Java enregistré dans la configuration de son service Windows, qui peut pointer vers un JDK plus ancien ou supprimé tandis que d'autres applications utilisent volontiers le système Java. Vérifiez le fichier java.exe exact dans le dossier vers lequel Jira pointe, avec la version java exécutée à partir de ce dossier.
Uniquement si la page Plateformes prises en charge d'Atlassian pour votre version exacte de Jira répertorie cette version de Java. Les versions plus récentes ne sont pas automatiquement prises en charge : un Java trop récent brise Jira de manière aussi fiable qu'un Java trop ancien, via des versions de classe modifiées et des règles de module plus strictes. Faites correspondre la plage documentée ; ne poursuivez pas le nombre le plus élevé.
La mise à jour a probablement remplacé ou supprimé le JDK vers lequel pointe JAVA_HOME de Jira, ou modifié le système JAVA_HOME qu'un autre administrateur a ensuite copié dans la configuration de Jira. Le correctif ne consiste pas à restaurer l'intégralité du serveur - installez ou conservez côte à côte un JDK pris en charge et pointez uniquement Jira dessus, en utilisant setenv.bat et les paramètres Java du service.