How to configure Linked Documents in MAXIMO 5.2 WebLogic Windows

Using Linked Documents in MAXIMO, you can attach Word documents, PDF files, diagrams, pictures, and other types of documents, as well as Web page URLs, to individual MAXIMO records.

In this scenario, please consider both MAXIMO Application Server and the server storing the documents as the same machine called AD.

Check the MXE.HOME Setting from mxserver.properties fileFor example:

mxe.home=C:\\MAXSQL\\ENG\\52\\MAXIMO

Create the DOCLINKS directory structure on the machine storing the document files For example:

Go to your <MAXIMO root>\doclinks\WEB-INF directory and copy the web.xml file into the WEB-INF directory you created in the step above. The file contains mime-mapping information, which you may later customize, if needed.

Map a drive, as for example H:, to the DOCLINKS folder on the machine storing the documents:

Important: Repeat this this drive H: mapping at each MAXIMO client workstations.

Editing the Doclink.properties file

Maximum Size for Upload File. For example:mxe.doclink.maxfilesize = 20

Default Directory Path for Folders with No Default Path. For example:mxe.doclink.doctypes.defpath = H:\\DOCLINKS\DEFAULT

Translation of Specified Filepaths of Folders to URL'sC<PATH>\\MAXSQL\\ENG\\52\\MAXIMO\\DOCLINKS = http://AD:7081/DOCLINKS

Configuring the Application Server for Attached Documents

To configure Attached Documents in the Application Server with WebLogic, you create a new web application. Complete the following steps:

1. Backup the config.xml file in <WebLogic root>\user_projects\<domain_name> in the domain in which you want to configure the Web application.

2. Make sure the Application Server is running.

3. Use Internet Explorer to access the Administration Console by specifying the following URL:http://<hostname>:<port>/console where <hostname> is the name of the machine and <port> is the port number of the Application Server.When prompted, enter the WebLogic user name and password you specified for the Application Server domain.

4. In the left pane, under the Deployments node, click Web Applications. The right frame refreshes.

5. Delete the existing Web application named doclinks that you created when you installed MAXIMO.

6. In the right pane, click Configure a new Web Application. The right pane refreshes and displays the Locate Application or Component to Configure panel, which shows two WebLogic steps.

7. In the path statement under WebLogic Step 2 (on the WebLogic UI), navigate to the location of the DOCLINKS directory on the mapped drive.

For example, click on the ad machine name to display the drive letters:

Then click the mapped drive H, to display the directories on H:

8. Next to the DOCLINKS directory, click [select]. The right pane refreshes and displays WebLogic steps 3 through 5.

9. In WebLogic step 3, under Available Servers, select the Application Server into which you want to deploy the Web application and click the right arrow to move it under Target Servers.

10. In WebLogic step 4, name the Web application DOCLINKS. The name must be the root directory name where the documents are stored. Since you selected it in step 8, above, DOCLINKS is the default. The name is case sensitive.

11. In WebLogic step 5, click Configure and Deploy. The Web Application you created appears in the Web Application tree in the left pane.

Editing Default File Paths in MAXIMO

Log into MAXIMO. You must have rights to edit file paths in Attached Documents.

Open an application that has an Attached Documents tab and click the Attached Documents tab.

From the Select Action menu, choose Manage All Document Folders.

Click the Details icon next to the document folder whose file path you want to change. This displays the details area at the bottom of the page.

In the Default File Path field, edit the path to specify the new location of the associated directory. Enter the full path using the mapped drive letter.

Change the file paths for the attachments, diagrams, and images folders to:H:\DOCLINKS\ATTACHMENTSH:\DOCLINKS\DIAGRAMSH:\DOCLINKS\IMAGESetc.

For example:

Additional Configuration Steps

Because you edited the doclink.properties file you must build and deploy MAXIMO EAR file.

Restart the Application Server.