Conectar aplicações JIRA ao PostgreSQL

Conectar aplicações JIRA a um banco de dados

On this page

Related content

  • No related content found

Still need help?

The Atlassian Community is here for you.

Ask the community

Estas instruções o ajudarão a conectar o JIRA a um banco de dados PostgreSQL .

Antes de começar

  • Verifique se há suporte para a versão do PostgreSQL. Consulte Plataformas com suporte.
  • Se você estiver migrando o JIRA para outro servidor, crie uma exportação dos dados como um backup XML. Assim, será possível transferir os dados do banco de dados antigo para o novo, conforme descrito em Switching databases (Alternância entre bancos de dados).
  • Desligue o JIRA antes de começar, a menos que você esteja executando o assistente de configuração.

Nesta página:

1. Crie e configure o banco de dados PostgreSQL

Você pode encontrar informações sobre a criação de usuários e bancos de dados para sua versão do PostgreSQL no site do sistema.

  1. Crie um usuário do banco de dados (função de login) ao qual o JIRA se conectará (por exemplo jiradbuser).
    Memorize esse nome de usuário do banco de dados, pois ele será usado para configurar a conexão do JIRA com esse banco de dados nas etapas subsequentes.

  2. Crie um banco de dados para o JIRA no qual armazenar pendências (por exemplo, jiradb) com agrupamento Unicode.
    Memorize esse nome do banco de dados, pois ele será usado para configurar a conexão do JIRA com esse banco de dados nas etapas subsequentes.

    CREATE DATABASE jiradb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;

    Ou, na linha de comando:

    $ createdb -E UNICODE -l C -T template0 jiradb
  3. O usuário deve ter permissões para se conectar ao banco de dados e para criar e gravar em tabelas no banco de dados.

2. Configure o servidor JIRA para que se conecte ao banco de dados PostgreSQL

Há duas maneiras de configurar o servidor JIRA para que se conecte ao banco de dados PostgreSQL:

  • Usando o assistente de configuração do JIRA – Use este método se tiver instalado o JIRA recentemente e o estiver configurando pela primeira vez. As configurações serão salvas no arquivo dbconfig.xml no seu diretório inicial do JIRA.
  • Usando a ferramenta de configuração do JIRA – Use este método se você já tiver uma instância do JIRA existente. As configurações serão salvas no arquivo dbconfig.xml no seu diretório inicial do JIRA.

Instruções para cada método de configuração

Assistente de configuração do JIRA

O assistente de configuração do JIRA será exibido quando você acessar o JIRA pela primeira vez no navegador.

  1. Na primeira tela, "Configurar idioma e banco de dados", defina Conexão do banco de dados como Meu próprio banco de dados.
  2. Defina Tipo de banco de dados como PostgreSQL.
  3. Preencha os campos conforme descrito na seção Campos de conexão com o banco de dados abaixo.
  4. Teste sua conexão e salve.

Ferramenta de configuração do JIRA

  1. Execute a ferramenta de configuração do JIRA da seguinte maneira:
  2. Navegue para a guia Banco de dados e defina o Tipo de banco de dados como PostgreSQL.
  3. Preencha os campos conforme descrito na seção Campos de conexão com o banco de dados abaixo.
  4. Teste sua conexão e salve.
  5. Reinicie o JIRA.

Campos de conexão com o banco de dados

Assistente de configuração/ferramenta de configuraçãodbconfig.xmlDescrição
Nome do host

Localizado na tag <url> (texto em negrito no exemplo abaixo):
<url>jdbc:postgresql://dbserver:5432/jiradb</url>

O nome ou o endereço IP do computador em que o servidor PostgreSQL está instalado.
PortaLocalizado na tag <url> (texto em negrito no exemplo abaixo):
<url>jdbc:postgresql://dbserver:5432/jiradb</url>		A porta TCP/IP em que o servidor PostgreSQL está escutando. Você pode deixar em branco para usar a porta padrão.
Banco de dadosLocalizado na tag <url> (texto em negrito no exemplo abaixo):
<url>jdbc:postgresql://dbserver:5432/jiradb</url>		O nome do seu banco de dados PostgreSQL (no qual o JIRA salvará os dados). Você deve tê-lo criado na Etapa 1 acima.
Nome de usuário

Localizado na tag <username> (texto em negrito no exemplo abaixo):
<username>jiradbuser</username>

O usuário que o JIRA usa para se conectar ao servidor PostgreSQL. Você deve tê-lo criado na Etapa 1 acima.
SenhaLocalizado na tag <password> (texto em negrito no exemplo abaixo):
<password>jiradbuser</password>		A senha do usuário, usada para autenticação no servidor PostgreSQL.
EsquemaLocalizado na tag <schema-name> (texto em negrito no exemplo abaixo):
<schema-name>public</schema-name>

O nome do esquema usado pelo banco de dados PostgreSQL.

O PostgreSQL 7.2 e versões posteriores exigem que um esquema seja especificado no elemento <schema-name/>. Se o banco de dados PostgreSQL usar o esquema "public" padrão, isso deverá ser especificado no elemento <schema-name/> conforme mostrado abaixo. O nome do esquema do banco de dados deve estar em letras minúsculas, pois o JIRA não funciona com bancos de dados PostgreSQL cujos nomes de esquema contenham caracteres em letra maiúscula.

Arquivo dbconfig.xml de exemplo

Para obter mais informações sobre os elementos filhos de <jdbc-datasource/> começando com pool no arquivo dbconfig.xml acima, consulte Tuning database connections (Ajustar conexões de banco de dados).

<?xml version="1.0" encoding="UTF-8"?>

<jira-database-config>
  <name>defaultDS</name>
  <delegator-name>default</delegator-name>
  <database-type>postgres72</database-type>
  <schema-name>public</schema-name>
  <jdbc-datasource>
    <url>jdbc:postgresql://dbserver:5432/jiradb</url>
    <driver-class>org.postgresql.Driver</driver-class>
    <username>jiradbuser</username>
    <password>password</password>
    <pool-min-size>20</pool-min-size>
    <pool-max-size>20</pool-max-size>
    <pool-max-wait>30000</pool-max-wait>
    <pool-max-idle>20</pool-max-idle>
    <pool-remove-abandoned>true</pool-remove-abandoned>
    <pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
 
    <validation-query>select version();</validation-query>
    <min-evictable-idle-time-millis>60000</min-evictable-idle-time-millis>
    <time-between-eviction-runs-millis>300000</time-between-eviction-runs-millis>
  
    <pool-test-on-borrow>false</pool-test-on-borrow>
	<pool-test-while-idle>true</pool-test-while-idle>

  </jdbc-datasource>
</jira-database-config>

 

3. Inicie o JIRA

Agora o JIRA está configurado para se conectar ao seu banco de dados PostgreSQL. A próxima etapa é iniciá-lo!

(tick) Parabéns, agora o JIRA está conectado ao seu banco de dados PostgreSQL.

Last modified on Mar 28, 2017

Was this helpful?

Yes
No
Provide feedback about this article

Related content

  • No related content found
Powered by Confluence and Scroll Viewport.