How To
Summary
How do you set up attached documents with WebSphere Application Server?
Steps
Creating Attached Documents Directories
- Create a doclinks directory on the machine storing the document files.
For example: C:\doclinks for Windows or /home/doclinks for UNIX - Share the drive so that the IBM HTTP Server and the WAS services can connect to it.
- Create the following subdirectories under doclinks:
- \attachments
- \default
- \diagrams
- \images
- Verify the directory structure.
Configuring the Application Server for Attached Documents
- 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
- Find DocumentRoot and change as follows:
- Windows: DocumentRoot = C:\doclinks
- UNIX: DocumentRoot = /home/doclinks
- Find ‘# This should be changed to whatever you set DocumentRoot to.’ and change as follows:
- Windows: <Directory "C:\doclinks">
- UNIX: <Directory "/home/doclinks">
- Search for Servername and make note of the servername
- Save & close that file
- Restart the HTTP Server
- 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.
- Create a test file text.txt
- 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)
- Login to Maximo.
- Go To => System Configuration => Platform Configuration => System Properties
- 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>
- Restart App server or click Live Refresh
- 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"}}]
Was this topic helpful?
Document Information
Modified date:
14 June 2022
UID
swg21312993