Upgraden naar VMware Identity Manager Connector (Linux) Mei 2018 VMware Identity Manager 3.2 VMware Identity Manager

Transcriptie

1 Upgraden naar VMware Identity Manager Connector (Linux) Mei 2018 VMware Identity Manager 3.2 VMware Identity Manager

2 U vindt de recentste technische documentatie op de website van VMware: Als u opmerkingen over deze documentatie heeft, kunt u uw feedback sturen naar: docfeedback@vmware.com VMware, Inc Hillview Ave. Palo Alto, CA Copyright VMware, Inc. Alle rechten voorbehouden. Informatie over copyright en handelsmerken. VMware, Inc. 2

3 Inhoud 4 1 Over het upgraden van de VMware Identity Manager Connector 5 2 Upgrade van VMware Identity Manager Connector voorbereiden 6 Voorwaarden voor upgrade 6 Controleren of een VMware Identity Manager Connector -upgrade online beschikbaar is 7 Proxyserverinstellingen voor de VMware Identity Manager Connector -appliance configureren 7 3 Een Online-Upgrade naar de nieuwste versie uitvoeren 9 4 Een Online-Upgrade naar een specifieke versie uitvoeren 11 5 Een offline-upgrade van VMware Identity Manager Connector uitvoeren 13 Een lokale webserver gebruiken voor offline-upgrades 13 Het script updateoffline.hzn gebruiken voor offline-upgrades 15 6 Instellingen configureren na het upgraden van de connector 17 7 Problemen met upgradefouten oplossen 20 Foutlogboeken van de upgrade controleren 20 Terugdraaien naar momentopnamen van connector 20 Een logboekbestandbundel verzamelen 21 VMware, Inc. 3

4 Upgraden naar VMware Identity Manager Connector (Linux) In dit document wordt beschreven hoe u uw Linux-gebaseerde virtual appliance van VMware Identity Manager Connector upgradet. Deze handleiding is van toepassing op SaaS-implementaties, waar de virtual appliance van een connector wordt geïmplementeerd op locatie. Deze is ook van toepassing op implementaties op locatie als de implementatie extra standalone virtual appliances van de connector bevat. Doelgroep Deze informatie is bedoeld voor iedereen die de virtual appliance van de VMware Identity Manager Connector installeert, bijwerkt en configureert. De informatie is geschreven voor ervaren systeembeheerders van Windows en Linux die vertrouwd zijn met virtuele machinetechnologie. Aanvullende informatie Zie Installatie en configuratie van VMware Enterprise Systems voor informatie over het upgraden van de Windows VMware Identity Manager Connector, een onderdeel van de VMware Enterprise Systems Connector. VMware, Inc. 4

5 Over het upgraden van de VMware Identity Manager Connector 1 U kunt de virtual appliance van de VMware Identity Manager Connector online of offline upgraden. Ondersteunde upgradepaden VMware Identity Manager bevat de connector De volgende upgradepaden worden ondersteund: Van versie en hoger naar Als u een eerdere versie dan upgradet, moet u eerst upgraden naar of hoger en vervolgens upgraden naar Als u een online-upgrade uitvoert, verschijnt de meest recente versie waarnaar een upgrade is toegestaan. Upgrade naar de toegestane versie en upgrade vervolgens naar Internetverbinding Standaard gebruikt de connector de VMware-website voor de upgradeprocedure. Hiervoor moet de appliance van de connector over een internetverbinding beschikken. Indien nodig moet u ook proxyserverinstellingen voor de appliance van de connector configureren. Als uw connectorinstantie geen internetverbinding heeft, kunt u de upgrade offline uitvoeren. Voor een offline-upgrade downloadt u het upgradepakket van My VMware. U kunt het script updateoffline.hzn gebruiken om de upgrade uit te voeren of een lokale webserver instellen om het upgradepakket te hosten. VMware, Inc. 5

6 Upgrade van VMware Identity Manager Connector voorbereiden 2 Om de connectorupgrade voor te bereiden, moet u een aantal vereiste taken uitvoeren, zoals het controleren op beschikbare upgrades en het configureren van de proxyserverinstellingen voor de appliance, indien van toepassing. Dit hoofdstuk omvat de volgende onderwerpen: Voorwaarden voor upgrade Controleren of een VMware Identity Manager Connector-upgrade online beschikbaar is Proxyserverinstellingen voor de VMware Identity Manager Connector-appliance configureren Voorwaarden voor upgrade Voordat u de connector upgradet, voert u deze vereiste taken uit. Voorwaarden voor online-upgrade Controleer of de appliance van de connector vapp-updates.vmware.com kan omzetten en bereiken op poort 80 en 443 via HTTP. Controleer of een connectorupgrade bestaat. Voer de juiste opdracht uit om te controleren of er upgrades beschikbaar zijn. Zie Controleren of een VMware Identity Manager Connector-upgrade online beschikbaar is. Controleer of minstens 4 GB vrije schijfruimte beschikbaar is op de primaire rootpartitie van de appliance. Controleer of de connector correct is geconfigureerd. Maak een momentopname van de connectorappliance om er een back-up van te maken. Raadpleeg de vsphere-documentatie voor meer informatie over het maken van momentopnamen. Als een HTTP-proxyserver vereist is voor uitgaande HTTP-toegang, configureert u de proxyserverinstellingen voor de connectorappliance. Zie Proxyserverinstellingen voor de VMware Identity Manager Connector-appliance configureren. VMware, Inc. 6

7 Voorwaarden voor offline-upgrade Controleer of een connectorupgrade bestaat. Zoek op de website My VMware Downloads op my.vmware.com naar upgrades. Controleer of minstens 4 GB vrije schijfruimte beschikbaar is op de primaire rootpartitie van de appliance. Controleer of de connector correct is geconfigureerd. Maak een momentopname van de connectorappliance om er een back-up van te maken. Raadpleeg de vsphere-documentatie voor meer informatie over het maken van momentopnamen. Controleren of een VMware Identity Manager Connector - upgrade online beschikbaar is Als de appliance van de connector verbinding met internet heeft, kunt u controleren op de beschikbaarheid van online-upgrades vanaf de appliance. Procedure 1 Meld u aan op de appliance van de connector als rootgebruiker. 2 Voer de volgende opdracht uit. /usr/local/horizon/update/updatemgr.hzn updateinstaller 3 Voer de volgende opdracht uit om te controleren of er een online-upgrade is. /usr/local/horizon/update/updatemgr.hzn check Proxyserverinstellingen voor de VMware Identity Manager Connector -appliance configureren Als u een online-upgrade uitvoert, heeft de connectorappliance toegang tot de VMware-updateservers via internet. Wanneer uw netwerkconfiguratie via een HTTP-proxy zorgt voor toegang tot internet, moet u de proxyinstellingen voor de appliance aanpassen. Schakel uw proxy in om alleen internetverkeer te verwerken. Als u er zeker van wilt zijn dat de proxy goed is ingesteld, moet u de parameter voor intern verkeer binnen het domein instellen op no-proxy. Vereisten Controleer of u over het rootwachtwoord voor de appliance van de connector beschikt. Controleer of u over de informatie voor de proxyserver beschikt. Procedure 1 Meld u aan op de appliance van de connector als rootgebruiker. VMware, Inc. 7

8 2 Voer YaST in op de opdrachtregel om het hulpprogramma YaST uit te voeren. 3 Selecteer Netwerkservices in het linkerdeelvenster en selecteer Proxy. 4 Voer in de velden URL HTTP-proxy en URL HTTPS-proxy de URL's van de proxyserver in. 5 Selecteer Voltooien en sluit het hulpprogramma YaST af. 6 Herstart de Tomcat-server op de virtual appliance van de connector om de nieuwe proxyinstellingen te gebruiken. service horizon-workspace restart De VMware-updateservers zijn nu beschikbaar voor de appliance van de connector. VMware, Inc. 8

9 Een Online-Upgrade naar de 3 nieuwste versie uitvoeren U kunt uw VMware Identity Manager Connector-instantie online upgraden. Gebruik deze opdrachten om te upgraden naar de nieuwste beschikbare versie. Zie Hoofdstuk 4 Een Online-Upgrade naar een specifieke versie uitvoeren om naar een specifieke versie te upgraden in plaats van de nieuwste beschikbare versie. Vereisten Controleer of u voldoet aan de vereisten die worden beschreven in Hoofdstuk 2 Upgrade van VMware Identity Manager Connector voorbereiden. Controleer of de appliance van de connector is ingeschakeld en of deze functioneert. Procedure 1 Meld u aan op de virtual appliance van de connector als rootgebruiker. 2 Voer de volgende opdracht uit. /usr/local/horizon/update/updatemgr.hzn updateinstaller 3 Voer de volgende opdracht uit om te controleren of er een online-upgrade beschikbaar is. /usr/local/horizon/update/updatemgr.hzn check 4 Voer de volgende opdracht uit om de virtual appliance bij te werken. /usr/local/horizon/update/updatemgr.hzn update Berichten die tijdens de upgrade worden opgeslagen in de logboekbestanden /opt/vmware/var/log/update.log en /opt/vmware/var/log/vami/updatecli.log. 5 Voer de updatemgr.hzn check-opdracht opnieuw uit om te controleren of er geen nieuwere update bestaat. /usr/local/horizon/update/updatemgr.hzn check VMware, Inc. 9

10 6 Controleer de versie van de bijgewerkte virtual appliance. vamicli version --appliance De nieuwe versie wordt weergegeven. 7 Start de virtual appliance opnieuw. reboot 8 Herhaal de vorige stappen voor elke appliance van een connector in uw VMware Identity Managerimplementatie. De connectorupgrade is voltooid. VMware, Inc. 10

11 Een Online-Upgrade naar een 4 specifieke versie uitvoeren U kunt uw VMware Identity Manager connectorinstantie online upgraden naar een specifieke versie in plaats van de nieuwste beschikbare versie, indien nodig. Opmerking Zie upgraden naar de nieuwste beschikbare versie Hoofdstuk 3 Een Online-Upgrade naar de nieuwste versie uitvoeren. Vereisten Controleer of u voldoet aan de vereisten die worden beschreven in Hoofdstuk 2 Upgrade van VMware Identity Manager Connector voorbereiden. Controleer of de virtual appliance is ingeschakeld en goed werkt. Procedure 1 Meld u aan op de virtual appliance van de connector als rootgebruiker. 2 Voer de volgende opdracht uit. /usr/local/horizon/update/updatemgr.hzn updateinstaller 3 Voer de volgende opdracht uit om de appliance bij te werken naar een specifieke versie. /usr/local/horizon/update/configureupdate.hzn provider --url waarbij newversion de versie is waarnaar u wilt upgraden, in de indeling n.n.n.n. Als u wilt upgraden naar versie (de connector met VMware Identity Manager ), gebruikt u: /usr/local/horizon/update/configureupdate.hzn provider --url Als u wilt upgraden naar versie (de connector geleverd met VMware Identity Manager 3.1), gebruikt u: /usr/local/horizon/update/configureupdate.hzn provider --url VMware, Inc. 11

12 Als u wilt upgraden naar versie (de connector geleverd met VMware Identity Manager 3.2), gebruikt u: /usr/local/horizon/update/configureupdate.hzn provider --url Als u wilt upgraden naar versie (de connector met VMware Identity Manager ), gebruikt u: /usr/local/horizon/update/configureupdate.hzn provider --url Berichten die tijdens de upgrade worden opgeslagen in de logboekbestanden /opt/vmware/var/log/update.log en /opt/vmware/var/log/vami/updatecli.log. 4 Controleer de versie van de bijgewerkte virtual appliance. vamicli version --appliance De nieuwe versie wordt weergegeven. 5 Start de virtual appliance opnieuw. reboot 6 Herhaal deze stappen voor elke connectorinstantie in uw implementatie. De connectorupgrade is voltooid. VMware, Inc. 12

13 Een offline-upgrade van VMware Identity Manager Connector uitvoeren 5 Als de appliance van de VMware Identity Manager Connector geen verbinding met internet kan maken voor de upgrade, kunt u een offline-upgrade uitvoeren. Er zijn twee opties beschikbaar voor offline-upgrades. U kunt een opslagplaats voor de upgrade op een lokale webserver instellen en de appliance configureren om de lokale webserver voor de upgrade te gebruiken. Of u kunt het upgradepakket downloaden naar de connectorserver en het script updateoffline.hzn gebruiken om te upgraden. Dit hoofdstuk omvat de volgende onderwerpen: Een lokale webserver gebruiken voor offline-upgrades Het script updateoffline.hzn gebruiken voor offline-upgrades Een lokale webserver gebruiken voor offline-upgrades Als u de offline-upgrade wilt uitvoeren met een lokale webserver, bereidt u de webserver voor om het upgradebestand te hosten, configureert u de connectorappliance om te verwijzen naar de webserver en voert u de upgrade uit. Een lokale webserver voorbereiden voor offline-upgrade Voordat u de offlineconnectorupgrade start, bereidt u de lokale webserver voor door een directorystructuur met een subdirectory voor de appliance van de connector te maken. Vereisten Download het bestand identity-manager-connector-versienummer-buildnummerupdaterepo.zip van My VMware. Ga naar my.vmware.com, navigeer naar de downloadpagina van VMware Identity Manager en download het bestand dat wordt weergegeven onder VMware Identity Manager Connector offline upgrade package. Als u een IIS-webserver gebruikt, moet u de webserver configureren om speciale tekens in bestandsnamen toe te staan. U configureert dit door in het gedeelte Filtering aanvragen de optie Dubbele escapetekens toestaan te selecteren. VMware, Inc. 13

14 Procedure 1 Maak een map in de webserver op en kopieer het gedownloade zipbestand naar deze locatie. 2 Controleer of uw webserver mimetypen voor.sig (tekst/standaard) en.sha256 (tekst/standaard) bevat. Zonder deze mimetypen kan de webserver niet controleren of er updates zijn. 3 Pak het bestand uit. De inhoud van het uitgepakte ZIP-bestand wordt verkregen via De uitgepakte inhoud van het bestand bevat de volgende subdirectory's: /manifest en /packagepool. 4 Voer de volgende updatelocal.hzn-opdracht uit om de controleren of de URL geldige updateinhoud bevat. /usr/local/horizon/update/updatelocal.hzn checkurl De connector configureren en de offline-upgrade uitvoeren Configureer de appliance van de connector om te verwijzen naar de lokale webserver om een offlineupgrade uit te voeren. Upgrade dan de appliance. Vereisten Een lokale webserver voorbereiden voor offline-upgrade. Procedure 1 Meld u aan op de appliance van de connector als rootgebruiker. 2 Voer de volgende opdracht uit om een upgrade-opslagplaats die een lokale webserver gebruikt te configureren. /usr/local/horizon/update/updatelocal.hzn seturl Opmerking Om de configuratie ongedaan te maken en de mogelijkheid te herstellen om een upgrade online uit te voeren, kunt u de volgende opdracht uitvoeren. /usr/local/horizon/update/updatelocal.hzn setdefault VMware, Inc. 14

15 3 Voer de upgrade uit. a Voer de volgende opdracht uit. /usr/local/horizon/update/updatemgr.hzn updateinstaller b Voer de volgende opdracht uit om de versie van de beschikbare upgrade te controleren. /usr/local/horizon/update/updatemgr.hzn check c Voer de volgende opdracht uit om de connector bij te werken. /usr/local/horizon/update/updatemgr.hzn update Berichten die tijdens de upgrade plaatsvinden, worden opgeslagen in het bestand update.log in /opt/vmware/var/log/update.log. d Voer de opdracht updatemgr.hzn check opnieuw uit. /usr/local/horizon/update/updatemgr.hzn check e Controleer de versie van de bijgewerkte appliance. vamicli version --appliance De opdracht zou de nieuwe versie moeten weergeven. f Start de appliance van de connector opnieuw. Voer bijvoorbeeld via de opdrachtregel de volgende opdracht uit. reboot 4 Herhaal de vorige stappen voor elke appliance van een connector in uw VMware Identity Managerimplementatie. De connectorupgrade is voltooid. Het script updateoffline.hzn gebruiken voor offlineupgrades U kunt het script updateoffline.hzn gebruiken om een offline-upgrade van de virtual appliance van de VMware Identity Manager-connector uit te voeren. Download het offline-upgradepakket van de downloadpagina van VMware Identity Manager voor gebruik met het script. Het script controleert of het upgradepakket overeenkomt met het product. Bijvoorbeeld: als u de virtual appliance van de connector upgradet en u het upgradepakket van de service gebruikt in plaats van het upgradepakket van de connector, resulteert het script in een foutmelding. VMware, Inc. 15

16 Procedure 1 Zoek het script updateoffline.hzn. In versies en hoger is het script beschikbaar in het volgende pad: /usr/local/horizon/update/updateoffline.hzn Opmerking Als u het script updateoffline.hzn wilt gebruiken met een versie lager dan , kunt u het script downloaden van KB-artikel op 2 Download het bestand identity-manager-connector-versienummer-buildnummerupdaterepo.zip van de downloadpagina voor VMware Identity Manager op my.vmware.com. De aanbevolen locatie voor het opslaan van het bestand is /var/tmp. 3 Voer het script updateoffline.hzn uit als rootgebruiker. /usr/local/horizon/update/updateoffline.hzn [-r] -f upgradebestandspad -f upgradebestandspad Upgrade de appliance met upgradebestandspad. upgradebestandspad moet een absoluut pad zijn. Vereist -r Opnieuw opstarten na de upgrade. Optioneel -h Het scriptgebruik weergeven. Optioneel Bijvoorbeeld: /usr/local/horizon/update/updateoffline.hzn -f /var/tmp/identity-managerconnector updaterepo.zip 4 Als u niet de optie - r met het script hebt gebruikt, start u de virtual appliance opnieuw nadat de upgrade is voltooid. reboot VMware, Inc. 16

17 Instellingen configureren na het upgraden van de connector 6 Nadat u de upgrade naar connector hebt uitgevoerd, moet u mogelijk bepaalde instellingen configureren. Log4j-configuratiebestanden Als log4j-configuratiebestanden in een connectorinstantie zijn bewerkt, worden nieuwe versies van de bestanden tijdens de upgrade niet automatisch geïnstalleerd. Na de upgrade werken de logboeken die worden beheerd door deze bestanden, echter niet. Dit probleem oplossen: 1 Meld u aan bij de connectorinstantie. 2 Zoek naar log4j-bestanden met het achtervoegsel.rpmnew. find / -name "**log4j.properties.rpmnew" 3 Kopieer, voor elk gevonden bestand, het nieuwe bestand naar het bijbehorende oude log4j-bestand zonder het achtervoegsel.rpmnew. Citrix-integratie Voor Citrix-integratie in VMware Identity Manager 3.2 moeten alle zelfstandige connectoren versie (de connectorversie in versie 3.2) of hoger hebben. U moet ook upgraden naar Integration Broker 3.2 of hoger. Toegangscontrole op basis van rollen Toegangscontrole op basis van rollen is geïntroduceerd in VMware Identity Manager 3.2. Zie de Versieinformatie voor VMware Identity Manager 3.2voor bekende problemen. VMware, Inc. 17

18 Wijzigingen in eerdere releases Wijzigingen in versie 3.1 Vanaf versie 3.1 is een nieuwe functie geïntroduceerd die verandert hoe gebruikersgroepen worden gesynchroniseerd. Na de upgrade naar VMware Identity Manager 3.1 of hoger moet u er voor alle gebruikersgroepen die al zijn toegevoegd vóór de upgrade, voor zorgen dat rechten zijn toegewezen. Nieuwe gebruikersgroepen die zijn toegevoegd na de upgrade, worden niet gesynchroniseerd naar de VMware Identity Manager-service tot aan de groep rechten voor een bron zijn verleend, de groep is toegevoegd aan een toegangsbeleidsregel, of, vanaf versie 3.2, de groep handmatig is gesynchroniseerd via de pagina Groep > Gebruikers van de groep. Als uw rechten zijn ingesteld op ALLE GEBRUIKERS, worden gebruikers die zijn gemaakt na de upgrade, niet opgenomen als de gebruikers nog niet zijn gesynchroniseerd. Voeg rechten voor de nieuwe groep toe. Zie Hoe groepssynchronisatie werkt na de upgrade naar VMware Identity Manager 3.1 voor meer informatie. Als u gepubliceerde Citrix-bronnen met VMware Identity Manager integreert, upgradet u naar Integration Broker 3.1. Voor VMware Identity Manager 3.1 en VMware Identity Manager Connector is Integration Broker 3.1 vereist. Wijzigingen in versie 3.0 Als u gepubliceerde Citrix-bronnen integreert met VMware Identity Manager, upgradet u naar Integration Broker 3.0. VMware Identity Manager 3.0 en VMware Identity Manager Connector (de connectorversie in 3.0) zijn niet compatibel met oudere versies van de Integration Broker. Tabel 6 1. Ondersteunde versies Versie van VMware Identity Manager of Connector Ondersteunde versie van Integration Broker VMware Identity Manager VMware Identity Manager Connector (connectorversie uitgebracht met VMware Identity Manager 3.0) VMware Identity Manager of lager VMware Identity Manager Connector of lager of lager of lager Als u Horizon-desktops en -applicaties in VMware Identity Manager integreert en u een VMware Identity Manager-service of -connectorcluster hebt geïmplementeerd, moet u Horizonintegratie opnieuw configureren. In de primaire connector, waar u Horizon-bronnen hebt opgeslagen en gesynchroniseerd, voegt u ze opnieuw toe en klikt u op Opslaan en synchroniseren. VMware, Inc. 18

19 In de andere connectoren, waar u Horizon-bronnenconfiguratie hebt opgeslagen, verwijdert u alle Horizon-pods, voegt u ze opnieuw toe en klikt u op Opslaan. VMware, Inc. 19

20 Problemen met upgradefouten 7 oplossen U kunt problemen met de upgrade oplossen door de foutlogboeken te bekijken. Als de connector niet wordt gestart na de upgrade, kunt u de connector terugzetten naar een vorige instantie door terug te gaan naar een momentopname. Dit hoofdstuk omvat de volgende onderwerpen: Foutlogboeken van de upgrade controleren Terugdraaien naar momentopnamen van connector Een logboekbestandbundel verzamelen Foutlogboeken van de upgrade controleren Bekijk de foutlogboeken om fouten die tijdens de upgrade zijn opgetreden, te verhelpen. Foutlogboeken van de upgrade staan in de map /opt/vmware/var/log. Probleem Wanneer de upgrade is voltooid, start de connector niet en worden fouten in de foutlogboeken weergegeven. Oorzaak Fouten tijdens de upgrade. Oplossing 1 Meld u aan bij de appliance van de connector. 2 Ga naar de directory /opt/vmware/var/log. 3 Open het bestand update.log en de vami/updatecli.log-bestanden en bekijk de foutberichten. 4 Verhelp de fouten en voer de upgrade-opdracht opnieuw uit. De upgrade-opdracht gaat verder vanaf het punt waarop deze is gestopt. Opmerking U kunt ook terugkeren naar een momentopname en de upgrade opnieuw uitvoeren. Terugdraaien naar momentopnamen van connector Als de connector niet goed start na een upgrade, kunt u teruggaan naar een vorige instantie. VMware, Inc. 20

21 Probleem Uw connectorinstantie wordt niet correct gestart, nadat u deze hebt geüpgraded. U hebt de foutlogboeken van de upgrade gecontroleerd en u hebt de upgradeopdracht opnieuw uitgevoerd, maar het probleem is niet opgelost. Oorzaak Tijdens het upgradeproces zijn fouten opgetreden. Oplossing u Ga terug naar een van de momentopnamen die u hebt gemaakt als back-up van uw originele connectorinstantie. Raadpleeg de vsphere-documentatie voor meer informatie. Een logboekbestandbundel verzamelen U kunt een bundel van logboekbestanden verzamelen om te verzenden naar VMware Support. U kunt de bundel ophalen via de configuratiepagina voor de connector. De volgende logboekbestanden worden in de bundel verzameld. Tabel 7 1. Logboekbestanden Onderdeel Locatie van logboekbestand Beschrijving Apache Tomcat-logboeken (catalina.log) Configurator-logboeken (configurator.log) Connector-logboeken (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 Apache Tomcat neemt berichten op die niet in andere logboekbestanden worden opgenomen. Aanvragen die de configurator van de REST-client en de webinterface ontvangt. Een record van elke ontvangen aanvraag van de webinterface. Elke logboekvermelding bevat tevens de verzoek-url, het tijdstempel en de uitzonderingen. Er worden geen synchronisatie-acties geregistreerd. Procedure 1 Meld u aan op de configuratiepagina voor de connector op 2 Klik op Logboekbundel voorbereiden. 3 Download de bundel en verzend deze naar VMware Support. VMware, Inc. 21