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

Os pacotes configuráveis CICS que contêm os pacotes configuráveis OSGi para o aplicativo devem ser implementados para zFS. O servidor JVM de destino deve estar configurado para executar uma estrutura OSGi e ser ativado na região CICS. É preciso estar conectado à região CICS usando o para criar os recursos CICS.

Sobre Esta Tarefa

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

Como melhor prática, certifique-se de que todos os pacotes configuráveis OSGi que constituem um componente do aplicativo Java seja implementado 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 tiver dependências em um pacote configurável OSGi que contenham uma biblioteca de código comum, a melhor prática é criar um pacote configurável CICS separado para a biblioteca. Nesse caso, é importante instalar o recurso BUNDLE de 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.

Procedimento

  1. Crie um recurso BUNDLE que especifique o diretório do pacote configurável no sistema de arquivos zSeries:
    1. Na perspectiva SM CICS, clique em Definições > Definições do Pacote Configurável na barra de menus do para abrir a visualização Definições de Pacotes Configuráveis.
    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 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 para abrir a visualização Pacotes Configuráveis OSGi. Verifique o estado dos pacotes configuráveis e serviços OSGi instalados na estrutura OSGi. A tabela a seguir resume os estados:
    BUNDLEPART OSGIBUNDLE OSGISERVICE
    ENABLED STARTING N/A
    ENABLED ACTIVE ACTIVE
    ENABLED ACTIVE INACTIVE
    DISABLED RESOLVED N/A
    DISABLED INSTALLED N/A
    UNUSABLE N/A N/A
    • 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, o CICS detectou que um serviço OSGi com esse nome já existe 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 e serviços OSGi estão disponíveis para outros pacotes configuráveis na estrutura.