Atualizando para o VMware Identity Manager Connector (Linux) SETEMBRO DE 2018 VMware Identity Manager 3.3 VMware Identity Manager

Transcrição

1 Atualizando para o VMware Identity Manager Connector (Linux) SETEMBRO DE 2018 VMware Identity Manager 3.3 VMware Identity Manager

2 Você pode encontrar a documentação técnica mais atualizada no site da VMware, em: O site da VMware também fornece as atualizações mais recentes de produtos. Caso tenha comentários sobre esta documentação, envie seu feedback para: docfeedback@vmware.com VMware, Inc Hillview Ave. Palo Alto, CA VMware Brasil Rua Surubim, 504 4º andar CEP Cidade Monções São Paulo SÃO PAULO: Brasil Tel: Fax: Direitos autorais VMware, Inc. Todos os direitos reservados. Informações sobre direitos autorais e marca registrada. VMware, Inc. 2

3 Conteúdo Atualizando para o VMware Identity Manager Connector (Linux) 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 Defina as configurações do servidor proxy para o appliance do VMware Identity Manager Connector 7 3 Realizando uma atualização online para a versão mais recente 9 4 Realizando uma atualização online para uma versão específica 11 5 Realizando uma atualização offline do VMware Identity Manager Connector 13 Usando um servidor Web local para a atualização offline 13 Usando o script updateoffline.hzn para atualização offline 15 6 Configurar as definições após atualização do conector 17 7 Solucionando problemas nos erros de atualização 19 Verificando os logs de erro de atualização 19 Revertendo para snapshots do conector 20 Coletando um pacote de arquivos de log 20 Erro de rede após a atualização 21 VMware, Inc. 3

4 Atualizando para o VMware Identity Manager Connector (Linux) Este documento descreve como fazer upgrade do seu appliance virtual do VMware Identity Manager Connector do 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 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

5 Sobre a Atualizando o VMware 1 Identity Manager Connector Você pode atualizar o appliance virtual do VMware Identity Manager Connector online ou offline. Caminhos de atualização com suporte O VMware Identity Manager 3.3 inclui o conector Há suporte para os seguintes caminhos de atualização: Da versão e posteriores para a versão Para atualizar de uma versão anterior para a , primeiro atualize para a ou posteriores e, em seguida, para a Quando você executa uma atualização on-line, é exibida a versão mais recente para a qual a atualização é permitida. Atualize para a versão permitida e, em seguida, para a Conectividade com a Internet 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ê pode baixar o pacote de atualização do My VMware. Você pode usar o script updateoffline.hzn para realizar a atualização ou configurar um servidor Web local para hospedar o pacote de atualização. VMware, Inc. 5

6 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 Defina 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 nas portas 80 e 443 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 4 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 Defina as configurações do servidor proxy para o appliance do VMware Identity Manager Connector. VMware, Inc. 6

7 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 4 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. 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 Defina as configurações do servidor proxy para o appliance do VMware Identity Manager Connector Se você realizar uma atualização online, o appliance do conector acessará os servidores de atualização da 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. 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. VMware, Inc. 7

8 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

9 Realizando uma atualização online para a versão mais recente 3 Você pode atualizar a instância do VMware Identity Manager Connector online. Use estes comandos para atualizar para a versão mais recente disponível. Para atualizar para uma versão específica em vez da versão mais recente, consulte Capítulo 4Realizando uma atualização online para uma versão específica. Pré-requisitos Verifique se você atende aos pré-requisitos descritos em Capítulo 2Preparando para atualizar o VMware Identity Manager Connector. Verifique se o appliance do conector está ligado e funcionando. Procedimentos 1 Faça login no appliance virtual 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 comando a seguir para atualizar o appliance virtual. /usr/local/horizon/update/updatemgr.hzn update As mensagens que ocorrem durante a atualização são salvas nos arquivos de log /opt/vmware/var/log/update.log e /opt/vmware/var/log/vami/updatecli.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 VMware, Inc. 9

10 6 Verifique a versão atualizada do appliance virtual. vamicli version --appliance A nova versão é exibida. 7 Reinicie o appliance virtual. 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

11 Realizando uma atualização online para uma versão específica 4 Você pode atualizar sua instância do conector do VMware Identity Manager on-line para uma versão específica, em vez da versão mais recente disponível, se necessário. Observação Para atualizar para a versão mais recente disponível, consulte Capítulo 3Realizando uma atualização online para a versão mais recente. Pré-requisitos Verifique se você atende aos pré-requisitos descritos em Capítulo 2Preparando para atualizar o VMware Identity Manager Connector. Verifique se o appliance virtual está ligado e funcionando. Procedimentos 1 Faça login no appliance virtual do conector como o usuário raiz. 2 Execute o seguinte comando. /usr/local/horizon/update/updatemgr.hzn updateinstaller 3 Execute o comando a seguir para atualizar o appliance virtual para uma versão específica. /usr/local/horizon/update/configureupdate.hzn provider --url onde newversion é a versão para a qual você deseja atualizar, no formato n.n.n.n. Para atualizar para a versão (o conector lançado com o VMware Identity Manager ), use: /usr/local/horizon/update/configureupdate.hzn provider --url Para atualizar para a versão (o conector lançado com o VMware Identity Manager 3.1), use: /usr/local/horizon/update/configureupdate.hzn provider --url VMware, Inc. 11

12 Para atualizar para a versão (o conector lançado com o VMware Identity Manager 3.2), use: /usr/local/horizon/update/configureupdate.hzn provider --url Para atualizar para a versão (o conector lançado com o VMware Identity Manager ), use: /usr/local/horizon/update/configureupdate.hzn provider --url Para atualizar para a versão (o conector lançado com o VMware Identity Manager 3.3), use: /usr/local/horizon/update/configureupdate.hzn provider --url As mensagens que ocorrem durante a atualização são salvas nos arquivos de log /opt/vmware/var/log/update.log e /opt/vmware/var/log/vami/updatecli.log. 4 Verifique a versão atualizada do appliance virtual. vamicli version --appliance A nova versão é exibida. 5 Reinicie o appliance virtual. reboot 6 Repita essas etapas para cada instância do conector na sua implantação. A atualização do conector é concluída. VMware, Inc. 12

13 Realizando uma atualização offline do VMware Identity Manager Connector 5 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. Duas opções estão disponíveis para a atualização offline. Você pode configurar um repositório de atualização em um servidor Web local e configurar o appliance para usar o servidor Web local para fazer a atualização. Ou você pode baixar o pacote de atualização para o servidor do conector e usar o script updateoffline.hzn para fazer a atualização. Este capítulo inclui os seguintes tópicos: Usando um servidor Web local para a atualização offline Usando o script updateoffline.hzn para atualização offline Usando um servidor Web local para a atualização offline Se você quiser executar a atualização offline usando um servidor Web local, prepare o servidor Web para hospedar o arquivo de atualização, configure o appliance do conector para apontar para o servidor Web e execute a atualização. 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 e copie o arquivo zip baixado para ele. VMware, Inc. 13

14 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 O conteúdo extraído do arquivo contém os seguintes subdiretórios: /manifest e /package-pool. 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 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 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 VMware, Inc. 14

15 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. 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. Usando o script updateoffline.hzn para atualização offline Você pode usar o script updateoffline.hzn para realizar uma atualização offline do appliance virtual do conector do VMware Identity Manager. Baixe o pacote de atualização offline da página de download do produto do VMware Identity Manager para usá-lo com o script. O script verifica se o pacote de atualização corresponde ao produto. Por exemplo, se você estiver atualizando o appliance virtual do conector e usar o pacote de atualização do serviço em vez do pacote de atualização do conector, o script resultará em um erro. Procedimentos 1 Localize o script updateoffline.hzn. Nas versões e posteriores, o script está disponível no seguinte caminho: /usr/local/horizon/update/updateoffline.hzn Observação Para usar o script updateoffline.hzn com uma versão anterior à , você pode baixar o script do artigo da KB em 2 Baixe o arquivo identity-manager-connector-versionnumber-buildnumber-updaterepo.zip da página de download do produto VMware Identity Manager em my.vmware.com. A localização recomendada para salvar o arquivo é /var/tmp. VMware, Inc. 15

16 3 Execute o script de updateoffline.hzn como o usuário raiz. /usr/local/horizon/update/updateoffline.hzn [-r] -f upgradefilepath -f upgradefilepath Atualize o appliance usando upgradefilepath. upgradefilepath deve ser um caminho absoluto. Obrigatório -r Reinicialize após a atualização. Opcional -h Exibe o uso do script. Opcional Por exemplo: /usr/local/horizon/update/updateoffline.hzn -f /var/tmp/identity-managerconnector updaterepo.zip 4 Se você não tiver usado a opção -r com o script, reinicie o appliance virtual após a conclusão da atualização. reboot VMware, Inc. 16

17 Configurar as definições após atualização do conector 6 Depois de atualizar para o conector , você pode precisar definir determinadas configurações. Arquivos de configuração Log4j Se algum arquivo de configuração log4j em uma instância de conector tiver sido editado, novas versões dos arquivos não serão instaladas automaticamente durante o upgrade. No entanto, após o upgrade, os logs controlados por esses arquivos não funcionarão. Para resolver esse problema: 1 Faça login na instância do conector. 2 Procure arquivos log4j com o sufixo.rpmnew. find / -name "**log4j.properties.rpmnew" 3 Para cada arquivo encontrado, copie o novo arquivo para o antigo arquivo log4j correspondente sem o sufixo.rpmnew. Integração do Citrix Para realizar a integração do Citrix no VMware Identity Manager 3.3, todos os conectores autônomos devem ter a versão (a versão do conector na versão 3.3) ou posteriores. Você também deve usar o Integration Broker 3.3. A atualização não está disponível para o Integration Broker. Desinstale a versão antiga e, em seguida, instale a nova versão. VMware, Inc. 17

18 Alterações em versões anteriores Alterações na versão 3.1 A partir da versão 3.1, um novo recurso foi introduzido que mudou a forma como grupos de usuários são sincronizados. Depois de atualizar para o VMware Identity Manager 3.1 ou posterior, para todos os grupos de usuário já adicionados antes da atualização, verifique se os direitos estão atribuídos. Novos grupos de usuários adicionados após a atualização não serão sincronizados com o serviço do VMware Identity Manager até que o grupo tenha direito a um recurso, seja adicionado a uma regra de política de acesso ou, a partir da versão 3.2, seja sincronizado manualmente na página Grupo > Usuários. Se os seus direitos estiverem definidos como TODOS OS USUÁRIOS, os usuários dos novos grupos criados após a atualização não serão incluídos se os usuários ainda não tiverem sido sincronizados. Adicione direitos aos novos grupos. Consulte Como funciona a sincronização de grupo após a atualização para o VMware Identity Manager 3.1 para obter mais informações. Alterações na versão 3.0 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. 18

19 Solucionando problemas nos 7 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 Erro de rede após a atualização 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 os arquivos update.log e vami/updatecli.log e examine as mensagens de erro. 4 Resolva os erros e execute o comando de atualização novamente. 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. 19

20 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 7 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 Logs de serviço /opt/vmware/horizon/workspace/logs/catal ina.log /opt/vmware/horizon/workspace/logs/confi gurator.log /opt/vmware/horizon/workspace/logs/conne ctor.log /opt/vmware/horizon/workspace/logs/conne ctor-dir-sync.log /opt/vmware/horizon/workspace/logs/horiz on.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. Mensagens relacionadas à sincronização de diretório. O VMware Identity Manager registra a atividade que ocorre no appliance do workspace-va, como atividades relacionadas a direitos, usuários e grupos. Procedimentos 1 Faça login na página de configuração do conector em VMware, Inc. 20

21 2 Clique em Preparar pacote de logs. 3 Baixe o pacote e o envie ao suporte da VMware. Erro de rede após a atualização Depois de atualizar o appliance virtual e reinicializar, ocorre um erro de rede. Problema Depois de atualizar o appliance, a seguinte mensagem de erro é exibida: NENHUMA REDE DETECTADA. FAÇA LOGIN E EXECUTE O COMANDO /opt/vmware/share/vami/vami_config_net PARA CONFIGURAR A REDE Solução 1 Reverta para o snapshot criado antes de atualizar o appliance virtual. 2 Faça login no appliance virtual como o usuário raiz ou faça login como o sshuser e execute o comando su para alternar para um superusuário. 3 Navegue até o seguinte diretório: /etc/sysconfig/networking/devices 4 Faça backup do arquivo ifcfg-eth0 para outro diretório. 5 Atualize o appliance virtual, mas não o reinicie. 6 Restaure o arquivo ifcfg-eth0 para o diretório /etc/sysconfig/networking/devices. 7 Reinicie o appliance virtual: reboot VMware, Inc. 21