44.4 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:

44.4.1 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.

Tabela 44-1 Os requisitos do servlet de Geração de Relatórios

Servidor

Java Servlet Engine

JVM

NetWare® 6.5 (Support Pack 1 ou posterior)

Tomcat 4.1x

Novell JVM* for NetWare 1.4.2

NetWare 6 (Support Pack 2 ou posterior) 1

Tomcat 3.3a

Novell JVM for NetWare 1.3.1

Windows Server 2003 (com o service pack mais recente)

Tomcat 3.3a

Sun JDK* 1.3.1_01

Windows 2000 (com o service pack mais recente)

Tomcat 3.3a

Sun JDK 1.3.1_01

SUSE Linux Enterprise Server (SLES) 9 SP1

Tomcat 4.1x

JVM 1.4.2 2

Novell Open Enterprise Server (Linux) 1.0

Tomcat 4.1x

JVM 1.4.2 3

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.

2 A JVM é instalada no servidor SLES 9 SP1 pelo programa de instalação do Servidor de Camada Intermediária do ZENworks 7.

3 A JVM é fornecida e instalada pelo programa de instalação do Novell Open Enterprise Server.

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

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.

OES Linux fornecido com o Tomcat instalado.

44.4.2 Instalando o servlet de relatório no Linux

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

  2. Copie o arquivo zfdamrServlet.war do diretório /opt/novell/zenworks/zdm/winutils/nalreporting do servidor do Desktop Management para /var/opt/novell/tomcat4/webapps.

  3. Reinicie o Tomcat para expandir o arquivo zfdamrServlet.war. Para reiniciar o Tomcat no Linux, digite /usr/share/tomcat/bin/startup.sh na linha de comandos.

    ou

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

44.4.3 Instalando o servlet de relatório no NetWare e no Windows

  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 do diretório de relatórios sys:\public\reporting\canned\nal do servidor do Desktop Management para sys:\tomcat\4\webapps.

  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.

44.4.4 Configurando o servlet Relatório para uso com Apache

  1. Abra o arquivo sys:/apache2/conf/httpd.conf.

  2. Adicione a linha a seguir no final do arquivo:

    Include sys:/public/Reporting/canned/Nal Reports/zfdamrServlet.conf

  3. Grave o arquivo httpd.conf.

  4. Reinicie o servidor da Web Apache.

44.4.5 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. O arquivo está localizado no diretório do Tomcat webapps\zfdamrservlet\web-inf

  2. Se 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 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 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 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 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.

44.4.6 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:

  • No ConsoleOne, ativar uma política de Destinos XML em um Pacote de Localização do Serviço. A política de Destinos XML identifica as localizações na Web (URLs) para as quais você deseja enviar dados XML. Se você estiver utilizando o servlet de Geração de Relatórios do Gerenciamento de Aplicativos, a localização será o URL desse servlet. Um Pacote de Localização do Serviço pode conter apenas uma política de Destinos XML. Se você não tiver criado um Pacote de Localização do Serviço ou se as políticas de Destinos XML dos pacotes atuais estiverem sendo utilizadas para especificar outras localizações, será necessário criar um novo Pacote de Localização do Serviço. As instruções apropriadas são fornecidas nas etapas a seguir.
  • 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 você deseja enviar ao URL da Web.

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 deve incluir o número da porta, que por padrão é a porta 8080 no Windows ou no NetWare, e 8180 no OES Linux e SLES. Trata-se da porta padrão do Tomcat nesses ambientes, além de ser necessária para que a Política de Localização de Serviços da geração de relatórios XML encontre o zfdamrServlet em execução no Tomcat.

    O URL do servlet de Geração de Relatórios no Windows ou NetWare seria:

    http://endereo_ip:8080/zfdamrServlet/run
    

    e o URL do servlet de Geração de Relatórios no (OES Linux ou SLES) seria:

    http://endereo_ip:8180/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 Etapa 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 a Etapa 8 para adicionar mais containers.

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

44.4.7 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 Seção 44.5, Configurando aplicativos para utilizar a geração de relatórios.