Maximo

Maximo

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

 View Only
Expand all | Collapse all

How to setup DOCLINKS in MAS Manage

  • 1.  How to setup DOCLINKS in MAS Manage

    Posted Tue July 18, 2023 02:25 PM

    I want to setup linked documents in my MAS Manage install but I've tried and tried and I can't seem to get it working.

    I followed (and I understand...) instructions defined in

    https://www.ibm.com/docs/en/maximo-manage/continuous-delivery?topic=documents-adding-persistent-storage-parameters-deployments<u5:p></u5:p>

    and

    https://www.ibm.com/docs/en/maximo-manage/continuous-delivery?topic=documents-configuring-system-properties-persistent-storage<u5:p></u5:p>

    I even used the same values as the example provided.

    At the point I'm at right now, there is a PVC created, and there is a mount in the Manage pod ( ex : /d01/doclinks ) in which I went and create ATTACHMENTS and Attachments folder (just to be safe, in different case)

    Set up also all the Maximo properties, restarted the pod, cannot update a document. I get no errors in Manage screen, but the file is not updated to the mount

    I would be interested in anyone replying with their actual REAL configuration (of course stripping any sensitive information) from the Maximo properties regarding the doclinks



    ------------------------------
    Francois Beliveau
    ------------------------------


  • 2.  RE: How to setup DOCLINKS in MAS Manage

    Posted Wed July 19, 2023 09:13 AM

    DOCLINKS has been automated. 

    ROLE_NAME=suite_manage_attachments_config ansible-playbook ibm.mas_devops.run_role



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



  • 3.  RE: How to setup DOCLINKS in MAS Manage

    Posted Thu July 20, 2023 08:02 AM

    Thanks for the tip that worked fine.



    ------------------------------
    Francois Beliveau
    ------------------------------



  • 4.  RE: How to setup DOCLINKS in MAS Manage

    Posted Tue April 16, 2024 07:35 AM
      |   view attached

    Hello Arif - Where we need to check  ROLE_NAME=suite_manage_attachments_config ansible-playbook ibm.mas_devops.run_role.

    Actually I am facing the issue during attachment in MAS . File got stored in the doclinks folder but i am not able to save or view the record.

    Print screen attached for better understanding.

    Regards,

    Biswa



    ------------------------------
    Biswaranjan Mishra
    ------------------------------

    Attachment(s)

    docx
    error.docx   124 KB 1 version


  • 5.  RE: How to setup DOCLINKS in MAS Manage

    Posted Wed April 17, 2024 02:50 AM

    Hi Biswaranjan,

    this playbook was replaced with a new one called suite_manage_doclinks_config.

    You can also set attachments manually. Steps are:

    1. in Manage Workspace config add a PVC with RWX storage class. You can call it whatever You want, just note down the mountpath - You will need that in step 2
    2. in System Properties set the doclinks path as You would in 7.6. Use the mountpath from step 1.


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



  • 6.  RE: How to setup DOCLINKS in MAS Manage

    Posted Wed April 17, 2024 03:22 AM
    Edited by Biswaranjan Mishra Wed April 17, 2024 03:41 AM
      |   view attached

    Hellow Witold - Now I am able to configure the attachments.

    Regards,

    Biswa



    ------------------------------
    Biswaranjan Mishra
    ------------------------------

    Attachment(s)

    docx
    Steps.docx   683 KB 1 version


  • 7.  RE: How to setup DOCLINKS in MAS Manage

    Posted Thu April 18, 2024 02:39 AM

    Hi,

    The set of topics here might be helpful to you:
    https://www.ibm.com/docs/en/mas-cd/maximo-manage/continuous-delivery?topic=documents-configuring-attached 



    ------------------------------
    Indrani Ghosh
    Content Designer
    IBM
    Kolkata
    9903261077
    ------------------------------



  • 8.  RE: How to setup DOCLINKS in MAS Manage

    Posted Thu September 26, 2024 07:01 AM

    Hi Biswaranjan, I encontered same error as you did in your  attachment steps.docx.

    Jsut in case that anyone  encounters same error - BMXAA4214E.

    I solved it by modifying mxe.doclink.path01 to value /doclinks=https://<your manage server URL>/maximo/oslc/doclinks - same as it was done in previous versions.

    Regards,  Janez



    ------------------------------
    Jani Naglic
    Kopa d.d.
    Slovenj Gradec
    ------------------------------



  • 9.  RE: How to setup DOCLINKS in MAS Manage

    Posted Tue September 24, 2024 06:57 PM

    Hi Francois and experts,

    I followed the below IBM technotes 

    How to configure Doclinks to use PVC (ibm.com)

    How to create a Persistent Volume Claim (PVC) on Manage (ibm.com)

    I also run playbook for attach document for ansible

    ROLE_NAME=suite_manage_attachments_config ansible-playbook ibm.mas_devops.run_role

    But still unable to attach document in Manage am getting error directory does not exist. When I checked in OpenShift -all pod, there is DOCLINK folder created but no sub directories created such as Attachment, CAD etc. I tried to manually create folders using mkdir but getting permission denied error. Do I need to manually create the sub folders?

    Also when I check MAXINST pod is still in pending status, also in manageworkspace there is an unknown playbook failure error.



    ------------------------------
    Vincent Jennifer Yap
    ------------------------------



  • 10.  RE: How to setup DOCLINKS in MAS Manage

    Posted Thu March 06, 2025 03:03 PM

    Go to Attachment Library/Folders, then Associate Folders.
    Delete (say) Attachments, and create a new one.
    After that I could change the paths for all folders.



    ------------------------------
    Richard Lesses
    IBM Maximo Support
    ------------------------------



  • 11.  RE: How to setup DOCLINKS in MAS Manage

    Posted 16 days ago

    Hi Everyone,

    Can you explain all the steps required to install and configure a PVC for use with Doclinks in Manage?

    Thanks



    ------------------------------
    Hariprasad R
    ------------------------------



  • 12.  RE: How to setup DOCLINKS in MAS Manage

    Posted 15 days ago

    We've helped several MAS setups where configuring Doclinks manually is smoother than relying solely on automation scripts.

    At DeltaExecutor, here's our recommended approach:

    1. Install and run the suite_manage_doclinks_config Ansible role (updated over the earlier attachments role) naviam.io+9community.ibm.com+9community.ibm.com+9.

    2. Use a RWX PVC and define its mount path in your Manage Workspace and in the mxe.doclink.path0X system property community.ibm.com+1moremaximo.com+1.

    3. Ensure folders exist with correct permissions for subfolders like ATTACHMENTS, CAD, etc. - automation may not create them automatically.

    4. Verify map settings for suite_manage_doclinks_config over older attachments roles for better support in recent releases naviam.io+7community.ibm.com+7github.com+7.

    After configuration, restart the pod and test uploading a document. If issues persist, review the playbook logs and verify path mappings in both the PVC and system properties.

    Happy to share a validator script or sample Ansible tasks if that helps.



    ------------------------------
    pal qwi
    ------------------------------