Esta seção descreve as opções disponíveis ao instalar uma instância AEM independente. Você também pode ler Elementos de Armazenamento para obter mais informações sobre a escolha do tipo de armazenamento de back-end após instalar o AEM 6 recentemente.
A porta padrão para AEM é 4502. Se essa porta não estiver disponível ou já estiver em uso, o Quickstart se configurará automaticamente 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 do início rápido, de forma 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 do início rápido:
Ao renomear o arquivo, ele deve começar com cq;
como em cq5-publish-p4503.jar
.
É recomendável que você always coloque o prefixo do número da porta em -p; como em cq5-publish-p4503.jar ou cq5-author-p6754.jar.
Isso garante que você não precise se preocupar em cumprir as regras usadas para extrair o número da porta:
-p
Você também pode alterar o número da porta usando a opção -port
no comando start .
Se você estiver executando o Oracle Java 11 (ou, em geral, versões do Java mais recentes do que 8), será necessário adicionar opções adicionais à linha de comando ao iniciar o AEM.
-add-opens
precisam ser adicionados para impedir que o reflexo relacionado acesse mensagens AVISO no stdout.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
-XX:+UseParallelGC
para atenuar possíveis problemas de desempenho.Abaixo há um exemplo de como os parâmetros adicionais da JVM devem ser exibidos 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
Executar modelo que permite 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 da inicialização rápida ser criada e pode incluir pacotes, configurações, etc. Isso pode ser particularmente útil para instalações prontas para produção, quando você desejar manter sua instalação limpa e sem conteúdo de amostra. Para obter mais informações, consulte:
Por padrão, a pasta crx-quickstart/install
é assistida por arquivos.
Essa 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á automaticamente selecionado e instalado. Se for removido, ele será 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:
crx-quickstart/install
pode ser criada antes que o início rápido seja iniciado e pacotes adicionais podem ser colocados lá.Consulte também How to install CRX packages automatically on server startup para obter exemplos.
Certifique-se de executar o procedimento a seguir enquanto estiver conectado como Administrador ou inicie/execute essas etapas usando a seleção do menu de contexto Executar como Administrador.
Fazer logon como um usuário com privilégios de administrador é insuficiente. Se você não estiver conectado como administrador ao concluir essas etapas, receberá erros de Acesso negado.
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:
Este comando chama o script apropriado que inicia o daemon de serviço do Windows em Java de 64 bits em vez de Java de 32 bits.
Para evitar que o processo seja bifurcado em mais de um processo, aumente o tamanho máximo do heap e os parâmetros da JVM PermGen. Localize o comando set jvm_options
e defina o valor da seguinte maneira:
set jvm_options=-XX:MaxPermSize=256M;-Xmx1792m
Abra o Prompt de comando, altere o diretório atual para a pasta crx-quickstart/opt/helpers da instalação AEM e insira 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:
O Windows indica que o serviço está em execução. AEM é iniciado e o executável prunsrv é exibido no Gerenciador de tarefas. No navegador da Web, navegue até AEM, por exemplo, https://localhost:4502
para começar a usar AEM.
Os valores de propriedade no arquivo instsrv.bat são usados ao criar o serviço do Windows. Se você editar os valores de propriedade em instsrv.bat, deverá desinstalar e depois reinstalar o serviço.
Ao instalar o AEM como serviço, você deve fornecer o caminho absoluto para o diretório de logs em com.adobe.xmp.worker.files.ncomm.XMPFilesNComm
do Configuration Manager.
Para desinstalar o serviço, clique em Stop no painel de controle Services 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 Services ou da lista na linha de comando quando você digita net start
.
O local padrão da pasta temporária da máquina java é /tmp
. AEM também usa essa pasta, por exemplo, ao criar pacotes.
Se 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 da JVM:
-Djava.io.tmpdir="/<*new-tmp-path*>"
para:
Outras opções e convenções de renomeação estão descritas no arquivo de ajuda do Quickstart, que está disponível por meio da opção -help. Para acessar a ajuda, digite:
java -jar cq5-<*version*>.jar -help
Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-5.6.0.jar'
--------------------------------------------------------------------------------
Adobe Experience Manager Quickstart (build 20130129)
--------------------------------------------------------------------------------
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
-ll <level>
Define launchpad log level (1 = error...4 = debug)
--------------------------------------------------------------------------------
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 cq5 in "publish"
mode, example: cq5-publish-7502.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
./crx-quickstart/logs.
--------------------------------------------------------------------------------
Ao instalar AEM em uma instância do Amazon Elastic Compute Cloud (EC2), se você instalar o autor e publicar na instância do EC2, a instância do Autor será instalada corretamente seguindo o procedimento em Instalar instâncias do AEM Manager; no entanto, a instância Publicar se torna Autor.
Antes de instalar a instância de publicação no ambiente EC2, faça o seguinte:
Descompacte o arquivo jar da instância de publicação antes de iniciar a instância pela primeira vez. Para descompactar o arquivo, use o seguinte comando:
java -jar quickstart.jar -unpack
Se você alterar o modo depois de iniciando a instância na primeira vez, não poderá alterar o modo de execução.
Inicie a instância executando:
java -jar quickstart.jar -r publish
Certifique-se de executar a instância primeiro depois de descompactá-la, executando o comando acima. Caso contrário, o preenchimento quickstart.properties não será gerado. Sem esse arquivo, qualquer atualização futura de AEM falhará.
Na pasta bin, abra o script start e verifique a seguinte seção:
# runmode(s)
if [ -z "$CQ_RUNMODE" ]; then
CQ_RUNMODE='author'
fi
Altere o modo de execução para publish e salve o arquivo.
# runmode(s)
if [ -z "$CQ_RUNMODE" ]; then
CQ_RUNMODE='publish'
fi
Pare a instância e reinicie-a executando o script start.
Os links a seguir podem ser usados para verificar se a instalação está operacional (todos os exemplos são baseados em que a instância está sendo executada na porta 8080 do host local, que o CRX está instalado em /crx e o Launchpad em /):
https://localhost:8080/crx/de
O console CRXDE Lite.
https://localhost:8080/system/console
O Console da Web.
Embora haja muitas possibilidades de configurar AEM WCM, algumas ações devem ser tomadas ou, pelo menos, revisadas imediatamente após a instalação:
Depois que AEM WCM for iniciado, você também poderá acessar:
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
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 Pacotes
https://localhost:4502/system/console/bundles
Consulte Configuração OSGi com o Console da Web para obter mais detalhes.
Para obter informações sobre como lidar com problemas que podem surgir durante a instalação, consulte:
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 alcançar e do armazenamento persistente que 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.
O Adobe recomenda fazer backup do repositório antes de excluir o AEM. Se você excluir todo o <cq-installation-diretory>, você excluirá o repositório. Para manter os dados do repositório antes de excluir, mover ou copiar a pasta <cq-installation-diretory>/crx-quickstart/repository em outro lugar antes de excluir as outras pastas.
Se a sua instalação do AEM usar armazenamento externo, por exemplo, um servidor de banco de dados, a remoção de uma pasta não removerá os dados automaticamente, mas removerá a configuração de armazenamento, o que dificulta a restauração do conteúdo JCR.