Prepare for remote search service

 

+

Search Tips   |   Advanced Search

 

To enable the remote search service, perform the following steps on the machine where you want to install the remote search service:

  1. If you use SOAP...

    Global security If turned on, the SOAP service itself is not secure.
    Java 2 security Must be disabled

    For development, you might want to disable global security for the WAS server on which you plan to install the remote search service...

  2. Copy the files...

    • WebScannerSoap.ear
    • WebScannerEjbEar.ear
    • PseLib.zip

    ...to...

    was_profile_root/installableApps

    ...on the machine on which you want to install the remote search service. You find these files in the directory...

    portal_server_root/installableApps

    ...of the portal installation.

  3. Depending on the requirements of the environment, install one of the two applications...

    • WebScannerEJbEar.ear
    • WebScannerSoap.ear

    ...on a server server1...

    1. Access the administrative console.

    2. Select...

      Applications | Install New Application

    3. Browse and select...

      WebScannerEjbEar.ear

      ...or...

      WebScannerSoap.ear

      ...depending on whether you are using EJB or Web service via SOAP.

    4. Click Next.

    5. On the following panels accept the default settings.

    6. A message confirms that the application...

      PSEStandalone (EJB)

      ...or the application...

      WebScannerEar (SOAP)

      ...was installed successfully.

    7. Click Save to Master Configuration.

    8. Click Save.

  4. If you use Document Conversion Services...

    1. Install remote document conversion services on server1.

      You do not need to delegate all conversion tasks from the WebSphere Portal to server1. You only need to install the remote conversion services.

    2. Invoke the IBM WAS Administrative Console and select...

      Environment | Shared Libraries

      Create a new shared library named PSE with a classpath as follows:

      $(APP_INSTALL_ROOT)/cell/dcs_war.ear/dcs.war/WEB-INF/lib/convertors.jar
      $(APP_INSTALL_ROOT)/cell/dcs_war.ear/dcs.war/WEB-INF/lib/Export.jar

      ...where cell is the IBM WebSphere Application Server cell name where DCS is installed.

    3. Click Apply | Save | Save to save changes.

  5. Extract the Portal Search libraries and add them to the classpath on server1...

    1. Create a directory with the name extract under the directory installableApps.

    2. Locate the file PseLib.zip in the directory installableApps and extract its content into the directory extract that you created in the previous step.

    3. Open the administrative console.

    4. Click...

      Environment | Shared Libraries

    5. Create or modify the new shared library named PSE.

    6. Add the libraries extract/lib to the classpath by adding a new line to the classpath and giving the full path:

      was_profile_root/installableApps/extract/lib

    7. Click...

      Apply | Save | Save

      ...to save changes to the configuration.

  6. Define a new Classloader for server1...

    1. In the administrative console, click...

      Servers | Application Servers | server1 | Server Infrastructure | Java and Process Management | Classloaders | New | Apply

    2. Under Additional Properties, click...

      Libraries | Add | Library Name PSE | OK

    3. Save the changes to the configuration.

  7. On the administrative console, determine the required values for configuring the portlet parameters, depending on whether you are using EJB or Web service via SOAP:

    • For EJB determine the value for the port under...

      Servers | Application Servers | YourAppServer1 | Communications | Ports | BOOTSTRAP_ADDRESS

    • For SOAP determine the value for the port number of the SOAP URL by using the HTTP transport port on which server1 is configured to run...

      Application servers | server1 | Ports | WC_defaulthost
      The WC_defaulthost value is 10000; therefore, if you did not change the default, we can use this value. Verify the port number that is set in the following file matches this port:

      was_profile_root/installedApps/cell/WebScannerEar.ear/WebScannerSoap.war/wsdl/com/ibm/hrl/portlets/WsPSE/WebScannerLiteServerSOAPService.wsdl

      WebScannerEar.ear is the name given to the Enterprise Application when you installed the WebScannerSoap.war file.

      Edit the file and look for the port given in the value for the SOAP address location. Example:

      <soap: address location="http://localhost:your_port_no/WebScannerSoap/servlet/rpcrouter"/>.

      In the example the port is your_port_no. The default value for the SOAP WC_defaulthost is 10000.

  8. In the administrative console, under...

    Resources | Asynchronous beans | Work managers

    ...create a new Work manager named PSEWorkManager with the following attributes:

       
    Name:                       PSEWorkManager    JNDI Name:                  wps/searchIndexWM
       Minimum Number of Threads:  20
       Maximum number of Threads:  60
       Growable =                  True    Service Names:              Application Profiling Service, WorkArea, Security, Internationalization 

  9. Click Apply | Save | Save to save changes to the configuration.

  10. Start the application:

    1. Open the administrative console.

    2. Click...

      Applications | Enterprise applications

    3. Scroll to...

      PSEStandalone

      ...or...

      WebScannerEar

      Use the filter feature to search for these names.

    4. Click the checkbox and click Start. A message confirms that the application started successfully.

  11. If you work with EJB on a secure server set the search user ID.

  12. If you disabled security or set the search user ID by one of the optional previous steps westart the WebSphere Application Server.

  13. Verify the remote search configuration works correctly.

  14. If required, re-enable security on the WebSphere Application Server.

  15. Back on the portal, configure Portal Search for remote search service.

 

Parent topic:

Use remote search service