Using AWX and interested in trying Oracle Linux Automation Manager? Here’s how

February 29, 2024 | 6 minute read
Monica S
Technical Product Manager
Text Size 100%:

AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. If you are using AWX for your automation needs and are interested in trying Oracle Linux Automation Manager, it just takes a few steps.

Why try Oracle Linux Automation Manager?

Oracle Linux Automation Manager is derived from the open source AWX project and offers capabilities for provisioning, deployment, configuration management, and task automation. And if you’re using AWX, you can use the created resources (Users, Projects, Templates) without rebuilding them in Oracle Linux Automation Manager.

Additionally, Oracle Linux Automation Manager offers:

  • Compatibility with existing playbooks used in other automation platforms
  • Thorough testing for complex enterprise environments, conducted before every release
  • Regular bug and security fixes
  • Continuous feature enhancements, based on enterprise customer experience and requirements, for an ever-improving automation experience.
  •  Access to 24/7 Oracle Linux Premier Support (subscription required)

Setting up AWX for automation involves configuring multiple resources such as Users, Projects, Templates, Inventories, and more. If you are considering moving to an enterprise-grade solution like Oracle Linux Automation Manager but have concerns about the manual tasks and time involved in migrating data, try out the following steps.  

AWX

  • Ensure AWX CLI is installed on the AWX host.
      # pip3 install awxkit
      # awx --help
  • Generate Oauth2 token, if not already done using the following command. Throughout this demo, the AWX version used is 23.6.0. Latest AWX versions are deployed in the form of container, the following commands will login to the container to generate the token.
     # kubectl  exec -n awx -it $(kubectl get pods -n awx -l app.kubernetes.io/component=awx -o name) -c awx-task -- awx-manage create_oauth2_token --user=<username>
  • Copy the Token generated and use the same in the following command:
     # awx --conf.host http://x.x.x.x --conf.token yyyyyyy  export > awx.json

             X.X.X.X → IP Address of the AWX host.
              yyyyyyy → Token Generated from previous step.

  • If you would want to selectively export certain resources such as Users, the following option can be used.
     # awx --conf.host http://x.x.x.x --conf.token yyyyyyy  export --users > awx.json
  • File named awx.json will be created and the snippet of the file is as follows.
{
     "users": [
          {
               "username": "admin",
               "first_name": "",
               "last_name": "",
               "email": "test@example.com",
               "is_superuser": true,               "is_system_auditor": false,               "password": "",
               "related": {
                    "roles": [
                         {
                              "name": "Admin",
                              "type": "role",
                              "content_object": {
                                   "organization": null,
                                   "name": "Demo Credential",
                                   "credential_type": {
                                        "name": "Machine",
                                        "kind": "ssh",
                                        "type": "credential_type"
                                   },
                                   "type": "credential"


Oracle Linux Automation Manager

  • Copy the generated awx.json file to the host where Oracle Linux Automation Manager is installed.  
  • As an AWX user, create the oauth2 token if not already done.
#sudo su -l awx -s /bin/bash # awx-manage create_oauth2_token --user=<username>
  •  Execute the following command to import the data from awx.json file.
#awx --conf.host http://x.x.x.x --conf.token yyyyyyy import < awx.json
  • For more verbose output, use the -v switch
# awx --conf.host http://x.x.x.x --conf.token yyyyyyy import -v < awx.json

Note: There might be Forbidden Errors( 403) seen for a few resources such as Credential Types but that will not stop the import.
Once the import is completed, Login and Refresh the Oracle Linux Automation Manager User Interface to see the imported Data.


Note: The above steps are for test and educational purposes only and are not covered by product support. Once you’ve made the decision to migrate to Oracle Linux Automation Manager, you can contact the Oracle Professional Services team noted below if you need assistance.

Tailoring for your needs

Oracle Professional Services can help you take a technical solution, like Oracle Linux Automation Manager, and tailor it for your environment to help meet your business goals and overall technology strategy.
Often, a business will invest in an ‘out-the-box’ product without the knowledge of how to use it effectively. The Oracle Professional Services team is on hand to understand the unique needs of your company and optimize the introduction and integration of new technology, while getting your IT personnel thoroughly trained.
If you're looking for technical help, contact Oracle Professional Services – a team of experts directly connected to the Oracle Linux and Virtualization Development team – by sending your inquiry to opencloud_ps_ww_grp@oracle.com.

Resources

Monica S

Technical Product Manager


Previous Post

Networking for Oracle Linux systems made easy with the training video playlist

Nicolas Pares | 2 min read

Next Post


On-premises Products: Security Attestations

Nancy Kramer | 5 min read