updating aap

Author: kquinn1204

content/patterns/federated-edge-observability/ansible-automation-platform.adoc

@@ -12,31 +12,41 @@ include::modules/comm-attributes.adoc[]
 [id="ansible-automation-pattern"]
 == Ansible Automation Platform
 
-=== How to Log In
+=== Logging in to the Ansible Automation Platform
 
-The default login user is `admin` and the password is generated randomly at install time; you will need the password to login in to the
-AAP interface. You do not have to log in to the interface - the pattern will configure the AAP instance; the pattern retrieves the password
-using the same technique as the `ansible_get_credentials.sh` script described below. If you want to inspect the AAP instance, or change any
-aspects of its configuration, there are two ways to login and look at it. Both mechanisms are equivalent; you get the same password to the
-same instance using either technique.
+The default login user for the AAP interface is `admin, and the password is randomly generated during installation. This password is required to access the interface.
 
-=== Via the OpenShift Console
+However, logging into the interface is not necessary, as the pattern automatically configures the AAP instance. The pattern retrieves the password using the same method as the `ansible_get_credentials.sh` script (described below).
 
-In the OpenShift console, navigate to Workloads > Secrets and select the `ansible-automation-platform` project if you want to limit the number
-of Secrets you can see.
+If you need to inspect the AAP instance or modify its configuration, there are two ways to log in. Both methods provide access to the same instance using the same password.
+
+=== Logging in secret retrieved using the OpenShift Console 
 
+Follow these steps tp log in to the Ansible Automation Platform using the OpenShift console:
+
+. In the OpenShift console, go to to *Workloads* > *Secrets* and select the `ansible-automation-platform` project if you want to limit the number
+of Secrets you can see.
++
 link:/images/ansible-edge-gitops/ocp-console-secrets-aap-admin-password.png[image:/images/ansible-edge-gitops/ocp-console-secrets-aap-admin-password.png[secrets-navigation]]
 
-The Secret you are looking for is in the `ansible-automation-platform` project and is named `controller-admin-password`. If you click on it,
-you can see the Data.password field. It is shown revealed below to show that it is the same as what is shown by the script method of retrieving it below:
+.. Select the `aap-admin-password`. 
+
+.. In the Data field click *Reveal values* to display the password. 
 
 link:/images/ansible-edge-gitops/ocp-console-aap-admin-password-detail.png[image:/images/ansible-edge-gitops/ocp-console-aap-admin-password-detail.png[secrets-detail]]
 
-=== Via https://github.com/validatedpatterns/ansible-edge-gitops/blob/main/scripts/ansible_get_credentials.sh[ansible_get_credentials.sh]
+. Under *Networking* > *Routes*, click the URL for `aap` route to open the Ansible Automation Platform interface. 
+
+.. Log in using the `admin` user and the password you retrieved from the `aap-admin-password` secret. The following image shows the login screen:
++
+link:/images/ansible-edge-gitops/ocp-console-secrets-aap-admin-password.png[image:/images/federated-edge-observability/app-login.png[AAP login screen]
+
+=== Logging in using secret retrieved using https://github.com/validatedpatterns/ansible-edge-gitops/blob/main/scripts/ansible_get_credentials.sh[ansible_get_credentials.sh]
 
-With your KUBECONFIG set, you can run `./scripts/ansible-get-credentials.sh` from your top-level pattern
-directory. This will use your OpenShift cluster admin credentials to retrieve the URL for your Ansible Automation Platform instance, as well as the password for its `admin` user, which is auto-generated by the AAP operator by default. The output of the command looks like this (your password will be different):
+Follow this procedure to log in to the Ansible Automation Platform using the `ansible_get_credentials.sh` script:
 
+. From the top-level pattern directory (ensuring you have set `KUBECONFIG`), run the `ansible_get_credentials.sh` script. This script retrieves the URL for your Ansible Automation Platform instance and the password for its `admin` user. The password is auto-generated by the AAP operator by default. The output of the command looks like this (your password will be different):
++
 [source,text]
 ----
 ./scripts/ansible_get_credentials.sh