InfiniBand Bring-up Tool v4.0.0
InfiniBand Bring-up Tool v4.0.0

AWX Interface

This section describes how to use the AWX web-based interface.

To log into AWX, browse to AWX interface at http://<AWX-server-name>/ and log in with a valid AWX username and password.

welcome-to-awx-version-1-modificationdate-1709767576233-api-v2.png

The default username set during installation has admin capabilities. The credentials can be accessed in the awx-cluster-bringup-admin-password secret. TBD verify

To retrieve the admin password, run the following command on your AWX host:

Copy
Copied!
            

$ kubectl get secret awx-cluster-bringup-admin-password -o jsonpath="{.data.password}" | base64 --decode

Warning

You can specify the controller_oauthtoken variable with OAuth token for your AWX controller instance instead of using controller_username and controller_password variables.

Refer to the official Ansible Tower Users documentation for information on users.

To view a list of the users currently configured, navigate to Access > Users:

awx-users-menu-version-1-modificationdate-1709767576677-api-v2.png

Warning

When modifying your own password, log out and log back in for it to take effect.

The following example shows how to update admin user details:

  1. Navigate to Access > Users.

  2. Click the "Edit User" icon which opens the "Edit Details" dialog box.

    awx-edit-user-version-1-modificationdate-1709767577060-api-v2.png

  3. Update the appropriate details for the following fields:

    • First Name

    • Last Name

    • Email

    • Password

    • Confirmation Password

      awx-edit-user-details-version-1-modificationdate-1709767577443-api-v2.png

  4. Click the "Save" button when finished.

Credentials are utilized by AWX for authentication when launching jobs against machines, synchronizing with inventory sources, and importing project content from a version control system. Refer to the official Ansible Tower Credentials documentation for further information.

Note

These credentials are used for all hosts configured in the hosts inventory list.

To view a list of the credentials that are currently configured, navigate to Resources > Credentials.

awx-credentials-menu-version-1-modificationdate-1709767577713-api-v2.png

"Default" is configured to use the SSH protocol with the root username.

The following example shows how to update credentials:

  1. Click the "Edit Credential" icon. This opens the "Edit Details" dialog.

    awx-edit-credential-version-1-modificationdate-1709767575767-api-v2.png

  2. Update the appropriate details for the following fields to use for SSH authentication:

    • Username

    • Password

      awx-edit-credential-details-version-1-modificationdate-1709767575490-api-v2.png

  3. Click "Save" when finished.

Privilege Escalation

The following example shows how to update the privilege escalation credentials.

This can be useful when needing root access to run jobs while not needing to specify a password.

  1. Update the "Username" and "Password" fields as described under section "Credentials", with the username and password of the superuser.

  2. Update the appropriate details for the following fields:

    1. Username – root

    2. Password – password of superuser

      privilege-escalation-version-1-modificationdate-1709767571367-api-v2.png

  3. Click "Save" when finished.

  4. Navigate to "Inventories" on the AWX menu and select "IB Cluster Inventory". Add/set the privilege_esc variable to true.

    privilege_esc-version-1-modificationdate-1709767570987-api-v2.png

SSH Private Key

The following example shows how to update credentials utilizing the "SSH Private Key" method.

This can be useful when root access is needed to run jobs when not having the password to the user but having the SSH private key.

  1. Click the "Edit Credential" icon. This opens the "Edit Details" dialog.

    using-ssh-private-key-version-1-modificationdate-1709767570450-api-v2.png

  2. Update the "SSH Private Key". You can either drag a file that contains the SSH private key or copy and paste the file content into the box.

    update-ssh-private-key-version-1-modificationdate-1709767569777-api-v2.png

  3. Click "Save" when finished.

The inventory includes a collection of hosts against which jobs may be launched. Inventories are divided into groups containing the actual hosts. Refer to the official Ansible Tower Inventories documentation for further information.

To view a list of the inventories currently available, go to Resources > Inventories.

awx-inventories-menu-version-1-modificationdate-1709767575093-api-v2.png

A job template is a definition and set of parameters for running an Ansible job. Job templates are useful to execute a single task many times. Refer to the official Ansible Tower Job Templates documentation for further information.

To view a list of the job templates currently available, go to Resources > Templates.

awx-templates-menu-version-1-modificationdate-1709767574740-api-v2.png

You can view a short description of the job template by selecting one from the list.

awx-templates-description-version-1-modificationdate-1709767574353-api-v2.png

In this example, the inventory to be used for this job template is defined as "IB Cluster Inventory" and the credentials for the hosts are defined as "Default".

To launch a job template, click the "Launch Template" icon.

awx-templates-launch-version-1-modificationdate-1709767573970-api-v2.png

To edit settings for a job template, click the "Edit Template" icon:

awx-templates-edit-version-1-modificationdate-1709767573593-api-v2.png

A workflow job template links together a sequence of disparate resources that accomplishes the task of tracking the full set of jobs that are part of the release process as a single unit. Refer to the official Ansible Tower Workflows and Ansible Tower Workflow Job Templates documentation for further information.

To view a list of the workflow job templates currently available, go to Resources > Templates.

awx-templates-workflow-version-1-modificationdate-1709767572970-api-v2.png

Workflow templates have a visualizer action that displays a graphical way of linking together job templates, workflow templates, project syncs, and inventory syncs.

To view the graph-like structure, click the "Visualizer" icon on a particular workflow:

awx-templates-visualizer-version-1-modificationdate-1709767572633-api-v2.png

Example visualization:

awx-templates-visualization-version-1-modificationdate-1709767571920-api-v2.png

© Copyright 2023, NVIDIA. Last updated on Mar 18, 2024.