O OSG é um elemento fundamental na pilha de tecnologias da Adobe Experience Manager (AEM). É usado para controlar os pacotes compostos de AEM e sua configuração.
O OSGi "fornece as primitivas padronizadas que permitem que os aplicativos sejam construídos a partir de componentes pequenos, reutilizáveis e colaborativos. Esses componentes podem ser compostos em um aplicativo e implantados".
Isso permite o gerenciamento fácil de pacotes, pois eles podem ser interrompidos, instalados e iniciados individualmente. As interdependências são tratadas automaticamente. Cada componente OSGi (consulte a Especificação OSGi) está contido em um dos vários pacotes.
Você pode gerenciar as configurações desses pacotes:
sling:OsgiConfig
) no repositórioQualquer um dos métodos pode ser usado embora haja diferenças sutis, principalmente em relação aos Modos de execução:
O Console da Web é a interface padrão para a configuração do OSGi. Ele fornece uma interface para editar as várias propriedades, onde valores possíveis podem ser selecionados de listas predefinidas.
Como tal, é o método mais fácil de usar.
Todas as configurações feitas com o Console da Web são aplicadas imediatamente e se aplicam à instância atual, independentemente do modo de execução atual ou de quaisquer alterações subsequentes no modo de execução.
nós de conteúdo (sling:osgiConfig) no repositório
sling:OsgiConfig
, é possível vincular a configuração a um modo de execução específico. Você pode até mesmo salvar configurações para mais de um modo de execução no mesmo repositório.Qualquer que seja o método utilizado, todos estes métodos de configuração:
Detalhes de determinadas configurações importantes estão listados em Configurações do OSGi.
O console Web no AEM fornece uma interface padronizada para configurar os pacotes. A guia Configuration é usada para configurar os pacotes OSGi e, portanto, é o mecanismo subjacente para configurar AEM parâmetros do sistema.
Quaisquer alterações feitas são imediatamente aplicadas à configuração OSGi relevante, não é necessário reiniciar.
As alterações feitas no console da Web são salvas no repositório como arquivos de configuração. Eles podem ser incluídos em pacotes de conteúdo para reutilização em outras instalações.
No console da Web, qualquer descrição que mencione as configurações padrão está relacionada aos padrões do Sling.
A Adobe Experience Manager tem seus próprios padrões e, portanto, os padrões definidos podem ser diferentes dos documentados no console.
Para atualizar uma configuração com o console da Web:
Acesse a guia Configuration do Console Web:
Abrindo o console da Web a partir do link no menu Ferramenta -> Operações. Depois de fazer logon no console, você pode usar o menu suspenso de:
OSGi >
O URL direto; por exemplo:
http://localhost:4502/system/console/configMgr
Uma lista será mostrada.
Selecione o pacote que deseja configurar:
Uma caixa de diálogo abrirá. Aqui você pode editar conforme necessário; por exemplo, defina Nível de registro como INFO
:
As atualizações são salvas no repositório como arquivos de configuração. Para localizá-los posteriormente (por exemplo, para incluir em um pacote de conteúdo para uso em outra instância), anote a identidade persistente ( PID
).
Clique em Salvar.
Suas alterações são aplicadas imediatamente à configuração OSGi relevante do sistema em execução, não é necessário reiniciar.
Agora você pode localizar os arquivos de configuração relacionados; por exemplo, para incluir em um pacote de conteúdo para uso em outra instância.
As alterações de configuração feitas usando o Console da Web são mantidas no repositório como arquivos de configuração ( .config
) em:
/apps
Eles podem ser incluídos em pacotes de conteúdo e reutilizados em outras instâncias.
O formato dos arquivos de configuração é muito específico - consulte a documentação do Sling Apache para obter detalhes completos.
Por isso, é recomendável criar e manter o arquivo de configuração fazendo alterações reais no console da Web.
O Console da Web não mostra nenhuma indicação de onde as alterações foram salvas no repositório, mas elas podem ser facilmente localizadas:
Crie o arquivo de configuração fazendo uma alteração inicial no console da Web.
Abra o CRXDE Lite.
No menu Ferramentas selecione Query … .
Envie um query de Type SQL
para procurar o PID da configuração que você atualizou.
Por exemplo, Apache Felix OSGi Management Console tem a identidade persistente (PID) de:
org.apache.felix.webconsole.internal.servlet.OsgiManager
Portanto, o query SQL pode ser:
select * from nt:base where jcr:path like '/apps/%' and contains(*, 'org.apache.felix.webconsole.internal.servlet.OsgiManager')
O nó do arquivo de configuração será exibido.
Para o exemplo acima:
/apps/system/config/org.apache.felix.webconsole.internal.servlet.OsgiManager.config
É possível abrir esse arquivo para visualização das alterações, mas para evitar erros de digitação, é recomendável fazer alterações reais no console.
Agora você pode criar um pacote de conteúdo, contendo esse nó, e usá-lo conforme necessário em outras instâncias.
Além de usar o console da Web, você também pode definir detalhes de configuração no repositório. Isso permite que você configure facilmente seus diferentes modos de execução.
Essas configurações são feitas criando nós sling:OsgiConfig
no repositório para referência do sistema. Esses nós espelham as configurações OSGi e formam uma interface do usuário para eles. Para atualizar os dados de configuração, atualize as propriedades do nó.
Se você modificar os dados de configuração no repositório, as alterações serão imediatamente aplicadas à configuração OSGi relevante como se as alterações tivessem sido feitas usando o console da Web, com as verificações de validação e consistência apropriadas. Isso também se aplica à ação de copiar uma configuração de /libs/
para /apps/
.
Como o mesmo parâmetro de configuração pode ser localizado em vários locais, o sistema:
sling:OsgiConfig
Para adicionar uma nova configuração ao repositório, é necessário saber o seguinte:
A Identidade Persistente (PID) do serviço.
Consulte o campo Configurações no console da Web. O nome é mostrado entre parênteses após o nome do pacote (ou nas Informações de configuração na parte inferior da página).
Por exemplo, crie um nó com.day.cq.wcm.core.impl.VersionManagerImpl.
para configurar AEM Gerenciador de versão do WCM.
Se um modo de execução específico é necessário. Crie a pasta:
config
- para todos os modos de execuçãoconfig.author
- pelo ambiente do autorconfig.publish
- para o ambiente publishconfig.<run-mode>
- se for caso dissoSe Configuração ou Configuração de Fábrica é necessário.
Os parâmetros individuais a configurar; incluindo qualquer definição de parâmetro existente que precise ser recriada.
Consulte o campo de parâmetro individual no console da Web. O nome é mostrado entre parênteses para cada parâmetro.
Por exemplo, crie uma propriedade
versionmanager.createVersionOnActivation
para configurar Criar versão na Ativação.
Já existe uma configuração em /libs
? Para lista de todas as configurações em sua instância, use a ferramenta Query no CRXDE Lite para enviar o seguinte query SQL:
select * from sling:OsgiConfig
Em caso afirmativo, essa configuração pode ser copiada para /apps/<yourProject>/
e, em seguida, personalizada no novo local.
Para adicionar a nova configuração ao repositório:
Use o CRXDE Lite para navegar até:
/apps/<yourProject>
Se ainda não existir, crie a pasta config
( sling:Folder
):
config
- aplicável a todos os modos de funcionamentoconfig.<run-mode>
- específico de um modo de funcionamento específicoNesta pasta, crie um nó:
Tipo: sling:OsgiConfig
Nome: a identidade persistente (PID);
por exemplo, para AEM o WCM Version Manager use com.day.cq.wcm.core.impl.VersionManagerImpl
Ao fazer uma configuração de fábrica, acrescente -<identifier>
ao nome.
Como em: org.apache.sling.commons.log.LogManager.factory.config-<identifier>
Em que <identifier>
é substituído pelo texto livre que você (deve) deve digitar para identificar a instância (não é possível omitir essas informações); por exemplo:
org.apache.sling.commons.log.LogManager.factory.config-MINE
Para cada parâmetro que você deseja configurar, crie uma propriedade neste nó:
Create Version on Activation
use versionmanager.createVersionOnActivation
Você só precisa criar propriedades para os parâmetros que deseja configurar, outras pessoas ainda usarão os valores padrão como definidos pela AEM.
Salve todas as alterações.
As alterações são aplicadas assim que o nó é atualizado, reiniciando o serviço (assim como as alterações feitas no console da Web).
Você não deve alterar nada no caminho /libs
.
O caminho completo de uma configuração deve estar correto para ser lido na inicialização.
A seguinte ordem de precedência é usada:
Nós do repositório em /apps/*/config...
.com tipo sling:OsgiConfig
ou arquivos de propriedade.
Nós do repositório com o tipo sling:OsgiConfig
em /libs/*/config...
. (definições inovadoras).
Qualquer arquivo .config
de <*cq-installation-dir*>/crx-quickstart/launchpad/config/...
. no sistema de arquivos local.
Isso significa que uma configuração genérica em /libs
pode ser mascarada por uma configuração específica do projeto em /apps
.
As alterações de configuração feitas enquanto o sistema está em execução disparam uma recarga com a configuração modificada.
Em seguida, a seguinte ordem de precedência se aplica:
/apps
terá efeito imediato./libs
terá efeito imediato, a menos que seja mascarada por uma configuração em /apps
.Para configurações específicas do modo de execução, é possível combinar vários modos de execução. Por exemplo, você pode criar pastas de configuração no seguinte estilo:
/apps/*/config.<runmode1>.<runmode2>/
As configurações nessas pastas serão aplicadas se todos os modos de execução corresponderem a um modo de execução definido na inicialização.
Por exemplo, se uma instância foi iniciada com os modos de execução author,dev,emea
, os nós de configuração em /apps/*/config.emea
, /apps/*/config.author.dev/
e /apps/*/config.author.emea.dev/
serão aplicados, enquanto os nós de configuração em /apps/*/config.author.asean/
e /config/author.dev.emea.noldap/
não serão aplicados.
Se várias configurações para o mesmo PID forem aplicáveis, a configuração com o maior número de modos de execução correspondentes será aplicada.
Por exemplo, se uma instância foi iniciada com os modos de execução author,dev,emea
e /apps/*/config.author/
e /apps/*/config.emea.author/
definir uma configuração para
com.day.cq.wcm.core.impl.VersionManagerImpl
, a configuração em /apps/*/config.emea.author/
será aplicada.
A granularidade desta regra está em um nível PID.
Não é possível definir algumas propriedades para o mesmo PID em /apps/*/config.author/
e outras mais específicas em /apps/*/config.emea.author/
para o mesmo PID.
A configuração com o maior número de modos de execução correspondentes será efetiva para todo o PID.
A lista a seguir mostra uma pequena seleção das configurações disponíveis (em uma instalação padrão) no repositório:
Autor - AEM Filtro WCM:
libs/wcm/core/config.author/com.day.cq.wcm.core.WCMRequestFilter
Publicar - AEM Filtro WCM:
libs/wcm/core/config.publish/com.day.cq.wcm.core.WCMRequestFilter
Publicar - AEM Estatísticas de Página WCM:
libs/wcm/core/config.publish/com.day.cq.wcm.core.stats.PageViewStatistics
Como essas configurações residem em /libs
, elas não devem ser editadas diretamente, mas copiadas para a área do aplicativo ( /apps
) antes da personalização.
Para lista de todos os nós de configuração em sua instância, use a funcionalidade Query no CRXDE Lite para enviar o seguinte query SQL:
select * from sling:OsgiConfig
Se você alterar uma configuração por meio do console da Web, ela será (normalmente) gravada no repositório em:
/apps/{somewhere}
Por padrão, {somewhere}
é system/config
, portanto, a configuração é gravada em
/apps/system/config
No entanto, se você estiver editando uma configuração que veio inicialmente de outro lugar no repositório: por exemplo:
/libs/foo/config/someconfig
Em seguida, a configuração atualizada é escrita sob o local original; por exemplo:
/apps/foo/config/someconfig
As configurações alteradas por admin
são salvas nos arquivos *.config
em:
/crx-quickstart/launchpad/config
Esta é a área de dados privados do administrador de configuração OSGi e contém todos os detalhes de configuração especificados por admin
, independentemente de como eles entraram no sistema.
Este é um detalhe de implementação e você nunca deve editar este diretório diretamente.
No entanto, é útil saber a localização desses arquivos de configuração para que as cópias possam ser feitas para backup e/ou instalação múltipla:
Console de gerenciamento do Apache Felix OSGi
../crx/org/apache/felix/webconsole/internal/servlet/OsgiManager.config
Repositório de Cliente CRX Sling
../com/day/crx/sling/client/impl/CRXSlingClientRepository/<pid-nr>.config
Você deve nunca editar as pastas ou arquivos em:
/crx-quickstart/launchpad/config