How to prevent Flex 2.0 upgrade failure due to multiple DNS search domains Configured on Flex Appliance

Article: 100048886
Last Published: 2020-11-12
Ratings: 0 0
Product(s): Appliances


The upgrade to Flex 2.0 may fail with "Installation Status: Failed” when multiple DNS search domains are configured on the appliance. To prevent the failure during the upgrade, implement the steps in this article prior to the upgrade. 

Error Message

When the system restarts after the upgrade, “Installation Status” is shown as Failed. The Common_Config playbook logs in /log/ansible/PLAYBOOK/ show an 'invalid DNS' error at the end of the file, as follows:

"msg": "Invalid DNS search domain: tulip.local tulip.local,,,," 

Task Name: Failed if DNS search domain "tulip.local tulip.local,,,," is not valid 
Error Code:  
Error: Invalid DNS search domain: tulip.local tulip.local,,,, 

Applies To

This article applies to Flex Appliance versions 1.2 and 1.3.x that are planning to upgrade to version 2.0


When multiple search domains are configured in DNS search domain, during the upgrade process invalid DNS search entries get added into the central configuration of the Flex Appliance.  


  1. Log in to the appliance node using SSH and perform the following steps from the Flex Appliance Shell:
    1. Run the system set-DNS command
    2. When prompted, specify the DNS server IP address and a single search domain. Do not specify multiple search domains to prevent failure during the 2.0 upgrade.
  2. (5340 appliances only) Once the operation completes, add a host entry for each Flex node IP address in the environment and their hostnames as follows:
    1. Run the system add-host command
    2. When prompted, specify the node IP address, short name, and domain
  3. If you have a multi-node appliance, repeat the previous steps on the other node before upgrading
  4. Once the operation has completed successfully, follow the rest of the steps to perform the upgrade. Once the upgrade has completed as "Successful", commit the upgrade and add all search domains which were removed prior to the upgrade, as follows:
    1. Run the system set-DNS command
    2. When prompted, specify the DNS server IP address and re-enter the multiple search domains.


Was this content helpful?