If this post helps, please consider accepting it as a solution to help other members find it more quickly.
Original Message:
Sent: Wed July 30, 2025 04:19 PM
From: Galina Leonova
Subject: How to setup DOCLINKS in MAS Manage
Hello IBM Support,
I'm encountering an issue with document links in our environment after configuring "DOCLINKS" according to your documentation.
Here's my current setup:
I've attached a file, <my_file>.jpg
, to a record and confirmed its presence on my Liberty WebSphere pod. However, when I click on the attachment within Manage, a new tab opens displaying the error message: "The application or context root for this request has not been found: /doclinks/Attachments/<my_file>.jpg> "
Interestingly, if I set mxe.doclink.securedAttachment
to TRUE
, Manage offers to download and view the attachment, which is a different user experience than our users are accustomed to with Maximo attachments.
Could you please advise on what might be missing in my configuration? Do I need to set up new route in OpenShift to point to "https://<OUR_MANAGE_URL>/doclinks"?
Is this potentially a bug in Manage that requires a fix request?
Thank you for your assistance.
------------------------------
Galina Leonova
Original Message:
Sent: Thu March 06, 2025 03:03 PM
From: Richard Lesses
Subject: How to setup DOCLINKS in MAS Manage
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
Original Message:
Sent: Mon September 23, 2024 10:41 PM
From: Vincent Jennifer Yap
Subject: How to setup DOCLINKS in MAS Manage
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
Original Message:
Sent: Tue July 18, 2023 02:25 PM
From: Francois Beliveau
Subject: How to setup DOCLINKS in MAS Manage
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
------------------------------