Instalação Personalizada Independente custom-standalone-install
Esta seção descreve as opções disponíveis ao instalar uma instância independente do AEM. Você também pode ler Elementos de Armazenamento para obter mais informações sobre como escolher o tipo de armazenamento de back-end após instalar o AEM 6.
Alterar o número da porta renomeando o arquivo changing-the-port-number-by-renaming-the-file
A porta padrão para AEM é 4502. Se essa porta não estiver disponível ou já estiver em uso, o Quickstart automaticamente se configurará para usar o primeiro número de porta disponível da seguinte maneira: 4502, 8080, 8081, 8082, 8083, 8084, 8085, 8888, 9362, <*random*>
.
Você também pode definir o número da porta renomeando o arquivo jar de início rápido, para que o nome do arquivo inclua o número da porta; por exemplo, cq5-publish-p4503.jar
ou cq5-author-p6754.jar
.
Há várias regras a serem seguidas ao renomear o arquivo jar de início rápido:
-
Ao renomear o arquivo, ele deve começar com
cq;
como emcq5-publish-p4503.jar
. -
Recomenda-se que você sempre prefixe o número da porta com -p; como em cq5-publish-p4503.jar ou cq5-author-p6754.jar.
- o número da porta deve ter 4 ou 5 dígitos
- esses dígitos devem vir após um traço
- se houver outros dígitos no nome do arquivo, o número da porta deverá ter o prefixo
-p
- o prefixo "cq5" no início do nome do arquivo é ignorado
-port
no comando start.Considerações sobre o Java 11 java-considerations
Se você estiver executando o Oracle Java 11 (ou versões do Java mais recentes que 8), é necessário adicionar opções adicionais à linha de comando ao iniciar o AEM.
- As seguintes opções -
-add-opens
precisam ser adicionadas para impedir mensagens de AVISO de acesso à reflexão relacionada emstdout.log
--add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning
- Além disso, você precisa usar o switch
-XX:+UseParallelGC
para atenuar possíveis problemas de desempenho.
Abaixo está um exemplo de como os parâmetros JVM adicionais devem ser ao iniciar o AEM no Java 11:
-XX:+UseParallelGC --add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning
Finalmente, se você estiver executando uma instância atualizada do AEM 6.3, verifique se a seguinte propriedade está definida como true em sling.properties
:
felix.bootdelegation.implicit
Modos de execução run-modes
Os modos de execução permitem ajustar a instância do AEM para uma finalidade específica; por exemplo, criar ou publicar, testar, desenvolver, intranet etc. Esses modos também permitem controlar o uso de conteúdo de amostra. Esse conteúdo de amostra é definido antes que o início rápido seja criado e pode incluir pacotes, configurações e assim por diante. Isso pode ser particularmente útil para instalações prontas para produção quando você quiser manter sua instalação enxuta e sem conteúdo de amostra. Para obter mais informações, consulte:
Adicionando um Provedor de Instalação de Arquivos adding-a-file-install-provider
Por padrão, a pasta crx-quickstart/install
é monitorada em busca de arquivos.
Esta pasta não existe, mas pode ser criada no tempo de execução.
Se um pacote, uma configuração ou um pacote de conteúdo for colocado nesse diretório, ele será selecionado e instalado automaticamente. Se for removido, ele é desinstalado.
É outra maneira de colocar pacotes, pacotes de conteúdo ou configurações no repositório.
Isso é especialmente interessante para vários casos de uso:
- Durante o desenvolvimento, pode ser mais fácil colocar algo no sistema de arquivos.
- Se algo der errado, o console da Web e o repositório não estarão acessíveis. Com isso, você pode colocar pacotes adicionais nesse diretório e eles devem ser instalados.
- A pasta
crx-quickstart/install
pode ser criada antes que o início rápido seja iniciado, e pacotes adicionais podem ser colocados lá.
Instalação e inicialização do Adobe Experience Manager as a Windows Service installing-and-starting-adobe-experience-manager-as-a-windows-service
Para instalar e iniciar o AEM como um serviço do Windows:
-
Abra o arquivo crx-quickstart\opt\helpers\instsrv.bat em um editor de texto.
-
Se você estiver configurando um servidor Windows de 64 bits, substitua todas as instâncias de prunsrv por um dos seguintes comandos, de acordo com seu sistema operacional:
- prunsrv_amd64
- prunsrv_ia64
Este comando invoca o script apropriado que inicia o daemon de serviço do Windows no Java de 64 bits em vez do Java de 32 bits.
-
Para evitar que o processo seja bifurcado em mais de um processo, aumente o parâmetro PermGen JVM. Localize o comando
set jvm_options
e defina o valor da seguinte maneira:set jvm_options=-Xmx1792m
-
Abra o Prompt de Comando, altere o diretório atual para a pasta crx-quickstart/opt/helpers da instalação do AEM e digite o seguinte comando para criar o serviço:
instsrv.bat cq5
Para verificar se o serviço foi criado, abra Serviços no painel de controle Ferramentas Administrativas ou digite
start services.msc
no Prompt de Comando. O serviço cq5 é exibido na lista. -
Inicie o serviço seguindo um destes procedimentos:
- No painel de controle Serviços, clique em cq5 e em Iniciar.
- Na linha de comando, digite net start cq5.
-
O Windows indica que o serviço está em execução. O AEM é iniciado e o executável prunsrv é exibido no Gerenciador de tarefas. Em seu navegador da Web, navegue até AEM, por exemplo,
https://localhost:4502
para começar a usar AEM.
com.adobe.xmp.worker.files.ncomm.XMPFilesNComm
a partir do Configuration Manager.Para desinstalar o serviço, clique em Parar no painel de controle Serviços ou na linha de comando, navegue até a pasta e digite instsrv.bat -uninstall cq5
. O serviço é removido da lista no painel de controle Serviços ou da lista na linha de comando quando você digita net start
.
Redefinição do local do diretório de trabalho temporário redefining-the-location-of-the-temporary-work-directory
O local padrão da pasta temporária da máquina java é /tmp
. O AEM também usa essa pasta, por exemplo, ao criar pacotes.
Se você quiser alterar o local da pasta temporária (por exemplo, se precisar de um diretório com mais espaço livre), defina um * <new-tmp-path>
* adicionando o parâmetro JVM:
-Djava.io.tmpdir="/<*new-tmp-path*>"
para:
- a linha de comando de inicialização do servidor
- o parâmetro de ambiente CQ_JVM_OPTS no script serverctl ou start
Outras opções disponíveis no arquivo Quickstart further-options-available-from-the-quickstart-file
Outras opções e convenções de renomeação são descritas no arquivo de ajuda Quickstart, que está disponível por meio da opção -help. Para acessar a ajuda do, digite:
java -jar cq-quickstart-6.5.0.jar -help
Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-6.5.0.jar'
--------------------------------------------------------------------------------
Adobe Experience Manager Quickstart (build 20190328)
--------------------------------------------------------------------------------
Usage:
Use these options on the Quickstart command line.
--------------------------------------------------------------------------------
-help (--help,-h)
Show this help message
-quickstart.server.port (-p,-port) <port>
Set server port number
-contextpath (-c,-org.apache.felix.http.context_path) <contextpath>
Set context path
-debug <port>
Enable Java Debugging on port number; forces forking
-gui
Show GUI if running on a terminal
-nobrowser (-quickstart.nobrowser)
Do not open browser at startup
-unpack
Unpack installation files only, do not start the server (implies
-verbose)
-v (-verbose)
Do not redirect stdout/stderr to files and do not close stdin
-nofork
Do not fork the JVM, even if not running on a console
-fork
Force forking the JVM if running on a console, using recommended
default memory settings for the forked JVM.
-forkargs <args> [<args> ...]
Additional arguments for the forked JVM, defaults to '-Xmx1024m
-XX:MaxPermSize=256m '. Use -- to specify values starting with -,
example: '-forkargs -- -server'
-a (--interface) <interface>
Optional IP address (interface) to bind to
-pt <string>
Process type (main/fork) - do not use directly, used when forking a
process
-r <string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string>]]]]]]]]]
Runmode(s) - Use this to define the run mode(s)
-b <string>
Base folder - defines the path under which the quickstart work folder
is created
-low-mem-action <string>
Low memory action - what to do if memory is insufficient at startup
-use-control-port
Start a control port
-nointeractive
Start with no interactivity
-ll <level>
Define launchpad log level (1 = error...4 = debug)
-n
Do not install shutdown hook
-D<property>=<value>
Additional framework properties.
-listener-port <listener-port>
Set listener port number
-x <string>
Run a Quickstart extension.
Options for executing Quickstart extensions:
-xargs <arg> [<arg> ...]
Construct an arguments list for a Quickstart extension (for example, -xargs --
-arg1 val1 -arg2 val2).
--------------------------------------------------------------------------------
Quickstart filename options
--------------------------------------------------------------------------------
Usage:
Rename the jar file, including one of the patterns shown below, to set the
corresponding option. Command-line options have priority on these filename
patterns.
--------------------------------------------------------------------------------
-NNNN
Include -NNNN.jar or -pNNNN in the renamed jar filename to run on port
NNNN, for example: quickstart-8085.jar
-nobrowser
Include -nobrowser in the renamed jar filename to avoid opening the
browser at startup, example: quickstart-nobrowser-8085.jar
-publish
Include -publish in the renamed jar filename to run in "publish" mode,
example: cq-publish-7502.jar
-dynamicmedia
Include -dynamicmedia in the renamed jar filename to run in
"dynamicmedia" mode, example: quickstart-dynamicmedia-4502.jar
-dynamicmedia_scene7
Include -dynamicmedia_scene7 in the renamed jar filename to run in
"dynamicmedia_scene7" mode, example:
quickstart-dynamicmedia_scene7-p4502.jar
--------------------------------------------------------------------------------
The license.properties file
--------------------------------------------------------------------------------
The license.properties file stores licensing information, created from the
licensing form displayed on first startup and stored in the folder from where
Quickstart is run.
--------------------------------------------------------------------------------
Log files
--------------------------------------------------------------------------------
Once Quickstart has been unpacked and started, log files can be found under
/Users/aemdocs/CQInstallationKits/AEM-65150-L8/crx-quickstart/logs.
--------------------------------------------------------------------------------
Instalação do AEM no ambiente Amazon EC2 installing-aem-in-the-amazon-ec-environment
Ao instalar o AEM em uma instância do Amazon Elastic Compute Cloud (EC2), se você instalar o autor e a publicação na instância do EC2, a instância do Autor será instalada corretamente seguindo o procedimento em Instalação de instâncias do AEM Manager; no entanto, a instância do Publish se torna Autor.
Antes de instalar a instância do Publish no ambiente EC2, faça o seguinte:
-
Descompacte o arquivo jar da instância do Publish antes de iniciar a instância pela primeira vez. Para descompactar o arquivo, use o seguinte comando:
code language-xml java -jar quickstart.jar -unpack
note note NOTE Se você alterar o modo após iniciando a instância pela primeira vez, não poderá alterar o modo de execução. -
Inicie a instância executando:
code language-xml java -jar quickstart.jar -r publish
note caution CAUTION Execute a instância primeiro após descompactá-la executando o comando acima. Caso contrário, o preenchimento quickstart.properties não será gerado. Sem esse arquivo, qualquer atualização futura do AEM falhará. -
Na pasta bin, abra o script start e verifique a seguinte seção:
code language-xml # runmode(s) if [ -z "$CQ_RUNMODE" ]; then CQ_RUNMODE='author' fi
-
Altere o modo de execução para publicar e salve o arquivo.
code language-xml # runmode(s) if [ -z "$CQ_RUNMODE" ]; then CQ_RUNMODE='publish' fi
-
Pare a instância e reinicie-a executando o script start.
Verificando a instalação verifying-the-installation
Os links a seguir podem ser usados para verificar se a instalação está operacional (todos os exemplos são baseados no fato de a instância estar em execução na porta 8080 do host local, de o CRX estar instalado em /crx e Launchpad em /):
-
https://localhost:8080/crx/de
O console CRXDE Lite. -
https://localhost:8080/system/console
O console da Web.
Ações após a instalação actions-after-installation
Embora existam muitas possibilidades para configurar o WCM do AEM, determinadas ações devem ser tomadas ou, pelo menos, revisadas imediatamente após a instalação:
- Consulte a Lista de Verificação de Segurança para obter as tarefas necessárias para garantir que seu sistema permaneça seguro.
- Revise a lista de usuários e grupos padrão que estão instalados com o WCM AEM. Verifique se você deseja realizar alguma ação em outras contas. Consulte Segurança e Administração de Usuários para obter mais detalhes.
Acesso ao CRXDE Lite e ao console da Web accessing-crxde-lite-and-the-web-console
Depois que o WCM do AEM for iniciado, você também poderá acessar:
- CRXDE Lite - usado para acessar e gerenciar o repositório
- Console da Web - usado para gerenciar ou configurar os pacotes OSGi (também conhecido como Console OSGi)
Acessar o CRXDE Lite accessing-crxde-lite
Para abrir o CRXDE Lite, você pode selecionar CRXDE Lite na tela de boas-vindas ou usar seu navegador para navegar até
https://<<i>host</i>>:<<i>port</i>>/crx/de/index.jsp
Por exemplo:https://localhost:4502/crx/de/index.jsp
Acesso ao console da Web accessing-the-web-console
Para acessar o console da Web do Adobe CQ, você pode selecionar Console OSGi na tela de boas-vindas ou usar seu navegador para navegar até
https://<host>:<port>/system/console
Por exemplo:https://localhost:4502/system/console
ou para a página Pacoteshttps://localhost:4502/system/console/bundles
Consulte Configuração OSGi com o Console da Web para obter mais detalhes.
Resolução de problemas troubleshooting
Para obter informações sobre como lidar com problemas que podem surgir durante a instalação, consulte:
Desinstalação do Adobe Experience Manager uninstalling-adobe-experience-manager
Como o AEM é instalado em um único diretório, não há necessidade de um utilitário de desinstalação. A desinstalação pode ser tão simples quanto excluir todo o diretório de instalação, embora a forma como você desinstala o AEM dependa do que você deseja obter e qual armazenamento persistente você usa.
Se o armazenamento persistente estiver incorporado no diretório de instalação, por exemplo, na instalação padrão do TarPM, a exclusão de pastas também removerá os dados.
Se sua instalação do AEM usar armazenamento externo, por exemplo, um servidor de banco de dados, a remoção da pasta não removerá os dados automaticamente, mas removerá a configuração de armazenamento, o que dificultará a restauração do conteúdo JCR.