IBM Support

How to set up attached documents with WebSphere Application Server

How To


Summary

How do you set up attached documents with WebSphere Application Server?

Steps

Creating Attached Documents Directories
  1. Create a doclinks directory on the machine storing the document files.
    For example: C:\doclinks for Windows or /home/doclinks for UNIX
  2. Share the drive so that the IBM HTTP Server and the WAS services can connect to it.
  3. Create the following subdirectories under doclinks:
    • \attachments
    • \default
    • \diagrams
    • \images
  4. Verify the directory structure.
Configuring the Application Server for Attached Documents
  1. Open the httpd.conf file for the IBM HTTP Server. Be sure you have a valid backup of httpd.conf.
    • Windows: C:\Program Files\IBM\HTTPServer\conf
    • UNIX: /home/IBMHTTPD/conf/httpd.conf
  2. Find DocumentRoot and change as follows:
    • Windows: DocumentRoot = C:\doclinks
    • UNIX: DocumentRoot = /home/doclinks
  3. Find ‘# This should be changed to whatever you set DocumentRoot to.’ and change as follows:
    • Windows: <Directory "C:\doclinks">
    • UNIX: <Directory "/home/doclinks">
  4. Search for Servername and make note of the servername
  5. Save & close that file
  6. Restart the HTTP Server
  7. Verify that the HTTP Server is configured correctly:
    • Create a test file text.txt
      • Windows: C:\doclinks\test.txt
      • UNIX: /home/doclinks/test.txt
    • Open a web browser and type in address: http://<server_name or IP address>/test.txt
      • Using the servername from the httpd.conf file
    • You should be able see your test.txt document in this window. If you cannot open the file, you must reconfigure the IBM HTTP server.
  8. Restart WebSphere Application Server and the operating system.
Editing file Paths in Maximo
This part is one of different settings with previous version (Maximo 6.X)
  1. Login to Maximo.
  2. Go To => System Configuration => Platform Configuration => System Properties
  3. Check that the following Property Names have the listed values. If not, update them as follows:
    Note: The paths in Windows and UNIX are case sensitive.
    • Property Name: mxe.doclink.doctypes.defpath
    • Windows Global Value: C:\doclinks
    • UNIX Global Value: /home/doclinks
    • Property Name: mxe.doclink.path01
    • Windows Global Value: C:\doclinks = http://<servername or IP>
    • UNIX Global Value: /home/doclinks=http://<servername or IP>
  4. Restart App server or click Live Refresh
  5. Go To any application which has attachments ==> Select Action ==> Attachment Library/Folders ==> Manage folders and set or check the following paths:
    Note these Default file paths are case-sensitive and must match the case of directory structure and that of the doclink.properties file.
Document Folder Default File Path (Windows) Default File Path (UNIX)
Attachments C:\doclinks\attachments /home/doclinks/attachments
CAD C:\doclinks\cad /home/doclinks/cad
Diagrams C:\doclinks\diagrams /home/doclinks/diagrams
Images C:\doclinks\images /home/doclinks/images

[{"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"System Related","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1;7.5;7.6","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSLKTY","label":"Maximo Asset Management for IT"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"","label":"All"}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSWK4A","label":"Maximo Asset Management Essentials"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":null,"Platform":[{"code":"","label":"All"}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
14 June 2022

UID

swg21312993

Page Feedback