UBUNTU-ADVANTAGE

Section: Ubuntu Advantage (1)
Updated: 29 March 2019
Page Index

NAME

ubuntu-advantage - Manage Ubuntu Advantage services from Canonical

SYNOPSIS

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

DESCRIPTION

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.

COMMANDS

attach [token]

Connect an Ubuntu Advantage support contract to this machine.

The optional token parameter can be obtained from https://auth.contracts.canonical.com/. When no token is provided, users are prompted for their Ubuntu SSO login credentials to https://login.ubuntu.com, which will enable an individual contract on the system.

detach

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

Disable this machine's access to an Ubuntu Advantage support services.

Activate and configure this machine's access to an Ubuntu Advantage services.

status [--format=table|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 system.

Each service status line has three columns:

name: name of the service

availability: whether the contract entitles use of this service. Possible values are: none or entitled

status: whether the service is activated on this machine. Possible values are: active, inactive, or n/a

version

Show version of the Ubuntu Advantage package.

SERVICES

Common Criteria EAL2 Provisioning (cc)

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 Ubuntu Long-term support (LTS) systems through Ubuntu Advantage for Infrastructure.

See https://ubuntu.com/esm 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 https://www.ubuntu.com/server/livepatch for more information.