Search This Blog

Tuesday, January 30, 2024

IBM MAS - Getting the Manage admin Docker image

 Getting the Manage admin Docker image:

Prerequisites for this activity. Use the following steps to install Docker.

1.       Install Docker from https://docs.docker.com.

2.       Make sure that the docker daemon is running.

Procedure

1)         In your Linux® terminal, run the oc login command.

$ oc login --token=sha256~yLcd9N_ih1UX7tGcq9REywmoliEGvK4R-rtDu_xxxxx --server=https://api.mas-app-sb123.cp.fyre.ibm.com:6443

2)      Expose the internal registry to external using Route.

$ oc patch configs.imageregistry.operator.openshift.io/cluster --patch '{"spec":{"defaultRoute":true}}' --type=merge

3)      Verify the internal registry route hostname.

$ oc get route -n openshift-image-registry

NAME            HOST/PORT         PATH  SERVICES        PORT      TERMINATION      WILDCARD

default-route   default-route-openshift-image-registry.apps.mas-app-sb1.cp.fyre.ibm.com         image-registry  all       reencrypt        None

image-registry  image-registry.openshift-image-registry.svc        image-registry  5000-tcp  reencrypt        None

4)      Log in by using the default registry route hostname.

docker login -u <user_name> -p $(oc whoami -t) default-route-openshift-image-registry.apps.<clustername>.<basedomain>

$ sudo docker login -u kubeadmin -p $(oc whoami -t) https://default-route-openshift-image-registry.apps.mas-app-sb123.cp.fyre.ibm.com

Remember: If you get x509: certificate signed by unknown authority error message, then you must place the Router trusted CA on your host.

5)      Extract the CA from Red Hat® OpenShift® Container Platform cluster, where the registry is configured.

$ oc extract secret/router-ca --keys=tls.crt -n openshift-ingress-operator

6)      Perform on the node, where the image pulling throws x509 error.

$ sudo cp tls.crt /usr/local/share/ca-certificates/.

$ sudo update-ca-certificates

7)      Make sure that the docker daemon is running.

$ ps -aux | grep dockerd

root       203  0.0  0.0  10508  4232 pts/0    T    01:28   0:00 sudo dockerd

root      2397  0.0  0.0  11016  4612 pts/1    S    16:49   0:00 sudo dockerd

root      2398  0.0  0.4 1538160 111260 pts/1  Sl   16:49   0:07 dockerd

sarika    3999  0.0  0.0   8160   724 pts/1    S+   23:26   0:00 grep --color=auto dockerd

 8)      Pull admin docker latest image: docker pull <Public image Repository> From the Manage project in OpenShift console, get the Public Image Repository value from the <instanceid>-<workspaceid>-admin in ImageStreams under Builds.

$ sudo docker pull `default-route-openshift-image-registry.apps.mas-app-sb1.cp.fyre.ibm.com/mas-sb1-manage/sb1-masdev-admin`

 9)      Get Image ID: docker images

$ sudo docker images

REPOSITORY                                       TAG      IMAGE ID      CREATED      SIZE

default-route-openshift-image-registry.apps.mas-app-sb1.cp.fyre.ibm.com/mas-sb1-manage/sb1-masdev-admin  latest   c0e655398e6b  3 weeks ago  7.87GB

 10)   Run the docker pulled admin image docker run -d <image id>.

$ sudo docker run -d c0e655398e6b

1f2dfad8d3c813792798dc1f220bf27b7935f604c4817f47346a1f96e2336a92

time="2021-06-26T16:54:46.067182200-04:00" level=info msg="starting signal loop" namespace=moby path=/run/docker/containerd/daemon/io.containerd.runtime.v2.task/moby/1f2dfad8d3c813792798dc1f220bf27b7935f604c4817f47346a1f96e2336a92 pid=2832

 11)   Get the container ID for the pulled admin image. docker ps -a

$ sudo docker images

REPOSITORY                  TAG      IMAGE ID      CREATED      SIZE

default-route-openshift-image-registry.apps.mas-app-sb1.cp.fyre.ibm.com/mas-sb1-manage/sb1-masdev-admin  latest   c0e655398e6b  3 weeks ago  7.87GB

12)   Copy the Manage code locally.

$ sudo docker cp d3544a11901e:/opt/IBM/SMP/maximo/latest.zip /mnt/c/temp/.

13)   Optional: Run tools such as integrity checker.

docker exec -it <container id> /bin/bash

Update the Maximo properties in /opt/IBM/SMP/maxio/applications/maximo/propertiesfolder.

Execute /opt/IBM/SMP/maxio/applications/maximo/validate_integ.sh.

Reference Link : https://www.ibm.com/docs/en/mas-cd/continuous-delivery?topic=preparing-getting-manage-admin-docker-image

Monday, January 29, 2024

Applying Customization Archive into IBM Maximo Manage

 Reference Link :https://www.ibm.com/support/pages/applying-customization-archive-ibm-maximo-manage




User Management in Maximo Application Suite

The latest version of MAS 8.8/Manage 8.4, the user creation process has been modified, and to alleviate any unnecessary confusion, I’m going to show what you need to know and walk you through this new process.


One change effective with MAS 8.8 and above is that a display name and a User ID are created when a user is created in MAS. The User ID is a primary key that identifies a user, and it cannot be changed after the user is created.

IBM Cloud Pak for Integration documentation - Reference Link

 https://www.ibm.com/docs/en/cloud-paks/cp-integration

Thursday, January 18, 2024

Red Hat OpenShift Container Platform Support

IBM Maximo Application Suite will run anywhere that you can run a supported Open Shift release on AMD64 architecture.


CPGeneral AvailabilityEnd of SupportSupported MAS Releases
4.10March 10, 2022September 10, 20238.9 - 8.10
4.111August 10, 2022February 10, 20248.9 - 8.10
4.12January 17, 2023January 17, 20258.9 - 8.10

Cloud Pak for Data covers the following application's dependencies:

  • Assist: Watson Discovery, Watson Text to Speak, Watson Speach to Text, Watson Assistant
  • Health & Predict Utilities: Watson Studio
  • Predict: Watson Studio, Watson Machine Learning, Watson Analytics Service, Watson Openscale
OCPCloud Pak for DataSupported MAS Releases
ReleaseGeneral AvailabilityEnd of Support
4.104.6.3February, 2023TBD8.9 - 8.10


Reference Link : 

https://access.redhat.com/support/policy/updates/openshift/






Tuesday, January 16, 2024

Collect MustGather data for IBM Maximo Application Suite using the MustGather tool

 You can collect and provide MustGather data for your IBM Maximo Application Suite problem.

1. Where IBM Maximo Application Suite is installed:

2. Run the IBM Maximo Application Suite MustGather tools
Multiple namespaces are targeted by the IBM Maximo Application Suite MustGather tools. These namespaces are in the format:  mas-{{instanceId}}-core and mas-{{instanceId}}-{{appId}}

The instanceId was set during installation of IBM Maximo Application Suite.

The instanceId can be found postinstallation as well using the Red Hat OpenShift web console or by using the oc client.

Important:

  • All the following actions need to be executed under a user that has admin cluster role in Red Hat  OpenShift.
  • The oc adm must-gather command is available starting with Red Hat OpenShift Container Platform 4.x. If you get a message that the command does not exist, then, it means that you are using an older version of the oc cli. Run oc version command to check the oc cli version.

Reference Link : 

IBM Maximo Application Suite - 8.11.0 APARs fixed

This list of Known Issues fixed in Maximo Application Suite 8.11.0.

DT209860 - Case sensitive issue when synchronizing groups 

DT213769 - Manager's access mode property for PVC configuration is not properly displayed on the workspace configuration UI

DT212451 - Import user feature is sending salted password to the user email

DT196144 - SAML users replacing local user login 

DT215063 - LDAP Bind user with "\" character does not work

DT214769 - Coreapi pod crashing during initialization

DT222586 - scimsync-agent failing comparison when adding user group members

DT222765 - SAML issue with wrong link field

DT216022 - Number cast issue when numeric userID

DT222884 - Diff secretName than the expect is crashing the deployer

DT230445 - Importuser/coreapi is not accepting "-"

DT225038 - LDAP customMaxSearchResults CR information being replaced when updating UI config 

DT223861 - Reduce render on the config page

DT212073 - SMTP/sendmailapi: Password change notification email is not sent to users with Japanese display name

DT223701 - Error saving a synchronized LDAP user - Mismatched input parameters

Reference Link : 

https://www.ibm.com/support/pages/node/7039339

https://www.ibm.com/support/pages/node/7038760


Friday, January 12, 2024

Maximo Application Suite Admin APIs 8.11.x

IBM  Maximo Application Suite provides powerful AI-driven asset and analytics solutions for your enterprise needs.

Maximo Application Suite is a powerful collection of:

  • Applications
  • Industry solutions
  • Add-ons
  • Tools

These APIs provide a mechanism for performing administrative operations against an installation of Maximo  Application Suite.

Reference link : https://developer.ibm.com/apis/catalog/maximo--maximo-application-suite-admin-apis/Introduction


How to create a Entity Relationship Document (ERD) for MAS 8

The following are the steps for MAS 8.11 and beyond as well as 8.10 and prior versions

Steps

For MAS 8.10 and prior, do the following steps; 

  • Access Manage Admin pod terminal - /tools/maximo/internal
  • execute the cli  - generd.sh
  • This generates the erd files inside /tools/maximo/erd
  • You then need to download that folder with contents into a local device with browser 
  • Then, access the erd/index.html by using the local browser - and browse the erd pages.

IBM - MAS : - Error AIUCO1026E: Unable to create user with id=, since it is already taken by a previously-deleted user.

The only way to restore the user or permanently delete the user from MAS is to update or delete the document in the mongoDB database.

Steps

1- Connect to the mongoDB shell 
https://www.ibm.com/support/pages/how-open-mongo-shell-mas-mongodb

2- List the databases:
show dbs

3- Use the mas core database:
use mas_<mas instance id>_core

4- find the user you want to restore or delete:
db.User.find({"_id" : "testuser"})

When the user is deleted, the document will end with the deleted information, i.e. user who deleted the record and the time of deletion, for example:
"deleted" : { "id" : "masadmin", "timestamp" : "2023-11-28T09:56:29.840785" }

You can then either restore the user or remove it from the database

To restore the user, execute the following command:

db.User.update({username: "testuser"},{$unset: {deleted:""}})

Once the command is executed, the user is visible again in MAS, however it is not visible in Manage.
An update to the user in MAS will lead to a syncronization failure with Manage. You need to reactivate the use in Manage.

To remove the user, execute the following command:

db.User.deleteone({username: "testuser"})

If you create a new user with the id of the user that you deleted, the synchronization with Manage will fail, you will have to reactivate the user in Manage.

The instructions to reactivate the user in Manage are here:
https://www.ibm.com/support/pages/reinstating-deleted-person-record-maximo

NOTE: removing the user from the database is permanent, it is recommended to have a working backup before attempting such operation. 



Modifying the size of a user field in MAS

  Question In MAS you can verify that many of the fields of the user records are also present in Manage application, but how can we change t...