Implementando Pacotes Configuráveis OSGi em um Servidor JVM

Para implementar um aplicativo Java™ em um servidor JVM, você deve instalar os pacotes configuráveis OSGi para o aplicativo na estrutura OSGi do servidor JVM de destino.

Antes de Iniciar

O pacote configurável CICS que contém os pacotes configuráveis OSGi para o aplicativo deve ser implementado no zFS. O servidor JVM de destino deve ser ativado na região CICS.

Sobre Esta Tarefa

Um pacote configurável CICS pode conter um ou mais pacotes configuráveis OSGi. Como o pacote configurável CICS é a unidade de implementação, todos os pacotes configuráveis OSGi são gerenciados juntos como parte do recurso BUNDLE. A estrutura OSGi também gerencia o ciclo de vida dos pacotes configuráveis, incluindo o gerenciamento de dependências e versões.

Assegure-se de que todos os pacotes configuráveis OSGi que constituem um componente de aplicativo Java estejam implementados no mesmo pacote configurável CICS. Se houver dependências entre pacotes configuráveis OSGi, implemente-os no mesmo pacote configurável CICS. Ao instalar o recurso BUNDLE de CICS, o CICS garante que todas as dependências entre os pacotes configuráveis OSGi são resolvidas.

Se você tiver dependências em um pacote configurável OSGi que contenha uma biblioteca de código comum, crie um pacote configurável CICS separado para a biblioteca. Nesse caso, é importante instalar o recurso BUNDLE do CICS que contém a biblioteca primeiro. Se você instalar o aplicativo Java antes dos pacotes configuráveis CICS dos quais ele depende, a estrutura OSGi não conseguirá resolver as dependências do aplicativo Java.

Não tente instalar um pacote configurável CICS que contenha um pacote configurável OSGi em um servidor JVM Liberty, já que essa configuração não é suportada. Em vez disso, é possível empacotar o pacote configurável OSGi juntamente com seu aplicativo da web em um Enterprise Bundle Archive (EBA), ou usar o repositório de pacote configurável do WebSphere Liberty Profile para tornar o pacote configurável OSGi disponível para todos os aplicativos da web no servidor JVM Liberty.

Procedimento

  1. Crie um recurso BUNDLE que especifique o diretório do pacote configurável no sistema de arquivos do zSeries:
    1. Na perspectiva CICS SM, clique em Definições > Definições de Pacote Configurável na barra de menus CICS Explorer para abrir a visualização de Definições de Pacote Configurável.
    2. Clique com o botão direito do mouse na visualização e clique em Novo para abrir o assistente Definição de Novo Pacote Configurável. Insira os detalhes para o recurso BUNDLE nos campos do assistente.
    3. Instale o recurso BUNDLE. É possível instalar o recurso em um estado ativado ou desativado:
      • Se você instalar o recurso em um estado DESATIVADO, o CICS instalará os pacotes configuráveis OSGi na estrutura e resolverá as dependências, mas não tentará iniciar os pacotes configuráveis.
      • Se você instalar o recurso em um estado ATIVADO, o CICS instalará os pacotes configuráveis OSGi, resolverá as dependências e iniciará os pacotes configuráveis OSGi. Se o pacote configurável OSGi contiver um ativador de pacote configurável lento, a estrutura OSGi não tentará iniciar o pacote configurável até que ele seja chamado pela primeira vez por outro pacote configurável OSGi.
  2. Opcional: Ative o recurso BUNDLE para iniciar os pacotes configuráveis OSGi na estrutura se o recurso ainda não estiver em um estado ENABLED.
  3. Clique em Operações > Pacotes Configuráveis na barra de menus do CICS Explorer para abrir a visualização Pacotes Configuráveis. Verifique o estado do recurso BUNDLE.
    • Se o recurso BUNDLE estiver em um estado ATIVADO, o CICS conseguiu instalar todos os recursos no pacote configurável com êxito.
    • Se o recurso BUNDLE estiver em um estado DESATIVADO, o CICS não conseguiu instalar um ou mais recursos no pacote configurável.
    Se o recurso BUNDLE não foi instalado no estado ativado, verifique as partes do pacote configurável para o recurso BUNDLE. Se qualquer uma das partes do pacote configurável estiver no estado INUTILIZÁVEL, oCICS não conseguiu criar os pacotes configuráveis OSGi. Geralmente, esse estado indica que há algum problema com o pacote configurável CICS no zFS. Você deve descartar o recurso BUNDLE, corrigir o problema e, em seguida, instalar novamente o recurso BUNDLE.
  4. Clique em Operações > Java > Pacotes Configuráveis OSGi na barra de menus do CICS Explorer para abrir a visualização Pacotes Configuráveis OSGi. Verifique o estado dos pacotes configuráveis e serviços OSGi instalados na estrutura OSGi.
    • Se o pacote configurável OSGi estiver no estado STARTING, o ativador do pacote configurável foi chamado mas ainda não retornou. Se o pacote configurável OSGi tiver uma política de ativação lenta, o pacote configurável permanecerá nesse estado até ser chamado na estrutura OSGi.
    • Se os pacotes configuráveis OSGi e os serviços OSGi estiverem ativos, o aplicativo Java está pronto.
    • Se o serviço OSGi estiver inativo, é possível que o CICS tenha detectado que já existe um serviço OSGi com esse nome na estrutura OSGi.
    • Se o recurso BUNDLE for desativado, o pacote configurável OSGi será movido para o estado RESOLVED.
    • Se o pacote configurável OSGi estiver no estado INSTALLED, ou ele não foi iniciado ou falhou ao iniciar, porque as dependências no pacote configurável OSGi não puderam ser resolvidas.

Resultados

O BUNDLE está ativado, os pacotes configuráveis OSGi estão instalados com êxito na estrutura OSGi e quaisquer serviços OSGi estão ativos. Os pacotes configuráveis OSGi estão disponíveis para outros pacotes configuráveis na estrutura.

O que Fazer Depois

É possível tornar o aplicativo Java disponível para outros aplicativos CICS fora da estrutura OSGi, conforme descrito em Chamando um aplicativo da web Java em um servidor JVM. Para atualizar ou remover um aplicativo, consulte Administrando aplicativos Java.