Instalação do servidor de aplicativos

Esta seção informa como instalar o Adobe Experience Manager (AEM) com um servidor de aplicativos. Consulte a seção Plataformas suportadas para ver os níveis de suporte específicos fornecidos para os servidores de aplicativos individuais.

As etapas de instalação dos seguintes Servidores de aplicativos estão descritas:

• WebSphere 8.5
• JBoss EAP 6.3.0/6.4.0
• Oracle WebLogic 12.1.3/12.2
• Tomcat 8/8.5

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 start e parar o servidor.

Descrição Geral

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

AEM vem como um único arquivo de guerra para implantar.

Se implantado, o seguinte ocorrerá por padrão:

• o modo de execução é author

• a instância (Repository, Felix OSGI ambiente, pacotes etc.) está instalado em ${user.dir}/crx-quickstartonde ${user.dir} é 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 parâmetro sling.run.modes no arquivo WEB-INF/web.xml do arquivo de guerra AEM antes da implantação

• sling.home: configure o parâmetro sling.home no arquivo WEB-INF/web.xmldo arquivo de guerra AEM antes da implantação

• raiz de contexto: renomear o arquivo AEM war

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 AEM
• Alterar o parâmetro sling.run.mode para publicar
• Reempacotar o arquivo web.xml em AEM arquivo de guerra
• Implantar AEM arquivo de guerra

Verificação de instalação

Para verificar se tudo está instalado, você pode:

• exclua o arquivo error.logpara ver se todo o conteúdo está instalado
• verifique /system/console se todos os pacotes estão instalados

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 AEM war.
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 de AEM padrão, 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. Start 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 Geral acima.

Preparação do servidor

• Deixe que os Cabeçalhos básicos de autenticação passem por:

  • Uma maneira de permitir que AEM autenticem 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 AEM usando a raiz de contexto = /, primeiro é necessário alterar a raiz de contexto do aplicativo Web padrão existente

Implantar AEM aplicativo da Web

• Baixar AEM arquivo de guerra

• 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 AEM arquivo de guerra

  • 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)

• Start AEM aplicação Web

JBoss EAP 6.3.0/6.4.0

Antes de uma implantação, leia a Descrição 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 deployment-timeout, para esse conjunto de atributos deployment-timeout 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 AEM aplicativo da Web

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

• Ative o aplicativo da Web AEM.

Oracle WebLogic 12.1.3/12.2

Antes de uma implantação, leia a Descrição Geral acima.

Isso usa um layout de servidor simples com apenas um servidor de administração.

Preparação do WebLogic Server

• Em ${myDomain}/config/config.xmladicione à seção security-configuration:

  • <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> consulte https://xmlns.oracle.com/weblogic/domain/1.0/domain. xsdpara obter a posição correta (por padrão, para posicioná-la no final da seção está ok)

• Aumente as configurações de memória da VM:

  • abra ${myDomain}/bin/setDomainEnv.cmd (resp.sh)pesquise por WLS_MEM_ARGS, defina, por exemplo, set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
  • reiniciar o WebLogic Server

• Crie em ${myDomain} uma pasta de pacotes e dentro de uma pasta cq e, nela, uma pasta Plan

Implantar AEM aplicativo da Web

• Baixar AEM arquivo de guerra

• Coloque o arquivo de guerra AEM na pasta ${myDomain}/packages/cq

• Faça suas configurações em WEB-INF/web.xml, se necessário (consulte acima na Descrição geral)

  • Desempacotar o 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 (consulte Descrição geral)
  • Repack arquivo web.xml

• Implantar AEM arquivo de guerra 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 Web no WebLogic /console

Tomcat 8/8.5

Antes de uma implantação, leia a Descrição Geral acima.

• Preparar servidor Tomcat

  • Aumente as configurações de memória da VM:

    • Em bin/catalina.bat (resp catalina.sh no 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 tomcat-users.xml manualmente 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 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
    • Aplicativo Web do start novamente

  • Se você instalar o aplicativo da Web AEM usando o manager-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 aumente o tamanho máximo de arquivo e o tamanho máximo de solicitação para pelo menos 500 MB, consulte o seguinte exemplo multipart-config de um arquivo 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 AEM aplicativo da Web

  • Baixar AEM arquivo de guerra

  • 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 AEM arquivo de guerra para ROOT.war se desejar 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 AEM esteja instalado

Resolução de problemas

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

• Resolução de Problemas