CA Nimsoft Unified Reporter Guia de Instalação 6.5
Histórico da revisão do documento Versão do documento Data Alterações 1.0 Abril de 2013 Versão inicial para disponibilidade geral do UR 6.5.
Avisos legais Copyright 2013, CA. All rights reserved. Garantia O material contido neste documento é fornecido "como está" e está sujeito a alterações em edições futuras sem aviso prévio. Além disso, na medida permitida pela lei aplicável, a Nimsoft LLC isenta-se de todas as garantias, sejam implícitas ou expressas, com relação a este manual e todas as informações contidas no presente documento, incluindo, sem limitação, garantias implícitas de comerciabilidade e adequação para um determinado fim. A Nimsoft LLC não será responsabilizada por erros ou danos acidentais ou resultantes do fornecimento, uso ou desempenho deste documento ou de qualquer outra informação contida no presente. Caso a Nimsoft LLC e o usuário tenham um acordo por escrito à parte sobre termos de garantia que cobrem o material deste documento conflitando com estes termos, os termos de garantia do acordo à parte prevalecerão. Licenças de tecnologia O hardware e/ou software descritos neste documento são fornecidos sob uma licença e poderão ser usados ou copiados somente de acordo com os termos da referida licença. Nenhuma parte deste manual poderá ser reproduzida de qualquer forma ou por qualquer meio (incluindo a recuperação e o armazenamento eletrônico ou a tradução em um idioma estrangeiro) sem um acordo prévio e consentimento por escrito da Nimsoft LLC, em conformidade com as leis de direitos autorais internacional e dos EUA. Legenda de direitos restritos Se o uso do software for destinado ao cumprimento de um contrato ou subcontrato do governo dos Estados Unidos da América -EUA, o software será fornecido e licenciado como "software comercial para computadores", conforme definido no DFAR 252.227-7014 (junho de 1995), ou como um "item comercial", conforme definido no FAR 2.101(a); ou como "software de computador restrito", conforme definido no FAR 52.227-19 (junho de 1987) ou em qualquer regulamento equivalente do órgão ou Cláusula contratual. O uso, a duplicação ou a divulgação do software está sujeito aos termos de licença comercial padrão da Nimsoft LLC, os departamentos que não fazem parte do DOD (Department of Defense) e os órgãos do governo dos EUA não receberão mais Direitos do que os Direitos Restritos, conforme definido no FAR 52.227-19(c)(1-2) (junho de 1987). Os usuários do governo dos EUA não receberão mais que Direitos Limitados, conforme definido no FAR 52.227-14 (junho de 1987) ou no DFAR 252.227-7015 (b)(2) (novembro de 1995), conforme aplicável em quaisquer dados técnicos. Marcas registradas Nimsoft é uma marca registrada da CA. Adobe, Acrobat, Acrobat Reader e Acrobat Exchange são marcas registradas da Adobe Systems Incorporated. Intel e Pentium são marcas registradas da Intel Corporation dos EUA. Java(TM) é uma marca registrada da Sun Microsystems, Inc. dos EUA. Microsoft e Windows são marcas registradas da Microsoft Corporation dos EUA. Netscape(TM) é uma marca registrada da Netscape Communications Corporation dos EUA. Oracle é uma marca registrada da Oracle Corporation, Redwood City, Califórnia, Estados Unidos. UNIX é uma marca registrada do Open Group. ITIL é uma marca comercial registrada do Office of Government Commerce no Reino Unido e em outros países. Todas as marcas comerciais, nomes comerciais, marcas de serviços e logotipos mencionados neste documento pertencem às respectivas empresas.
Entrar em contato com a Nimsoft Para sua conveniência, o CA Nimsoft fornece um único site onde é possível acessar as informações sobre os produtos da CA Nimsoft. No endereço http://support.nimsoft.com/, é possível acessar o seguinte: Informações para contato online e telefônico, assistência técnica e atendimento ao cliente Informações sobre fóruns e comunidades de usuário Downloads de produto e documentação Políticas e diretrizes de suporte da CA Nimsoft Outros recursos úteis adequados ao seu produto Fazer uma avaliação Caso tenha algum comentário ou pergunta sobre a documentação de produtos da CA Nimsoft, envie uma mensagem para support@nimsoft.com.
Índice Capítulo 1: Introdução 7 Antes de instalar o UR... 7 Faça backup de seus bancos de dados... 7 Os usuários do Oracle precisam criar um novo espaço de tabela... 8 JVM Requirement... 8 Capítulo 2: Instalando o Unified Reporter 9 Instalar o Unified Reporter... 9 Configurar o servidor de email... 11 Capítulo 3: Desinstalar o Unified Reporter 13 Índice 5
Capítulo 1: Introdução O Unified Reporter é um componente opcional que oferece relatórios avançados para o UMP (Unified Management Portal). Você pode executar os relatórios prontos que são fornecidos ou criar seus próprios relatórios ad hoc. O UR está disponível para download no site de suporte da Nimsoft support.nimsoft.com. Observação: é necessário ter credenciais para acessar o site de suporte. Para solicitá-las, envie um email para support@nimsoft.com. Esta seção contém os seguintes tópicos: Antes de instalar o UR (na página 7) Antes de instalar o UR Execute as tarefas descritas nesta seção antes de instalar o UR. Faça backup de seus bancos de dados Antes de atualizar, é recomendável fazer backup do banco de dados do NIS e do banco de dados de repositório do UR. O backup desses bancos de dados garante que os dados de monitoramento e os Relatórios unificados que você tiver criado possam ser restaurados. Observação: o nome do banco de dados do NIS padrão é NimsoftSLM. O nome do banco de dados de repositório do UR padrão é jasperserver no UR 1.9 e unifiedreporter no UR 6.5. Capítulo 1: Introdução 7
Antes de instalar o UR Os usuários do Oracle precisam criar um novo espaço de tabela Válido para as instalações executadas pela primeira vez Quando você instala o UR pela primeira vez, o programa de instalação o orienta durante a configuração de uma conexão de banco de dados. Se seu provedor de banco de dados for Oracle, o instalador solicitará a inserção de um nome de usuário e uma senha para um espaço de tabela do Oracle. Não é possível usar o mesmo nome de usuário e senha da instalação do NM. Se isso ocorrer, o programa de instalação do UR exibirá uma mensagem de aviso e impedirá que você prossiga. Para concluir a instalação do UR, é preciso criar um novo nome de usuário e senha no servidor do Oracle e digitá-los no painel Conexão do banco de dados do programa de instalação. JVM Requirement Para executar o programa de instalação, é necessário ter a JVM (Máquina virtual Java) 1.6.x instalada no computador. Você pode verificar o suporte para versões da JVM baixando a Matriz de compatibilidade da Nimsoft. Para verificar se você tem uma JVM suportada, siga estas etapas: 1. No prompt de comando, insira o seguinte comando: java -version Se a versão mostrada for a 1.6.x, prossiga para a próxima seção. Se o comando falhar, siga para a próxima etapa. 2. Se você acredita que seu sistema tem a JVM versão 1.6.x, mas a etapa anterior falhou, verifique se a JVM faz parte da variável de ambiente PATH do sistema. 3. Caso não haja nenhum diretório no sistema para Java, instale-o da seguinte maneira: a. Obtenha uma cópia do Java no site http://www.java.com (não afiliado à Nimsoft) e instale-o de acordo com as instruções do site. b. Execute a etapa 2 para garantir que a JVM seja incluída na variável de ambiente PATH. Importante: Certifique-se de obter o pacote certo para o seu sistema operacional (32 ou 64 bits). Por exemplo, um sistema operacional de 64 bits requer uma JVM de 64 bits. 8 Guia de Instalação
Capítulo 2: Instalando o Unified Reporter Esta seção descreve como instalar o UR. Esta seção contém os seguintes tópicos: Instalar o Unified Reporter (na página 9) Configurar o servidor de email (na página 11) Instalar o Unified Reporter É possível implantar o UR em qualquer robô onde o UMP está instalado e em execução. Entretanto, o programa de instalação deve ser executado no sistema que executa o hub principal. Siga estas etapas: 1. Efetue logon no site Central de atendimento ao cliente da CA Nimsoft. 2. Faça download do pacote de instalação do para seu SO. 3. Execute o programa de instalação no sistema que executa o hub principal: Windows: clique duas vezes no arquivo InstallUR.exe Linux:./installUR_linux.bin -i [gui console] Solaris:./installUR_solaris.bin -i [gui console] O modo de GUI inicia o assistente de instalação e o modo de console executa o programa de instalação no modo de linha de comando. Ao iniciar o programa de instalação a partir da linha de comando, sempre inclua os argumentos -i gui ou console. As instruções a seguir pressupõem que você esteja executando a instalação no modo gui, embora ambos os modos solicitem as mesmas informações. 4. Clique em Avançar no painel Introdução. 5. Vá até o local de instalação do Nimsoft Monitor. Por padrão, o NM é instalado nos seguintes locais: Windows 32-bit: C:\Arquivos de programas\nimsoft Windows 64-bit: C:\Arquivos de programas (x86)\nimsoft Linux: /opt/nimsoft Solaris: /opt/nimsoft Capítulo 2: Instalando o Unified Reporter 9
Instalar o Unified Reporter 6. Digite o nome de usuário e a senha para o usuário administrativo do NM. 7. Selecione o robô do Nimsoft Monitor na lista Robô no qual deseja instalar o Unified Reporter. Observação: Se estiver atualizando, uma caixa de diálogo informa sobre uma instância existente do UR no robô selecionado. Clique em Prosseguir e, em seguida, vá para a etapa 10. Se a caixa de diálogo Atualização/reinstalação inválida for exibida, você está tentando uma atualização que não é suportada. Para visualizar o caminho de atualização com suporte, consulte a Matriz de compatibilidade do Nimsoft no site: http:http://support.nimsoft.com/downloads/doc/nmscompatibility_supp ortmatrix_current.pdf. 8. Atualize o local do data_engine, se o local exibido não estiver correto. 9. No painel Conexão do banco de dados: Microsoft SQL: você pode selecionar Autenticação do banco de dados ou Autenticação do Windows NT. Oracle: é preciso digitar o nome de usuário e a senha para um novo espaço de tabela, e não o usuário configurado para o data_engine. Caso contrário, o programa de instalação não permitirá que você continue. Depois de concluído o painel Conexão do banco de dados, o sistema exibe um resumo das informações sobre a instalação. Vá para a etapa 10. MySQL: clique em Avançar. 10. [Apenas para o Microsoft SQL e o MySQL]: selecione o botão de opções apropriado no painel Esquema do banco de dados. 11. [Apenas para o Microsoft SQL e o MySQL]: digite ou selecione um esquema de banco de dados ou o nome do catálogo. Observação: se você clicar na seta para voltar no navegador após a criação de um novo esquema/catálogo e, em seguida, selecionar novamente Criar um esquema/catálogo, o sistema não permitirá o uso do mesmo nome uma segunda vez. Nesse caso, selecione Use um esquema/catálogo existente para usar o nome criado anteriormente. 12. No painel de resumo sobre a instalação, clique em Instalar se estiver satisfeito com as informações exibidas. Clique em Voltar para editar as informações nos painéis anteriores. Um painel com barras de status é exibido durante a instalação do Unified Reporter. Quando a instalação estiver concluída, é exibida uma caixa de diálogo informando que a instalação foi realizada com êxito. 13. Clique em Concluído. 10 Guia de Instalação
Configurar o servidor de email O Unified Reporter está instalado e pronto para uso. Consulte o Guia de Início Rápido do Unified Reporter, disponível em docs.nimsoft.com, para obter uma introdução ao UR, e para obter informações sobre como configurar o ireport. Configurar o servidor de email Se você programar relatórios ou executá-los em segundo plano, é possível especificar endereços de email para notificação quando o relatório for concluído. Para usar este recurso, você deve configurar o JasperReports Server para estabelecer comunicação com um servidor de email. Siga estas etapas: 1. Localize o arquivo js.quartz.properties no diretório a seguir no sistema em que o UR estiver implantado: <Nimsoft>/probes/service/wasp/webapps/jasperserver-pro/WEB-INF/js.quartz.pro perties. 2. Abra o arquivo js.quartz em um editor de texto. 3. Edite os valores das propriedades no arquivo js.quartz usando as tabelas abaixo. Observação: para configuração do servidor de email, é preciso definir uma propriedade adicional para autenticação. O arquivo está localizado no sistema em que o UR foi implantado no seguinte diretório: <Nimsoft>/probes/service/wasp/webapps/jasperserver-pro/WEB-INF/applicationC ontext-report-scheduling.xml. 4. Reinicie o JasperServer. Propriedade <Nimsoft>/probes/service/wasp/webapps/jasperserver-pro/WEB-INF/js.quartz.prope rties Descrição report.scheduler.mail.sender.host report.scheduler.mail.sender.username report.scheduler.mail.sender.password report.scheduler.mail.sender.from report.scheduler.mail.sender.protocol O nome do computador que hospeda o servidor de email. O nome do usuário do servidor de email que o JasperReports Server pode usar. A senha do usuário do servidor de email. O endereço que aparece no campo De das notificações por email. O protocolo que o servidor de email usa. O JasperReportsServer oferece suporte apenas a SMTP. Observação: a entrada deve estar em letras minúsculas. Por exemplo, smtp. Capítulo 2: Instalando o Unified Reporter 11
Configurar o servidor de email report.scheduler.mail.sender.port O número da porta que o servidor de email usa. Para SMTP, o padrão normalmente é 25 (valores diferentes de 25 podem não funcionar em versões anteriores do JasperServer). <Nimsoft>/probes/service/wasp/webapps/jasperserver-pro/WEB-INF/applicationCon text-report-scheduling.xml Propriedade Bean Descrição javamailproperties key="mail.smtp.auth" reportscheduler MailSender Se o servidor de email requer autenticação, altere esta propriedade de false para true. 12 Guia de Instalação
Capítulo 3: Desinstalar o Unified Reporter Desinstale o UR ao executar o programa de desinstalação no sistema que executa o hub principal. Em sistemas Windows, o programa de desinstalação pode ser iniciado a partir de atalhos do menu Iniciar ou é possível executar o arquivo <Nimsoft>/UnifiedReporter/Uninstall_UnifiedReporter. O programa de desinstalação atualiza a configuração do probe wasp, de forma que Unified Reporter não esteja mais disponível para configuração ou inicialização. O programa de desinstalação não remove as tabelas de banco de dados que oferecem suporte ao UR. Portanto, se for necessário remover os arquivos de UR, eles devem ser removidos manualmente. Para remover manualmente arquivos de UR: 1. Abra o Gerenciador de infraestrutura. 2. Na exibição em árvore, clique no robô do hub onde o UMP e o UR estão instalados. 3. Clique com o botão direito no probe wasp, no painel superior direito e selecione a opção Desativar no menu pop-up. 4. Remova o UR do probe wasp seguindo estas etapas: a. Clique no probe wasp para selecioná-lo. b. Pressione <Ctrl> e clique com o botão direito do mouse no probe wasp. Em seguida, selecione a opção Raw Configure no menu pop-up. c. Expanda o nó webapps. d. Clique na pasta jasperserver-pro para selecioná-la. e. Clique em Delete Section. 5. Remova os seguintes arquivos (se existirem) do robô em que o UR foi implantado: <nimsoft>/probes/service/wasp/tmp <nimsoft>/probes/service/wasp/bin <nimsoft>/probes/service/wasp/tmp_jasper.zip <nimsoft>/probes/service/wasp/webapps/jasperserver-pro <nimsoft>/probes/service/wasp/webapps/jasperserver-pro.war 6. Ative o probe wasp. Capítulo 3: Desinstalar o Unified Reporter 13