Chapter 14. The awx-manage Utility Use the awx-manage utility to access detailed internal information of automation controller. Commands for awx-manage must run as the awx user only. 14.1. Inventory Import awx-manage is a mechanism by which an automation controller administrator can import inventory directly into automation controller. To use awx-manage properly, you must first create an inventory in automation controller to use as the destination for the import. For help with awx-manage , run the following command: awx-manage inventory_import [--help] The inventory_import command synchronizes an automation controller inventory object with a text-based inventory file, dynamic inventory script, or a directory of one or more, as supported by core Ansible. When running this command, specify either an --inventory-id or --inventory-name , and the path to the Ansible inventory source ( --source ). awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1 By default, inventory data already stored in automation controller blends with data from the external source. To use only the external data, specify --overwrite . To specify that any existing hosts get variable data exclusively from the --source , specify --overwrite_vars . The default behavior adds any new variables from the external source, overwriting keys that already exist, but preserving any variables that were not sourced from the external data source. awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1 --overwrite Note Edits and additions to Inventory host variables persist beyond an inventory synchronization as long as --overwrite_vars is not set. 14.2. Cleanup of old data awx-manage has a variety of commands used to clean old data from automation controller. Automation controller administrators can use the automation controller Management Jobs interface for access or use the command line. awx-manage cleanup_jobs [--help] This permanently deletes the job details and job output for jobs older than a specified number of days. awx-manage cleanup_activitystream [--help] This permanently deletes any [Activity stream] data older than a specific number of days. 14.3. Cluster management For more information about the awx-manage provision_instance and awx-manage deprovision_instance commands, see Clustering . Note Do not run other awx-manage commands unless instructed by Ansible Support. 14.4. Analytics gathering Use this command to gather analytics on-demand outside of the predefined window (the default is 4 hours): USD awx-manage gather_analytics --ship For customers with disconnected environments who want to collect usage information about unique hosts automated across a time period, use this command: awx-manage host_metric --since YYYY-MM-DD --until YYYY-MM-DD --json The parameters --since and --until specify date ranges and are optional, but one of them has to be present. The --json flag specifies the output format and is optional.

Commands:
awx-manage inventory_import [--help]
awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1
awx-manage inventory_import --source=/ansible/inventory/ --inventory-id=1 --overwrite
awx-manage cleanup_jobs [--help]
awx-manage cleanup_activitystream [--help]
awx-manage gather_analytics --ship
awx-manage host_metric --since YYYY-MM-DD --until YYYY-MM-DD --json