Network not found error or networking information gets reset to old entries after upgrading VMware Identity Manager or after applying patch
search cancel

Network not found error or networking information gets reset to old entries after upgrading VMware Identity Manager or after applying patch

book

Article ID: 336785

calendar_today

Updated On:

Products

VCF Operations/Automation (formerly VMware Aria Suite)

Issue/Introduction

Symptoms:

  • After upgrading VMware Identity Manager the Appliance can not be reached via SSH or Ping
  • When reviewing the VM console session a red banner is displayed stating: "NO NETWORKING DETECTED. PLEASE LOGIN AND RUN THE COMMAND..."
  • When running the Upgrade precheck from Aria Suite Lifecyle Manager the check failed at "VMware Identity Manager Network properties check"
  • When applying a patch the DNS entries get set to an old entry this was confirmed when checking the /etc/resolv.conf but this issue can also occur for other networking configurations.

 

Environment

VMware Identity Manager 3.3.x

Cause

This issue occurs due to missing or misconfigured OVF properties.

To understand the cause:

  1. To review current parsed OVF properties run this command from the appliance:

    /opt/vmware/bin/ovfenv
     
  2. Check the value of the OVF properties from the output which may show empty for some or all:

    [vami.DNS.IdentityManager]=
    [vami.domain.IdentityManager]=
    [vami.gateway.IdentityManager]=
    [vami.hostname]=
    [vami.ip0.IdentityManager]=
    [vami.netmask0.IdentityManager]=
    [vm.vmname]=

    Or the output may show: "Unable to find the ovf environment."

    A normal output of the command would be similar to this:

    [vami.DNS.IdentityManager]=###.###.###.###
    [vami.domain.IdentityManager]=example.com
    [vami.gateway.IdentityManager]=###.###.###.###
    [vami.hostname]=vidm.example.com
    [vami.ip0.IdentityManager]=###.###.###.###
    [vami.netmask0.IdentityManager]=###.###.###.###
    [vm.vmname]=IdentityManager

     
  3. To validate OVF properties you can use this command:

    /usr/local/horizon/scripts/networkwizard.hzn showovfenv

    The output may show similar to this:

    Detect ovfenv
    Try custom ovfenv
    hostname: Host name lookup failure
    Try standard ovfenv

    ovfenv: ipv4 missing gateway
    OVFENV_OK=
    OVFENV_NET_HOSTNAME=
    OVFENV_NET_DNS=
    OVFENV_IPV4_IP0=DHCP

Resolution

To resolve the issue access to the VMware Identity Manager (vIDM) VM's within vCenter Server are required with permissions to edit VM properties.

** Before proceeding please ensure a valid Backup of each VMware Identity Manager (vIDM) VM has been taken **

  1. Power off the globalenvironment from Aria Suite Lifecyle Manager.

  2. Edit the vApp Options from the vCenter Server (Configure vApp Properties) to update the values with the correct entries.

    1. Using the "ADD" or "EDIT" button, please use below table to create/validate properties:

      CategoryLabelKey class IDKey IDKey instance IDDescriptionTypeUser configurableSettings
      ApplicationTimezone setting vamitimezone Sets the selected timezone.String choiceTrue

      Choice list:

      "Pacific/Samoa", "US/Hawaii", "US/Alaska", "US/Pacific", "US/Mountain", "US/Central", "US/Eastern", "America/Caracas", "America/Argentina/Buenos_Aires", "America/Recife", "Etc/GMT-1", "Etc/UTC", "Europe/London", "Europe/Paris", "Africa/Cairo", "Europe/Moscow", "Asia/Baku", "Asia/Karachi", "Asia/Calcutta", "Asia/Dacca", "Asia/Bangkok", "Asia/Hong_Kong", "Asia/Tokyo", "Australia/Sydney", "Pacific/Noumea", "Pacific/Fiji"

      Default value: 

      Etc/UTC
      ApplicationJoin the VMware Customer Experience Improvement Program. ceip.enabled 

      VMware’s Customer Experience Improvement Program (“CEIP”) provides VMware with information that enables
            VMware to improve its products and services, to fix problems, and to advise you on how best to deploy
            and use our products.  As part of the CEIP, VMware collects technical information about your organization’s
            use of VMware products and services on a regular basis in association with your organization’s VMware license key(s).
            This information does not personally identify any individual.

            Additional information regarding the data collected through CEIP and the purposes for which it is used by VMware is set
            forth in the Trust & Assurance Center at http://www.vmware.com/trustvmware/ceip.html.
            If you prefer not to participate in VMware’s CEIP for this product, you should uncheck the box below.
            You may join or leave VMware’s CEIP for this product at any time.

      BooleanTrueDefault value: True
      ApplicationEnable Federal Information Processing Standards (FIPS) mode fips.mode.enabled Enabling FIPS mode will ensure FIPS compliant algorithms for encryption. Connector will be activated in the FIPS mode automatically.
            For AD over IWA, the minimum password length requirement for Active Directory users is 14 characters.
      BooleanTrueDefault value: False
      Networking PropertiesHost Name (FQDN) vami.hostname The FQDN name for this VM.  Leave blank for DHCP or reverse DNS to be used to lookup hostname.StringTrue 
      Networking PropertiesDefault GatewayvamigatewayIdentityManagerThe default gateway address for this VM.  Leave blank if DHCP is desired.  All fields but hostname are required for static IP.StringTrue 
      Networking PropertiesDomain NamevamidomainIdentityManagerThe domain name of this VM. Leave blank if DHCP is desired.StringTrue 
      Networking PropertiesDomain Search PathvamisearchpathIdentityManagerThe domain search path (comma or space separated domain names) for this VM. Leave blank if DHCP is desired.StringTrue 
      Networking PropertiesDNSvamiDNSIdentityManagerThe domain name servers for this VM (comma separated).  Leave blank if DHCP is desired.  All fields but hostname are required for static IP.StringTrue 
      Networking PropertiesIP Addressvamiip0IdentityManagerThe IP address for this interface.  Leave blank if DHCP is desired.  All fields but hostname are required for static IP.StringTrue 
      Networking PropertiesNetmaskvaminetmask0IdentityManagerThe netmask or prefix for this interface.  Leave blank if DHCP is desired.  All fields but hostname are required for static IP.StringTrue 
       vmnamevmvmname  StringFalseDefault value: 
      IdentityManager


    2. Set the appliance configuration by using "SET VALUE" button:

      KeyValue
      vamitimezoneleave as default 
      Etc/UTC
      ceip.enabledCan be found in Aria Suite Lifecyle Manager (vRSLCM) Product settings of global environment. Telemetry Enabled
      fips.mode.enabledCan be found in Aria Suite Lifecyle Manager (vRSLCM) Product settings of global environment. FIPS Compliance Mode
      vami.hostnameFull Qualified Domain Name of the vIDM node
      vami.gateway.IdentityManagerDefault Gateway
      vami.domain.IdentityManagerDomain
      vami.searchpath.IdentityManagerDNS searchpath
      vami.DNS.IdentityManagerDNS server, can be comma separated but require a whitespace after the comma, e.g.: 
      ###.###.#.#, ###.###.#.#
      vami.ip0.IdentityManagerIP address of the vIDM node
      vami.netmask0.IdentityManager
      Netmask
      Netmask of the vIDM node
      vm.vmnameCan not be changed


  3. Go to OVF Details, Check the box for VMware Tools under the OVF environment transport section.
  4. Power on the environment from Aria Suite Lifecyle Manager.
  5. Trigger inventory sync in Aria Suite Lifecyle Manager for the VIDM environment
  6. To validate OVF properties you can use this command:

    /usr/local/horizon/scripts/networkwizard.hzn showovfenv