Maximo

Maximo

Come for answers, stay for best practices. All we're missing is you.

Β View Only
  • 1.  Authentication in the local Maximo Manage dev environment

    Posted Sat November 04, 2023 11:50 AM
    Edited by Diego Visentin Sat November 04, 2023 12:29 PM

    I have successfully created a local Maximo Manage development environment by extracting images from a MAS 8.11.
    With a few tricks I am able to connect but I suspect there is some problem with the passwords initially stored on the database by the synch process from the MongoDB of the MAS. 
    Can anyone who uses it tell me if they have experienced any problems using the MAS user credentials in the derived "dev" environment?



    ------------------------------
    Diego Visentin
    EAM BU Director
    Tempestive S.p.A.
    ------------------------------



  • 2.  RE: Authentication in the local Maximo Manage dev environment

    Posted Mon November 06, 2023 03:09 AM

    Hi Diego,

    the Manage DB does not contain passwords for the users (when run within OpenShift), so You need to create a 'local' Manage user. The way that I do it is by using MXLoader.

    1. download MXLoader and point it to the "normal" (within OpenShift) Manage
    2. create a new Sheet in MXLoader for Users and follow the info on how to configure Object Structure to be able to create a user
    3. upload a new user
    4. make a copy of the Manage DB
    5. setup the local Mange outside of OCP and point it to the copy of the database
    6. run the local Manage and log in using the user and pass created via MXLoader

    Also, the config in dockerfile from IBM docs allows connections to Manage only from localhost. If You try to connect from anywhere else, You will get a login page, but You will not be able to log in even with correct user and pass. I'm putting a post about how to avoid this constraint and be able to connect from any host - stay tuned.



    ------------------------------
    Witold Wierzchowski
    ------------------------------



  • 3.  RE: Authentication in the local Maximo Manage dev environment

    Posted Mon November 06, 2023 03:27 AM
    Edited by Dirk Huppertz Mon November 06, 2023 03:27 AM
    Hi Diego,
    I had the same issue.
    My guess is that the issue is related to the CrypoX key.
    Unfortunately, I haven't had time to analyze the root cause further.
    But, I found a way to work arround it:
    1. Create an automation script to set the password of maxadmin
    2. Create an API-key for a user (i.e. maxadmin)
    3. Start the local container
    4. Call the automation script using the API key for authentication via REST API
    5. Now, maxadmin has the new password in the manage database and you can login πŸ‘
    Regards
    Dirk



    ------------------------------
    Dirk Huppertz
    Senior Project Manager
    S&T Deutschland GmbH
    Aachen
    ------------------------------



  • 4.  RE: Authentication in the local Maximo Manage dev environment

    Posted Wed November 08, 2023 03:52 PM

    Here are a few new findings:

    • The synchronization process from MAS Core to Manage does not transmit passwords
    • To use the preset passwords (form a migrated 7.6 db or from demo data) in the local container you have to set the cryptox key properly (this is missing in the manual!!)
    • new password (in the Manage database) cannot be set via UI, so you have to set it via Interface (MXLoader as described by Witold or automation script or ...)

    Wondering what IBMs idea was, how to manage the passwords in manage for the dev container?



    ------------------------------
    Dirk Huppertz
    Senior Project Manager
    S&T Deutschland GmbH
    Aachen
    ------------------------------



  • 5.  RE: Authentication in the local Maximo Manage dev environment

    Posted Wed November 08, 2023 04:19 PM

    > you have to set the cryptox key properly (this is missing in the manual!!)

    This is mentioned in the Dockerfile/Containerfile which is available to download. The file comes out as a rtf file but it is a standard image file. When Manage is installed, it is installed with randomly generated crypto/cryptox keys (one can also manually define the same at the time of the installation). So, I have to assume that we are all pulling the images from OpenShift after the Manage is installed.



    ------------------------------
    Arif Ali
    ------------------------------



  • 6.  RE: Authentication in the local Maximo Manage dev environment

    Posted Wed November 08, 2023 04:35 PM
    Edited by Dirk Huppertz Wed November 08, 2023 04:37 PM

    Hi Arif,
    sorry, but I cannot confirm.
    Here a snippet from the dockerfile.rtf

    And a snipped from the manual at https://www.ibm.com/docs/en/mas-cd/maximo-manage/continuous-delivery?topic=environment-building-deploying-development-images 

    As you can see, only the crypto key is set, not the cryptox key.
    The password field in the maxuser object is an cryptox field, so you need to set the key.

    Kind regards
        Dirk



    ------------------------------
    Dirk Huppertz
    Senior Project Manager
    S&T Deutschland GmbH
    Aachen
    ------------------------------



  • 7.  RE: Authentication in the local Maximo Manage dev environment

    Posted Thu November 09, 2023 03:14 AM

    I can confirm that the official docs are missing couple points, which caused me some headaches when setting up the local Manage first time.

    As for the user sync process between MAS Core and other MAS apps (Manage included): it does not transmit passwords for a reason. MAS uses the microservices concept (to some extend at least) and the authentication part is done in a dedicated service (this is CoreIDP pod to be precise). 

    Another dirty way to set the password for local Manage is to use E-signature password. Procedure is as follows:

    1. before copying the Manage DB set e-signature password for Your user
      the esig password is stored in Manage DB and it is encrypted using the same key as the 'login password'
    2. copyDB and build the local Manage env
    3. using Your favourite db client (i use DBeaver) update the maxuser record and set the password to value from esigpass
    4. You can now login using the password that You've set in step 1.


    ------------------------------
    Witold Wierzchowski
    ------------------------------



  • 8.  RE: Authentication in the local Maximo Manage dev environment

    Posted Wed November 08, 2023 09:20 AM

    The local Maximo Manage development environment is an officially documented feature https://www.ibm.com/docs/en/maximo-manage/continuous-delivery?topic=administering-setting-up-local-maximo-manage-development-environment

    I think your solution is to use username/password combination of the same word (e.g., wilson/wilson).



    ------------------------------
    Arif Ali
    ------------------------------