Skip to content

Commit 6239b68

Browse files
authored
Merge pull request #248 from DecisionsDev/updateEks
Update EKS and AKS articles wrt ODM9.5.0.1
2 parents a5474e5 + 16c887a commit 6239b68

File tree

5 files changed

+37
-32
lines changed

5 files changed

+37
-32
lines changed

.secrets.baseline

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
"files": "^.secrets.baseline$",
44
"lines": null
55
},
6+
67
"generated_at": "2025-10-22T13:19:14Z",
78
"plugins_used": [
89
{
@@ -1320,15 +1321,15 @@
13201321
"hashed_secret": "8b712744eee080d5fe6048e4f589235d00435559",
13211322
"is_secret": false,
13221323
"is_verified": false,
1323-
"line_number": 133,
1324+
"line_number": 134,
13241325
"type": "Secret Keyword",
13251326
"verified_result": null
13261327
},
13271328
{
13281329
"hashed_secret": "b11974a9da0d56698df935ab86e19b127804d6d4",
13291330
"is_secret": false,
13301331
"is_verified": false,
1331-
"line_number": 157,
1332+
"line_number": 158,
13321333
"type": "Secret Keyword",
13331334
"verified_result": null
13341335
}

platform/azure/README-NGINX.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,11 @@ Installing an NGINX Ingress controller allows you to access ODM components throu
1616
1. Use the official YAML manifest:
1717

1818
```shell
19-
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.12.1/deploy/static/provider/cloud/deploy.yaml
19+
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.13.3/deploy/static/provider/cloud/deploy.yaml
2020
```
2121

2222
> [!NOTE]
23-
> The version will probably change after the publication of our documentation so please refer to the actual [documentation](https://kubernetes.github.io/ingress-nginx/deploy/#azure)!
23+
> The version will probably change after the publication of our documentation, so please refer to the actual [documentation](https://kubernetes.github.io/ingress-nginx/deploy/#azure).
2424

2525
2. Get the Ingress controller external IP address (it will appear 80 seconds or so after the resource application above):
2626

@@ -43,7 +43,7 @@ Installing an NGINX Ingress controller allows you to access ODM components throu
4343

4444
## Install an ODM release with NGINX Ingress Controller
4545

46-
You can reuse the secret with TLS certificate created [above](README.md#manage-adigital-certificate-10-min):
46+
You can reuse the secret with TLS certificate created at [Manage a digital certificate](README.md#manage-adigital-certificate-10-min).
4747

4848
You can now install the product.
4949
- Get the [aks-nginx-values.yaml](./aks-nginx-values.yaml) file and replace the following keys:
@@ -113,7 +113,7 @@ Where:
113113

114114
This section explains how to track ODM usage with the IBM License Service.
115115

116-
Follow the **Installation** section of the [Manual installation without the Operator Lifecycle Manager (OLM)](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=ilsfpcr-installing-license-service-without-operator-lifecycle-manager-olm) documentation.
116+
Follow the **Installation** section of the [Manual installation without the Operator Lifecycle Manager (OLM)](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=ilsfpcr-installing-license-service-without-operator-lifecycle-manager-olm) documentation.
117117

118118
### Patch the IBM Licensing instance with Nginx configuration
119119

@@ -142,6 +142,7 @@ You will be able to access the IBM License Service by retrieving the URL with th
142142
```bash
143143
export LICENSING_URL=$(kubectl get ingress ibm-licensing-service-instance -n ibm-licensing -o jsonpath='{.status.loadBalancer.ingress[0].ip}')/ibm-licensing-service-instance
144144
export TOKEN=$(kubectl get secret ibm-licensing-token -n ibm-licensing -o jsonpath='{.data.token}' |base64 -d)
145+
echo http://${LICENSING_URL}/status?token=${TOKEN}
145146
```
146147

147148
You can access the `http://${LICENSING_URL}/status?token=${TOKEN}` URL to view the licensing usage.
@@ -152,7 +153,7 @@ Otherwise, you can also retrieve the licensing report .zip file by running:
152153
curl "http://${LICENSING_URL}/snapshot?token=${TOKEN}" --output report.zip
153154
```
154155

155-
If your IBM License Service instance is not running properly, refer to this [troubleshooting page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=service-troubleshooting-license).
156+
If your IBM License Service instance is not running properly, refer to this [troubleshooting page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=service-troubleshooting-license).
156157

157158
## Troubleshooting
158159

platform/azure/README.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ az account list-locations -o table
7575
Then, create a resource group by running the following command:
7676

7777
```shell
78-
az group create --name <resourcegroup> --location <azurelocation> --tags Owner=<email> Team=<team> Usage=demo Usage_desc="Azure customers support" Delete_date=2025-12-31
78+
az group create --name <resourcegroup> --location <azurelocation> --tags Owner=<email> Team=<team> Usage=demo Usage_desc="Azure customers support" Delete_date=2026-12-31
7979
```
8080

8181
The following example output shows that the resource group has been created successfully:
@@ -90,7 +90,7 @@ The following example output shows that the resource group has been created succ
9090
"provisioningState": "Succeeded"
9191
},
9292
"tags": {
93-
"Delete_date": "2025-12-31",
93+
"Delete_date": "2026-12-31",
9494
"Owner": "<email>",
9595
"Team": "<team>",
9696
"Usage": "demo",
@@ -117,7 +117,7 @@ Make a note of the newly-created Resource Group that is displayed in the JSON ou
117117

118118
```shell
119119
az group update --name <noderesourcegroup> \
120-
--tags Owner=<email> Team=<team> Usage=demo Usage_desc="Azure customers support" Delete_date=2025-12-31
120+
--tags Owner=<email> Team=<team> Usage=demo Usage_desc="Azure customers support" Delete_date=2026-12-31
121121
```
122122

123123
### Set up your environment to this cluster
@@ -144,8 +144,8 @@ The following example output shows the single node created in the previous steps
144144

145145
```
146146
NAME STATUS ROLES AGE VERSION
147-
aks-nodepool1-27504729-vmss000000 Ready agent 21m v1.31.7
148-
aks-nodepool1-27504729-vmss000001 Ready agent 21m v1.31.7
147+
aks-nodepool1-27504729-vmss000000 Ready agent 21m v1.32.7
148+
aks-nodepool1-27504729-vmss000001 Ready agent 21m v1.32.7
149149
```
150150

151151
## Create the PostgreSQL Azure instance (10 min)
@@ -185,7 +185,7 @@ Result:
185185
"availabilityZone": "2",
186186
"backup": {
187187
"backupRetentionDays": 7,
188-
"earliestRestoreDate": "2025-04-29T09:37:34.208183+00:00",
188+
"earliestRestoreDate": "2025-10-20T12:18:24.730053+00:00",
189189
"geoRedundantBackup": "Disabled"
190190
},
191191
"cluster": null,
@@ -214,7 +214,7 @@ Result:
214214
"startHour": 0,
215215
"startMinute": 0
216216
},
217-
"minorVersion": "12",
217+
"minorVersion": "14",
218218
"name": "<postgresqlserver>",
219219
"network": {
220220
"delegatedSubnetResourceId": null,
@@ -248,7 +248,7 @@ Result:
248248
"type": ""
249249
},
250250
"systemData": {
251-
"createdAt": "2025-04-29T09:31:58.093917+00:00",
251+
"createdAt": "2025-10-20T12:13:15.036215+00:00",
252252
"createdBy": null,
253253
"createdByType": null,
254254
"lastModifiedAt": null,
@@ -298,7 +298,7 @@ kubectl create secret docker-registry ibm-entitlement-key \
298298
--docker-server=cp.icr.io \
299299
--docker-username=cp \
300300
--docker-password="<API_KEY_GENERATED>" \
301-
--docker-email=<USER_EMAIL> -n odm
301+
--docker-email=<USER_EMAIL>
302302
```
303303
Where:
304304

@@ -322,7 +322,7 @@ Check that you can access the ODM charts:
322322
```shell
323323
helm search repo ibm-odm-prod
324324
NAME CHART VERSION APP VERSION DESCRIPTION
325-
ibm-helm/ibm-odm-prod 25.0.0 9.5.0.0 IBM Operational Decision Manager License By in...
325+
ibm-helm/ibm-odm-prod 25.1.0 9.5.0.1 IBM Operational Decision Manager License By in...
326326
```
327327

328328
### Manage a digital certificate (10 min)
@@ -425,7 +425,7 @@ You can then open a browser on `https://xxx.xxx.xxx.xxx:9453` to access Decision
425425

426426
This section explains how to track ODM usage with the IBM License Service.
427427

428-
Follow the **Installation** section of the [Installation License Service without Operator Lifecycle Manager (OLM)](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=ilsfpcr-installing-license-service-without-operator-lifecycle-manager-olm) documentation.
428+
Follow the **Installation** section of the [Installation License Service without Operator Lifecycle Manager (OLM)](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=ilsfpcr-installing-license-service-without-operator-lifecycle-manager-olm) documentation.
429429

430430
#### a. Expose the licensing service using the AKS LoadBalancer
431431

@@ -469,15 +469,15 @@ export TOKEN=$(kubectl get secret ibm-licensing-token -n ibm-licensing -o jsonpa
469469
```
470470

471471
> **Note**
472-
> If `LICENSING_URL` is empty, take a look at the [troubleshooting](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=service-troubleshooting-license) page.
472+
> If `LICENSING_URL` is empty, take a look at the [troubleshooting](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=service-troubleshooting-license) page.
473473
474474
You can access the `http://${LICENSING_URL}:8080/status?token=${TOKEN}` URL to view the licensing usage or retrieve the licensing report .zip file by running:
475475

476476
```shell
477477
curl "http://${LICENSING_URL}:8080/snapshot?token=${TOKEN}" --output report.zip
478478
```
479479

480-
If your IBM License Service instance is not running properly, refer to this [troubleshooting page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=service-troubleshooting-license).
480+
If your IBM License Service instance is not running properly, refer to this [troubleshooting page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=service-troubleshooting-license).
481481

482482
## Troubleshooting
483483

platform/eks/README-NGINX.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,7 @@ You will be able to access the IBM License Service by retrieving the URL with th
9696
```bash
9797
export LICENSING_URL=$(kubectl get ingress ibm-licensing-service-instance -n ibm-licensing -o jsonpath='{.status.loadBalancer.ingress[0].hostname}')/ibm-licensing-service-instance
9898
export TOKEN=$(kubectl get secret ibm-licensing-token -n ibm-licensing -o jsonpath='{.data.token}' |base64 -d)
99+
echo http://${LICENSING_URL}/status?token=${TOKEN}
99100
```
100101

101102
You can access the `http://${LICENSING_URL}/status?token=${TOKEN}` URL to view the licensing usage.
@@ -106,4 +107,4 @@ Otherwise, you can also retrieve the licensing report .zip file by running:
106107
curl "http://${LICENSING_URL}/snapshot?token=${TOKEN}" --output report.zip
107108
```
108109

109-
If your IBM License Service instance is not running properly, refer to this [troubleshooting page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=service-troubleshooting-license).
110+
If your IBM License Service instance is not running properly, refer to this [troubleshooting page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=service-troubleshooting-license).

platform/eks/README.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -55,23 +55,24 @@ Where you provide your `AWS Access Key ID`, `AWS Secret Access Key` and the `Def
5555
#### b. Create an EKS cluster (20 min)
5656

5757
```bash
58-
eksctl create cluster <CLUSTER_NAME> --version 1.32 --alb-ingress-access
58+
eksctl create cluster <CLUSTER_NAME> --version 1.33 --nodes 3 --alb-ingress-access
5959
```
6060

6161
> **Note**
62-
> The tutorial has been tested with the Kubernetes version 1.32. Check the supported kubernetes version in the [system requirement](https://www.ibm.com/support/pages/ibm-operational-decision-manager-detailed-system-requirements) page.
62+
> The tutorial has been tested with the Kubernetes version 1.33. Check the supported kubernetes version in the [Detailed System Requirements](https://www.ibm.com/software/reports/compatibility/clarity/product.html?id=C88B83D2853E4A628442E38C1194FF8F) page.
6363
6464
> **Warning**
65-
> If you prefer to use the NGINX Ingress Controller instead of the ALB Load Balancer to expose ODM services, don't use the --alb-ingress-access option during the creation of the cluster !
65+
> If you prefer to use the NGINX Ingress Controller instead of the ALB Load Balancer to expose ODM services, don't use the --alb-ingress-access option during the creation of the cluster.
6666
67-
For more information, refer to [Creating an Amazon EKS cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html).
67+
To see the options that you can specify when creating a cluster with `eksctl`, use the `eksctl create cluster --help` command. For more information, refer to [Creating an Amazon EKS cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html).
6868

6969
#### c. Set up your environment
7070

7171
If your environment is set up correctly, you should be able to get the cluster information by running the following command:
7272

7373
```bash
74-
$ kubectl cluster-info
74+
kubectl cluster-info
75+
7576
Kubernetes control plane is running at https://xxxxxxxx.<REGION>.eks.amazonaws.com
7677
CoreDNS is running at https://xxxxxxxx.<REGION>.eks.amazonaws.com/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
7778

@@ -142,7 +143,7 @@ kubectl create secret generic odm-db-secret \
142143
To get access to the ODM material, you must have an IBM entitlement key to pull the images from the IBM Cloud Container registry.
143144
This is what will be used in the next step of this tutorial.
144145

145-
You can also download the ODM on Kubernetes package (.tgz file) from Passport Advantage® (PPA), and then push the contained images to the EKS Container Registry (ECR). If you prefer to manage the ODM images this way, see the details [here](README-ECR.md)
146+
You can also download the ODM CASE package from IBM Cloud Container Registry, and then push the contained images to the EKS Container Registry (ECR). If you prefer to manage the ODM images this way, see the details [here](README-ECR.md)
146147

147148
#### a. Retrieve your entitled registry key
148149

@@ -177,7 +178,7 @@ helm repo update
177178
```bash
178179
$ helm search repo ibm-odm-prod
179180
NAME CHART VERSION APP VERSION DESCRIPTION
180-
ibm-helm/ibm-odm-prod 25.0.0 9.5.0.0 IBM Operational Decision Manager
181+
ibm-helm/ibm-odm-prod 25.1.0 9.5.0.1 IBM Operational Decision Manager
181182
```
182183

183184
### 4. Manage a  digital certificate (10 min)
@@ -298,30 +299,30 @@ The ODM services are accessible from the following URLs:
298299

299300
#### a. Install the IBM License Service
300301

301-
Follow the **Installation** section of the [Installation License Service without Operator Lifecycle Manager (OLM)](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=ilsfpcr-installing-license-service-without-operator-lifecycle-manager-olm) documentation.
302+
Follow the **Installation** section of the [Installation License Service without Operator Lifecycle Manager (OLM)](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=ilsfpcr-installing-license-service-without-operator-lifecycle-manager-olm) documentation.
302303

303304
#### b. Patch the IBM Licensing instance
304305

305306
Get the [licensing-instance.yaml](./licensing-instance.yaml) file and run the command:
306307

307308
```bash
308-
kubectl patch IBMLicensing instance --type merge --patch-file licensing-instance.yaml -n ibm-licensing
309+
kubectl patch IBMLicensing instance --type merge --patch-file licensing-instance.yaml -n ibm-licensing
309310
```
310311

311312
Wait a couple of minutes for the changes to be applied.
312313

313314
Run the following command to see the status of Ingress instance:
314315

315316
```bash
316-
kubectl get ingress -n ibm-licensing
317+
kubectl get ingress -n ibm-licensing
317318
```
318319

319320
You should be able to see the address and other details about `ibm-licensing-service-instance`.
320321
```
321322
NAME CLASS HOSTS ADDRESS PORTS AGE
322323
ibm-licensing-service-instance alb * k8s-ibmlicen-ibmlicen-xxxxxxxx-yyyyyyy.<aws-region>.elb.amazonaws.com 80 44m
323324
```
324-
You can find more information and use cases on [this page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.12.0?topic=configuring-kubernetes-ingress).
325+
You can find more information and use cases on [this page](https://www.ibm.com/docs/en/cloud-paks/foundational-services/4.14.0?topic=configuring-kubernetes-ingress).
325326

326327
> **Note**
327328
> If you choose to use the NGINX Ingress Controller, you must use the [licensing-instance-nginx.yaml](./licensing-instance-nginx.yaml) file. Refer to [Track ODM usage with the IBM License Service with NGINX Ingress Controller](README-NGINX.md#track-odm-usage-with-the-ibm-license-service-with-nginx-ingress-controller).
@@ -333,6 +334,7 @@ The ALB address should be reflected in the Ingress configuration. You will be ab
333334
```bash
334335
export LICENSING_URL=$(kubectl get ingress ibm-licensing-service-instance -n ibm-licensing -o jsonpath='{.status.loadBalancer.ingress[0].hostname}')
335336
export TOKEN=$(kubectl get secret ibm-licensing-token -n ibm-licensing -o jsonpath='{.data.token}' |base64 -d)
337+
echo http://${LICENSING_URL}/status?token=${TOKEN}
336338
```
337339

338340
> **Note**

0 commit comments

Comments
 (0)