Installation effectuée avec

• Mac OS X Lion (10.7.3)
• JIRA 5.0.3 Standalone
• MySQL

1. Obtenir Jira
   1. Télécharger JIRA : http://www.atlassian.com/software/jira/JIRADownloadCenter.jspa
   2. Décompresser le fichier atlassian-jira-5.0.3.tar.gz
   3. 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/

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 vide¹⁾
   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).

• Installing JIRA on Mac OS X

1. Mise à jour
2. Migration

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

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.

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. Récupérer le MySQL Connector sur le site d'Oracle.
6. Copier le fichier dans le répertoire d'installation de JIRA + lib, par défaut c'est /opt/atlassian/jira/lib.
7. Redémarrer JIRA si nécessaire.

Source

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.

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.