review and update doc according to odm 95

Author: siasin

platform/azure/README-Azure-SQL-MI.md

@@ -2,40 +2,44 @@
 
 This page provides instructions on setting up IBM® Operational Decision Manager (ODM) with Azure SQL Managed Instance (MI).
 
-Search for 'Azure SQL' among the available services and create a SQL Managed Instance or a Single instance:
+Search for 'Azure SQL' among the available services and create a **SQL Managed Instance** with Resource type: `Single instance`:
 
 ![Single instance](images/sqlmi-select_offer.png)
 
 Choose the desired Resource Group for deploying the SQL Managed Instance and specify the Managed Instance name:
 
 ![Basics configuration](images/sqlmi-basics.png)
 
-Click the link 'Configure Managed Instance' and reduce the number of CPUs allocated to the instance:
+Click the link `Configure Managed Instance` that is next to the *Compute + storage* parameter under **Managed Instance details** section. 
+
+Reduce the number of CPUs allocated for the instance to 4 vCores and apply the changes:
 
 ![Resources configuration](images/sqlmi-resources.png)
 
-Back to basics, select `Use SQL authentication` as Authentication method and then fill in admin login and password values:
+Back to **Basics** tab, select the option `Use SQL authentication` as **Authentication method** and then fill in admin login and password values:
 
 ![Authentication](images/sqlmi-authentication.png)
 
-In the Networking tab, enable `Public endpoint` and allow access from `Azure services`:
+In the **Networking** tab, enable `Public endpoint` and allow access from `Azure services`:
 > NOTE: It is not recommended to use a public IP. In a production environment, you should use a private IP.
 
 ![Network access](images/sqlmi-network.png)
 
-You can now review your configuration and proceed to create the Managed Instance. While it can take up to six hours, in most cases, it is created in approximately one hour:
+Click the **Review + create** button to review your configuration and proceed to create the Managed Instance. While it can take up to six hours, in most cases, it is created in approximately one hour:
 
 ![Review](images/sqlmi-review.png)
 
-Once the SQL Managed Instance is operational, you have the ability to establish a database within it:
+Once the SQL Managed Instance is operational, you have the ability to establish a database within it. 
+
+Click **+ New database** to create one with `odmdb` as *Database name*:
 
 ![New database](images/sqlmi-newdb.png)
 
 Later you'll need the FQDN for your SQL MI; it can be found as `Host` in the instance Overview:
 
 ![SQL MI Overview](images/sqlmi-overview.png)
 
-The port to use should always be 3342 but you can verify it in the public JDBC connection string from your SQL Managed Instance:
+The port to use should always be 3342. You can verify it in the public *JDBC* connection string of your SQL Managed Instance (under **Setting** section):
 
 ![JDBC string](images/sqlmi-jdbcstring.png)
 
@@ -49,20 +53,20 @@ kubectl create secret generic <odmdbsecret> --from-literal=db-user=<sqlmiadmin>
 > [!WARNING]
 > db-user must not contain the `@<managedinstancename>` part!
 
-Then you can deploy ODM with:
-
 You can now install the product.
 - Get the [aks-sqlmi-values.yaml](./aks-sqlmi-values.yaml) file and replace the following keys:
   - `<registrysecret>` is your registry secret name
-  - `<postgresqlserver>` is your flexible postgres server name
   - `<odmdbsecret>` is the database credentials secret name
   - `<mynicecompanytlssecret>` is the container certificate
-  - `<password>` is the password to login with the basic registry users like `odmAmin`
+  - `<password>` is the password to login with the basic registry users like `odmAdmin` 
   - `<sqlminame>` is the name of the SQL managed instance
   - `<identifier>` is the identifier of the dnsZone of the SQL managed instance
 
+> [!NOTE]
+> Make sure that you have created the registry secret and also the container certificate secret as explained in [Prepare your environment for the ODM installation](README.md#prepare-your-environment-for-the-odm-installation).
+
 ```shell
-helm install <release> ibmcharts/ibm-odm-prod  --version 24.1.0 -f aks-sqlmi-values.yaml
+helm install <release> ibm-helm/ibm-odm-prod  --version 25.0.0 -f aks-sqlmi-values.yaml
 ```
 
 Other deployment options (especially using NGINX) and IBM License Service usage are explained in the [NGINX README](README-NGINX.md).

platform/azure/README-NGINX.md

@@ -51,7 +51,7 @@ You can now install the product.
   - `<postgresqlserver>` is your flexible postgres server name
   - `<odmdbsecret>` is the database credentials secret name
   - `<mynicecompanytlssecret>` is the container certificate
-  - `<password>` is the password to login with the basic registry users like `odmAmin`
+  - `<password>` is the password to login with the basic registry users like `odmAdmin`
 
 ```shell
 helm install <release> ibm-helm/ibm-odm-prod  --version 25.0.0 -f aks-nginx-values.yaml

platform/azure/README.md

@@ -368,7 +368,7 @@ You can now install the product.
   - `<postgresqlserver>` is your flexible postgres server name
   - `<odmdbsecret>` is the database credentials secret name
   - `<mynicecompanytlssecret>` is the container certificate
-  - `<password>` is the password to login with the basic registry users like `odmAmin`  
+  - `<password>` is the password to login with the basic registry users like `odmAdmin`  
 
 ```shell
 helm install <release> ibm-helm/ibm-odm-prod --version 25.0.0 -f aks-values.yaml