Table des matières

Installation de JIRA sur Mac OS X

Installation effectuée avec

Installation

  1. Obtenir Jira
    1. Décompresser le fichier atlassian-jira-5.0.3.tar.gz
    2. Déplacer les fichiers dans /Applications/JIRA (répertoire arbitraire, peut être différent)
  2. Configurer JIRA_HOME
    1. Créer le répertoire HOME dans /Applications/JIRA pour avoir un répertoire /Applications/JIRA/HOME pour le JIRA_HOME (ce répertoire est aussi arbitraire, peut être différent).
    2. Ouvrir le fichier jira-application.properties dans le répertoire atlassian-jira/WEB-INF/classes et éditer la valeur jira.home pour donner quelque chose comme
      jira.home = /Applications/JIRA/HOME
    3. Configurer la variable d'environnement JIRA_HOME : $ export JIRA_HOME=/Applications/JIRA/HOME
  3. Configurer Java
    1. Trouver l'installation de Java : $ whereis java
    2. Configurer la variable d'environnement JAVA_HOME avec le répertoire donné précédement : $ export JAVA_HOME=/usr/bin/java
  4. Changer le port d'écoute de JIRA (optionnel : Par défaut le port est à 8080, il est possible qu'il soit nécessaire de le changer)
    1. Ouvrir le fichier server.xml dans le répertoire JIRA/conf
    2. Modifier la valeur de <Connector port="8080" dans l'élément <Service name="Catalina">, ce qui devrait ressembler à ceci si on change le port pour 8989:
      <Service name="Catalina">
          <Connector port="8989"
              ...
  1. Démarrer JIRA
    1. Exécuter la commande bin/startup.sh
    2. Aller à l'adresse http://localhost:8989/

Mise à jour

La mise à jour a essentiellement les mêmes étapes que la migration. La procédure ci-dessous se base sur la mise à jour manuelle de JIRA.

  1. Faire une sauvegarde de tout.
    1. Faire une exportation des données JIRA : Dans JIRA, aller dans Administration → Système → Import / Export et faire l'exportation. Ceci créera un ZIP dans /Applications/JIRA/HOME/export.
    2. Arrêter l'instance de JIRA
    3. Faire une sauvegarde de la base de données (ex : dump SQL avec données)
    4. Faire un backup (fichier ZIP) du répertoire /Applications/JIRA.
  2. Faire une nouvelle installation de JIRA
    1. Télécharger la dernière version de JIRA
    2. Supprimer le répertoire de JIRA existant et recréer un nouveau répertoire vide1)
    3. Décompresser le fichier à l'emplacement de l'installation actuelle de JIRA (ie : /Applications/JIRA).
    4. Replacer les fichiers du répertoire HOME de l'ancienne installation dans le nouveau répertoire HOME de la nouvelle installation.
  3. Configuration
    1. Configurer JIRA_HOME : Ouvrir le fichier jira-application.properties dans le répertoire atlassian-jira/WEB-INF/classes et éditer la valeur jira.home pour donner quelque chose comme
jira.home = /Applications/JIRA/HOME
  1. Configurer la variable d'environnement JIRA_HOME : $ export JIRA_HOME=/Applications/JIRA/HOME
  2. Changer le port d'écoute de JIRA (optionnel : Par défaut le port est à 8080, il est possible qu'il soit nécessaire de le changer)
    1. Ouvrir le fichier server.xml dans le répertoire conf
    2. Modifier la valeur de <Connector port="8080" dans l'élément <Service name="Catalina">, ce qui devrait ressembler à ceci si on change le port pour 8989 :
<Service name="Catalina">
    <Connector port="8989"
        ...
  1. Configurer la base de données
    1. Si nécessaire, télécharger MySQL Connector/J.
    2. Créer une nouvelle base de données jiradb.
      1. Exécuter le SQL :
CREATE DATABASE jiradb CHARACTER SET utf8 COLLATE utf8_bin;
  1. Donner les permissions :
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX ON <JIRADB>.* TO '<USERNAME>'@'<JIRA_SERVER_HOSTNAME>' IDENTIFIED BY '<PASSWORD>';
FLUSH privileges;
  1. Exécuter la commande /Applications/JIRA/bin/config.sh
  2. Donner les informations de la base de données (host, username, password, database, etc)
  3. Démarrer JIRA
  4. Exécuter la commande bin/startup.sh
  5. Aller à l'adresse http://localhost:8989/
  6. JIRA devrait proposer un wizard : choisir l'option d'importer les données et importer le fichier ZIP qui a été créé à l'étape 1-c (inclure l'extension, ie : .zip).

Sources

Icônes

Types d'opérations

  1. Mise à jour
  2. Migration

Installation sur Linux

Cette procédure prend en compte que JIRA sera utilisé avec MySQL.

Installation de JIRA

  1. Télécharger le fichier atlassian-jira-6.4.4-x64.bin.
  2. Faire en sorte qu'il est exécutable : # chmod a+x atlassian-jira-6.4.4-x64.bin.
  3. Exécuter le fichier .bin.
  4. Choisir l'installation personnalisée.
    1. Le répertoire d'installation par défaut est /opt/atlassian/jira.
    2. Les données de JIRA seront dans /var/atlassian/application-data/jira.

Préparer la base de données

  1. Se connecter à MySQL : mysql -u root -p.
  2. Ajouter un utilsateur pour JIRA :
    mysql> CREATE USER 'jiradbuser'@'localhost' IDENTIFIED BY '<PASSWORD>';
  3. Créer la base de données :
    mysql> CREATE DATABASE jiradb CHARACTER SET utf8 COLLATE utf8_bin;
  4. Donner les permissions:
    mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX on jiradb.* TO 'jiradbuser'@'localhost' IDENTIFIED BY '<PASSWORD>';
    mysql> FLUSH PRIVILEGES;
  5. Copier le fichier dans le répertoire d'installation de JIRA + lib, par défaut c'est /opt/atlassian/jira/lib.
  6. Redémarrer JIRA si nécessaire.

Source

Configuration

  1. Aller sur la machine avec le bon port (par défaut c'est 8080). Il se peut que démarrer JIRA soit nécessaire : service jira start.

Mise à jour sous Linux

La mise à jour est de 7.1.2 à 7.1.9.

Étapes:

  1. Téléchargement du package .bin récent de JIRA.
  2. Exécution du package
  3. Choisir l'option de la mise à jour.
  4. La mise à jour procède à ces tâches:
    1. Faire un backup de l'installation actuelle
    2. Détecter les différences dans la configuration, par exemple dans le fichier server.xml.
    3. Procéder à la mise à jour.
  5. Une fois la mise à jour terminée, il faut reconfigurer server.xml. J'ai simplement renommé le server.xml en server.xml.orig de la nouvelle installation et recopié le vieux server.xml provenant du backup au répertoire de conf.

À cette étape JIRA est fonctionnel en faisant le ./startup.sh.

1)
la procédure de mise à jour mentionne explicitement de ne pas écraser le répertoire de JIRA avec les fichiers de la nouvelle installation