Atualizando para o VMware Identity Manager Modificado em 17 de outubro de 2017 VMware Identity Manager 2.9.2

Transcrição

1 Atualizando para o VMware Identity Manager Modificado em 17 de outubro de 2017 VMware Identity Manager 2.9.2

2 Você pode encontrar a documentação técnica mais atualizada no site da VMware, em: Caso tenha comentários sobre esta documentação, envie seu feedback para: docfeedback@vmware.com VMware, Inc Hillview Ave. Palo Alto, CA Copyright 2017 VMware, Inc. Todos os direitos reservados. Informações de direitos autorais e marcas registradas. VMware, Inc. 2

3 Conteúdo 4 1 Sobre a atualização para o VMware Identity Manager Atualizando um cluster 6 2 Atualizando o VMware Identity Manager online 8 Pré-requisitos para a atualização online 8 Verificar a disponibilidade de uma atualização online do VMware Identity Manager 9 Defina as configurações do servidor proxy para o appliance do VMware Identity Manager 9 Realizar uma atualização online para a versão Atualizando o VMware Identity Manager offline 11 Pré-requisitos para a atualização offline 11 Preparar um servidor Web local para a atualização offline 12 Configurar o appliance e realizar a atualização offline 12 4 Configurações a serem definidas após a atualização 15 5 Solucionando problemas nos erros de atualização 17 Verificando os logs de erro de atualização 17 Revertendo para os instantâneos do VMware Identity Manager 18 Coletando um pacote de arquivos de log 18 VMware, Inc. 3

4 Atualizando para o VMware Identity Manager descreve como atualizar para o VMware Identity Manager de versões anteriores. Caso você prefira fazer uma nova instalação, consulte Instalação e configuração do VMware Identity Manager. Lembre-se de que uma nova instalação não preserva suas configurações existentes. Para obter mais informações sobre como usar sua instância do VMware Identity Manager atualizada, consulte o Guia do administrador do VMware Identity Manager. Público-alvo Essas informações se dirigem a qualquer um que instale, atualize e configure o VMware Identity Manager. Elas foram escritas para administradores experientes de sistemas Windows ou Linux que estão familiarizados com a tecnologia de máquina virtual. Glossário de Publicações Técnicas VMware As Publicações Técnicas VMware fornecem um glossário de termos que talvez você não conheça. Para conhecer definições de termos usados na documentação técnica da VMware, acesse VMware, Inc. 4

5 Sobre a atualização para o 1 VMware Identity Manager Há suporte para os seguintes caminhos e cenários de atualização. Caminhos de atualização com suporte Há suporte para os seguintes caminhos de atualização: Versão e posterior para a versão Importante Os comandos para a atualização online para a versão são diferentes de versões anteriores. Consulte Realizar uma atualização online para a versão para obter mais informações. Conectividade com a Internet Você pode atualizar o VMware Identity Manager online ou offline. Via de regra, o appliance do VMware Identity Manager usa o site da VMware para o procedimento de upgrade, o que exige que o appliance tenha conectividade com a Internet. Você também deve definir as configurações do servidor proxy para o appliance, se aplicável. Se o seu appliance virtual não tiver conectividade com a Internet, você poderá fazer a atualização offline. Para uma atualização offline, baixe o pacote de atualização do My VMware e configure um servidor Web local para hospedar o arquivo de atualização. Cenários de atualização Se você implantou um appliance único do VMware Identity Manager, atualize-o online ou offline conforme descrito em Capítulo 2 Atualizando o VMware Identity Manager online ou em Capítulo 3 Atualizando o VMware Identity Manager offline. Observação Espere algum tempo de inatividade porque todos os serviços são interrompidos durante a atualização. Planeje o tempo da sua atualização de acordo. Se você implantou vários appliances virtuais do VMware Identity Manager em cluster para failover ou alta disponibilidade, consulte Atualizando um cluster. VMware, Inc. 5

6 Para atualizar o VMware Identity Manager sem tempo de inatividade em um cenário de implantação de vários centros de dados, consulte "Atualizando o VMware Identity Manager sem tempo de inatividade" em Instalando e configurando o VMware Identity Manager. Atualizando um cluster Caso você tenha implantado múltiplos appliances virtuais do VMware Identity Manager em um cluster para failover ou alta disponibilidade, é possível atualizar os nós um a um. Conte com algum tempo de inatividade durante a atualização e planeje o momento para sua atualização de acordo com essa possível demora. Procedimentos 1 Tire snapshots do banco de dados e dos nós do VMware Identity Manager. 2 Remova todos os nós com exceção de um dos que constam no balanceador de carga. 3 Atualize o nó que ainda está conectado ao balanceador de carga. Siga o processo para uma atualização online ou offline, conforme descrito em Capítulo 2 Atualizando o VMware Identity Manager online ou Capítulo 3 Atualizando o VMware Identity Manager offline. Importante Conte com algum tempo de inatividade durante o processo de atualização. 4 Após a atualização do nó, deixe-o conectado ao balanceador de carga. Isso garante que o serviço do VMware Identity Manager fique disponível enquanto você atualiza os outros nós. 5 Atualize um a um os outros nós. VMware, Inc. 6

7 6 Confirme que o RabbitMQ não está sendo executado no modo de cluster nos nós atualizados. Na versão e posteriores, a agrupação em clusters do RabbitMQ foi desabilitada. Siga estes comandos para cada nó atualizado. a b Faça login no nó atualizado. Execute o seguinte comando: rabbitmqctl cluster_status O comando deve retornar um status semelhante ao seguinte: sva-1:~ # rabbitmqctl cluster_status Cluster status of node 'rabbitmq@sva-1'... [{nodes,[{disc,['rabbitmq@sva-1']}]}, {running_nodes,['rabbitmq@sva-1']}, {cluster_name,<<"rabbitmq@sva-1.hs.trcint.com">>}, {partitions,[]}, {alarms,[{'rabbitmq@sva-1',[]}]}] c Se o status incluir referências a qualquer nó diferente do nó em que você executou o comando rabbitmqctl cluster_status, execute os seguintes comandos: 1 Pare o RabbitMQ. rabbitmqctl stop_app 2 Redefina o RabbitMQ. rabbitmqctl force_reset 3 Inicie o RabbitMQ. rabbitmqctl start_app 7 Depois que todos os nós tiverem sido atualizados, adicione-os novamente ao balanceador de carga. VMware, Inc. 7

8 Atualizando o 2 VMware Identity Manager online Você pode atualizar o appliance virtual do VMware Identity Manager online. O appliance virtual deve ser capaz de conectar-se à Internet para uma atualização online. Este capítulo inclui os seguintes tópicos: Pré-requisitos para a atualização online Verificar a disponibilidade de uma atualização online do VMware Identity Manager Defina as configurações do servidor proxy para o appliance do VMware Identity Manager Realizar uma atualização online para a versão Pré-requisitos para a atualização online Antes de atualizar o appliance virtual do VMware Identity Manager online, realize estas tarefas como prérequisitos. Verifique se há ao menos 4 GB de espaço em disco na partição raiz principal do appliance virtual. Tire um snapshot de seu appliance virtual para fazer backup. Para obter mais informações sobre como tirar snapshots, consulte a documentação do vsphere. Caso você esteja usando um banco de dados externo, tire um snapshot ou faça um backup do banco de dados. Verifique se o VMware Identity Manager está adequadamente configurado. Verifique se o appliance virtual pode resolver e atingir vapp-updates.vmware.com na porta 80 por HTTP. Caso um servidor proxy HTTP seja obrigatório para acesso HTTP de saída, defina as configurações do servidor proxy para o appliance virtual. Consulte Defina as configurações do servidor proxy para o appliance do VMware Identity Manager. Confirme se há uma atualização para o VMware Identity Manager. Execute o comando adequado para verificar autualizações. Consulte Verificar a disponibilidade de uma atualização online do VMware Identity Manager. VMware, Inc. 8

9 Verificar a disponibilidade de uma atualização online do VMware Identity Manager Se o seu appliance virtual do VMware Identity Manager pode se conectar à Internet, você poderá verificar a disponibilidade de atualizações online a partir do appliance. Procedimentos 1 Faça login no appliance virtual como o usuário root. 2 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 O appliance virtual do VMware Identity Manager acessa aos servidores de atualização da VMware por meio da 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 seja configurado corretamente, defina o parâmetro para o tráfego interno como no-proxy no domínio. Observação Os servidores proxy que exigem autenticação não são suportados. Pré-requisitos Verifique se você tem a senha-raiz para o appliance virtual. Certifique-se de que você tenha as informações do servidor proxy. Observe que os servidores proxy que exigem autenticação não são suportados. Procedimentos 1 Faça login no appliance virtual do VMware Identity Manager como 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 VMware Identity Manager para usar as novas configurações de proxy. service horizon-workspace restart VMware, Inc. 9

10 Os servidores de atualização da VMware agora estão disponíveis para o appliance virtual do VMware Identity Manager. Realizar uma atualização online para a versão Caso seu appliance virtual do VMware Identity Manager tenha conectividade com a Internet, você pode atualizar o appliance online. Importante Os comandos para atualizar online para a versão são diferentes dos comandos em versões anteriores. Certifique-se de seguir estas instruções para atualizar para a versão Pré-requisitos Verifique se você atende aos pré-requisitos descritos em Pré-requisitos para a atualização online. Verifique se o appliance virtual está ligado e funcionando. Procedimentos 1 Faça login no appliance virtual do VMware Identity Manager como usuário-raiz. 2 Execute o seguinte comando no updatemgr.hzn. /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 O comando retorna a versão mais recente disponível. 4 Execute o seguinte comando para atualizar o appliance para a versão /usr/local/horizon/update/configureupdate.hzn provider --url As mensagens que surgirem durante a atualização serão salvas no arquivo update.log em /opt/vmware/var/log/update.log. 5 Verifique a versão atualizada do appliance. vamicli version --appliance A nova versão é exibida. 6 Reinicie o appliance virtual. reboot A atualização está completa. VMware, Inc. 10

11 Atualizando o VMware Identity 3 Manager offline Caso o appliance virtual do seu VMware Identity Manager 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 para usar o servidor Web lical para fazer a atualização. Este capítulo inclui os seguintes tópicos: Pré-requisitos para a atualização offline Preparar um servidor Web local para a atualização offline Configurar o appliance e realizar a atualização offline Pré-requisitos para a atualização offline Antes de atualizar o appliance virtual do VMware Identity Manager offline, realize estas tarefas como prérequisitos. Verifique se há ao menos 4 GB de espaço em disco na partição raiz principal do appliance virtual. Tire um snapshot de seu appliance virtual para fazer backup. Para obter mais informações sobre como tirar snapshots, consulte a documentação do vsphere. Caso você esteja usando um banco de dados externo, tire um snapshot ou faça um backup do banco de dados. Verifique se o VMware Identity Manager está adequadamente configurado. Confirme se há uma atualização para o VMware Identity Manager. Consulte o site do My VMware em my.vmware.com para saber se há atualizações. Prepare o servidor Web local para receber o arquivo atualizado. Consulte Preparar um servidor Web local para a atualização offline. VMware, Inc. 11

12 Preparar um servidor Web local para a atualização offline Antes de você começar a atualização offline, configure o servidor Web local criando uma estrutura de diretório que inclua um subdiretório para o appliance virtual do VMware Identity Manager. Pré-requisitos Obtenha o arquivo identity-manager buildnumber-updaterepo.zip. Vá para my.vmware.com e navegue até a página de download do produto VMware Identity Manager para baixar o arquivo. 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. 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 appliance e realizar a atualização offline Para realizar uma atualização offline, configure o appliance do VMware Identity Manager de modo que ele aponte para o servidor Web local. 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 VMware Identity Manager como o usuário root. VMware, Inc. 12

13 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 no updatemgr.hzn. /usr/local/horizon/update/updatemgr.hzn updateinstaller b Execute o seguinte comando. /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. c 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 d Verifique a versão atualizada do appliance. vamicli version --appliance O comando deve exibir a nova versão. e Reinicie o appliance virtual. Por exemplo, a partir da linha de comando, execute o seguinte comando. reboot A atualização está completa. Observe que os recursos de busca e preenchimento automático no console de administração podem não estar disponíveis por minutos após a inicialização do appliance virtual, dependendo da versão da qual você está atualizando. Na versão 2.7, os índices de pesquisa foram movidos para o Elasticsearch, um mecanismo de pesquisa e de análise incorporado no appliance do VMware Identity Manager. O processo de migração pode levar no máximo entre 15 e 20 minutos após o appliance virtual ter iniciado. VMware, Inc. 13

14 Observe também que para a pesquisa e o preenchimento automático funcionarem, a auditoria não deve estar desabilitada. Você pode verificar a configuração de auditoria na página Auditoria > da configuração > do catálogo. VMware, Inc. 14

15 Configurações a serem 4 definidas após a atualização Depois de atualizar para a versão , defina estas configurações, se necessário. As seguintes alterações foram feitas em versões anteriores à Alterações de sincronização em massa no VMware Identity Manager Nas versões anteriores, a sincronização em massa foi processada com 4 threads por CPU por meio de um parâmetro de configuração global no banco de dados chamado bulksyncthreadlimitpercpu=4. A partir da versão 2.9.1, o número de threads para o processamento de sincronização em massa não se baseia na CPU. É um número absoluto, que é, via de regra, o mesmo que o número de CPUs em um nó. Se você sincronizar um grande número de usuários e grupos e perceber que a sincronização está lenta após o upgrade, poderá especificar o número de threads definindo o parâmetro de configuração global chamado bulksyncsharedthreadcount. Defina o valor de thread no banco de dados usando a seguinte REST API e reinicie os nós para que a alteração entre em vigor. Solicitação HTTP: Operation: PUT URI: bulksyncsharedthreadcount Cabeçalhos HTTP: Content-Type: application/vnd.vmware.horizon.manager.systemconfigparameter+json Accept: application/vnd.vmware.horizon.manager.systemconfigparameter+json Authorization: HZN <operator token> Corpo da solicitação (com 8 threads, por exemplo): { "name": "bulksyncsharedthreadcount", "values": { "values": [ VMware, Inc. 15

16 } } ] "8" Se você tiver configurado um cluster do VMware Identity Manager para failover com dois nós, recomendamos a atualização para três nós. Isso acontece devido a uma limitação do Elasticsearch, um mecanismo de pesquisa e análise embutido no appliance do VMware Identity Manager. Você pode continuar a usar dois nós mas deve estar ciente de algumas limitações relacionadas ao Elasticsearch. Consulte "Configurando falha e redundância" em Instalando e configurando o VMware Identity Manager para obter mais informações. Ative a nova interface do usuário do portal. a b No console de administração, clique na seta na guia Catálogo e selecione Configurações. Selecione Nova Interface de Usuário do Portal para o Usuário Final no painel à esquerda e clique em Habilitar Nova Interface de Usuário do Portal. O protocolo TLS 1.0 está desativado por padrão no VMware Identity Manager 2.9.x. Há suporte para o TLS 1.1 e 1.2. Os problemas com produtos externos normalmente acontecem quando o TLS 1.0 está desabilitado. Recomendamos que você atualize suas outras configurações do produto para usar o TLS 1.1 ou 1.2. No entanto, se esses produtos tiverem uma dependência no TLS 1.0, você poderá habilitar o TLS 1.0 no VMware Identity Manager, de acordo com as instruções no artigo da Base de Conhecimento VMware, Inc. 16

17 Solucionando problemas nos 5 erros de atualização Você pode solucionar problemas de atualização revendo os logs de erro. Caso o VMware Identity Manager seja iniciado, você poderá retornar a uma instância anterior revertendo para um instantâneo. Este capítulo inclui os seguintes tópicos: Verificando os logs de erro de atualização Revertendo para os instantâneos do VMware Identity Manager 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 for concluída, o VMware Identity Manager não é iniciado e erros aparecem nos logs de erro. Causa Ocorreram erros durante a atualização. Solução 1 Faça login no appliance virtual do VMware Identity Manager. 2 Vá para o diretório localizado em /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. 17

18 Revertendo para os instantâneos do VMware Identity Manager Caso o VMware Identity Manager não seja iniciado de modo adequado após uma atualização, você pode reverter para uma instância anterior. Problema Após a atualização do VMware Identity Manager, 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 Retroceda até um dos snapshots que você escolheu como backup de sua instância e banco de dados externo do VMware Identity Manager originais, se for o caso. 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. Você obtém o pacote da página de configuração do appliance do VMware Identity Manager. Os seguintes arquivos de log são coletados no pacote. Tabela 5 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. VMware, Inc. 18

19 Tabela 5 1. Arquivos de log (Continuação) Componente Localização do arquivo de log Descrição Logs de Serviço (horizon.log) Logs do Catálogo Unificado (greenbox_web.log) /opt/vmware/horizon/workspace/logs/horiz on.log /opt/vmware/horizon/workspace/logs/green box_web.log O log de serviço registra a atividade que ocorre no appliance do VMware Identity Manager, como atividades relacionadas a direitos, usuários e grupos. Registra a atividade relacionada ao catálogo unificado. Procedimentos 1 Faça login na página de configuração do appliance do VMware Identity Manager em 2 Clique em Preparar pacote de logs. 3 Baixe o pacote. VMware, Inc. 19