Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

---

 

Add the QPServlet application to the Lotus QuickPlace server

Add the QPServlet to your IBM^® Lotus^® QuickPlace^® server. The QPServlet application (stored in the Java archive file cs.jar) allows the My Lotus QuickPlaces portlet to retrieve information from the Lotus QuickPlace server. This procedure is not necessary for the Inline QuickPlace portlet.

Perform the following steps:

1. If it does not already exist, create a directory on the Lotus QuickPlace server called /domino/servlet/ in the following directory: domino_data_root

2. Locate the Domino Data servlets.properties file, typically in the same directory: domino_data_root. If this file does not exist, create it with a text editor.

3. Open the servlets.properties file in a text editor and add the following line:

   servlet.QPServlet.code=com.lotus.cs.util.QPServlet

   The preceding line is case-sensitive, and add a hard return character at the end of the line.

4. Save and close the file.

5. On the portal server, copy the Collaborative Services Java archive file (cs.jar) from the following directory: portal_server_root/shared/app/.

6. All platforms except i5/OS: Paste the file into the following directory on the Lotus QuickPlace server: domino_data_root/domino/java.

   Do not create sub-directories such as /WEB-INF.

7. i5/OS: Perform the following steps to store the cs.jar file:

   1. Enter the following command on an OS/400 command line to create a new directory called WPS1:

      MKDIR /WPS1

   2. Enter the following command to change the owner of the new directory to QNOTES:

      CHGOWN OBJ('/WPS1') NEWOWN(QNOTES)

   1. Copy and paste cs.jar to the new directory.

   2. Enter the following command:

      CHGOWN OBJ('/WPS1/cs.jar') NEWOWN(QNOTES)

8. All platforms except i5/OS: Using a text editor, edit the NOTES.INI file on the Lotus QuickPlace server to specify the cs.jar file. Perform the following steps:

   1. Locate the JavaUserClassext line and append WPS1 to the line.

   2. Add the following line below the JavaUserClassext line:

      Windows:

      WPS1=c:\Domino\data\domino\java\cs.jar

       

      Unix:

      WPS1=/opt/IBM/Lotus/Domino/data/domino/java/cs.jar

9. i5/OS only: Using a text editor, edit the NOTES.INI file on the Lotus QuickPlace server to specify the cs.jar file. Perform the following steps:

   1. Add the following line:

      WPS1=/WPS1/cs.jar

   2. Locate the JavaUserClassext line.

   3. Append WPS1 to the JavaUserClassext line.

10. Still in the NOTES.INI file, enable the DIIOP task for the Lotus QuickPlace server by locating the Servertasks line, and adding diiop at the end of the line.

11. Follow these steps to ensure that Domino Servlet Manager is set for Java Servlet Support:

    1. On the Lotus QuickPlace server, start the Domino Administrator client software and type the password for the administrator.

    2. Open the names.nsf database.

    3. Edit the Lotus QuickPlace Server document.

    4. Go to Internet Protocols and click Domino Web Engine.

    5. Set Java Servlet Support to Domino Servlet Manager.

    6. Save the close the Server document.

12. To verify that the servlet runs, in your Web browser, go to the following page: http://yourQuickPlaceserver.yourInternetdomain/servlet/QPServlet?actionType=69

    The browser should return a message similar to the following message:

    QPServlet:LCS Build [Version][Date][WPS build stream]=[CSBLDVER][CSBLDDATE][CSBLDWPS]
    Posted Build

    If you do not see the preceding message, see the following troubleshooting technote to help determine why the QPServlet is not loading correctly on your Lotus QuickPlace server:

    Technote 1159319 Error: "Connection to QuickPlace Server Could not Be Established" in MyTeamWorkPlace Portlet

    You can also use Search at IBM Support to find technotes by number.

The list of Lotus QuickPlace team places on your server should now appear in the drop-down list. If you experience problems with the drop-down server list, see the following troubleshooting technote:

Technote 1157249 Troubleshooting Pickers in Lotus Collaborative Portlets

You can also use Search at IBM Support to find technotes by number.

 

Parent topic:

Checklist of tasks: Lotus QuickPlace server and portlets

 

Previous topic

Pointing the My Lotus QuickPlaces portlet to an alternate Lotus QuickPlace server (optional)

 

Next topic

Configuring the Search All Places feature

---