Merge pull request #60120 from dfitzmau/OCPBUGS-9123

Author: adellape

modules/installation-launching-installer.adoc

@@ -364,8 +364,7 @@ For production {product-title} clusters on which you want to perform installatio
 ====
 ifdef::aws[]
 .. Select *aws* as the platform to target.
-.. If you do not have an Amazon Web Services (AWS) profile stored on your computer, enter the AWS
-access key ID and secret access key for the user that you configured to run the
+.. If you do not have an Amazon Web Services (AWS) profile stored on your computer, enter the AWS access key ID and secret access key for the user that you configured to run the
 installation program.
 +
 [NOTE]
@@ -377,8 +376,7 @@ The AWS access key ID and secret access key are stored in `~/.aws/credentials` i
 endif::aws[]
 ifdef::azure,ash[]
 .. Select *azure* as the platform to target.
-.. If you do not have a Microsoft Azure profile stored on your computer, specify the
-following Azure parameter values for your subscription and service principal:
+.. If the installation program cannot locate the `osServicePrincipal.json` configuration file, which contains Microsoft Azure profile information, in the `~/.azure/` directory on your computer, the installer prompts you to specify the following Azure parameter values for your subscription and service principal.
 *** *azure subscription id*: The subscription ID to use for the cluster.
 Specify the `id` value in your account output.
 *** *azure tenant id*: The tenant ID. Specify the `tenantId` value in your
@@ -387,6 +385,12 @@ account output.
 for the service principal.
 *** *azure service principal client secret*: The value of the `password`
 parameter for the service principal.
++
+[IMPORTANT]
+====
+After you enter values for the previously listed parameters, the installation program creates a `osServicePrincipal.json` configuration file and stores this file in
+the `~/.azure/` directory on your computer. These actions ensure that the installation program can load the profile when it is creating an {product-title} cluster on the target platform.
+====
 .. Select the region to deploy the cluster to.
 .. Select the base domain to deploy the cluster to. The base domain corresponds
 to the Azure DNS Zone that you created for your cluster.