O Disparador de Aplicativos pode usar o protocolo HTTP ou HTTPS para enviar informações de eventos como dados XML ao servlet Relatório do Gerenciamento de Aplicativos do ZfD (zfdamrServlet). O servlet processa as mensagens e adiciona-as a um banco de dados compatível com JDBC*, por exemplo, o banco de dados Sybase incluído no ZfD.
Para configurar os relatórios XML, você precisa concluir as seguintes tarefas:
O servlet Relatório requer um dos seguintes ambientes de servidor. Os números de versão relacionados são requisitos de versão mínimos.
Servidor
Mecanismo de servlet Java
JVM
NetWare® 6 (Support Pack 2 ou posterior) 1
Tomcat 3.3a
Novell JVM* para NetWare 1.3.1
Windows 2000 (com service pack mais recente)
Tomcat 3.3a
Sun JDK 1.3.1_01
1 É necessário Support Pack 2 ou posterior. Sem o Support Pack 2 ou posterior, o servlet Relatório faz com que a utilização do servidor pule para 100% e permaneça nesse nível.
Para obter informações sobre a instalação do Tomcat no NetWare 6, consulte a documentação do NetWare 6.
Verifique se o ambiente de servidor onde você está instalando o servlet Relatório satisfaz os requisitos de software relacionados na seção anterior, Satisfazendo os requisitos do servlet Relatório .
Copie o arquivo zfdamrServlet.war do diretório PUBLIC\REPORTING\CANNED\NAL REPORTS no volume SYS: do servidor do ZfD para o diretório WEBAPPS do Tomcat.
O arquivo também está disponível no CD de Programa do ZfD 4 no diretório ZENWORKS\PRODUCTS\APPMGMT\NAL REPORTS.
Reinicie o Tomcat para expandir o arquivo zfdamrServlet.war.
ou
Se não quiser reiniciar o Tomcat, use as ferramentas fornecidas com o Tomcat para expandir o arquivo.
Configurando o servlet Relatório
O servlet Relatório precisa de informações sobre o banco de dados onde ele gravará os eventos do relatório. Para fornecer essas informações:
Abra o arquivo WEB.XML. O arquivo está localizado no diretório WEBAPPS\ZFDAMRSERVLET\WEB-INF do Tomcat
Se você estiver usando um banco de dados Sybase, localize o parâmetro dbip > mude o valor do parâmetro para o endereço IP do servidor de banco de dados. O endereço IP é o único parâmetro que você precisa mudar para um banco de dados Sybase.
ou
Caso esteja usando um banco de dados diferente do Sybase, modifique os parâmetros a seguir conforme requerido pelo seu banco de dados.
dbuser: Digite 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 do usuário pré-configurado (MW_DBA) é o nome do usuário Leitura-Gravação padrão para um banco de dados Sybase criado pelo programa de instalação do ZfD. Se você está usando um banco de dados Sybase do ZfD e não mudou o nome do usuário Leitura-Gravação padrão, você não precisa mudar esse parâmetro.
dbpasswd: Digite a senha para o nome do usuário especificado no parâmetro dbuser. A senha pré-configurada (novell) é a senha do usuário Leitura-Gravação padrão para um banco de dados Sybase criado pelo programa de instalação do ZfD. Se você está usando um banco de dados Sybase do ZfD e não mudou a senha do usuário Leitura-Gravação padrão, não precisa mudar este parâmetro.
dbip: Digite o endereço IP do servidor que está executando o banco de dados.
dbport: Digite a porta onde o banco de dados está recebendo. A porta pré-configurada (2638) é a porta do servidor NetWare padrão para um banco de dados Sybase criado pelo programa de instalação do ZfD. Se você está usando um banco de dados Sybase do ZfD instalado em NetWare e não mudou a porta padrão, não precisa mudar esse parâmetro.
dbprotocol: Digite o protocolo a ser usado ao acessar o banco de dados. Para o Sybase, ele é jdbc: (o valor pré-configurado).
dbsubprotocol: Digite o subprotocolo a ser usado ao acessar o banco de dados. Para o Sybase, ele é sybase: (o valor pré-configurado).
dbsubname: Digite o subnome a ser usado ao acessar o banco de dados. Para o Sybase, ele é Tds: (o valor pré-configurado).
dbdriver: Digite a classe plena do driver a ser usado ao acessar o banco de dados. O driver deve suportar o protocolo relacionado no parâmetro dbprotocol. Para o Sybase, ele é com.sybase.jdbc2.jdbc.SybDriver (o valor pré-configurado).
Grave o arquivo.
Reinicie o Tomcat.
Habilitando a Diretiva de Destinos XML
Para que o Disparador de Aplicativos possa relatar eventos de aplicativos através do XML, você precisa:
Ativar uma Diretiva de Destinos XML em um Pacote de Localização do Serviço do eDirectory. A Diretiva de Destinos XML identifica os locais na Web (URLs) para onde os dados XML devem ser enviados. Se você estiver usando o servlet Relatório do Gerenciamento de Aplicativos, será o URL desse servlet. Um Pacote de Localização do Serviço pode ter apenas uma Diretiva de Destinos XML. Se você não tiver criado um Pacote de Localização do Serviço ou se as Diretivas de Destinos XML de seus pacotes atuais estão sendo usadas para especificar outros locais, será preciso criar um novo Pacote de Localização do Serviço. As instruções são fornecidas nas etapas abaixo.
Associe o Pacote de Localização do Serviço aos containers nos quais residem os usuários ou estações de trabalho cujos relatórios você deseja enviar ao URL da Web.
Para ativar uma Diretiva de Destinos XML e associar containers a ela:
No ConsoleOne, clique o botão direito do mouse no Pacote de Localização do Serviço que deseja usar > clique em Propriedades.
ou
Se você não tiver um Pacote de Localização do Serviço, clique o botão direito do mouse no container onde deseja criá-lo > clique em Novo > clique em Pacote de Diretivas. Siga as instruções fornecidas no Assistente do Pacote de Diretivas para criar um Pacote de Localização do Serviço.
Na página Geral, marque a caixa na coluna Habilitado para habilitar a Diretiva de Destinos XML.
Selecione a Diretiva de Destinos XML na lista > clique em Propriedades para exibir a página de propriedades de Destinos XML.
Clique em Adicionar para exibir a caixa de diálogo URL de XML > digite o URL para onde os dados XML devem ser enviados > clique em OK para adicionar o URL à lista.
O URL para o servlet Relatório é:
http://ip_address/zfdamrServlet/run
onde ip_address é o endereço IP ou nome do host DNS do servidor onde o servlet Relatório está sendo executado.
Quando terminar de adicionar URLs, clique em OK para retornar à página Geral.
Clique em Associações para exibir a página Associações.
Use essa página para associar o Pacote de Localização do Serviço aos containers nos quais residem os usuários ou estações de trabalho cujos relatórios no XML deseja enviar ao URL da Web. Se um container pai inclui vários containers onde residem objetos Usuário e Estação de Trabalho, você pode selecionar o container pai em vez de cada container individual.
Clique em Adicionar > procure e selecione o container que deseja adicionar > clique em OK para adicioná-lo à lista.
Quando terminar de adicionar containers, clique em OK para gravar as informações.
Configurando objetos Aplicativo para usar os relatórios XML
Depois de habilitar a Diretiva de Destinos XML, você pode começar a configurar objetos Aplicativo para usar os relatórios XML. Como o relatório de eventos é configurado para cada aplicativo, você pode escolher para quais aplicativos deseja coletar relatórios de evento e para quais não deseja.
