Fazendo upgrade para o VMware Identity Manager Connector (Linux) MAIO DE 2018 VMware Identity Manager 3.2 VMware Identity Manager

(1)

Fazendo upgrade para o VMware Identity Manager Connector 2018.1.1.1

(Linux)

MAIO DE 2018

VMware Identity Manager 3.2

VMware Identity Manager

(2)

Fazendo upgrade para o VMware Identity Manager Connector 2018.1.1.1 (Linux)

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.

(3)

Conteúdo

Atualizando para o VMware Identity Manager Connector 2018.1.1.1 (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 20

Verificando os logs de erro de atualização 20 Revertendo para snapshots do conector 20 Coletando um pacote de arquivos de log 21

(4)

Atualizando para o VMware Identity Manager Connector 2018.1.1.1 (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.

(5)

Sobre a Atualizando o VMware

Identity Manager Connector 1

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.2.0.1 inclui o conector 2018.1.1.1.

Há suporte para os seguintes caminhos de atualização:

n Da versão 2017.8.1.0 e posteriores para a versão 2018.1.1.1

Para fazer upgrade de uma versão anterior para a 2017.8.1.0, primeiro faça upgrade para a 2017.8.1.0 ou posteriores e, em seguida, para a 2018.1.1.1. Quando você executa um upgrade on-line, é exibida a versão mais recente para a qual o upgrade é permitido. Atualize para a versão permitida e, em seguida, para a 2018.1.1.1.

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.

(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:

n Pré-requisitos para atualização

n Verificar a disponibilidade de uma atualização online do VMware Identity Manager Connector

n 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

n Verifique se o appliance do conector pode resolver e alcançar vapp-updates.vmware.com nas portas 80 e 443 sobre HTTP.

n 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.

n Verifique se pelo menos 4 GB de espaço em disco está disponível na partição raiz primária do appliance.

n Verifique se o conector está adequadamente configurado.

n 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.

n 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.

(7)

Pré-requisitos para a atualização offline

n Confirme se existe uma atualização do conector. Procure por atualizações no site My VMware Downloads em my.vmware.com.

n Verifique se pelo menos 4 GB de espaço em disco está disponível na partição raiz primária do appliance.

n Verifique se o conector está adequadamente configurado.

n 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

n Verifique se você tem a senha root do appliance do conector.

n Certifique-se de que você tenha as informações do servidor proxy.

Procedimentos

(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.

(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 4 Realizando uma atualização online para uma versão específica.

Pré-requisitos

n Verifique se você atende aos pré-requisitos descritos em Capítulo 2 Preparando para atualizar o VMware Identity Manager Connector.

n 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.

3 Execute o seguinte comando para verificar se existe a atualização online.

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.

(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.

(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 3 Realizando uma atualização online para a versão mais recente.

Pré-requisitos

n Verifique se você atende aos pré-requisitos descritos em Capítulo 2 Preparando para atualizar o VMware Identity Manager Connector.

n Verifique se o appliance virtual está ligado e funcionando.

Procedimentos

1 Faça login no appliance virtual do conector como o usuário raiz.

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 https://vapp-updates.vmware.com/vai- catalog/valm/vmw/8F11A214-F782-11E1-B9EB-86776188709B/newVersion

onde newVersion é a versão para a qual você deseja atualizar, no formato n.n.n.n.

n Para atualizar para a versão 2017.7.1.1 (o conector lançado com o VMware Identity Manager 2.9.2.1), use:

/usr/local/horizon/update/configureupdate.hzn provider --url https://vapp-

updates.vmware.com/vai-catalog/valm/vmw/8F11A214-F782-11E1-B9EB-86776188709B/2017.7.1.1 n Para atualizar para a versão 2017.12.1.0 (o conector lançado com o VMware Identity Manager

3.1), use:

updates.vmware.com/vai-catalog/valm/vmw/8F11A214-F782-11E1-B9EB-86776188709B/2017.12.1.0

(12)

n Para atualizar para a versão 2018.1.1.0 (o conector lançado com o VMware Identity Manager 3.2), use:

updates.vmware.com/vai-catalog/valm/vmw/8F11A214-F782-11E1-B9EB-86776188709B/2018.1.1.0 n Para atualizar para a versão 2018.1.1.1 (o conector lançado com o VMware Identity Manager

3.2.0.1), use:

updates.vmware.com/vai-catalog/valm/vmw/8F11A214-F782-11E1-B9EB-86776188709B/2018.1.1.1

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.

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.

(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.

n Usando um servidor Web local para a atualização offline

n 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

n 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.

n 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.

(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 http://YourWebServer/VM/.

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 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

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.

b Execute o seguinte comando para verificar a versão da atualização disponível.

(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.

e Verifique a versão atualizada do 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.

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 2017.12.1.0 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 à 2017.12.1.0, você pode baixar o script do artigo da KB 2147931 em https://kb.vmware.com.

(16)

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.

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-manager- connector-2018.1.1.1-8435207-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

(17)

Configurar as definições após

atualização do conector 6

Depois de atualizar para o conector 2018.1.1.1, 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.2, todos os conectores autônomos devem ter a versão 2018.1.1.0 (a versão do conector na versão 3.2) ou posteriores.

Você também deve fazer upgrade para o Integration Broker 3.2 ou posteriores.

Controle de acesso baseado em funções

O controle de acesso baseado em funções foi introduzido no VMware Identity Manager 3.2. Para obter os problemas conhecidos, consulte as Notas da versão do VMware Identity Manager 3.2.

(18)

Alterações em versões anteriores Alterações na versão 3.1

n 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.

n Se você integrar recursos publicados Citrix ao VMware Identity Manager, atualize para o Integration Broker 3.1. O VMware Identity Manager 3.1 e o VMware Identity Manager Connector 2017.12.1.0 exigem o Integration Broker 3.1.

Alterações na versão 3.0

n 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 6‑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)

3.0

VMware Identity Manager 2.9.1 ou anterior 2.9.1 ou anterior VMware Identity Manager Connector 2.9.1 ou anterior 2.9.1 ou anterior

n 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.

(19)

n 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.

(20)

Solucionando problemas nos

erros de atualização 7

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.

n Verificando os logs de erro de atualização

n Revertendo para snapshots do conector

n 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 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.

(21)

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)

/opt/vmware/horizon/workspace/logs/catal ina.log

As mensagens de registro do Apache Tomcat que não estão registradas em outros arquivos de log.

Logs do Configurador (configurator.log)

/opt/vmware/horizon/workspace/logs/confi gurator.log

Solicita que o Configurador receba do cliente REST e da interface Web.

Logs do Conector (connector.log)

/opt/vmware/horizon/workspace/logs/conne ctor.log

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.