Instalação do Servidor AX com Oracle

Transcrição

1 Instalação do Servidor AX com Oracle Versão: 6.5 Publicado em: quarta-feira, 15 de março de 2017 ACL Services Ltd. 2017

2

3 Índice Índice Índice 3 Introdução 7 Público-alvo 7 Máquinas obrigatórias 7 Tarefas pré-instalação 9 Reunindo recursos de instalação 10 Serviços de Suporte ACL 10 Contato primário da ACL 10 Administrador de banco de dados 10 Equipe de TI 11 Portas do Servidor AX 12 Verificação das portas em uso 12 Portas exigidas pelo Servidor AX 12 Configuração do firewall 13 Download dos instaladores do Analytics Exchange 15 Instaladores disponíveis 15 Etapas de download 15 Instalação 17 Configuração do servidor de banco de dados Oracle 18 Preparar o banco de dados 18 Executar os scripts SQL de tablespace e usuário 18 Executar os scripts SQL do esquema de criação de banco de dados 18 Instalar o Servidor AX para Oracle 20 Pré-requisitos 20 Instalar o Servidor AX 20 Tarefas pós-instalação 27 Verificar se o Servidor AX está sendo executado 28 Verificar o log do Serviço do Analytics Exchange 28 Verificar os serviços do Servidor AX 28 Página 3 de 79

4 Índice Verificação dos aplicativos do Servidor AX 28 Ativar o Servidor AX 30 Ativação on-line 30 Ativação off-line 30 Adicionar um administrador do Servidor AX 32 Configurar o diretório de arquivamento e restauração 33 Verificando as conexões de aplicativos do cliente 34 Pré-requisitos 34 Verificações de conexões de aplicativos 34 Configuração do Python para uso com o Servidor AX 36 Como funciona? 36 Instale o Python versão 3.5.x (32 bits) 36 Defina a variável de ambiente PYTHONPATH 36 Instalação do Nó do Motor AX (opcional) 39 Instalar o Nó do Motor AX para Oracle 40 Pré-requisitos 40 Instalar o Nó do Motor AX 40 Pós-requisitos 43 Configuração de uma pasta de dados compartilhada 44 Uso de pastas de dados compartilhadas 44 Configuração de uma pasta compartilhada no Windows Configuração de Nós do Motor AX 45 Como funciona? 45 Configuração de Nós do Motor AX 45 Configuração de Nós do Motor AX 46 Certificados de segurança 49 Como funciona? 49 Uso dos certificados autoassinados para o Servidor AX 49 Certificados do Nó do Motor AX 50 Conexões PostgreSQL 50 Instalação de certificados de segurança 52 Ferramentas e conhecimento necessário 52 Página 4 de 79

5 Índice Faça backup da configuração de servidor do aplicativo TomEE antes de começar 52 Processo do lado do servidor 53 Processo no lado do cliente 55 Anexo 57 Requisitos do Servidor AX 58 Hardware 58 Software 59 Pré-requisitos instalados automaticamente 59 Pré-requisitos incluídos no servidor Windows 61 Servidor de banco de dados 61 Requisitos do Nó do Motor AX 63 Hardware 63 Software 63 Pré-requisitos instalados automaticamente 64 Pré-requisitos incluídos no servidor Windows 65 Backup e restauração do Oracle 66 Estratégias de backup 66 Do que fazer backup 67 Backup de dados do Servidor AX 67 Restauração de dados do Servidor AX 68 Execução de scripts de banco de dados Oracle 70 Execução de scripts do banco de dados 70 Configuração de conta de serviços 71 Nomes dos serviços 71 Serviço do Analytics Exchange 71 Analytics Exchange Connector 72 Banco de dados do Analytics Exchange 72 Autenticação do Analytics Exchange 74 Tipos de autenticação 74 Escolha de um método de autenticação 74 Atribuição de direitos para o serviço do Conector do AX 75 Atribuição de acesso de leitura e gravação à pasta de instalação do AX Connector 75 Página 5 de 79

6 Índice Conceda direitos de controle total ao executável do AX Connector (aclse.exe). 75 Direitos de Permitir logon local 76 Configurar a Autenticação Integrada do Windows 77 Criação de uma conta SPN 77 Mapeamento do serviço de autenticação para a conta SPN 77 Registro de um SPN para o serviço AX Connector 78 Teste do mapeamento da conta SPN 78 Habilitação da Autenticação Integrada do Windows a partir do Internet Explorer 79 Página 6 de 79

7 Introdução Introdução Este guia destina-se a orientar você durante o processo de instalação do Servidor AX com um servidor de banco de dados do Oracle. O conteúdo deste guia são limitados à instalação e configuração inicial. Para obter informações adicionais sobre manutenção do Servidor AX e uso do Analytics Exchange, visite os Documentos on-line da Ajuda do ACL. Público-alvo Este guia é escrito para administradores do Servidor AX responsáveis pela instalação e configuração do Analytics Exchange para suas organizações. Máquinas obrigatórias Para usar um servidor de banco de dados do Oracle, você precisa instalar o banco de dados em uma máquina diferente da do Servidor AX. Página 7 de 79

8

9 Tarefas pré-instalação Tarefas pré-instalação Página 9 de 79

10 Tarefas pré-instalação Reunindo recursos de instalação Antes de começar a instalar ou atualizar o Servidor AX, identifique os principais contatos necessários para obter ajuda e informações para o processo de instalação. Serviços de Suporte ACL Entre em contato com os Serviços de Suporte ACL se encontrar problemas que não puder resolver durante a instalação ou a atualização. Antes de entrar em contato com o suporte da ACL, verifique se você tem as seguintes informações: A versão específica do Servidor AX sendo instalada ou atualizada Detalhes sobre o banco de dados (PostgreSQL ou Oracle) usado com o Servidor AX Todas as mensagens de erro ou aviso encontrados Você pode entrar em contato com os Serviços de Suporte ACL de diversas formas: enviando um ticket de suporte on-line (método preferido) bate-papo ao vivo (support@acl.com) telefone Contato primário da ACL Para fazer o download do pacote de instalação do Servidor AX no Launchpad, você precisa ter uma conta válida do Launchpad. Se você é o contato primário da sua empresa, deve ter recebido um de boas-vindas da ACL com instruções para fazer login na sua conta. Se você não recebeu o , ou se precisa de mais ajuda, entre em contato com os Serviços de Suporte ACL. Se você não é o contato primário, deve ter recebido instruções por quando foi adicionado ao Launchpad pelo contato primário. Se você não recebeu as instruções, entre em contato com o contato primário da empresa ou com o administrador de contas da ACL. Administrador de banco de dados Se a sua empresa tem um administrador de banco de dados, ele terá informações importantes necessárias para instalar e configurar o Servidor AX. Página 10 de 79

11 Tarefas pré-instalação Equipe de TI Se a sua empresa tem uma equipe de TI que administra serviços como acesso à rede, armazenamento de arquivos e políticas de segurança, ela poderá ter informações necessárias para concluir a instalação. Também pode ocorrer que a equipe precise executar tarefas como criar contas de usuário do Active Directory e modificar regras de firewall. Página 11 de 79

12 Tarefas pré-instalação Portas do Servidor AX Para que o Serviço do Analytics Exchange inicie corretamente no servidor do Servidor AX ou no Nó do Motor AX, verifique se as portas exigidas pelo servidor de aplicativos TomEE não estão sendo utilizadas por outros serviços ou aplicativos. Verificação das portas em uso Em um prompt de comando, use o comando NETSTAT para exibir as portas em uso: NETSTAT -a Se as portas necessárias estão sendo usadas por outro serviço, execute uma das etapas a seguir: reconfigure o serviço para usar uma porta diferente desative temporariamente o serviço em Serviços do Windows durante a instalação do Servidor AX Se necessário, modifique algumas portas utilizadas pelo Servidor AX após a conclusão do processo de instalação. Ao instalar o Servidor AX ou o Nó do Motor AX pela primeira vez em um servidor, verifique se as portas exigidas pelo servidor de aplicativos TomEE não estão sendo usadas antes de executar o instalador. Portas exigidas pelo Servidor AX O Servidor AX e o Nó do Motor AX são instalados com as configurações padrão de porta utilizadas pelo Serviço do Analytics Exchange. Porta Componente Criptografia Descrição 8009 Tomcat Connector AJP Não SSL A porta utilizada para conexão com o servidor de aplicativos TomEE 80 Tomcat Connector HTTP Não SSL Porta utilizada para comunicação HTTP não criptografada com o servidor. 443 Tomcat Connector HTTPS SSL Porta utilizada para comunicação criptografada HTTP (HTTPS) com o servidor. Se você está atualizando uma versão anterior do Servidor AX, a porta Página 12 de 79

13 Tarefas pré-instalação Porta Componente Criptografia Descrição padrão é PostgreSQL Compatível No instalador do Servidor AX, você pode especificar uma porta diferente que não está em uso. Se você estiver configurando uma instalação de dois servidores, verifique se o PostgreSQL e o servidor de aplicativos do Servidor AX conseguem se comunicar por essa porta Conector do AX TwoFish 128 bits Se essa porta estiver sendo usada, você poderá especificar uma porta diferente sem uso no instalador do Servidor AX. Esse serviço é usado principalmente para acessar as tabelas do Servidor AX que foram exportadas para os projetos do ACL Analytics Nó do Motor AX Não SSL Usado para conectar o Nó do Motor AX ao Servidor AX mestre. Se o Nó do Motor AX e o Servidor AX estiverem se comunicando por meio de um firewall, essa porta deverá estar aberta Banco de dados Oracle Não SSL Porta utilizada para comunicação descriptografada com o banco de dados do Oracle. Sua equipe de TI estipulará qual porta é necessária quando o Oracle for usado como servidor do banco de dados do Servidor AX. A porta pode ser alterada depois de concluir a instalação, se necessário Banco de dados Oracle SSL Porta utilizada para comunicação criptografada com o banco de dados do Oracle. Sua equipe de TI estipulará qual porta é necessária quando o Oracle for usado como servidor do banco de dados do Servidor AX. A porta pode ser alterada depois de concluir a instalação, se necessário ACL Connector para Analytics Exchange SSL Por usada para estabelecer uma conexão ODBC aos resultados de análise. Essa porta somente será necessária se você instalar o serviço opcional ACL Connector para Analytics Exchange. Configuração do firewall Para conexão ao Servidor AX de fora do firewall da rede, é necessário permitir conexões de entrada nas portas a seguir: Página 13 de 79

14 Tarefas pré-instalação Porta Componente Descrição 443 Tomcat Connector HTTPS Conector do AX 4201 Nó do Motor AX Usado para habilitar conexões HTTPS ao servidor Web dos aplicativos web Cliente Web AX e Configuração do Servidor AX e para transferências seguras de arquivos de e para o Servidor AX. O valor padrão para servidores atualizados de versões anteriores à é Usado para permitir o acesso às tabelas do Servidor AX a partir de computadores clientes por meio do ACL Analytics. Usado para conectar o Nó do Motor AX ao Servidor AX mestre. Se o Nó do Motor AX e o Servidor Server estiverem se comunicando por um firewall, você deverá abrir essa porta. Cada computador cliente que se conecta ao Servidor AX também deve ter as portas correspondentes abertas para comunicação de saída. Página 14 de 79

15 Tarefas pré-instalação Download dos instaladores do Analytics Exchange Faça o download dos instaladores no Launchpad para poder instalar o Analytics Exchange. Você deve ser capaz de fazer login em uma conta do Launchpad ( para fazer o download dos instaladores do Analytics Exchange e ativar o Servidor AX. Instaladores disponíveis Os instaladores para os seguintes aplicativos do Analytics Exchange estão disponíveis no Launchpad: Servidor AX (contém instaladores para o Servidor AX e o PostgreSQL) Nó do Motor AX Atualização de compatibilidade do ACL Analytics para o Servidor AX (se for o caso) Cliente AX Direct Link Etapas de download A página de download do instalador fornece a versão mais recente do Analytics Exchange. Se você precisa de um instalador para uma versão anterior, você deve entrar em contato com os Serviços de Suporte ACL para obter uma cópia do instalador para aquela versão 1. Faça login no Launchpad ( e clique em Analytics Exchange. Um com instruções de login será enviado de notifications@aclgrc.com para a conta do administrador do ACL da sua empresa. Se você não conseguir fazer login em usa conta do Launchpad, entre em contato com o administrador de contas do ACL da empresa ou com os Serviços de Suporte ACL para obter auxílio. 2. Na lista suspensa Pacote de software para download, selecione o instalador para baixar. Certifique-se de baixar a edição correta (não Unicode ou Unicode), pois todos os aplicativos instalados devem usar a mesma edição. 3. Clique em Download <Versão> e salve o instalador no computador onde planeja instalar o aplicativo. Página 15 de 79

16

17 Instalação Instalação Página 17 de 79

18 Instalação Configuração do servidor de banco de dados Oracle Prepare o servidor do seu banco de dados Oracle e execute os scripts SQL do Servidor AX. Você deve concluir a instalação do Oracle antes de instalar o Analytics Exchange. O servidor de banco de dados e o Servidor AX não podem residir na mesma máquina. Preparar o banco de dados Configure uma instância do banco de dados Oracle para o Servidor AX e, se necessário, configure o servidor do banco de dados para permitir conexões criptografadas entre o servidor do banco de dados e o Servidor AX. Depois de instalar o Servidor AX, você pode precisar importar o certificado do servidor do banco de dados para o armazenamento de chaves do Servidor AX. Executar os scripts SQL de tablespace e usuário O administrador de banco de dados deve executar os scripts a seguir antes de instalar o Servidor AX: CREATE_AX_TABLESPACE.sql: define a alocação física de espaço para o banco de dados do Analytics Exchange CREATE_DATABASE_USER.sql: cria o usuário de banco de dados do Analytics Exchange As variáveis a seguir devem ser definidas para o CREATE_DATABASE_USER.sql: V_USER V_USERPWD Para obter mais informações, consulte "Execução de scripts de banco de dados Oracle" Na página 70. Executar os scripts SQL do esquema de criação de banco de dados Execute scripts SQL adicionais para criar o esquema de banco do dados do Servidor AX, em vez de contar com o assistente de instalação do Servidor AX para criar o esquema. Criar Schema.sql CreateQuartzTables.sql Criar Core Data.sql Página 18 de 79

19 Instalação Para obter mais informações, consulte "Execução de scripts de banco de dados Oracle" Na página 70. Página 19 de 79

20 Instalação Instalar o Servidor AX para Oracle Para instalar o Servidor AX para Oracle, o servidor de banco de dados já deve estar instalado em uma máquina física separada. Pré-requisitos Antes de instalar o Servidor AX para Oracle, prepare o servidor do banco de dados e execute os scripts SQL incluídos no instalador. Para obter mais informações, consulte "Configuração do servidor de banco de dados Oracle" Na página 18 Instalar o Servidor AX Cuidado Você deve instalar as atualizações do Windows KB antes de iniciar a instalação do Analytics Exchange no Windows Server 2012 R2. Se você não instalar esta atualização, sua instalação do Analytics Exchange não será concluída com sucesso. Executar o instalador e selecionar a configuração do banco de dados 1. Clique duas vezes no pacote de instalação. Se for exibida uma caixa de diálogo com um aviso de segurança, verifique as informações listadas e clique em Sim. 2. Selecione o idioma da instalação e clique em OK. 3. Na página Localização para extrair arquivos de instalação, especifique a pasta onde os arquivos de instalação serão extraídos e clique em Instalar. Dica Clique em Procurar para selecionar uma pasta ou aceite o local padrão: C:\Arquivos de Programas (x86)\acl Software\Installers\ACLAX<versão>_Server_ <edição>. 4. Clique em Sim na caixa de diálogo com a mensagem sobre o motor do banco de dados. 5. Na página Opções de configuração do Servidor do Analytics Exchange, selecione Oracle e clique em Avançar. Página 20 de 79

21 Instalação 6. Se for solicitada a instalação de pré-requisitos, clique em Instalar e aguarde a instalação dos prérequisitos. Siga as instruções na tela para concluir a instalação dos pré-requisitos. Pode ser necessário reiniciar o computador depois de reinstalar os prerrequisitos. Configure seus serviços do Analytics Exchange 1. Se for solicitada a instalação de pré-requisitos, clique em Instalar e aguarde a instalação dos prérequisitos. Siga as instruções na tela para concluir a instalação dos pré-requisitos. Pode ser necessário reiniciar o computador depois de reinstalar os prerrequisitos. O sistema pode solicitar que você aceite os termos e condições para o.net Framework ao instalar prerrequisitos. Nesse caso, a caixa de diálogo de termos e condições pode aparecer oculta atrás da caixa de diálogo do instalador do Analytics Exchange. Ao instalar o.net Framework, verifique se o instalador não está aguardando sua entrada. 2. Na página Bem-vindo, clique em Avançar. Na página Contrato de licença, selecione Eu aceito os termos do contrato de licença e clique em Avançar. 3. Na página Pastas de destino e configurações, especifique onde os arquivos do aplicativo do Servidor AX serão instalados e o local onde os dados do Servidor AX serão armazenados. Se necessário, clique em Modificar para modificar um ou ambos os locais padrão. Os caminhos especificados não devem incluir espaços, e a localização especificada para os dados do Servidor AX deve ter disponibilidade de espaço em disco suficiente. Se você quiser armazenar dados do Servidor AX em um servidor de arquivos dedicado ou em outro local da rede, será necessário configurar uma pasta compartilhada após concluir a instalação. A pasta compartilhada não pode ser especificada no instalador do Servidor AX. 4. No painel Número da porta do Conector do Analytics Exchange, insira o número da porta do Conector do AX a ser usada, ou aceite o valor padrão de O serviço Conector do AX é utilizado principalmente para acessar tabelas do ACL no Servidor AX a partir do ACL Analytics. 5. No painel Conta do serviço Tomcat do Analytics Exchange, faça o seguinte: a. Insira o domínio e o nome de usuário da conta no formato domínio\nomeusuário ou clique em Pesquisar para localizar o domínio e o nome de usuário. Se você pesquisar por nome de conta, insira ou selecione antes o domínio ou o nome do servidor na caixa de diálogo Pesquisar por conta de usuário, para que o instalador mostre a lista apropriada de contas de usuário disponíveis. Página 21 de 79

22 Instalação Não há suporte para executar o serviço TomEE utilizando uma conta de usuário local. Essas contas não têm os privilégios adequados para executar alguns comandos do ACL. b. Insira a Senha da conta. c. Clique em Avançar. d. Se solicitado a conceder a permissão "Fazer logon como um serviço" para a conta do serviço Tomcat, clique em Sim e em OK. Para obter informações sobre as opções de configuração das contas de serviço, consulte "Configuração de conta de serviços" Na página 71. Definir as configurações de conexão do banco de dados 1. Na página Configurar o banco de dados do ACL Analytics Exchange, certifique-se de que Oracle 11 ou superior está marcado e execute uma das ações a seguir: o o Selecione Criar um novo banco de dados se estiver usando o instalador do Servidor AX para criar o esquema do banco de dados do Analytics Exchange. Selecione Utilizar um banco de dados existente se o administrador de banco de dados Oracle já criou o esquema do banco de dados do Analytics Exchange. 2. Opcional. Para criptografar comunicações de banco de dados entre o Analytics Exchange e o Oracle, marque Criptografar comunicação do banco de dados e clique em Avançar. Para criptografar a conexão, é necessário configurar o servidor de banco de dados do Oracle para conexões SSL. Dica A criptografia reduz um pouco o desempenho. Portanto, ative-a apenas se dados são transferidos entre o servidor de banco de dados e o servidor de aplicativos por meio de uma rede não protegida. 3. Se você marcou Criptografar comunicação do banco de dados, clique em Avançar na caixa de diálogo com a mensagem sobre a porta SSL do Oracle. A porta SSL do Oracle deve ter sido configurada corretamente por um administrador de banco de dados Oracle para que a instalação possa prosseguir. 4. Na página Configurações de conexão do banco de dados Analytics Exchange, insira as seguintes informações para configurar a cadeia de conexão: Campo Servidor de banco de dados Descrição O endereço IP ou nome do servidor onde o servidor de banco de dados está localizado. Página 22 de 79

23 Instalação Campo Nome do serviço Porta não SSL Porta SSL Nome de usuário Senha Descrição O nome do banco de dados global da instância do banco de dados a ser usada. Porta usada para conexões HTTP padrão com o banco de dados do Analytics Exchange. O valor padrão é A porta usada para conexões SSL com o banco de dados do Analytics Exchange. Esse campo somente está disponível se a opção Criptografar comunicação com o banco de dados foi marcada. O valor padrão é O nome da conta de usuário usada para acessar o banco de dados do Analytics Exchange. A senha da conta de usuário. Para verificar as informações de conexão, clique em Testar conexão e clique em Avançar. Se estiver usando SSL, a conexão de teste pode falhar. Continue com a instalação e importe seu certificado de segurança para o armazenamento de chaves do Servidor AX depois de concluir a instalação. Para obter mais informações, consulte "Tarefas pós-instalação" Na página 27. Configurar segurança e autenticação 1. Na página Detalhes da conexão do Microsoft Active Directory, verifique se o valor padrão que será utilizado na caixa de texto Domínio padrão está correta ou digite o valor correto e, em seguida, clique em Avançar. O valor de domínio padrão é o domínio onde os usuários finais são autenticados, caso não tenham especificado um domínio ao fazer login utilizando autenticação baseada em formulário. Por exemplo, se um usuário inserir jsmith como nome de usuário, e se o domínio padrão for ACL, isso equivale a inserir acl\jsmith. 2. Na página Autenticação do Analytics Exchange, selecione o método de autenticação adequado: Autenticação baseada em formulário: selecione essa opção se desejar que os usuários insiram o nome de usuário e senha a cada vez que iniciarem uma nova sessão com o Analytics Exchange. Uma sessão é criada quando uma nova janela do navegador da web é aberta ou quando o Cliente AX é iniciado. Autenticação integrada do Windows: selecione essa opção caso deseje que os usuários sejam autenticados silenciosamente por aplicativos do Analytics Exchange com base na conta de usuário usada para fazer login no Windows. As contas de usuário que pertencem ao domínio configurado do Active Directory não precisam inserir o nome de usuário e senha ao acessar aplicativos do Analytics Exchange. Para obter mais informações sobre as opções de autenticação e a configuração exigida, consulte "Autenticação do Analytics Exchange" Na página 74. Página 23 de 79

24 Instalação 3. Especifique os detalhes de configuração da autenticação do Servidor AX executando uma das seguintes ações e clique em Avançar: Se você selecionou Autenticação baseada em formulário, especifique o nome do host do servidor onde o Servidor AX está instalado. Por exemplo: AX.ACL.COM. Se você tiver selecionado Autenticação Integrada do Windows, insira as seguintes informações: Nome do host do Servidor do Analytics Exchange: especifique o nome do host do servidor onde o Servidor AX está instalado. Por exemplo: AX.ACL.COM Domínio do Active Directory especifique o domínio do Active Directory a usar para autenticar usuários Endereço IP do controlador de domínio do Kerberos o endereço IP da localização do controlador de domínio do Active Directory da organização Senha do serviço Kerberos a senha para a conta do nome da entidade do serviço (SPN) no Active Directory 4. Se você já tem um certificado de segurança SSL, execute as ações a seguir na página Informações do certificado SSL: a. Selecione Usar arquivo de armazenamento de chaves existente e navegue até o arquivo de armazenamento de chaves no computador. b. Insira a senha do armazenamento de chaves existente. 5. Na página Informações do certificado SSL, insira as informações a seguir e clique em Avançar: Campo Nome do servidor Nome do departamento ou da divisão Nome da organização Nome da cidade Nome do estado/província Código do país Descrição O nome do host do servidor de banco de dados. Por exemplo: ax.acl.com. A divisão ou unidade de negócios para a qual o certificado é emitido. Por exemplo: Desenvolvimento. Nome da sua empresa ou organização. Por exemplo: ACL Services Ltd.. Cidade ou local onde a empresa ou organização está localizada. Por exemplo: Vancouver. Estado ou província onde a empresa ou a organização está localizada. Por exemplo: BC. Código de dois caracteres do país onde a empresa ou organização está localizada. Por exemplo: CA. Insira uma senha de no mínimo 6 caracteres. Senha do armazenamento de chaves Senha da chave privada Se você estiver usando um arquivo de armazenamento de chaves existente, essa instância da caixa de texto Senha do armazenamento de chaves será desativada. Insira novamente a mesma senha. A Senha do armazenamento de chaves e a Senha da chave privada devem ser idênticas. Página 24 de 79

25 Instalação Para obter informações sobre a utilização desse certificado e as opções de configuração, consulte "Certificados de segurança" Na página Na página Insira o nome de usuário e senha do console do Tomcat, insira as informações a seguir e clique em Avançar: Nome de usuário: insira o nome de usuário que quer usar para acessar e administrar o Tomcat Web Application Manager e o aplicativo web Configuração do Servidor AX Senha: insira uma senha para o nome de usuário Confirmar senha: insira a senha novamente para confirmá-la Finalizar a instalação 1. Clique em Instalar. Antes do processo de instalação ser concluído, será necessário aguardar cerca de um minuto enquanto o servidor de aplicativos TomEE fica totalmente funcional. A janela de comando pode ser exibida intermitentemente durante este período de tempo. Não cancele a instalação. 2. Quando o processo de instalação for concluído, clique em Finalizar para sair do instalador. O aplicativo web Configuração do Servidor AX é exibido automaticamente no navegador da web padrão após a conclusão do instalador. Você deve concluir as tarefas pós-instalação no aplicativo web para que o Servidor AX fique totalmente funcional. Para obter mais informações, consulte "Tarefas pós-instalação" Na página 27. Se o aplicativo web Configuração do Servidor AX exibir um erro no navegador da web, aguarde dois ou três minutos antes de recarregar a página. Dependendo do hardware do seu servidor, os serviços necessários podem levar alguns minutos para ficarem totalmente funcionais. Se você fechar o aplicativo web Configuração do Servidor AX antes de concluir todas as tarefas pós-instalação, poderá acessá-lo novamente em um navegador da web. O local padrão é onde <nomedoservidor> é o nome do host ou o endereço IP do Servidor AX. Por exemplo: Página 25 de 79

26

27 Tarefas pós-instalação Tarefas pós-instalação Conclua as tarefas a seguir para finalizar a instalação do Servidor AX. Dependendo da configuração do Servidor AX, algumas dessas tarefas podem ser opcionais. Se você tiver componentes em diversos servidores, pode ser necessário concluir as tarefas em cada máquina. Tarefa Localização Detalhes Se você estiver usando um servidor de banco de dados Oracle com comunicação criptografada, importe seu certificado de segurança para o armazenamento de chaves do Servidor AX. O servidor que hospeda o Servidor AX Dependendo do seu certificado, você pode precisar importar o certificado para o armazenamento de chaves do Servidor AX antes de estabelecer uma conexão entre o Servidor AX e o banco de dados. Verificar se o Servidor AX está sendo executado O servidor que hospeda o Servidor AX Consulte "Verificar se o Servidor AX está sendo executado" Na página seguinte. Ativar o Servidor AX Launchpad ( Consulte "Ativar o Servidor AX" Na página 30. Adicionar um administrador do Servidor AX Aplicativo web Configuração do Servidor AX ( Servidor AX>/aclconfig) Consulte "Adicionar um administrador do Servidor AX" Na página 32 Configurar o diretório de arquivamento e restauração Aplicativo web Configuração do Servidor AX Consulte "Configurar o diretório de arquivamento e restauração" Na página 33. Verificar as conexões de aplicativos cliente Computadores cliente do Analytics Exchange Consulte "Verificando as conexões de aplicativos do cliente" Na página 34 Instale e configure o Python se você pretende usar a integração do Python nos scripts de Análise O servidor que hospeda o Servidor AX e qualquer máquina que abriga uma instância do Nó do Motor AX. Consulte "Configuração do Python para uso com o Servidor AX" Na página 36 Definir a configuração de tempo limite do aplicativo para o Cliente AX Por padrão, o aplicativo encerra quando fica ocioso por 30 minutos. Você pode alterar essa configuração de tempo ocioso máximo no arquivo de configuração aclau- Página 27 de 79

28 Tarefas pós-instalação Tarefa Localização Detalhes ditexchange.xml. Página 28 de 79

29 Tarefas pós-instalação Verificar se o Servidor AX está sendo executado Verifique se o Servidor AX está sendo executado conferindo o log de serviços, os serviços e o Tomcat Web Application Manager. Verificar o log do Serviço do Analytics Exchange Para verificar se o Serviço do Analytics Exchange está sendo executado, no subdiretório TomCat/logs do Servidor AX, abra o arquivo TomEE.date.log e examine as entradas do log. Um novo arquivo de log é criado sempre que o serviço é iniciado/reiniciado ou quando o arquivo excede o tamanho máximo especificado. Verificar os serviços do Servidor AX O status de cada serviço do Windows do Servidor AX deve ser "Iniciado" ou "Executando". Se você instalou componentes do Servidor AX em mais de um servidor, verifique os serviços em todos os servidores. 1. No servidor onde são executados os serviços, navegue até o Painel de Controle do Windows, selecione Ferramentas administrativas e abra Serviços. 2. Na janela Serviços, verifique se os serviços a seguir estão listados como "Iniciados" ou "Executando" na coluna Status: Serviço do Analytics Exchange: executa no Servidor AX e em cada instância do Nó do Motor AX Conector do AX: executa apenas no Servidor AX Banco de dados do Analytics Exchange <número da versão>: executa no servidor onde o PostgreSQL está instalado Esse serviço pode ser executado no mesmo servidor do Servidor AX ou em um servidor separado. O serviço estará presente somente se o PostgreSQL for o servidor de banco de dados do Servidor AX Se qualquer um dos serviços não tiver sido iniciado, você poderá tentar iniciá-lo clicando com o botão direito no serviço e selecionando Iniciar. Se ainda assim o serviço não iniciar, verifique os arquivos de log para determinar a causa do problema ou entre em contato com os Serviços de Suporte ACL. Verificação dos aplicativos do Servidor AX Verifique o status de implementação dos aplicativos do Servidor AX no Tomcat Web Application Manager. Página 29 de 79

30 Tarefas pós-instalação 1. Em um navegador da web, acesse e faça login no Tomcat Web Application Manager. Substitua o nome_do_servidor pelo nome do host ou endereço IP do servidor que hospeda o Servidor AX ou a instância do Nó do Motor AX. As suas credenciais do Tomcat Web Application Manager são especificadas durante a instalação do Servidor AX. Se você não se lembrar do nome de usuário e da senha, redefina-os. 2. Confirme se os aplicativos a seguir exibem o status Executando como verdadeiro no Servidor AX: Servidor do ACL Analytics Exchange (AX) <número versão> Cliente web AX do ACL ACL AX System Admin Servidor do ACL AX Core ACL AX Central Authentication System (CAS) ACL AX Gateway Mapper ACL AX Light Client Tomcat Host Manager Application Tomcat Manager Application Interface REST do ACL AX Core Apache TomEE Se qualquer um desses aplicativos não tiver sido iniciado,kl na coluna Comandos, clique em Iniciar. 3. Saia do Tomcat Web Application Manager. Página 30 de 79

31 Tarefas pós-instalação Ativar o Servidor AX Você pode ativar seu Servidor AX on-line usando a Configuração do Servidor AX ou off-line usando o Launchpad. Você deve ter uma conta válida do Launchpad com as permissões adequadas para ativar o Servidor AX. Se você não tiver uma conta do Launchpad, entre em contato com o administrador de contas do ACL. Ativação on-line 1. Faça login no aplicativo Web Configuração do Servidor AX ( e localize o painel Ativação. 2. Na lista Tipo de servidor, selecione uma das seguintes opções: Produção: o servidor de produção primário Não produção: o servidor usado para atividades que não são de produção, como testes e preparação Recuperação de desastres: o servidor designado para failover ou recuperação de desastres 3. Em Ativação, insira suas credenciais do Launchpad e clique em Selecionar organização. 4. Na lista Organizações, selecione a organização à qual o servidor pertence e clique em Ativar servidor. Resultado: após a importação do arquivo de identificação, será exibida a mensagem O servidor foi ativado. Ativação off-line 1. Faça login no aplicativo Web Configuração do Servidor AX ( e localize o painel Ativação. 2. Na lista Tipo de servidor, selecione uma das seguintes opções: Produção: o servidor de produção primário Não produção: o servidor usado para atividades que não são de produção, como testes e preparação Recuperação de desastres: o servidor designado para failover ou recuperação de desastres 3. Em Ativação off-line, clique em Gerar e salve o arquivo identificador de máquina AXOfflineActivation.mif na sua estação de trabalho local. Sua estação de trabalho local deve ter uma conexão com a Internet para acessar o Launchpad e concluir o resto da ativação. 4. Faça login no Launchpad ( e selecione sua organização. 5. Selecione Opções > Ativações e, à esquerda, clique em Ativação off-line. Página 31 de 79

32 Tarefas pós-instalação 6. Faça upload do seu arquivo de ativação: a. Clique em Escolher arquivo, navegue até o arquivo identificador de máquina do seu servidor (AXOfflineActivation.mif) e clique em Abrir. b. Na lista suspensa Aplicativo, selecione o tipo de instalação do Servidor AX. c. Na lista suspensa Usuário, selecione o seu nome e clique em Fazer upload. Resultado: após a conclusão do upload do arquivo identificador de máquina, o nome de máquina do servidor será exibido na lista Ativações. 7. Ao lado do nome do servidor ativado, clique em Download do arquivo de ativação e salve o arquivo de ativação analytics_exchange_server.oaf em sua estação de trabalho. 8. No aplicativo Web Configuração do Servidor AX, na seção Ativação off-line, navegue até o arquivo de ativação baixado do Launchpad e clique em Importar. Resultado: após a importação do arquivo de identificação, será exibida a mensagem O servidor foi ativado. Página 32 de 79

33 Tarefas pós-instalação Adicionar um administrador do Servidor AX Use o aplicativo web Configuração do Servidor AX para adicionar um usuário administrativo. A função Administrador é concedida ao usuário. Você deve adicionar pelo menos uma conta administrativa após a instalação do Servidor AX para poder usar o Cliente AX. Após adicionar o primeiro usuário, você poderá usar o Cliente AX para adicionar mais usuários. 1. Em um navegador da web, acesse e faça login no aplicativo web Configuração do Servidor AX. Use as mesmas credenciais utilizadas para fazer login no Tomcat Web Application Manager. 2. Localize o painel Adicionar administrador AX e insira o nome da conta de usuário do Windows a ser adicionada: Se a conta de usuário pertencer ao domínio padrão do Active Directory para a implementação do Analytics Exchange, será possível inserir o nome de usuário sem especificar o domínio. O domínio padrão do Servidor AX é especificado na seção Configurações do painel Servidor. Se a conta de usuário não pertencer ao domínio padrão do Active Directory, será necessário especificar o domínio e o nome do usuário neste formato: Domínio\nome do usuário Se a conta de usuário for uma conta local do Windows no servidor onde o Servidor AX está instalado, será necessário especificar o nome do computador e do usuário utilizando o formato: NomeComputador\NomeUsuário 3. Clique em Adicionar administrador. Página 33 de 79

34 Tarefas pós-instalação Configurar o diretório de arquivamento e restauração Configure o diretório de arquivamento e restauração para disponibilizar os comandos Archive e Restore aos usuários finais com privilégios de Administrador no Cliente AX. Se o diretório não for configurado, os comandos Archive e Restore serão desativados no Cliente AX. 1. Em um navegador da web, acesse e faça login no aplicativo web Configuração do Servidor AX. Use as mesmas credenciais utilizadas para fazer login no Tomcat Web Application Manager. 2. Na seção Servidor, no campo Diretório de arquivamento e restauração, insira o caminho de arquivo ou caminho UNC do diretório onde deseja salvar as coleções arquivadas. Você precisa especificar uma pasta que já existe. Um caminho UNC é uma pasta compartilhada especificada no seguinte formato: \\<nome_do_servidor>\<pasta_compartilhada>. A conta de usuário usada para executar o Serviço do Analytics Exchange deve ter Permissões totais para a pasta que você configurar como diretório de arquivamento e restauração. É necessário atribuir manualmente os privilégios de segurança necessários no Active Directory. O diretório de dados pode estar situado localmente no Servidor AX ou em um servidor de arquivos remoto ou rede de área de armazenamento (SAN). Você deve verificar se o local especificado tem espaço suficiente alocado em disco para armazenar suas coleções arquivadas com base no tamanho das coleções armazenadas no Servidor AX, incluindo os resultados das tarefas de análise e as políticas de arquivamento da sua organização. 3. Clique em Atualizar na parte inferior da coluna Servidor para salvar suas alterações. Página 34 de 79

35 Tarefas pós-instalação Verificando as conexões de aplicativos do cliente Verifique se os usuários locais e remotos podem se conectar ao Servidor AX usando o Cliente AX, o ACL Analytics e o Cliente Web AX após a instalação do Servidor AX e das instâncias do Nó do Motor AX. Pré-requisitos Nos locais de onde os usuários se conectarão: instale o Cliente AX instale o ACL Analytics Verificações de conexões de aplicativos Verificar Inicie o Cliente AX e conecte-se ao Servidor AX. Exporte uma tabela do Servidor AX que tenha um arquivo de dados de origem armazenado no Servidor AX. Detalhes Se não for possível efetuar o login, verifique as configurações a seguir: o o o Se a conta de usuário usada para fazer o login não pertencer ao domínio padrão do Active Directory especificado para o Servidor AX, será necessário especificar o domínio ao fazer o login. Por exemplo: NomeDomínio\NomeUsuário As configurações de Servidor especificadas na caixa de diálogo Opções devem corresponder às configurações exigidas pelo Servidor AX. Se existir um firewall no computador cliente onde o Cliente AX está sendo executado, verifique se as portas necessárias estão abertas para comunicação de saída. Por padrão, a porta exigida é 443 (Tomcat Connector HTTPS). A porta (Conector do AX) também deverá estar aberta se o ACL Analytics for usado. a. Ao selecionar a tabela, verifique se a propriedade Origem de dados especifica "Origem de dados é gerenciada pelo Servidor AX". b. Na caixa de diálogo Exportar, certifique-se de que a opção Trabalhar com o(s) arquivo(s) exportado(s) está marcada e Exportar arquivos de dados com as definições selecionadas está desmarcada (configurações padrão). c. Se for possível abrir a tabela no ACL Analytics após inserir a senha de perfil do servidor, a configuração do Conector do AX estará correta. d. Se você não conseguir abrir a tabela de servidor, consulte "Atribuição de direitos para o serviço do Conector do AX" Na página 75 para obter instruções sobre como concluir a configuração de segurança adicional que pode ser necessária. Quando você importa um projeto ou uma análise do ACL para o Servidor AX e seleciona Importar arquivos de dados de origem (arquivos.fil), todas as tabelas no projeto são convertidas em tabelas de servidor e os arquivos de dados do ACL (.fil) associados são copiados para o Servidor Página 35 de 79

36 Tarefas pós-instalação Verificar Detalhes AX. As tabelas de servidor são acessadas usando o Conector do AX. Execute o sistema de ajuda selecionando Ajuda > Conteúdo. Se as solicitações de HTTP do cliente forem redirecionadas para um servidor proxy, as tentativas de acesso ao sistema de ajuda poderão falhar. Você pode especificar o endereço IP e porta corretos do servidor de proxy adicionando as duas linhas a seguir ao arquivo ACLAnalyticsExchange.ini na pasta onde o Cliente AX está instalado. O local padrão é C:\Arquivos de Programas\ACL Software\ACL Analytics Exchange Client. -Dhttp.proxyHost=<nome_do_host_ou_ip_do_servidor_proxy> -Dhttp.proxyPort=<porta_servidor_proxy> Por exemplo: -Dhttp.proxyHost= Dhttp.proxyPort=3128 Página 36 de 79

37 Tarefas pós-instalação Configuração do Python para uso com o Servidor AX Para configurar o Python para trabalhar com o Servidor AX, é necessário instalar a versão correta do Python, adicionar o executável do Python à variável de ambiente PATH do seu sistema e configurar a variável de ambiente PYTHONPATH em cada máquina que hospeda uma instância do Servidor AX ou do Nó do Motor AX. Como funciona? Para executar scripts do Python, o Analytics Exchange deve poder chamar o executável do Python e encontrar os scripts que está instruído a executar. O Servidor AX usa a variável de ambiente PATH para localizar o Python e a variável de ambiente PYTHONPATH para localizar scripts. Instale o Python versão 3.5.x (32 bits) Você precisa concluir estas etapas em cada máquina que hospeda uma instância do Servidor AX ou Nó do Motor AX. 1. Na página Downloads Python, baixe a versão mais recente do Python 3.5 para sua máquina. 2. Em sua máquina, clique duas vezes no arquivo do instalador. 3. No instalador, selecione Adicionar Python númeroversão ao PATH. 4. Clique em Instalar e siga as instruções na tela. 5. Reinicialize a máquina antes de executar qualquer script Python da ACL. Defina a variável de ambiente PYTHONPATH Você precisa concluir estas etapas em cada máquina que hospeda uma instância do Servidor AX ou Nó do Motor AX. 1. No seu Windows, crie uma ou mais pastas para arquivar os scripts Python. Exemplo:C:\scripts_python. 2. No Windows, abra a caixa de diálogo Propriedades do Sistema e clique em Variáveis de Ambiente. 3. Na seção Variáveis do sistema, clique em Novo e insira o seguinte: Nome da variável:pythonpath Valor da variável:, insira o caminho completo para a(s) pasta(s) que criou para arquivar os scripts Python Página 37 de 79

38 Tarefas pós-instalação Separe os caminhos de várias pastas com ponto e vírgula: C:\scripts_python;C:\- dev;c:\tmp. 4. Para salvar a variável, clique em OK e na caixa de diálogo Propriedades do Sistema, clique em OK. Página 38 de 79

39 Instalação do Nó do Motor AX (opcional) Instalação do Nó do Motor AX (opcional) Página 39 de 79

40 Instalação do Nó do Motor AX (opcional) Instalar o Nó do Motor AX para Oracle Instale o Nó do Motor AX para aumentar os recursos de processamento de análises do Analytics Exchange. O Nó do Motor AX é hospedado em um servidor separado do Servidor AX. Pré-requisitos Instale e configure o Servidor AX antes de instalar o Nó do Motor AX. Instalar o Nó do Motor AX Cuidado Você deve instalar as atualizações do Windows KB antes de iniciar a instalação do Analytics Exchange no Windows Server 2012 R2. Se você não instalar esta atualização, sua instalação do Analytics Exchange não será concluída com sucesso. Executar o instalador e selecionar a configuração do banco de dados 1. Clique duas vezes no pacote de instalação. Se for exibida uma caixa de diálogo com um aviso de segurança, verifique as informações listadas e clique em Sim. 2. Selecione o idioma da instalação e clique em OK. 3. Na página Localização para extrair arquivos de instalação, especifique a pasta onde os arquivos de instalação serão extraídos e clique em Instalar. Dica Clique em Procurar para selecionar uma pasta ou aceite o local padrão: C:\Arquivos de Programas (x86)\acl Software\Installers\ACLAX<versão>_EngineNode_ <edição>. 4. Na página Opções de configuração do Servidor do Analytics Exchange, selecione Oracle e clique em Avançar. 5. Se for solicitada a instalação de pré-requisitos, clique em Instalar e aguarde a instalação dos pré-requisitos. Siga as instruções na tela para concluir a instalação dos pré-requisitos. Configurar o serviço do banco de dados 1. Na página Bem-vindo, clique em Avançar. Na página Contrato de licença, selecione Eu aceito os termos do contrato de licença e clique em Avançar. Página 40 de 79

41 Instalação do Nó do Motor AX (opcional) 2. Na página Pastas de destino, especifique onde os arquivos de aplicativos do Nó do Motor AX serão instalados e o diretório de trabalho para o processamento de análises. Clique em Avançar. Se necessário, clique em Modificar para modificar um ou ambos os locais padrão. Os caminhos especificados não devem incluir espaços. 3. Na página Informações do Servidor do ACL Analytics Exchange, insira o endereço IP do servidor onde o Servidor AX está instalado e clique em Avançar. 4. Na página Configurações de conexão com o banco de dados do Analytics Exchange Servidor, selecione Oracle nas opções de Plataforma de banco de dados. 5. Para criptografar comunicações de banco de dados, marque Criptografar comunicação do banco de dados e clique em Avançar. Para criptografar a conexão, o servidor de banco de dados deve ser configurado para conexões SSL. Dica A criptografia reduz um pouco o desempenho. Portanto, ative-a apenas se dados são transferidos entre o servidor de banco de dados e o servidor de aplicativos por meio de uma rede não protegida. 6. Na segunda página Configurações de conexão do banco de dados Analytics Exchange Servidor, insira as seguintes informações: Campo Servidor de banco de dados Nome do serviço Porta não SSL Porta SSL Nome de usuário Senha Descrição O endereço IP ou nome do servidor onde o servidor de banco de dados está localizado. O nome do banco de dados global da instância do banco de dados a ser usada. Porta usada para conexões HTTP padrão com o banco de dados do Analytics Exchange. O valor padrão é A porta usada para conexões SSL com o banco de dados do Analytics Exchange. Esse campo somente está disponível se a opção Criptografar comunicação com o banco de dados foi marcada. O valor padrão é O nome da conta de usuário usada para acessar o banco de dados do Analytics Exchange. A senha da conta de usuário. Para verificar as informações de conexão, clique em Testar conexão e clique em Avançar. Configurar a conta e a segurança do serviço de aplicativos 1. No painel Conta do serviço Tomcat do Analytics Exchange, faça o seguinte e clique em Avançar: a. Insira o domínio e o nome de usuário da conta no formato domínio\nomeusuário ou clique em Pesquisar para localizar o domínio e o nome de usuário. Página 41 de 79

42 Instalação do Nó do Motor AX (opcional) Se você pesquisar por nome de conta, insira ou selecione antes o domínio ou o nome do servidor na caixa de diálogo Pesquisar por conta de usuário, para que o instalador mostre a lista apropriada de contas de usuário disponíveis. Não há suporte para executar o serviço TomEE utilizando uma conta de usuário local. Essas contas não têm os privilégios adequados para executar alguns comandos do ACL. b. Insira a Senha da conta. c. Clique em Avançar. d. Se solicitado a conceder a permissão "Fazer logon como um serviço" para a conta do serviço Tomcat, clique em Sim e em OK. Para obter informações sobre as opções de configuração das contas de serviço, consulte "Configuração de conta de serviços" Na página Na página Informações do certificado SSL, insira as informações a seguir para criar um certificado de segurança autoassinado e proteger conexões HTTPS com o Nó do Motor AX e clique em Avançar: Campo Nome do servidor Nome do departamento ou da divisão Nome da organização Nome da cidade Nome do estado/província Código do país Descrição O nome do host do servidor do banco de dados. Por exemplo: ax.acl.com. A divisão ou unidade de negócios para a qual o certificado é emitido. Por exemplo: Desenvolvimento. Nome da sua empresa ou organização. Por exemplo: ACL Services Ltd.. Cidade ou local onde a empresa ou organização está localizada. Por exemplo: Vancouver. Estado ou província onde a empresa ou a organização está localizada. Por exemplo: BC. Código de dois caracteres do país onde a empresa ou organização está localizada. Por exemplo: CA. Insira uma senha de no mínimo 6 caracteres. Senha do armazenamento de chaves Senha da chave privada Se você estiver usando um arquivo de armazenamento de chaves existente, essa instância da caixa de texto Senha do armazenamento de chaves será desativada. Insira novamente a mesma senha. A Senha do armazenamento de chaves e a Senha da chave privada devem ser idênticas. Página 42 de 79

43 Instalação do Nó do Motor AX (opcional) Para obter informações sobre a utilização desse certificado e as opções de configuração, consulte "Certificados de segurança" Na página 49. Finalizar a instalação 1. Clique em Instalar. Antes do processo de instalação ser concluído, será necessário aguardar cerca de um minuto enquanto o servidor de aplicativos TomEE fica totalmente funcional. A janela de comando pode ser exibida intermitentemente durante este período de tempo. Não cancele a instalação. 2. Quando o processo de instalação for concluído, clique em Finalizar para sair do instalador. Pós-requisitos "Configuração de uma pasta de dados compartilhada" Na página seguinte "Configuração de Nós do Motor AX" Na página 45 Página 43 de 79