Troubleshooting user migration

The migration process uses an internal API to migrate user IDs from Maximo® Asset Management to Maximo Application Suite. If you have users with a different user ID and login ID and you are upgrading to Maximo Application Suite 8.7 or earlier, you must re-create your existing users.

About this task

Maximo Application Suite has two fields for user management, username and user ID. If any of your Maximo Asset Management users have a user ID different from their login ID, you must delete and re-create the users after you upgrade to Maximo Application Suite.

Procedure

  1. If the user has only Maximo Manage license entitlement:
    1. In the Maximo Application Suite user interface, login as an administrator and go to Suite Administration > Users.
    2. Search for the user by using the Maximo Asset Management login ID as the search criterion.
    3. Create a new user based on the information of the existing user and set the user ID as a unique key and login ID.
      For more information, see Administering users and user access.
    4. Delete the old user.
    5. Run the MASUSERSYNC cron task to synchronize the users from Maximo Application Suite to Maximo Manage
      For more information, see Synchronizing migrated users.
  2. If the user has entitlement to multiple products in Maximo Application Suite, for example, Maximo Manage and IoT:
    1. In the Maximo Application Suite user interface, login as an administrator and go to Suite Administration > Users.
    2. Create a user based on the information of the existing user and set the user ID as a unique key and login ID.
    3. Change the login ID of the existing user by adding _bk to it.
    4. Delete the email address of the existing user to avoid duplicate email addresses.
    5. Do not synchronize the user to any products in Maximo Application Suite.
      Tip: In the case of a user in multiple products, preserve the original user information from Maximo Asset Management even if the user cannot log in to the system by using the Maximo Asset Management login ID. If you want to keep an old user, you can change the Username and use the user. If you decide to delete it, you can delete it yourself and add the entitlement to the new user. To find these users easily, search for Usernames with "_bk”.