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/

Pour migrer JIRA sur un autre serveur, voici la procédure :

1. Sur le serveur source :
   1. Faire un backup de la base de données (ex : dump SQL avec données)
   2. 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.
   3. Faire un backup (fichier ZIP) du répertoire /Applications/JIRA/HOME.
   4. Copier ces deux fichiers pour les transférer sur le serveur cible.
2. Sur le serveur cible :
   1. Importer les données SQL sur MySQL à l'aide du fichier créé à l'étape 1a.
   2. Créer le répertoire /Applications/JIRA et décompresser le fichier contenant l'application JIRA.
   3. Créer le répertoire /Applications/JIRA/HOME et y mettre les données du fichier compressé du créé à l'étape 1c.
   4. Faire la configuration voulue de JIRA comme indiqué dans la procédure d'installation (JIRA_HOME, JAVA_HOME, server port, jira-application.properties).
   5. Aller sur la page de l'application (ex : http://localhost:8989/)
   6. Entrer les informations pour les paramètres de base
   7. Dans la deuxième étape, on offre le choix d'importer les données, utilisez cette option.
   8. Importer les données ZIP qui ont été créés à l'étape 1b.
   9. Ceci devrait compléter la procédure de migration.

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 jira.
      1. Exécuter le SQL :

         CREATE DATABASE jiradb CHARACTER SET utf8 COLLATE utf8_bin;

      2. Donner les permissions :

         GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX ON <JIRADB>.* TO '<USERNAME>'@'<JIRA_SERVER_HOSTNAME>' IDENTIFIED BY '<PASSWORD>';
         FLUSH privileges;

   3. Exécuter la commande /Applications/JIRA/bin/config.sh
   4. Donner les informations de la base de données (host, username, password, database, etc)
2. Démarrer JIRA
   1. Exécuter la commande bin/startup.sh
   2. Aller à l'adresse http://localhost:8989/
   3. 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.