Maximo

 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
    ------------------------------