Amministrare applicazioni Jira Supporto

Definire o modificare il server di posta SMTP

1. Scegliere Amministrazione () > Sistema.
2. Selezionare Posta > Posta in uscita per aprire la pagina del server di posta SMTP.
   Se non è stato definito alcun server di posta SMTP, nella pagina verrà visualizzato un pulsante Configura nuovo server di posta SMTP. Se uno è già stato definito, i dettagli del server di posta SMTP verranno visualizzati nella pagina, insieme a una serie di collegamenti operativi a destra.

3. Fare clic sul pulsante Configura nuovo server di posta SMTP per definire un nuovo server di posta SMTP o sul collegamento Modifica a destra per modificare il server di posta SMTP esistente, che aprirà la pagina Aggiungi/Aggiorna server di posta SMTP.

4. Completa la sezione superiore di questa pagina come segue:

   Nome	Specificare un nome arbitrario per identificare questa configurazione del server di posta SMTP.
   Descrizione	(Facoltativo) Specificare una descrizione arbitraria che descriva il server di posta SMTP. Questa descrizione viene visualizzata sotto il nome del server di posta SMTP nella pagina di configurazione del server di posta SMTP.
   Dall’indirizzo	Specificare l’indirizzo email utilizzato nel campo ‘indirizzo mittente’ (o ‘da’) dei messaggi di notifica inviati da Jira, a meno che non venga sovrascritto in una configurazione di progetto. Specificare solo un indirizzo email per questo campo (ad esempio [email protected]). Jira utilizzerà questo valore per costruire l’intestazione ‘from’ completa in base all’utente corrente ("Joe Bloggs (Jira) <[email protected]>"). Per modificare l’intestazione ‘da’, vai a Amministrazione > Sistema > Configurazione generale e (in Impostazioni), modifica il campo E-mail da.
   Prefisso email	Specificare l’oggetto delle e-mail inviate da questo server utilizzerà questa stringa come prefisso. Questo è utile per gli utenti in modo che possano filtrare le notifiche e-mail da Jira in base a questo prefisso.

   Schermata: Aggiungi (o Aggiorna) Server di posta SMTP

   

Specificare un nome host o un percorso JNDI per il server di posta SMTP

La seconda parte della pagina Aggiungi/Aggiorna server di posta SMTP specifica i dettagli del server di posta SMTP a cui Jira invierà la posta. Ci sono due modi per farlo. O:

• specificare i dettagli dell’host SMTP del server di posta SMTP;
  o:
• specificare la posizione JNDI di un oggetto javax.mail.Session, ovvero utilizzare JNDI per cercare un server di posta SMTP preconfigurato nel server delle applicazioni. Questo ha i seguenti vantaggi:
  • Migliore sicurezza: i dettagli della posta non sono disponibili per gli amministratori Jira attraverso l’interfaccia di amministrazione Jira e non sono memorizzati nei file di backup Jira.
  • Altre opzioni SMTP: ad esempio, è possibile passare a RSET invece di NOOP per testare le connessioni impostando la proprietà mail.smtp.userset.
  • Gestione centralizzata: i dettagli della posta sono configurati nella stessa posizione dei dettagli del database e possono essere configurati tramite gli strumenti di amministrazione del server delle applicazioni.

Specificare i dettagli dell’host SMTP

La maggior parte delle persone configura il server di posta SMTP di Jira specificando i dettagli dell’host SMTP di questo server di posta direttamente in Jira.

1. Nella sezione Host SMTP della pagina Aggiungi/Aggiorna server di posta SMTP (sopra), compilare i seguenti campi del modulo:

   Provider di servizi (non disponibile quando si aggiorna un server di posta SMTP esistente)	Scegliere tra l’utilizzo del proprio server di posta SMTP (cioè personalizzato), o Gmail (cioè Google Apps Mail / Gmail) o Yahoo! (cioè Yahoo! Mail Plus) come fornitore di servizi per il server di posta SMTP. Se scegli Gmail o Yahoo! opzioni e poi tornare a Personalizzato, alcuni dei campi chiave in questa sezione verrà automaticamente popolato con le impostazioni del server di posta SMTP rilevanti per questi fornitori di servizi.
   Protocollo	Scegli se il tuo server di posta SMTP è standard (es. SMTP) o sicuro (es. SECURE_SMTP).
   Nome host	Specificare il nome host o l’indirizzo IP del server di posta SMTP. Ad Es. smtp.yourcompany.com
   Porta SMTP	(Opzionale) Il numero di porta SMTP, di solito 25 per SMTP o 465 per SMTPS, entrambi i quali sono assunti se questo campo è lasciato vuoto.
   Timeout	(Facoltativo) Specificare il periodo di timeout in millisecondi, che viene trattato come 10000 se questo campo viene lasciato vuoto. Specificando 0 o un valore negativo qui, Jira attenderà indefinitamente la risposta del server SMTP.
   TLS	(Facoltativo) Selezionare questa casella di controllo se l’host SMTP utilizza il protocollo TLS (Transport Layer Security).
   Nome utente	(Facoltativo) Se l’host SMTP richiede l’autenticazione, specificare qui il nome utente di queste credenziali di autenticazione. (La maggior parte dei server aziendali richiede l’autenticazione per inoltrare la posta a utenti non locali.)
   Password	(Opzionale) Ancora una volta, se il tuo host SMTP richiede l’autenticazione, spcify la password associata al nome utente specificato sopra. Quando si modifica un server di posta SMTP esistente, selezionare la casella di controllo Cambia password per accedere e modificare questo campo.

   Si prega di notare:

   • Se lo script di avvio del server utilizza le proprietà di sistema -Dmail (ad esempio mail.smtp.host o mail.smtp.port), sovrascriveranno le impostazioni specificate nel modulo precedente. Inoltre, se necessario, è possibile specificare manualmente il nome host che Jira si riferisce al server SMTP impostando -Dmail.smtp.localhost

   • L’SMTP deve supportare il tipo di contenuto multipart. Senza questo mail non sarà in grado di inviare.
2. (Opzionale) Fare clic sul pulsante Test Connection per verificare che Jira possa comunicare con il server di posta SMTP appena configurato.
3. Fare clic sul pulsante Aggiungi (o Aggiorna) per salvare la configurazione del server di posta SMTP di Jira.

Specificare una ‘Posizione JNDI’

In alternativa a specificare i dettagli dell’host SMTP direttamente in Jira, è possibile configurarli nel server delle applicazioni e quindi cercare una sessione di posta preconfigurata tramite JNDI.

Nella sezione Posizione JNDI della pagina Aggiungi/Aggiorna server di posta SMTP (sopra), specificare la posizione di un oggetto javax.mail.Session da utilizzare per l’invio di e-mail, nel campo Posizione JNDI. Questo inizierà con il prefisso java:comp/env/

Configurazione di una posizione JNDI

La posizione JNDI specificata in Jira dipenderà dal server delle applicazioni e dalla configurazione di Jira. Le posizioni JNDI sono in genere configurate nel server delle applicazioni che esegue Jira. Quindi, Jira dovrà essere riavviato dopo aver configurato una posizione JNDI affinché tale configurazione sia disponibile in Jira.

Per esempio, in Tomcat 6 (il server di applicazioni in bundle con ‘consigliato’ di distribuzioni di Jira), il JNDI Posizione sarebbe java:comp/env/mail/JiraMailServer e aggiungere la sezione seguente per il conf/server.xml della tua Jira directory di installazione dell’applicazione, all’interno di <Context/> nodo:

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="mail.yourcompany.com" mail.smtp.port="25" mail.transport.protocol="smtp" mail.smtp.auth="true" mail.smtp.user="jirauser" password="mypassword" /> ...</Context>

O se non si necessita di autenticazione (ad esempio, se si invia tramite localhost, o solo internamente all’azienda):

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="localhost" mail.smtp.port="25" mail.transport.protocol="smtp" /> ...</Context>

Se si esegue Jira su un server di applicazioni diverso da Apache Tomcat (che non è una configurazione Jira supportata), una metodologia simile per la configurazione di una posizione JNDI sul server di posta SMTP dovrebbe applicarsi a tale server di applicazioni.

Se hai problemi di connessione, aggiungi un parametro mail.debug="true" all’elemento <Resource/> (sopra), che ti permetterà di vedere i dettagli di ‘debug’ a livello SMTP durante il test della connessione.

Sposta le classi JavaMail

Dovrai anche assicurarti che le classi JavaMail (in genere nei file della libreria JAR) siano presenti nel classpath del tuo server delle applicazioni e che queste non siano in conflitto con i file della libreria JAR di Jira. Ciò è necessario perché il server delle applicazioni stesso (non Jira) sta stabilendo la connessione SMTP e come tale, il server delle applicazioni non può vedere i file della libreria JAR nel classloader di Jira.

Alcuni sistemi operativi possono raggruppare le classi JavaMail con i server delle applicazioni (ad esempio Tomcat in Red Hat Enterprise Linux). Questo potrebbe essere in conflitto con la copia di Jira delle classi JavaMail, con conseguenti errori come:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

oppure:

java.lang.IllegalArgumentException: Mail server at location is not of required type javax.mail.Session.

I server di applicazioni più leggeri come Apache Tomcat (incluso quello incorporato nelle distribuzioni “raccomandate” di Jira), non sempre vengono forniti con JavaMail.

Per evitare conflitti, controllare la directory lib/ del server delle applicazioni:

• Se il server delle applicazioni contiene già mail-1.4.1.jar e activation-1.1.1.jar, rimuovere semplicemente mail-1.4.1.jar e activation-1.1.1.jar dalla sottodirectory <jira-application-dir>/WEB-INF/lib/ della directory di installazione dell’applicazione Jira.
• Se il server delle applicazioni non contiene mail-1.4.1.jar e activation-1.1.1.jar, spostare le mail-1.4.1.jar e activation-1.1.1.jar dalla sottodirectory <jira-application-dir>/WEB-INF/lib/ della directory di installazione dell’applicazione Jira nella sottodirectory lib/ della directory di installazione di Jira (per le distribuzioni ‘raccomandate’ di Jira) o nella sottodirectory lib/ del server delle applicazioni che esegue Jira.

SMTP su SSL

È possibile crittografare le comunicazioni e-mail tra Jira e il server di posta tramite SSL, a condizione che il server di posta supporti SSL.

In primo luogo, è necessario importare il certificato del server SMTP in un keystore Java. Il processo è descritto nella pagina Configurazione di una connessione SSL a Active Directory.

Nota importante: senza importare il certificato, Jira non sarà in grado di comunicare con il server di posta.

In secondo luogo, modificare le proprietà di connessione del server di posta e specificare starttlse SSLSocketFactory. Da {$Jira_INSTALL}/conf/server.xml (questo esempio utilizza il server di Gmail):

<Resource name="mail/GmailSmtpServer" auth="Container" type="javax.mail.Session" mail.smtp.host="smtp.gmail.com" mail.smtp.port="465" mail.smtp.auth="true" mail.smtp.user="[email protected]" password="mypassword" mail.smtp.starttls.enable="true" mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"/>

Risoluzione dei problemi

Un suggerimento utile per il debug dei problemi relativi alla posta in Jira è impostare la proprietà -Dmail.debug=true all’avvio. Ciò causerà la registrazione dei dettagli a livello di protocollo delle interazioni e-mail di Jira. Inoltre, alzando il livello di registro di JIRA mostrerà quando il servizio è in esecuzione e come vengono elaborate le mail.

Problemi comuni

• Se Jira non sembra creare o inviare e-mail o creare problemi e commenti da e-mail, l’installazione di Jira potrebbe riscontrare errori OutOfMemory. Si prega di controllare i file di registro per gli errori OutOfMemory. Se ci sono errori OutOfMemory, riavviare Jira e indagare sugli errori.
• Se trovate alcune email in arrivo semplicemente scompaiono, verificare di non aver accidentalmente avviato una seconda copia di Jira (ad es. in un ambiente di staging) che sta scaricando ed eliminando i messaggi di posta elettronica. Vedere la pagina Ripristino dati per i flag da impostare per impedire l’elaborazione della posta.
• Se si ricevono errori ‘Mail Relay’, assicurarsi di aver specificato il nome utente e la password nella sezione Host SMTP della pagina di configurazione del server di posta SMTP di Jira.

Ottenere aiuto

Se non è possibile risolvere un problema da soli, si prega di creare un caso di supporto nel progetto ‘Jira’ e noi vi assisteremo.