Atualizando para o VMware Identity Manager (Linux)€¦ · Conteúdo Atualizando para o VMware Identity Manager Connector 2018.8.1.0 (Linux) 4 1 Sobre a Atualizando o VMware Identity

Atualizando para oVMware Identity ManagerConnector 2018.8.1.0(Linux)SETEMBRO DE 2018VMware Identity Manager 3.3VMware Identity Manager

Atualizando para o VMware Identity Manager Connector 2018.8.1.0 (Linux)

VMware, Inc. 2

Você pode encontrar a documentação técnica mais atualizada no site da VMware, em:

https://docs.vmware.com/br/

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:

[email protected]

Direitos autorais © 2015–2018 VMware, Inc. Todos os direitos reservados. Informações sobre direitos autorais emarca registrada.

VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com

VMware BrasilRua Surubim, 504 4º andar CEP 04571-050Cidade MonçõesSão PauloSÃO PAULO: 04571-050BrasilTel: +55 11 55097200Fax: + 55. 11. 5509-7224www.vmware.com/br

https://docs.vmware.com/br/

mailto:[email protected]

http://pubs.vmware.com/copyright-trademark.html

http://pubs.vmware.com/copyright-trademark.html

Conteúdo

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

Atualizando para o VMware IdentityManager Connector 2018.8.1.0 (Linux)

Este documento descreve como fazer upgrade do seu appliance virtual do VMware Identity ManagerConnector do Linux.

Este guia se aplica às implantações do SaaS, em que um appliance virtual do conector é implantado nolocal. Também se aplica às implantações no local quando a implantação inclui mais appliances virtuaisautônomos do conector.

Público-alvoEstas informações se dirigem a qualquer um que instale, atualize e configure o appliance virtual doVMware Identity Manager Connector. Elas foram escritas para administradores experientes de sistemasWindows ou Linux que estão familiarizados com a tecnologia de máquina virtual.

Informações adicionaisPara obter informações sobre como atualizar o VMware Identity Manager Connector para Windows, umcomponente do VMware Enterprise Systems Connector, consulte a Instalação e configuração do VMwareEnterprise Systems.

VMware, Inc. 4

Sobre a Atualizando o VMwareIdentity Manager Connector 1Você pode atualizar o appliance virtual do VMware Identity Manager Connector online ou offline.

Caminhos de atualização com suporteO VMware Identity Manager 3.3 inclui o conector 2018.8.1.0.

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

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

Para atualizar de uma versão anterior para a 2017.8.1.0, primeiro atualize para a 2017.8.1.0 ouposteriores e, em seguida, para a 2018.8.1.0. Quando você executa uma atualização on-line, é exibida aversão mais recente para a qual a atualização é permitida. Atualize para a versão permitida e, emseguida, para a 2018.8.1.0.

Conectividade com a InternetComo padrão, o conector usa o site da VMware para o procedimento de atualização, o qual exige que oappliance do conector tenha acesso à Internet. Você também deve configurar as definições do servidorproxy 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. Parauma atualização offline, você pode baixar o pacote de atualização do My VMware. Você pode usar oscript updateoffline.hzn para realizar a atualização ou configurar um servidor Web local parahospedar o pacote de atualização.

VMware, Inc. 5

Preparando para atualizar oVMware Identity ManagerConnector 2Para preparar a atualização do conector, você deve executar uma série de tarefas de pré-requisito, comoverificar atualizações disponíveis e configurar as definições do servidor proxy para o appliance, seaplicá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çãoAntes de atualizar o conector, realize essas tarefas de pré-requisitos.

Pré-requisitos para a atualização onlinen 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 verificarautualizações. Consulte Verificar a disponibilidade de uma atualização online do VMware IdentityManager Connector.

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

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çõessobre 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 doservidor proxy do appliance do conector. Consulte Defina as configurações do servidor proxy para oappliance do VMware Identity Manager Connector.

VMware, Inc. 6

Pré-requisitos para a atualização offlinen 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 doappliance.

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çõessobre como tirar snapshots, consulte a documentação do vSphere.

Verificar a disponibilidade de uma atualização online doVMware Identity Manager ConnectorSe seu appliance do conector tem conectividade à Internet, é possível verificar a disponibilidade deatualizaçõ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 oappliance do VMware Identity Manager ConnectorSe você realizar uma atualização online, o appliance do conector acessará os servidores de atualizaçãoda VMware pela Internet. Caso sua configuração de rede forneça acesso à Internet por meio de umproxy 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 estejaconfigurado 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



VMware, Inc. 7

http://my.vmware.com

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

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çãoonline para a versão maisrecente 3Você pode atualizar a instância do VMware Identity Manager Connector online. Use estes comandospara 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

n Verifique se você atende aos pré-requisitos descritos em Capítulo 2Preparando para atualizar oVMware 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 delog /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çãomais recente.


VMware, Inc. 9

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 doVMware Identity Manager.

A atualização do conector é concluída.


VMware, Inc. 10

Realizando uma atualizaçãoonline para uma versãoespecífica 4Você pode atualizar sua instância do conector do VMware Identity Manager on-line para uma versãoespecí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 umaatualização online para a versão mais recente.

Pré-requisitos

n Verifique se você atende aos pré-requisitos descritos em Capítulo 2Preparando para atualizar oVMware 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 Manager2.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 Manager3.1), use:



VMware, Inc. 11




n Para atualizar para a versão 2018.1.1.1 (o conector lançado com o VMware Identity Manager3.2.0.1), use:






As mensagens que ocorrem durante a atualização são salvas nos arquivos delog /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.



VMware, Inc. 12

Realizando uma atualizaçãooffline do VMware IdentityManager Connector 5Caso o appliance virtual do VMware Identity Manager Connector não consiga conectar-se à Internet parafazer 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 deatualização em um servidor Web local e configurar o appliance para usar o servidor Web local para fazera atualização. Ou você pode baixar o pacote de atualização para o servidor do conector e usar o scriptupdateoffline.hzn para fazer a atualização.

Este capítulo inclui os seguintes tópicos:

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 offlineSe você quiser executar a atualização offline usando um servidor Web local, prepare o servidor Webpara hospedar o arquivo de atualização, configure o appliance do conector para apontar para o servidorWeb e execute a atualização.

Preparar um servidor Web local para a atualização offlineAntes de iniciar a atualização offline do conector, prepare o servidor Web local criando uma estrutura dediretório que inclui um subdiretório para o appliance do conector.

Pré-requisitos

n Baixe o arquivo identity-manager-connector-versionNumber-buildNumber-updaterepo.zipdo My VMware. Vá para my.vmware.com, procure a página Baixar VMware Identity Manager e baixeo 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 nosnomes de arquivo. Você configura isso na seção Solicitação de filtroselecionando a opção Permitirescape duplo.

Procedimentos

1 Crie um diretório no servidor Web em http://YourWebServer/VM/ e copie o arquivo zip baixado paraele.

VMware, Inc. 13


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 deatualização válido.

/usr/local/horizon/update/updatelocal.hzn checkurl http://YourWebServer/VM

Configurar o conector e realizar a atualização offlineConfigure o appliance do conector para apontar ao servidor Web local para realizar uma atualizaçãooffline. 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 Weblocal.

/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çãoonline, 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.



VMware, Inc. 14

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.logem /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 doVMware Identity Manager.


Usando o script updateoffline.hzn para atualização offlineVocê pode usar o script updateoffline.hzn para realizar uma atualização offline do appliance virtual doconector do VMware Identity Manager. Baixe o pacote de atualização offline da página de download doproduto 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ê estiveratualizando o appliance virtual do conector e usar o pacote de atualização do serviço em vez do pacotede 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.

2 Baixe o arquivo identity-manager-connector-versionNumber-buildNumber-updaterepo.zipda 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

https://kb.vmware.com/s/article/2147931


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.8.1.0-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 daatualização.

reboot


VMware, Inc. 16

Configurar as definições apósatualização do conector 6Depois de atualizar para o conector 2018.8.1.0, você pode precisar definir determinadas configurações.

Arquivos de configuração Log4jSe algum arquivo de configuração log4j em uma instância de conector tiver sido editado, novas versõesdos arquivos não serão instaladas automaticamente durante o upgrade. No entanto, após o upgrade, oslogs 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 correspondentesem o sufixo .rpmnew.

Integração do CitrixPara realizar a integração do Citrix no VMware Identity Manager 3.3, todos os conectores autônomosdevem ter a versão 2018.8.1.0 (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 IntegrationBroker. Desinstale a versão antiga e, em seguida, instale a nova versão.

VMware, Inc. 17

Alterações em versões anteriores

Alterações na versão 3.1n 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 todosos 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 doVMware Identity Manager até que o grupo tenha direito a um recurso, seja adicionado a uma regrade 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 gruposcriados 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 IdentityManager 3.1 para obter mais informações.

Alterações na versão 3.0n 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 aintegração do Horizon novamente.

n No conector primário, onde os recursos do Horizon foram salvos e sincronizados, remova todosos pods do Horizon, adicione-os novamente e clique em Salvar e Sincronizar.

n Nos outros conectores, onde você salvou a configuração de recursos do Horizon, remova todosos pods do Horizon, adicione-os novamente e clique em Salvar.


VMware, Inc. 18

https://docs.vmware.com/br/VMware-Identity-Manager/3.2/idm-administrator_aw/GUID-51A78F73-8F3F-40FC-9297-28C90DF5F26B.html

https://docs.vmware.com/br/VMware-Identity-Manager/3.2/idm-administrator_aw/GUID-51A78F73-8F3F-40FC-9297-28C90DF5F26B.html

Solucionando problemas noserros de atualização 7Você pode solucionar problemas de atualização revendo os logs de erro. Se o conector não for iniciadoapós o upgrade, você poderá reverter para uma instância anterior retornando a um snapshot.

Este capítulo inclui os seguintes tópicos:

n Verificando os logs de erro de atualização

n Revertendo para snapshots do conector

n Coletando um pacote de arquivos de log

n Erro de rede após a atualização

Verificando os logs de erro de atualizaçãoResolva os erros que ocorrem durante a atualização revisando os logs de erro. Os arquivos de log deatualizaçã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çãonovamente.

VMware, Inc. 19

Revertendo para snapshots do conectorSe o conector não for iniciado de modo adequado após uma atualização, você poderá reverter para umainstância anterior.

Problema

Depois de atualizar a instância do conector, ele não é iniciado corretamente. Você reviu os logs de errosda 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 logVocê pode coletar um pacote de arquivos de log para enviar ao suporte da VMware. Você obtém opacote 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 ApacheTomcat que não estão registradas emoutros arquivos de log.

Logs do Configurador(configurator.log)

/opt/vmware/horizon/workspace/logs/confi

gurator.log

Solicita que o Configurador receba docliente REST e da interface Web.

Logs do conector /opt/vmware/horizon/workspace/logs/conne

ctor.log

Um registro de cada solicitação recebidada interface Web. Cada entrada de loginclui também a URL, o carimbo dedata/hora e as exceções da solicitação.Nenhuma ação de sincronização éregistrada.

/opt/vmware/horizon/workspace/logs/conne

ctor-dir-sync.log

Mensagens relacionadas à sincronizaçãode diretório.

Logs de serviço /opt/vmware/horizon/workspace/logs/horiz

on.log

O VMware Identity Manager registra aatividade que ocorre no appliance doworkspace-va, como atividadesrelacionadas a direitos, usuários egrupos.

Procedimentos

1 Faça login na página de configuração do conector em https://connectorURL:8443/cfg/logs.


VMware, Inc. 20

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çãoDepois 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 ocomando 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

Documents

Atualizando para o VMware Identity Manager (Linux)€¦ · Conteúdo Atualizando para o VMware Identity Manager Connector 2018.8.1.0 (Linux) 4 1 Sobre a Atualizando o VMware Identity