Introduzione:
Dopo aver testato Jira e aver deciso di mantenerlo per la produzione, si consiglia vivamente di cambiare il tipo di database utilizzato da Jira. Il database predefinito al momento della consegna è H2(file locale dB) e in questo HOW-TO descrivo cosa dovevo fare per eseguire quel passaggio in Debian Jessie.
Passaggi:
Riferimenti:
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
Database di backup:
(SprocketWheelIcon)==>>Sistema ==>>(menu a sinistra)Sistema di backup ==>>Nome file:HP_JIRA_Backup_1.zip
Risultati:
es. /var/atlassian/application-data/jira/export/HP_JIRA_Backup_1.zip
Crea il nuovo database in MySQL:
Segui queste istruzioni:
1) Collegati a mysql come root:mysql -p -u root
PW: ******
2) Creare il DB, i diritti di accesso utente e utente: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) Suggerimento:per confermare se le autorizzazioni sono state concesse correttamente, accedi al server DB con l'utente JIRA DB ed esegui il comando seguente:SHOW GRANTS FOR 'jiradbuser'@'localhost';
4) Esci da MySQL:quit;
Arresta il server MySQL e Jira: service mysql stop
service jira stop
Elimina i file di registro di innoDB
IMPORTANTE!! Assicurati di non avere altre applicazioni che utilizzino il formato innoDB per i suoi database, altrimenti l'eliminazione potrebbe danneggiare i dati.rm /var/lib/mysql/ib_logfile?
Modifica /etc/mysql/my.cnf e aggiungi le seguenti righe:
PER Mysql 5.5 e versioni precedenti [mysqld]
...
default_storage_engine=InnoDB
max_allowed_packet=256M
innodb_log_file_size=256M
PER MySQL 5.6 [mysqld]
...
default_storage_engine=InnoDB
max_allowed_packet=256M
innodb_log_file_size=2G
Rimuovi questo se esiste sql_mode = NO_AUTO_VALUE_ON_ZERO
Avvia il server MySQL: service mysql start
Installa il driver MySQL JDBC nella directory dei driver 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
Collegamento di Jira al database MySQL:
Rinomina il dbconfig.xml file come segue:
Nota: questa modifica del nome del file costringerà Jira ad avviare la procedura guidata di installazione se non trova questo file.mv /var/atlassian/application-data/jira/dbconfig.xml /var/atlassian/application-data/jira/dbconfig.xml.H2
Riavvia Jira:
Nota: Normalmente è un processo lungo che potrebbe richiedere fino a un minuto prima che Jira possa essere davvero pronto per essere utilizzato.service jira stop && service jira start && tail -f /var/atlassian/application-data/jira/log/atlassian-jira.log
Fai attenzione agli errori (come 'eccezione...'
Quando i log mostrano qualcosa come di seguito, Jira è pronto per essere utilizzato per continuare la migrazione del database.---------------------------------------------------------------------------------
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
---------------------------------------------------------------------------------
Collegamento di Jira al database MySQL:
– Utilizzando il browser vai a questo sito Jira e ti verrà presentata la procedura guidata di configurazione di Jira.
– Seleziona la Impostazione manuale
– Nella pagina di configurazione del database, seleziona:Il mio database e riempi gli spazi vuoti
– Fai clic su Verifica connessione per verificare la validità delle informazioni
– Se tutto ok, clicca su Continua pulsante.
– Inserisci il Nome dell'azienda e seleziona Privato , e fornisci l'URL nella pagina "Imposta proprietà dell'applicazione"
– Seleziona Ho una chiave Jira e incolla la chiave nel campo sotto l'ID server
– E compila le seguenti pagine ecc.
Migrazione del database
Importazione da dati H2 meno recenti salvati nel file di backup xml (.zip)
Nel terminale:
Sposta il file di backup nella directory di importazione:mv /var/atlassian/application-data/jira/export/HP_JIRA_Backup_1.zip /var/atlassian/application-data/jira/import/HP_JIRA_Backup_1.zip
Nel sito Jira:
(Icona ruota dentata )==>> Sistema ==>> (Menu a sinistra )Ripristina sistema
Inserisci il nome del file (senza percorso) del backup (compresa l'estensione .zip)
Fai clic su Ripristina pulsante.
NOTA IMPORTANTE: Questa operazione sovrascriverà tutte le impostazioni (tranne la Connessione al Database) che hai già inserito nel precedente Installazione guidata come password/utente/e-mail/Lingua ecc. Pertanto, se queste informazioni non sono esattamente le stesse, dovrai disconnetterti e accedere nuovamente.
Il portafoglio per la licenza Jira potrebbe essere necessario rinnovare su:
https://www.atlassian.com/purchase/cart
Per correggere l'errore, apparirà se il FLAG pool-test-while-idle non è impostato nel file dbconfig.xml, modificare il file:
/var/atlassian/application-data/jira/dbconfig.xml e aggiungi la seguente riga all'interno di <pool-test-while-idle>true</pool-test-while-idle>
es.<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>
Motivo: La procedura guidata di installazione non l'ha impostata (inesistente) durante la configurazione delle impostazioni del database e l'interfaccia si lamentava del fallimento di un test di connessione al database. Ho dovuto apportare la modifica manualmente in un secondo momento e riavviare Jira.
Riavviare Jira e verificare la presenza di errori. service jira stop && service jira start && tail -f /var/atlassian/application-data/jira/log/atlassian-jira.log
Verifica dei log per gli errori:
Puoi verificare la presenza di errori tramite l'interfaccia di Jira Analizzatore log funzione in:
(SprocketWheelIcon )==>>Sistema ==>>(Menu a sinistra )Strumenti di supporto ==>>Analizzatore log (TAB)==>>Aggiorna (al centro a destra)