Provided by: ubuntu-advantage-tools_20.3_amd64 bug


       ubuntu-advantage - Manage Ubuntu Advantage services from Canonical


       ua <command> [<args>]
       ubuntu-advantage <command> [<args>]


       Ubuntu  Advantage  is  a  collection of services offered by Canonical to Ubuntu users. The
       Ubuntu Advantage command line tool is used to attach  a  system  to  an  Ubuntu  Advantage
       contract  to  then  enable and disable services from Canonical. The available commands and
       services are described in more detail below.


       attach [--no-auto-enable] <token>
              Connect an Ubuntu Advantage support contract to this machine.

              The token parameter can be obtained from

              The optional  --no-auto-enable  flag  will  disable  the  automatic  enablement  of
              recommended  entitlements  which  usually  happens  immediately  after a successful

       detach Remove the Ubuntu Advantage support contract from this machine. This also  disables
              all enabled services that can be.

       disable [cc-eal|cis-audit|esm|fips|fips-updates|livepatch]
              Disable this machine's access to an Ubuntu Advantage service.

       enable [cc-eal|cis-audit|esm|fips|fips-updates|livepatch]
              Activate and configure this machine's access to an Ubuntu Advantage service.

              Refresh contract and service details from Canonical.

       status [--format=tabular|json]
              Report current status of Ubuntu Advantage services on system.

              This  shows  whether  this  machine  is  attached  to  an  Ubuntu Advantage support
              contract. When attached, the report includes the specific support contract  details
              including  contract  name,  expiry  dates,  and  the status of each service on this

              The attached status output has four columns:

              SERVICE: name of the service

              ENTITLED: whether the contract to which this machine is attached  entitles  use  of
              this service. Possible values are: yes or no

              STATUS:  whether  the  service  is  enabled  on this machine.  Possible values are:
              enabled, disabled, n/a (if your contract entitles you to the service, but it  isn't
              available for this machine) or  (if you aren't entitled to this service)

              DESCRIPTION: a brief description of the service

              The unattached status output instead has three columns. SERVICE and DESCRIPTION are
              the same as above, and there is the addition of:

              AVAILABLE: whether this service would be available if this machine  were  attached.
              The possible values are yes or no.

              Show version of the Ubuntu Advantage package.


       By  default,  Ubuntu  Advantage  client  configuration  options are read from /etc/ubuntu-

       The following configuration options are available:

              The ubuntu advantage contract server URL

              Where Ubuntu Advantage client stores its data files

              The logging level used when writing to log_file

              The log file for the Ubuntu Advantage client

       Additionally, any configuration option can be overridden in the environment by setting  an
       environment   variable   prefaced   by  UA_<option_name>.  Both  uppercase  and  lowercase
       environment variables are allowed.

       For example, the following overrides the log_level found in uaclient.conf:

         UA_LOG_LEVEL=info ua attach


       Common Criteria EAL2 Provisioning (cc-eal)
              Enables and install the Common Criteria artifacts.

              The artifacts include a configure script, a tarball with additional  packages,  and
              post  install  scripts. The artifacts will be installed in /usr/lib/common-criteria
              directory   and   the   README   and   configuration   guide   are   available   in
              /usr/share/doc/ubuntu-commoncriteria directory.

       CIS Audit (cis-audit)
              Enables and installs the CIS Audit artifacts.

       Extended Security Maintenance (esm)
              Extended Security Maintenance ensures the ongoing security and integrity of systems
              running Ubuntu Long Term  Support  (LTS)  releases  through  Ubuntu  Advantage  for

              See for more information.

       FIPS 140-2 certified modules (fips)
              Install, configure, and enable FIPS 140-2 certified modules.

              After  successfully  enabling  FIPS, the system MUST be rebooted. Failing to reboot
              will result in the system not running the updated FIPS kernel.

              Disabling FIPS is not currently supported.

       FIPS 140-2 certified modules with updates (fips-updates)
              Install, configure, and enable FIPS 140-2 certified modules with updates.  Enabling
              FIPS  with  updates  will  take  the  system  out of FIPS compliance as the updated
              modules are not FIPS certified.

              After successfully enabling FIPS with updates, the system MUST be rebooted. Failing
              to reboot will result in the system not running the updated FIPS kernel.

              Disabling FIPS with updates is not currently supported.

       Livepatch Service (livepatch)
              Automatically  apply  critical  kernel patches without rebooting. Reduces downtime,
              keeping your Ubuntu LTS systems secure and compliant.

              See for more information.


       Please report bugs either by  running  `ubuntu-bug  ubuntu-advantage-tools`  or  login  to
       Launchpad   and  navigate  to


       Copyright (C) 2019-2020 Canonical Ltd.