Atualizando o VMware Identity Manager Connector SETEMBRO DE 2017 VMware AirWatch 9.2 VMware Identity Manager 3.0
Atualizando o VMware Identity Manager Connector Você pode encontrar a documentação técnica mais atualizada no site da VMware, em: https://docs.vmware.com/br/ Caso tenha comentários sobre esta documentação, envie seu feedback para: docfeedback@vmware.com VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com Copyright 2015 2017 VMware, Inc. Todos os direitos reservados. Informações de direitos autorais e marcas registradas. VMware, Inc. 2
Conteúdo Atualizando o VMware Identity Manager Connector 4 1 Sobre a Atualizando o VMware Identity Manager Connector 5 2 Preparando para atualizar o VMware Identity Manager Connector 6 Pré-requisitos para atualização 6 Verificar a disponibilidade de uma atualização online do VMware Identity Manager Connector 7 Definir as configurações do servidor proxy para o appliance do VMware Identity Manager Connector 7 3 Realizando uma atualização online do VMware Identity Manager Connector 9 4 Realizando uma atualização offline do VMware Identity Manager Connector 11 Preparar um servidor Web local para a atualização offline 11 Configurar o conector e realizar a atualização offline 12 5 Configurar as definições após atualização do conector 14 6 Solucionando problemas nos erros de atualização 15 Verificando os logs de erro de atualização 15 Revertendo para snapshots do conector 16 Coletando um pacote de arquivos de log 16 VMware, Inc. 3
Atualizando o VMware Identity Manager Connector Atualizando o VMware Identity Manager Connector descreve como atualizar o appliance virtual do VMware Identity Manager Connector baseado no Linux. Este guia se aplica às implantações do SaaS, em que um appliance virtual do conector é implantado no local. Também se aplica às implantações no local quando a implantação inclui mais appliances virtuais autônomos do conector. Público-alvo Estas informações se dirigem a qualquer um que instale, atualize e configure o appliance virtual do VMware Identity Manager Connector. Elas foram escritas para administradores experientes de sistemas Windows ou Linux que estão familiarizados com a tecnologia de máquina virtual. Informações adicionais Para obter informações sobre como usar sua instância do conector atualizada, consulte Administração do VMware Identity Manager. Para obter informações sobre como atualizar o VMware Identity Manager Connector para Windows, um componente do VMware Enterprise Systems Connector, consulte a Instalação e configuração do VMware Enterprise Systems. VMware, Inc. 4
Sobre a Atualizando o VMware 1 Identity Manager Connector Você pode atualizar o appliance virtual do VMware Identity Manager Connector online ou offline. Como padrão, o conector usa o site da VMware para o procedimento de atualização, o qual exige que o appliance do conector tenha acesso à Internet. Você também deve configurar as definições do servidor proxy para o appliance do conector, se aplicável. Se a instância do seu conector não tiver acesso à Internet, você pode realizar a atualização offline. Para uma atualização offline, você deve baixar o pacote de atualização e configurar um servidor Web local para hospedar o arquivo de atualização. VMware, Inc. 5
Preparando para atualizar o VMware Identity Manager Connector 2 Para preparar a atualização do conector, você deve executar uma série de tarefas de pré-requisito, como verificar atualizações disponíveis e configurar as definições do servidor proxy para o appliance, se aplicável. Este capítulo inclui os seguintes tópicos: Pré-requisitos para atualização Verificar a disponibilidade de uma atualização online do VMware Identity Manager Connector Definir as configurações do servidor proxy para o appliance do VMware Identity Manager Connector Pré-requisitos para atualização Antes de atualizar o conector, realize essas tarefas de pré-requisitos. Pré-requisitos para a atualização online Verifique se o appliance do conector pode resolver e alcançar vapp-updates.vmware.com na porta 80 sobre HTTP. Confirme se existe uma atualização do conector. Execute o comando adequado para verificar autualizações. Consulte Verificar a disponibilidade de uma atualização online do VMware Identity Manager Connector. Verifique se pelo menos 2 GB de espaço em disco está disponível na partição raiz primária do appliance. Verifique se o conector está adequadamente configurado. Faça um snapshot do appliance do conector para fazer um backup. Para obter mais informações sobre como tirar snapshots, consulte a documentação do vsphere. Se um servidor proxy HTTP for necessário para o acesso HTTP de saída, configure as definições do servidor proxy do appliance do conector. Consulte Definir as configurações do servidor proxy para o appliance do VMware Identity Manager Connector. VMware, Inc. 6
Atualizando o VMware Identity Manager Connector Pré-requisitos para a atualização offline Confirme se existe uma atualização do conector. Procure por atualizações no site My VMware Downloads em my.vmware.com. Verifique se pelo menos 2 GB de espaço em disco está disponível na partição raiz primária do appliance. Verifique se o conector está adequadamente configurado. Faça um snapshot do appliance do conector para fazer um backup. Para obter mais informações sobre como tirar snapshots, consulte a documentação do vsphere. Configure o appliance do conector para usar um servidor Web local para hospedar o arquivo de atualização. Consulte Capítulo 4 Realizando uma atualização offline do VMware Identity Manager Connector. Verificar a disponibilidade de uma atualização online do VMware Identity Manager Connector Se seu appliance do conector tem conectividade à Internet, é possível verificar a disponibilidade de atualizações online a partir do appliance. Procedimentos 1 Faça login no appliance do conector como o usuário raiz. 2 Execute o seguinte comando. /usr/local/horizon/update/updatemgr.hzn updateinstaller 3 Execute o seguinte comando para verificar se há uma atualização online. /usr/local/horizon/update/updatemgr.hzn check Definir as configurações do servidor proxy para o appliance do VMware Identity Manager Connector O appliance do conector acessa os servidores de atualização VMware pela Internet. Caso sua configuração de rede forneça acesso à Internet por meio de um proxy HTTP, você deve ajustar as configurações de proxy no appliance. Habilite seu proxy para lidar apenas com o tráfego da Internet. Para garantir que o proxy esteja configurado corretamente, defina o parâmetro para o tráfego interno para não proxy no domínio. Observação Os servidores proxy que exigem autenticação não são suportados. VMware, Inc. 7
Atualizando o VMware Identity Manager Connector Pré-requisitos Verifique se você tem a senha root do appliance do conector. Certifique-se de que você tenha as informações do servidor proxy. Procedimentos 1 Faça login no appliance do conector como o usuário raiz. 2 Insira YaST na linha de comando para executar o utilitário YaST. 3 Selecione Serviços de Rede no painel esquerdo e selecione Proxy. 4 Insira as URLs do servidor proxy nos campos URL do Proxy HTTP e URL do Proxy HTTPS. 5 Selecione Concluir e saia do utilitário do YaST. 6 Reinicie o servidor Tomcat no appliance virtual do conector para usar as novas configurações de proxy. service horizon-workspace restart Os servidores de atualização VMware estão agora disponíveis para o appliance do conector. VMware, Inc. 8
Realizando uma atualização online do VMware Identity Manager Connector 3 Você pode atualizar a instância do VMware Identity Manager Connector online. Pré-requisitos Você atendeu aos pré-requisitos listados em Capítulo 2 Preparando para atualizar o VMware Identity Manager Connector. Verifique se o appliance do conector está ligado e funcionando. Procedimentos 1 Faça login no appliance do conector como o usuário raiz. 2 Execute o seguinte comando. /usr/local/horizon/update/updatemgr.hzn updateinstaller 3 Execute o seguinte comando para verificar se existe a atualização online. /usr/local/horizon/update/updatemgr.hzn check 4 Execute o seguinte comando para atualizar o appliance. /usr/local/horizon/update/updatemgr.hzn update As mensagens que surgirem durante a atualização serão salvas no arquivo update.log em /opt/vmware/var/log/update.log. 5 Execute o comando updatemgr.hzn check novamente para verificar se não há uma atualização mais recente. /usr/local/horizon/update/updatemgr.hzn check 6 Verifique a versão atualizada do appliance. vamicli version --appliance A nova versão é exibida. VMware, Inc. 9
Atualizando o VMware Identity Manager Connector 7 Reinicie o appliance do conector. reboot 8 Repita os passos anteriores para cada appliance do conector na sua implantação do VMware Identity Manager. A atualização do conector é concluída. VMware, Inc. 10
Realizando uma atualização offline do VMware Identity Manager Connector 4 Caso o appliance virtual do VMware Identity Manager Connector não consiga conectar-se à Internet para fazer a atualização, você pode realizar uma atualização offline. Você deve configurar um repositório de atualização em um servidor Web local e configurar o appliance do conector para usar o servidor Web local para atualização. Este capítulo inclui os seguintes tópicos: Preparar um servidor Web local para a atualização offline Configurar o conector e realizar a atualização offline Preparar um servidor Web local para a atualização offline Antes de iniciar a atualização offline do conector, prepare o servidor Web local criando uma estrutura de diretório que inclui um subdiretório para o appliance do conector. Pré-requisitos Baixe o arquivo identity-manager-connector-versionnumber-buildnumber-updaterepo.zip do My VMware. Vá para my.vmware.com, procure a página Baixar VMware Identity Manager e baixe o arquivo listado em Pacote de Atualização Offline do VMware Identity Manager Connector. Caso você use um servidor web IIS, configure o servidor Web para permitir caracteres especiais nos nomes de arquivo. Você configura isso na seção Solicitação de filtroselecionando a opção Permitir escape duplo. Procedimentos 1 Crie um diretório no servidor Web em http://yourwebserver/vm/ e copie o arquivo zip baixado para ele. 2 Verifique se o seu servidor Web inclui tipos mime para.sig (text/plain) e.sha256 (text/plain). Sem esses tipos mime, seu servidor Web não verifica atualizações. 3 Descompacte o arquivo. O conteúdo do arquivo ZIP extraído é armazenado em http://yourwebserver/vm/. O conteúdo extraído do arquivo contém os seguintes subdiretórios: /manifest e /package-pool. VMware, Inc. 11
Atualizando o VMware Identity Manager Connector 4 Execute o seguinte comando do updatelocal.hzn para verificar se a URL tem conteúdo de atualização válido. /usr/local/horizon/update/updatelocal.hzn checkurl http://yourwebserver/vm Configurar o conector e realizar a atualização offline Configure o appliance do conector para apontar ao servidor Web local para realizar uma atualização offline. Feito isso, atualize o appliance. Pré-requisitos Preparar um servidor Web local para a atualização offline. Procedimentos 1 Faça login no appliance do conector como o usuário raiz. 2 Execute o seguinte comando para configurar um repositório de atualização que use um servidor Web local. /usr/local/horizon/update/updatelocal.hzn seturl http://yourwebserver/vm/ Observação Para desfazer a configuração e restaurar a capacidade de realizar uma atualização online, você pode executar o seguinte comando. /usr/local/horizon/update/updatelocal.hzn setdefault 3 Realizar a atualização. a Execute o seguinte comando. /usr/local/horizon/update/updatemgr.hzn updateinstaller b Execute o seguinte comando para verificar a versão da atualização disponível. /usr/local/horizon/update/updatemgr.hzn check c Execute o seguinte comando para atualizar o conector. /usr/local/horizon/update/updatemgr.hzn update As mensagens que surgirem durante a atualização serão salvas no arquivo update.log em /opt/vmware/var/log/update.log. VMware, Inc. 12
Atualizando o VMware Identity Manager Connector d Execute o comando updatemgr.hzn check novamente. /usr/local/horizon/update/updatemgr.hzn check e Verifique a versão atualizada do appliance. vamicli version --appliance O comando deve exibir a nova versão. f Reinicie o appliance do conector. Por exemplo, a partir da linha de comando, execute o seguinte comando. reboot 4 Repita os passos anteriores para cada appliance do conector na sua implantação do VMware Identity Manager. A atualização do conector é concluída. VMware, Inc. 13
Configurar as definições após atualização do conector 5 Depois de atualizar para o conector 2017.8.1.0, você precisa definir determinadas configurações. Se você integrar recursos publicados Citrix ao VMware Identity Manager, atualize para o Integration Broker 3.0. O VMware Identity Manager 3.0 e o VMware Identity Manager Connector 2017.8.1.0 (a versão do Connector na versão 3.0) não são compatíveis com as versões mais antigas do Integration Broker. Tabela 5 1. Versões com suporte Versão do VMware Identity Manager ou Connector Versão do Integration Broker compatível VMware Identity Manager 3.0 3.0 VMware Identity Manager Connector 2017.8.1.0 (a versão do Connector na versão 3.0 do VMware Identity Manager) VMware Identity Manager 2.9.1 ou anterior VMware Identity Manager Connector 2.9.1 ou anterior 3.0 2.9.1 ou anterior 2.9.1 ou anterior Se você integrar os desktops e aplicativos do Horizon ao VMware Identity Manager e tiver implantado um cluster do serviço ou conector do VMware Identity Manager, deverá configurar a integração do Horizon novamente. No conector primário, onde os recursos do Horizon foram salvos e sincronizados, remova todos os pods do Horizon, adicione-os novamente e clique em Salvar e Sincronizar. Nos outros conectores, onde você salvou a configuração de recursos do Horizon, remova todos os pods do Horizon, adicione-os novamente e clique em Salvar. VMware, Inc. 14
Solucionando problemas nos 6 erros de atualização Você pode solucionar problemas de atualização revendo os logs de erro. Se o conector não for iniciado após o upgrade, você poderá reverter para uma instância anterior retornando a um snapshot. Este capítulo inclui os seguintes tópicos: Verificando os logs de erro de atualização Revertendo para snapshots do conector Coletando um pacote de arquivos de log Verificando os logs de erro de atualização Resolva os erros que ocorrem durante a atualização revisando os logs de erro. Os arquivos de log de atualização estão no diretório /opt/vmware/var/log. Problema Depois que a atualização é concluída, o conector não é iniciado e aparecem erros nos logs de erro. Causa Ocorreram erros durante a atualização. Solução 1 Faça login no appliance do conector. 2 Vá ao diretório /opt/vmware/var/log. 3 Abra o arquivo update.log e revise as mensagens de erro. 4 Resolva os erros e volte a executar o comando de atualização. O comando de atualização é reiniciado a partir do ponto onde parou. Observação Como alternativa, você pode reverter para um snapshot e executar a atualização novamente. VMware, Inc. 15
Atualizando o VMware Identity Manager Connector Revertendo para snapshots do conector Se o conector não for iniciado de modo adequado após uma atualização, você poderá reverter para uma instância anterior. Problema Depois de atualizar a instância do conector, ele não é iniciado corretamente. Você reviu os logs de erros da atualização e executou o comando de atualização novamente, mas isso não resolveu o problema. Causa Os erros ocorreram durante o processo de atualização. Solução u Reverta para um dos snapshots que você fez como backup da sua instância original do conector. Para obter mais informações, consulte a documentação do vsphere. Coletando um pacote de arquivos de log Você pode coletar um pacote de arquivos de log para enviar ao suporte da VMware. Você obtém o pacote da página de configuração do conector. Os seguintes arquivos de log são coletados no pacote. Tabela 6 1. Arquivos de log Componente Localização do arquivo de log Descrição Logs do Apache Tomcat (catalina.log) Logs do Configurador (configurator.log) Logs do Conector (connector.log) /opt/vmware/horizon/workspace/logs/catal ina.log /opt/vmware/horizon/workspace/logs/confi gurator.log /opt/vmware/horizon/workspace/logs/conne ctor.log As mensagens de registro do Apache Tomcat que não estão registradas em outros arquivos de log. Solicita que o Configurador receba do cliente REST e da interface Web. Um registro de cada solicitação recebida da interface Web. Cada entrada de log inclui também a URL, o carimbo de data/hora e as exceções da solicitação. Nenhuma ação de sincronização é registrada. Procedimentos 1 Faça login na página de configuração do conector em https://connectorurl:8443/cfg/logs. 2 Clique em Preparar pacote de logs. 3 Baixe o pacote e o envie ao suporte da VMware. VMware, Inc. 16