Configurando a geração de relatórios XML

O Disparador de Aplicativos pode utilizar o protocolo HTTP ou HTTPS para enviar informações sobre eventos como dados XML ao servlet de Geração de Relatórios de Aplicativo do Desktop Management (zfdamrServlet). Esse servlet processa as mensagens e as adiciona a um banco de dados compatível com o JDBC, como o banco de dados Sybase que acompanha o ZENworks.

Para configurar a geração de relatórios XML, é necessário concluir as tarefas a seguir:


Atendendo aos requisitos do servlet de Geração de Relatórios

O servlet de Geração de Relatórios requer um dos seguintes ambientes de servidor. Os números de versão relacionados correspondem aos requisitos mínimos de versão.

Servidor Java Servlet Engine JVM

NetWare 6 (Support Pack 2 ou posterior) 1

Tomcat 3.3a

Novell JVM* for NetWare 1.3.1

Windows 2000 (com o service pack mais recente)

Tomcat 3.3a

Sun JDK 1.3.1_01

1 É necessário ter o Support Pack 2 ou posterior. Se esse requisito não for atendido, o servlet de Geração de Relatórios fará com que a taxa de utilização do servidor atinja 100% e permaneça nesse nível.

Para obter informações sobre como instalar o Tomcat no NetWare 6, consulte a documentação do NetWare 6.

Para obter informações sobre como instalar o Tomcat no Windows 2000, visite o site do Apache Tomcat na Web.


Instalando o servlet de Geração de Relatórios

  1. Verifique se ambiente de servidor no qual o servlet de Geração de Relatórios está sendo instalado atende aos requisitos de software relacionados na seção anterior, Atendendo aos requisitos do servlet de Geração de Relatórios.

  2. Copie o arquivo zfdamrServlet.war a partir do diretório sys:\public\reporting\canned\nal reports do Servidor do Desktop Management para o diretório webapps do Tomcat.

    Esse arquivo também está disponível no diretório zenworks\products\appmgmt\nal reports do CD ZENworks 6.5 Desktop Management.

  3. Reinicie o Tomcat para expandir o arquivo zfdamrServlet.war.

    ou

    Se você não quiser reiniciá-lo, utilize as ferramentas que acompanham o Tomcat para expandir o arquivo.


Configurando o servlet de Geração de Relatórios

O servlet de Geração de Relatórios precisa obter informações sobre o banco de dados no qual ele gravará os eventos de geração de relatórios. Para fornecer essas informações:

  1. Abra o arquivo web.xml. Esse arquivo está localizado no diretório webapps\zfdamrservlet\web-inf do Tomcat.

  2. Se você estiver utilizando um banco de dados Sybase, localize o parâmetro dbip e mude seu valor de acordo com o endereço IP do servidor de banco de dados. O endereço IP é o único parâmetro que precisa ser modificado para um banco de dados Sybase.

    ou

    Se você estiver utilizando um banco de dados que não seja o Sybase, modifique os parâmetros descritos a seguir conforme necessário para o seu banco de dados. Se você estiver utilizando um banco de dados Microsoft SQL, siga as orientações no TID 10094306.

    dbuser: especifique um nome de usuário que tenha acesso de Gravação ao banco de dados. O acesso de Leitura não é necessário. O nome de usuário pré-configurado (MW_DBA) corresponde ao nome do usuário de Leitura-Gravação padrão para um banco de dados Sybase criado pelo programa de instalação do Servidor do Desktop Management. Se você estiver utilizando um banco de dados Sybase do ZENworks e não tiver mudado o nome do usuário de Leitura-Gravação padrão, não será necessário modificar esse parâmetro.

    dbpasswd: especifique a senha para o nome de usuário determinado no parâmetro dbuser. A senha pré-configurada (novell) corresponde à senha do usuário de Leitura-Gravação padrão para um banco de dados Sybase criado pelo programa de instalação do Servidor do Desktop Management. Se você estiver utilizando um banco de dados Sybase do ZENworks e não tiver mudado a senha do usuário de Leitura-Gravação padrão, não será necessário modificar esse parâmetro.

    dbip: especifique o endereço IP do servidor que está executando o banco de dados.

    dbport: especifique a porta de recebimento do banco de dados. A porta pré-configurada (2638) corresponde à porta do servidor NetWare padrão para um banco de dados Sybase criado pelo programa de instalação do Servidor do Desktop Management. Se você estiver utilizando um banco de dados Sybase do ZENworks instalado no NetWare e não tiver mudado a porta padrão, não será necessário modificar esse parâmetro.

    dbprotocol: especifique o protocolo a ser utilizado ao acessar o banco de dados. Para o Sybase, esse parâmetro corresponde a jdbc: (o valor pré-configurado).

    dbsubprotocol: especifique o subprotocolo a ser utilizado ao acessar o banco de dados. Para o Sybase, esse parâmetro corresponde a sybase: (o valor pré-configurado).

    dbsubname: especifique o subnome a ser utilizado ao acessar o banco de dados. Para o Sybase, esse parâmetro corresponde a Tds: (o valor pré-configurado).

    dbdriver: especifique a classe completa do driver a ser utilizado ao acessar o banco de dados. Esse driver deve oferecer suporte ao protocolo relacionado no parâmetro dbprotocol. Para o Sybase, esse parâmetro corresponde a com.sybase.jdbc2.jdbc.SybDriver (o valor pré-configurado).

  3. Grave o arquivo.

  4. Reinicie o Tomcat.


Habilitando a política de Destinos XML

Para que o Disparador de Aplicativos possa gerar relatórios de eventos de aplicativo por meio do XML, você deve:

Para ativar uma política de Destinos XML e associá-la a containers:

  1. No ConsoleOne, clique o botão direito do mouse no Pacote de Localização do Serviço que você deseja utilizar e selecione Propriedades.

    ou

    Se você não possui um Pacote de Localização do Serviço, clique o botão direito do mouse no container em que você deseja criar esse pacote, clique em Novo e selecione Pacote de Políticas. Siga as instruções fornecidas no Assistente de Pacotes de Políticas para criar um Pacote de Localização do Serviço.


    Página de políticas Geral
  2. Na página Geral, marque a caixa na coluna Habilitado para habilitar a política de Destinos XML.

  3. Selecione a política de Destinos XML na lista e clique em Propriedades para exibir a página de propriedades Destinos XML.


    Página Destinos XML
  4. Clique em Adicionar para exibir a caixa de diálogo URL de XML, digite o URL para o qual você deseja enviar os dados XML e, em seguida, clique em OK para adicionar esse URL à lista.

    O URL para o servlet de Geração de Relatórios é:

    http://endereço_ip/zfdamrServlet/run

    em que endereço_ip corresponde ao endereço IP ou ao nome de host DNS do servidor no qual o servlet de Geração de Relatórios está sendo executado.

  5. Repita a Passo 4 para adicionar outros URLs.

  6. Quando terminar de adicionar URLs, clique em OK para retornar à página Geral.

  7. Clique em Associações para exibir a página Associações.


    Página Associações do Pacote de Localização do Serviço

    Utilize essa página para associar o Pacote de Localização do Serviço aos containers em que residem os usuários ou as estações de trabalho cujos relatórios XML você deseja enviar ao URL da Web. Se um container pai incluir vários containers em que residem objetos Usuário e Estação de Trabalho, selecione esse container pai em vez de cada container individual.

  8. Clique em Adicionar, pesquise e selecione o container que você deseja adicionar e, em seguida, clique em OK para adicioná-lo à lista.

  9. Repita Passo 8 para adicionar mais containers.

  10. Quando terminar de adicionar containers, clique em OK para gravar as informações.


Configurando objetos Aplicativo para utilizar a geração de relatórios XML

Depois de habilitar a política de Destinos XML, você poderá começar a configurar objetos Aplicativo de forma a utilizar a geração de relatórios XML. Como a geração de relatórios de eventos é configurada para cada aplicativo, é possível determinar os aplicativos para os quais você deseja e não deseja coletar relatórios de eventos.

Para obter instruções detalhadas sobre como configurar um aplicativo de forma a utilizar a geração de relatórios XML, consulte Configurando aplicativos para utilizar a geração de relatórios.