Configurar o diretório inicial da aplicação JIRA

Como eu defino minha página inicial do JIRA?

Existem alguns métodos disponíveis para especificar o local de seu Diretório inicial da aplicação JIRA no JIRA. Porém, esteja ciente das observações abaixo antes de especificar esse local.

Métodos recomendados

Os métodos recomendados para especificar o local do diretório inicial do JIRA no JIRA são:

• Usar a Ferramenta de configuração do JIRA para alterar o local do diretório inicial do JIRA.
• Editar o arquivo jira-application.properties e definir o valor da propriedade "jira.home" para o local desejado para o seu diretório inicial do JIRA (esse local deve ser diferente do diretório da aplicação, para que não haja problemas posteriormente). Se você for especificar o caminho desse local no Windows, use duas barras invertidas ("\") entre os subdiretórios. Por exemplo, X:\\path\\to\\JIRA\‌\Home.
  Se você definir um caminho UNC no Microsoft Windows, não deixe de aplicar escape duplo na primeira barra invertida: \\\\machinename\\path\\to\\JIRA\\home
  Consulte a página Diretório de instalação do JIRA para saber onde esse arquivo está localizado.
• Definir uma variável de ambiente chamada JIRA_HOME no sistema operacional cujo valor seja o local do seu diretório inicial do JIRA. Para fazer isso:

  • No Windows, escolha uma das seguintes alternativas:
    
    • Configure essa variável de ambiente usando a interface de usuário do Windows (normalmente, em "Meu computador" ou "Computador")
    • No prompt de comando, digite o seguinte comando (com o caminho do seu próprio diretório inicial do JIRA) antes de executar o JIRA a partir do prompt de comando:
      
      • set JIRA_HOME=X:\path\to\JIRA\Home
        Defina o valor da variável de ambiente JIRA_HOME  usando este formato, onde:
        
        • X é a letra da unidade na qual o diretório inicial do JIRA está localizado e
        • nenhum espaço foi adicionado em torno do sinal de igual ("=")
    • Especifique o comando acima em um arquivo em lotes usado para iniciar o JIRA.
  • No Linux/Solaris, escolha uma das seguintes alternativas:
    
    • Digite o seguinte comando no prompt do shell/console (com o caminho do seu próprio diretório inicial do JIRA) antes de executar o JIRA:
      
      • export JIRA_HOME=/path/to/jira/home
    • Especifique o comando acima em um script usado para iniciar o JIRA.

Nota: Se você tiver especificado valores diferentes para uma propriedade "jira.home" no arquivo jira-application.properties e uma variável de ambiente JIRA_HOME, o valor da variável de ambiente JIRA_HOME terá precedência.

Método alternativo

Como alternativa, você pode especificar o local do diretório inicial do JIRA como uma propriedade no seu servidor de aplicação:

• Configure uma nova propriedade de contexto web chamada "jira.home" para seu servidor de aplicação. Para fazer isso, é preciso definir essa propriedade de contexto web em um elemento <parameter/> (como um filho do elemento <context/>) no seu arquivo server.xml.
  O arquivo server.xml está localizado no subdiretório conf do seu Diretório de instalação da aplicação JIRA.

  <Context ...>
  ...
    <Parameter name="jira.home" value="c:/jira/home"/>
  ...
  </Context>
  

Nota: Uma propriedade de contexto web "jira.home" definida no servidor de aplicação substitui o valor da propriedade "jira.home" definida no seu arquivo jira-application.properties. Porém, uma variável de ambiente do JIRA_HOME definindo o seu diretório inicial do JIRA substituirá qualquer um desses valores "jira.home".

Que local devo especificar para minha página inicial do JIRA?

Você pode especificar qualquer local em um disco para o diretório inicial do JIRA. Não deixe de especificar um caminho absoluto.

Observe que não é possível usar o mesmo diretório inicial do JIRA para várias instâncias do JIRA. Recomendamos localizar o diretório inicial JIRA de maneira completamente independente do diretório de instalação do JIRA (ou seja, sem que um esteja aninhado no outro). Isso minimizará a perda de informações durante grandes operações (por exemplo, backup e restauração de instâncias).

Como eu altero minha página inicial do JIRA?

1. Defina a página inicial do JIRA para o novo local usando seu método preferido conforme descrito em "Como eu defino minha página inicial do JIRA?" (acima).
2. Reinicie o JIRA.

O que é armazenado no diretório inicial do JIRA?

A página a seguir descreve os dados armazenados no diretório inicial do JIRA: Diretório inicial da aplicação JIRA.

Observações

• Se você estiver usando o Windows Installer, não será preciso configurar o diretório inicial do JIRA separadamente, uma vez que você será instruído a especificar esse local durante o processo de instalação.
• O instalador do JIRA poderá não conseguir criar a página inicial devido a problemas de permissão. Se esse for o caso, consulte O JIRA não consegue iniciar porque não foi possível criar o subdiretório necessário.