Errors you may encounter and their meaning#

If you encounter an error or warning message from Pro Client that you don’t understand and cannot find on this page, please click the “Give feedback?” button at the top of the page and let us know so that we can add it.

User Configuration Migration in version 27.14#

Version 27.14 of Ubuntu Pro Client changed how some user configuration settings are stored on disk. It moved several settings out of /etc/ubuntu-advantage/uaclient.conf and into a file managed solely by the pro config {set,unset,show} subcommands.

Most settings should be automatically migrated to the new file when Pro Client is upgraded. If something failed you may see one of the following messages:

Migration error 1#

  • Error message:

    Warning: Failed to load /etc/ubuntu-advantage/uaclient.conf
        No automatic migration will occur.
        You may need to use "pro config set" to re-set your settings.

  • Where you’ll see it:

    During an apt upgrade or apt install ubuntu-advantage-tools.

  • What does it mean:

    This means that /etc/ubuntu-advantage/uaclient.conf could not be read or parsed as YAML during the migration.

  • What you can do about it:

    Check the contents of /etc/ubuntu-advantage/uaclient.conf and ensure it is valid YAML.

    For any setting that is nested under ua_config:

    • If you modified the value in the past, run pro config set field_name=your_custom_value

    • Delete the setting from /etc/ubuntu-advantage/uaclient.conf

    • Delete the ua_config: line from /etc/ubuntu-advantage/uaclient.conf

Migration error 2#

  • Error message:

    Warning: Failed to migrate user_config from /etc/ubuntu-advantage/uaclient.conf
        Please run the following to keep your custom settings:
          pro config set example=example

  • Where you’ll see it:

    During an apt upgrade or apt install ubuntu-advantage-tools

  • What does it mean:

    This means that /var/lib/ubuntu-advantage/user-config.json could not be written, or a JSON serialisation error occurred.

  • What you can do about it:

    Run each of the pro config set commands recommended in the warning message.

Migration error 3#

  • Error message:

    Warning: Failed to migrate /etc/ubuntu-advantage/uaclient.conf
        Please add following to uaclient.conf to keep your config:
          example: example

  • Where you’ll see it:

    During an apt upgrade or apt install ubuntu-advantage-tools

  • What does it mean:

    This means that /etc/ubuntu-advantage/uaclient.conf could not be written, or a YAML serialisation error occurred.

  • What you can do about it:

    Ensure that the settings listed in the warning output make it into your new uaclient.conf.

Warnings in versions >=27.14~#

  • Error message:

    legacy "ua_config" found in uaclient.conf

    or

    Warning: uaclient.conf contains old ua_config field.

  • Where you’ll see it:

    In /var/log/ubuntu-advantage.log after using the pro CLI or during an apt upgrade to a newer version of ubuntu-advantage-tools.

  • What does it mean:

    This means that there are still settings nested under ua_config in /etc/ubuntu-advantage/uaclient.conf. These will still be honored, but support may be removed in the future.

  • What you can do about it:

    Check the contents of /etc/ubuntu-advantage/uaclient.conf.

    For any setting that is nested under ua_config:

    • If you modified the value in the past, run pro config set field_name=your_custom_value

    • Delete the setting from /etc/ubuntu-advantage/uaclient.conf

    • Delete the ua_config: line from /etc/ubuntu-advantage/uaclient.conf