Add the QPServlet application to the Lotus QuickPlace server

 

+

Search Tips   |   Advanced Search

 

Add the QPServlet to the 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 called /Servlet/ in the following directory: domino_server_root/data

2. Locate the Domino Data file...

   domino_server_root/data/servlets.properties

   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. Copy the Collaborative Services Java archive file (cs.jar) from...

   portal_server_root/shared/app/

6. All platforms but i5/OS: Paste the file into the following directory...

   domino_server_root/data/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 but 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. For Windows and UNIX, add the following line below the JavaUserClassext line:

          WPS1=c:/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 QuickPlace server by locating the Servertasks line, and adding diiop at the end of the line.

11. 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 the 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 the Lotus QuickPlace server:

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

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

The list of QuickPlaces on the 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

We 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

 

---