Instalando o Confluence no Windows por um arquivo Zip

Instalando o Confluence no Windows

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Neste guia, explicaremos a instalação do Confluence em um ambiente de produção, com um banco de dados externo, usando manualmente um arquivo zip.

Esse método oferece o máximo de controle sobre o processo de instalação.

 

 

Outras maneiras de instalar o Confluence: 

  • Avaliação - coloque seu teste gratuito em funcionamento rapidamente.
  • Instalador – instalar o Confluence usando o instalador do Windows. 
  • Linux – instalar o Confluence em um sistema operacional Linux.

Nesta página:

Antes de começar

Antes de instalar o Confluence, você precisa responder a algumas perguntas. 

 

Você está usando um sistema operacional e uma versão do Java com suporte?
Quero saber mais sobre isso...

Consulte a página Plataformas com suporte para obter a versão do Confluence que você está instalando. Aqui você obterá informações sobre sistemas operacionais, bancos de dados e navegadores com suporte.

É bom saber:

  • Não damos suporte à instalação do Confluence em OSX.
  • Não damos suporte ao OpenJDK. Será necessário instalar o Oracle Java JRE ou JDK.
  • É possível usar o JDK (Java Development Kit) ou o JRE (Java Runtime Environment).
  • Damos suporte apenas à versão do Apache Tomcat que vem inclusa no Confluence.
Você deseja executar o Confluence como serviço do Windows?
Quero saber mais sobre isso...

Executar o Confluence como serviço no Windows significa que o Confluence será iniciado automaticamente quando o Windows for iniciado.

Você deve usar o instalador do Windows se desejar executar o Confluence como serviço.

Se você optar por não executar o Confluence como serviço:

  • Você iniciará e interromperá o Confluence executando o arquivo start-confluence.bat em seu diretório de instalação do Confluence.
  • O Confluence será executado como a conta de usuário do Windows que foi usada para instalar o Confluence, ou você pode optar por executar como usuário dedicado (esse usuário precisa ter acesso total a leitura e gravação no diretório de instalação e no diretório home).
  • O Confluence precisará ser reiniciado manualmente se o seu servidor for reiniciado.
As portas 8090 e 8091 estão disponíveis?
Quero saber mais...

O Confluence é executado na porta 8090 por padrão. Se essa porta já estiver em uso, o instalador solicitará que você escolha uma porta diferente.

A sincronização, que é obrigatória para a edição colaborativa, é executada na porta 8091 por padrão. Se essa porta já estiver em uso, será preciso alterar a porta na qual a sincronização é executada depois que a instalação do Confluence estiver concluída. Consulte Administrando a edição colaborativa para saber como alterar a porta na qual a sincronização é executada. Não será possível editar páginas até que a Sincronização tenha uma porta disponível.

Que banco de dados você planeja usar? 
Quero saber mais sobre isso...

Será necessário um banco de dados externo para executar o Confluence na produção. Consulte a Plataformas com suporte página para saber a versão que você está instalando, a fim de obter uma lista de banco de dados com suporte atualmente. Se você ainda não tiver um banco de dados, o PostgreSQL é gratuito, fácil de configurar e foi testado extensivamente com o Confluence.

É bom saber:

  • Instale seu banco de dados antes de começar. Guias passo a passo estão disponíveis para o PostgreSQL, Oracle, MySQL e SQL Server.
  • Use codificação de caracteres UTF-8. Consulte Configurando a codificação de caracteres para obter mais informações.
  • Se estiver usando Oracle ou MySQL, você precisará baicar o driver para o seu banco de dados.
  • O banco de dados integrado H2 pode ser usado para avaliar o Confluence, mas será necessário migrar para outro banco de dados antes da execução em produção. Talvez seja mais fácil usar um banco de dados externo desde o início.

Você tem uma licença do Confluence?

Quero saber mais sobre isso...

Você precisará de uma licença válida do servidor Confluence para usá-lo.

É bom saber:

  • Se você ainda não adquiriu uma licença do Confluence, você poderá criar uma licença de avaliação durante a configuração.
  • Se você já possui uma chave de licença, será solicitado a fazer login em my.atlassian.com para resgatá-la ou você poderá inserir a chave manualmente durante a configuração.
  • Se estiver migrando do Confluence Cloud, você precisará de uma nova licença.

Sua variável JAVA_HOME está configurada corretamente?
Quero saber mais sobre isso...

Antes de instalar o Confluence, verifique se você está executando uma versão do Java com suporte e se a variável de ambiente JAVA_HOME está configurada corretamente.

Para verificar a variável JAVA_HOME:

Abra um prompt de comando, digite echo %JAVA_HOME% e pressione Enter. 

  • Se você vir um caminho para o seu diretório de instalação do Java, a variável de ambiente JAVA_Home foi configurada corretamente.
  • Se nada for exibido, ou se apenas %JAVA_HOME% for retornado, será necessário configurar manualmente a variável de ambiente JAVA_HOME. Consulte Configurando a variável JAVA_HOME no Windows para ler um guia passo a passo.

 

Instalar o Confluence

1. Baixe o Confluence

Baixe o arquivo zip para seu sistema operacional – https://www.atlassian.com/software/confluence/download

2. Crie o diretório de instalação

  1. Crie seu diretório de instalação (com permissão de controle total) – é aqui que o Confluence será instalado. Evite usar espaços ou caracteres especiais no caminho. Chamaremos esse diretório de seu <installation-directory>

  2. Extraia o arquivo zip do Confluence para seu <installation-directory>. Recomendamos usar o 7zip ou o Winzip.

3. Crie o diretório home

  1. Crie seu diretório home (com permissão de controle total) – será aqui que dados do Confluence como logs, índices de pesquisa e arquivos serão armazenados. Ele deve ser separado do seu diretório de instalação. Chamaremos esse diretório de seu <home-directory>
  2. Edite <installation-directory>\confluence\WEB-INF\classes\confluence-init.properties.
  3. No final do arquivo, insira o caminho para o seu <home directory>.

    Mostre como fazer isso...

    É possível editar o arquivo confluence-init.properties no Bloco de Notas ou em qualquer outro editor de texto.

    1. Role a tela até o final do texto e encontre a seguinte linha:

      # confluence.home=c:/confluence/data
      
    2. Retire o "#" e o espaço no início dessa linha (para que o Confluence não considere a linha um comentário)

      confluence.home=c:/data/confluence-home
    3. Caso você decida usar um diretório diferente como diretório home, você deve:
      • Evitar espaços no caminho do diretório ou no nome do arquivo.
      • Usar barras "/" para definir o caminho nesse arquivo.

4. Verificar as portas

Por padrão, o Confluence fica ativo na porta 8090. Se você tiver outra aplicação sendo executada em seu servidor que utilize as mesmas portas, será necessário dizer ao Confluence para usar uma porta diferente. 

Mostre como fazer isso...

Para alterar as portas:

  1. Edite <installation-directory>\conf\server.xml

  2. Altere a porta do servidor (8000) e a porta do conector (8090) para portas livres em seu servidor.

    No exemplo abaixo, alteramos a porta do servidor para 5000 e a porta do conector para 5050.

    Server port="5000" shutdown="SHUTDOWN" debug="0">
      <Service name="Tomcat-Standalone">
        <Connector port="5050" connectionTimeout="20000" redirectPort="8443"
            maxThreads="48" minSpareThreads="10"
            enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
            protocol="org.apache.coyote.http11.Http11NioProtocol" />

 

5. Iniciar o Confluence

  1. Execute <installation-directory>/startup.bat para iniciar o processo de configuração.  
     
    Um prompt de comando se abrirá. Fechar essa janela interromperá o Confluence.
     
  2. Vá para http://localhost:8090/ para iniciar o Confluence em seu navegador (altere a porta se tiver atualizado a porta do Conector).
      
Problemas para iniciar o Confluence?

 

Configure o Confluence

6. Escolher o tipo de instalação

  1. Escolha Instalação de produção
      
  2. Escolha os complementos que você quer instalar.

7. Inserir a licença

Siga as instruções na tela para fazer login em my.atlassian.com para recuperar sua licença, ou insira uma chave de licença. 

8. Conectar-se ao seu banco de dados

  1. Se você ainda não tiver criado seu banco de dados, é hora de fazer isso. Consulte a seção "Antes de começar" desta página para obter detalhes. 
     
  2. Selecione seu banco de dados no menu suspenso e escolha Banco de dados externo.
     
  3. Escolha como você quer se conectar ao seu banco de dados:
     

    Conexão JDBC direta...

    Essa opção usa uma conexão de banco de dados JDBC padrão. A combinação de conexões é manejada dentro do Confluence.

    Se você estiver usando Oracle ou MySQL, há um passo extra: 

    • Baixe e extraia o Drivers JDBC de banco de dados adequados.
    • Solte o arquivo JAR dentro da sua pasta <confluence-installation>/confluence/WEB-INF/lib antes de continuar com o assistente de instalação.

    No assistente de instalação:

    • Nome da classe do driver – o nome da classe Java do driver do seu banco de dados. Se você não tiver certeza, verifique a documentação do banco de dados.
    • URL do banco de dados – o URL JDBC do seu banco de dados. Se você não tiver certeza, verifique a documentação do banco de dados.
    • Nome de usuário e Senha – Um nome de usuário e senha válidos que o Confluence possa usar para acessar seu banco de dados.
    Fonte de dados...

    Essa opção pede ao servidor de aplicação (Apache Tomcat) uma conexão de banco de dados. Será necessário adicionar manualmente a fonte de dados ao arquivo server.xml antes de poder continuar.

    Para configurar uma fonte de dados, siga nosso guia para o seu banco de dados:

    No assistente de instalação:

    • Nome da fonte de dados – é o nome JNDI da fonte de dados, conforme configurada no arquivo server.xml.
      Alguns servidores terão nomes JNDI como jdbc/datasourcename; outros serão algo do tipo java:comp/env/jdbc/datasourcename.

9. Preencher seu novo site com conteúdo

Escolha se você deseja que o Confluence preencha seu site com conteúdo:
 
Espaço de demonstração...

 Essa opção criará um espaço que você e seus usuários poderão usar para conhecer o Confluence. Você poderá excluir esse espaço a qualquer momento.

Importar dados de um site existente...

Use essa opção se você tiver uma exportação completa de site de um site Confluence existente. Essa opção é útil quando estiver migrando para outro banco de dados ou configurando um site de teste.  

É bom saber:

  • Só é possível importar sites da mesma versão ou anterior do Confluence.
  • A conta de administrador do sistema e todos os outros dados e conteúdo de usuários serão importados de sua instalação anterior.

No assistente de configuração:

  • Fazer upload de um arquivo de backup – use essa opção se seu arquivo de exportação de site for pequeno (25 mb ou menos).
  • Restaurar um arquivo de backup do sistema de arquivos – use essa opção se seu arquivo de backup for grande. Solte o arquivo em seu diretório <confluence-home>/restore  e siga as instruções para restaurar o backup.

  • Criar índice – precisaremos criar um índice antes que o conteúdo importado possa ser pesquisado. Isso pode demorar para sites grandes, por isso desmarque a seleção dessa opção se preferir criar o índice mais tarde. Não será possível pesquisar o conteúdo até que o índice seja criado.

10. Escolher onde gerenciar usuários

Escolha gerenciar os usuários e grupos do Confluence dentro do Confluence ou em uma aplicação JIRA, como JIRA Software ou JIRA Service Desk:
 
Gerenciar usuários e grupos no Confluence...

Escolha essa opção se desejar gerenciar usuários no Confluence ou se não tiver uma aplicação JIRA instalada.

É bom saber:

  • Se você planejar gerenciar usuários em uma aplicação JIRA, mas ela ainda não estiver instalada, recomendamos instalar primeiro o JIRA e retornar à configuração do Confluence depois.
  • É possível adicionar gerenciamento externo de usuários (por exemplo, LDAP, Crowd ou JIRA) posteriormente, caso você queira.
Conectar ao JIRA...

 Escolha essa opção se você tiver uma aplicação JIRA instalada e desejar gerenciar usuários entre ambas as aplicações.

É bom saber:

  • Essa é uma maneira rápida de configurar sua integração com o JIRA com as opções mais comuns. 
  • Ela configurará um diretório de usuários do JIRA para o Confluence e definirá links de aplicações entre o JIRA e o Confluence para facilitar o compartilhamento de dados.
  • Você poderá especificar exatamente que grupos da sua aplicação JIRA deverão ter permissão para fazer login no Confluence. Seus níveis de licença para cada aplicação não precisam ser iguais. 
  • Você precisará do JIRA 4.3 ou mais recente, JIRA Core 7.0 ou mais recente, JIRA Software 7.0 ou mais recente ou JIRA Service Desk 3.0 ou mais recente.

No assistente de instalação:

  • URL base do JIRA – o endereço do seu servidor JIRA, como http://www.example.com:8080/jira/ ou http://jira.example.com/

  • Login do administrador do JIRA – é o nome de usuário e a senha de uma conta de usuário que tem permissão global de Administrador de Sistema JIRA em sua aplicação JIRA. O Confluence também usará esse nome de usuário e senha para criar uma conta de administrador local, que permitirá que você acesse o Confluence se o JIRA não estiver disponível. Observe que essa conta específica fica armazenada no diretório de usuários interno do Confluence; por isso, se você alterar a senha no JIRA, ela não será atualizada automaticamente no Confluence.
  • URL base do Confluence – é o URL que o JIRA usará para acessar seu servidor do Confluence. O URL que você fornecer aqui substitui o URL base especificado no Confluence para fins de conexão à aplicação JIRA.
  • Grupos de usuários – são os grupos do JIRA cujos membros devem ter permissão para usar o Confluence. Membros desses grupos receberão a permissão "Can use" para o Confluence e serão contados em sua licença do Confluence. O nome padrão do grupo de usuários varia dependendo da sua versão do JIRA:
    • JIRA 6.4 e versões mais antigas: jira-users
    • JIRA Software 7.x e versões mais recentes: jira-software-users
    • JIRA Core 7.x e versões mais recentes: jira-core-users
    • JIRA Service Desk 3.x e versões mais recentes: jira-servicedesk-users
  • Grupos de administradores – informe um ou mais grupos do JIRA cujos membros devem ter acesso administrativo ao Confluence. O grupo padrão é jira-administrators. Esses grupos receberão as permissões globais de administrador de sistema e administrador do Confluence no Confluence.

11. Criar a conta de administrador

Insira os detalhes da conta de administrador.  

Pule essa etapa se tiver escolhido gerenciar usuários em um aplicativo JIRA ou se tiver importado dados de um site existente. 

12. Começar a usar o Confluence

Pronto! Seu site do Confluence está acessível de um URL como este: http://<nome_do_computador_ou_endereço_IP>:<porta>

Caso você planeje executar o Confluence por trás de um proxy reverso, consulte Considerações de proxy e SSL antes de seguir adiante. 

Consulte algumas coisas que podem ajudar a sua equipe a iniciar as operações:

Solução de problemas

Está encontrando pendências na instalação do Confluence?
  • Se a janela do seu navegador web mostrar um erro na primeira vez que você tentar acessar o Confluence, espere cerca de 30 segundos e, em seguida, atualize a página.
  • Se a janela do prompt de comando se fechar imediatamente, é possível que sua variável JAVA_HOME não esteja configurada corretamente. Consulte Configurando a variável JAVA_HOME no Windows

 Vá para Solucionando problemas de instalação em nossa base de conhecimento para obter mais ajuda.  

Last modified on Aug 7, 2017

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.