IBM Support

Maximo Application Suite 8.11: How to undelete a MAS User

How To


Summary

In Maximo Application Suite 8.11, a new enhancement was added to retain the details of deleted users. While these users do not appear within the UI or API calls, their data is still present in the mongo database, and now can potentially be restored.

Note that IBM takes no responsibility for data loss or corruption that can occur because of user-performed operation directly against the Mongo database. It is recommended that a proper database backup strategy is in place before you attempt any changes.

Objective

Normally, it is impossible to re-create a MAS user within the UI after they are deleted. This error is reported when the user is re-created:
AIUCO1026E: Unable to create user with id=XXXX, since it is already taken by a previously-deleted user.
In order to restore the MAS user, you instead need to run commands directly against your MAS mongo database.

Steps

Once a mongo shell has been opened for your MAS mongo database, you have two options to re-create the user. You can either undelete the specific user to restore the old user, or delete the data record completely allowing you to re-create the user manually.
This first command restores the old user (in this case, user1), making them once again visible within the MAS User Administration UI.
db.User.update({username: "user1"},{$unset: {deleted:""}})
Alternatively, you can run this second command to delete the user from your database. This allows you to re-create the user manually within the UI. Note this command deletes the old user completely, causing their user data to be lost forever.
db.User.deleteMany({username: "user1"})

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSRHPA","label":"IBM Maximo Application Suite"},"ARM Category":[{"code":"a8m3p000000F80hAAC","label":"Maximo Application Suite-\u003EMAS Applications-\u003EAdministration"}],"ARM Case Number":"TS014718709","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.11.0"}]

Document Information

Modified date:
04 December 2023

UID

ibm17087805