Show Menu
TÓPICOS×

Instalação do servidor de aplicativos

JAR e WAR são os tipos de arquivo em que o AEM é lançado. Esses formatos estão passando por garantia de qualidade para acomodar os níveis de suporte aos quais a Adobe se comprometeu.
Esta seção informa como instalar o Adobe Experience Manager (AEM) com um servidor de aplicativos. Consulte a seção Plataformas Mecanismos de Servlet / Servidores de Aplicativo suportadas para ver os níveis de suporte específicos fornecidos para cada servidor de aplicativos.
As etapas de instalação dos seguintes Servidores de aplicativos estão descritas:
Consulte a documentação apropriada do servidor de aplicativos para obter mais informações sobre como instalar aplicativos da Web, configurações do servidor e como iniciar e parar o servidor.
Se você estiver usando o Dynamic Media em uma implantação WAR, consulte a documentação da mídia dinâmica.

Descrição geral

Comportamento padrão ao instalar o AEM em um servidor de aplicativos

O AEM vem como um único arquivo de guerra a ser implantado.
Se implantado, o seguinte ocorrerá por padrão:
  • o modo de execução é author
  • a instância (Repositório, ambiente Felix OSGI, pacotes etc.) está instalado no ${user.dir}/crx-quickstart local em que ${user.dir} está o diretório de trabalho atual, este caminho para crx-quickstart é chamado sling.home
  • a raiz de contexto é o nome do arquivo de guerra, por exemplo: aem-6

Configuração

Você pode alterar o comportamento padrão da seguinte maneira:
  • modo de execução : configure o sling.run.modes parâmetro no WEB-INF/web.xml arquivo do arquivo AEM war antes da implantação
  • sling.home: configure o sling.home parâmetro no WEB-INF/web.xml arquivo do arquivo de guerra do AEM antes da implantação
  • raiz de contexto: renomear o arquivo de guerra do AEM

Publicar instalação

Para obter uma instância de publicação implantada, é necessário definir o modo de execução para publicar:
  • Desempacotar o WEB-INF/web.xml do arquivo de guerra do AEM
  • Alterar o parâmetro sling.run.mode para publicar
  • Reempacotar arquivo web.xml no arquivo AEM war
  • Implantar arquivo de guerra do AEM

Verificação da instalação

Para verificar se tudo está instalado, você pode:
  • exclua o error.log arquivo para ver se todo o conteúdo está instalado
  • verifique se todos os pacotes estão instalados /system/console

Duas instâncias no mesmo servidor de aplicativos

Para fins de demonstração, pode ser apropriado instalar o autor e publicar a instância em um servidor de aplicativos. Para isso, faça o seguinte:
  1. Altere as variáveis sling.home e sling.run.mode da instância de publicação.
  2. Descompacte o arquivo WEB-INF/web.xml do arquivo de guerra do AEM.
  3. Altere o parâmetro sling.home para um caminho diferente (caminhos absolutos e relativos são possíveis).
  4. Altere sling.run.mode para publicar para a instância de publicação.
  5. Reempacotar o arquivo web.xml.
  6. Renomeie os arquivos de guerra para que eles tenham nomes diferentes: Por exemplo, uma renomeia para aemauthor.war e a outra para aempublish.war.
  7. Use configurações de memória mais altas, por exemplo, para instâncias padrão de AEM, use, por exemplo: -Xmx3072m
  8. Implante os dois aplicativos da Web.
  9. Após a implantação, pare os dois aplicativos da Web.
  10. Nas instâncias de autor e publicação, verifique se nos arquivos sling.properties a propriedade felix.service.urlhandlers=false está definida como false (o padrão é que ela esteja definida como true).
  11. Inicie os dois aplicativos da Web novamente.

Procedimentos de instalação dos servidores de aplicativos

WebSphere 8.5

Antes de uma implantação, leia a Descrição Descrição geral geral acima.
Preparação do servidor
  • Deixe que os Cabeçalhos básicos de autenticação passem por:
    • Uma maneira de permitir que o AEM autentique um usuário é desabilitar a segurança administrativa global do servidor WebSphere para fazer isso: vá para Segurança -> Segurança global e desmarque a caixa de seleção Ativar segurança administrativa, salve e reinicie o servidor.
  • set "JAVA_OPTS= -Xmx2048m"
  • Se você quiser instalar o AEM usando a raiz de contexto = /, primeiro é necessário alterar a raiz de contexto do aplicativo da Web padrão existente
Implantar o aplicativo da Web do AEM
  • Baixar arquivo de guerra do AEM
  • Faça suas configurações em web.xml, se necessário (consulte acima na Descrição geral)
    • Desempacotar arquivo WEB-INF/web.xml
    • alterar o parâmetro sling.run.mode para publicar
    • exclua o comentário do parâmetro inicial sling.home e defina esse caminho conforme necessário
    • Repack arquivo web.xml
  • Implantar arquivo de guerra do AEM
    • Escolha uma raiz de contexto (se desejar definir os modos de execução de sling, você precisa selecionar as etapas detalhadas do assistente de implantação e, em seguida, especificá-la na etapa 6 do assistente)
  • Iniciar aplicativo da Web AEM

JBoss EAP 6.3.0/6.4.0

Antes de uma implantação, leia a Descrição Descrição geral geral acima.
Preparar servidor JBoss
Defina os argumentos da memória no arquivo conf (por exemplo, standalone.conf )
  • JAVA_OPTS="-Xms64m -Xmx2048m"
se você usar o deployment-scanner para instalar o aplicativo da Web AEM, talvez seja bom aumentar o valor deployment-timeout, desse conjunto de um deployment-timeout atributo no arquivo xml da sua instância (por exemplo configuration/standalone.xml) :
<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
            <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>

Implantar o aplicativo da Web do AEM
  • Carregue o aplicativo da Web do AEM no console de administração do JBoss.
  • Ative o aplicativo da Web do AEM.

Oracle WebLogic 12.1.3/12.2

Antes de uma implantação, leia a Descrição Descrição geral geral acima.
Isso usa um layout de servidor simples com apenas um servidor administrativo.
Preparação do WebLogic Server
  • Em ${myDomain}/config/config.xml adicionar à seção de configuração de segurança:
  • Aumente as configurações de memória da VM:
    • open ${myDomain}/bin/setDomainEnv.cmd (resp.sh)search for WLS_MEM_ARGS, defina por exemplo set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
    • reiniciar o WebLogic Server
  • Criar em ${myDomain} uma pasta de pacotes e dentro de uma pasta cq e nela uma pasta Plano
Implantar o aplicativo da Web do AEM
  • Baixar arquivo de guerra do AEM
  • Coloque o arquivo de guerra do AEM na pasta $/packages/cq
  • Faça com que suas configurações sejam ativadas WEB-INF/web.xml (consulte acima na Descrição geral)
    • Desempacotar WEB-INF/web.xml arquivo
    • alterar o parâmetro sling.run.mode para publicar
    • exclua o comentário do parâmetro inicial sling.home e defina esse caminho conforme necessário (consulte Descrição geral)
    • Repack arquivo web.xml
  • Implantar arquivo de guerra do AEM como um aplicativo (para outras configurações, use as configurações padrão)
  • A instalação pode demorar...
  • Verifique se a instalação terminou conforme mencionado acima na Descrição geral (por exemplo, ajustando o error.log)
  • Você pode alterar a raiz de contexto na guia Configuração do aplicativo da Web no WebLogic /console

Tomcat 8/8.5

Antes de uma implantação, leia a Descrição Descrição geral geral acima.
  • Preparar servidor Tomcat
    • Aumente as configurações de memória da VM:
      • Em bin/catalina.bat (resp catalina.sh on unix), adicione a seguinte configuração:
      • set "JAVA_OPTS= -Xmx2048m
    • O Tomcat não permite acesso de administrador nem de gerente na instalação. Portanto, é necessário editar manualmente tomcat-users.xml para permitir o acesso a essas contas:
      • Edite tomcat-users.xml para incluir o acesso do administrador e do gerente. A configuração deve ser semelhante ao seguinte exemplo:
      ```
               <?xml version='1.0' encoding='utf-8'?>
                <tomcat-users>
                <role rolename="manager"/>
                <role rolename="tomcat"/>
                <role rolename="admin"/>
                <role rolename="role1"/>
                <role rolename="manager-gui"/>
                <user username="both" password="tomcat" roles="tomcat,role1"/>
                <user username="tomcat" password="tomcat" roles="tomcat"/>
                <user username="admin" password="admin" roles="admin,manager-gui"/>
                <user username="role1" password="tomcat" roles="role1"/>
                </tomcat-users>
               ```
      
      
    • Se você quiser implantar o AEM com a raiz de contexto "/", é necessário alterar a raiz de contexto do aplicativo Web ROOT existente:
      • Parar e desimplantar o aplicativo Web ROOT
      • Renomear pasta ROOT.war na pasta de aplicativos da Web do tomcat
      • Iniciar a aplicação Web novamente
    • Se você instalar o aplicativo da Web do AEM usando o gerenciador-gui, precisará aumentar o tamanho máximo de um arquivo carregado, já que o padrão permite apenas o tamanho de upload de 50 MB. Para isso, abra o web.xml do aplicativo da Web do gerenciador,
      webapps/manager/WEB-INF/web.xml
      e aumentar o tamanho máximo de arquivo e o tamanho máximo de solicitação para pelo menos 500 MB, veja o seguinte multipart-config exemplo de um arquivo como esse web.xml :
        <multipart-config>
         <!-- 500MB max -->
         <max-file-size>524288000</max-file-size>
         <max-request-size>524288000</max-request-size>
         <file-size-threshold>0</file-size-threshold>
         </multipart-config>
      
      
  • Implantar o aplicativo da Web do AEM
    • Baixar arquivo de guerra do AEM
    • Faça suas configurações em web.xml, se necessário (consulte acima na Descrição geral)
      • Desempacotar arquivo WEB-INF/web.xml
      • alterar o parâmetro sling.run.mode para publicar
      • exclua o comentário do parâmetro inicial sling.home e defina esse caminho conforme necessário
      • Repack arquivo web.xml
    • Renomeie o arquivo de guerra do AEM para ROOT.war se você quiser implantá-lo como aplicativo Web raiz, renomeie-o como, por exemplo, aemauthor.war se desejar que aemauthor seja uma raiz de contexto
    • copie-o para a pasta de aplicativos Web do tomcat
    • aguarde até que o AEM esteja instalado

Resolução de Problemas

Para obter informações sobre como lidar com problemas que podem surgir durante a instalação, consulte: