Prepare for remote search service

 

+

Search Tips   |   Advanced Search

 

This topic describes how you prepare your portal system for remote search service. You can provide remote search service by either using EJB or SOAP.

If you use SOAP, the following security and performance considerations apply:

Global security If you use SOAP over a secure server, the SOAP service itself is not secure.
Java 2 security If you use SOAP, disable Java 2 security.

You might consider disabling security before working with the remote search service for development or evaluation purposes. In this case disable global security on the IBM WebSphere Application Server server on which you install the remote search before you enable the remote search service for your portal.

  1. Access the console.

  2. Click...

    Security | Global security

  3. Deselect...

    Enable global security

  4. This configuration takes effect after restarting IBM WAS. You will perform the required restart in a later step of the following procedure.

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

  1. Copy the files...

    WebScannerSoap.ear WebScannerEjbEar.ear PseLibs.zip

    ...from...

    portal_server_root/installableApps

    ...to...

    portal_server_root/installableApps

    ...on the machine where you want to install the remote search service.

  2. Access the console.

  3. Select...

    Applications | Install New Application

  4. Browse and select WebScannerEjbEar.ear or WebScannerSoap.ear, depending on whether you are using EJB or Web service via SOAP.

  5. Click Next.

  6. On the following panels accept the default settings.

  7. A message confirms that the application PSEStandalone (for EJB) or the application WebScannerEar (for SOAP) was installed successfully.

  8. Click Save to Master Configuration.

  9. Click Save.

  10. Optional

    You only need to perform this step 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 WAS cell name where DCS is installed.

    3. Click Apply > Save > Save to save your changes.

  11. Extract the Portal Search libraries and add them to the classpath on server1. To do this...

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

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

    3. Open the console.

    4. Click Environment > Shared Libraries.

    5. Create or modify the new shared library names 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 to save your changes to the configuration.

  12. Define a new Classloader for server1. To do this...

    1. In the console, click Servers > Application Servers, then click server1 .

    2. Under Server Infrastructure > Java and Process Management click Classloaders.

    3. Click New and then Apply.

    4. Under Additional Properties, click Libraries, then click Add.

    5. Select the Library Name PSE from the drop-down list and click OK.

    6. Save changes to the configuration.

  13. On the 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 for the SOAP URL parameter. The appropriate port number for the
      SOAP URL parameter is the port on which the application server runs, in other words, the HTTP transport on which Server1 is configured to run. Determine the correct port number from Application servers > server1 > Ports > WC_defaulthost. The WC_defaulthost value is 10000; therefore, if you did not change the default, use this value. Make sure that 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
      Replace the variables as follows:

      • was_profile_root is the profile directory of your WAS installation. For example, this can be: 

              /usr/WebSphere/AppServer(/profiles/profile)

      • cell is the cell name of your remote search machine.

      • WebScannerEar.ear is the name that you gave 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.

  14. In the 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 (Ensure that the Growable check box is selected.) 
   Service Names:              Application Profiling Service, WorkArea, Security, Internationalization

  15. Click Apply > Save to save your changes to the configuration.

  16. Start the application:

    1. Open the 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.

  17. Optional

    This step is required only if you work with EJB on a secure server: Set the search user ID.

  18. Optional

    This step is required only if you disabled security or set the search user ID by one of the optional previous steps: Restart the WAS.

  19. Check that your remote search configuration works correctly.

  20. If required, re-enable security on the WAS.

  21. Back on your portal, configure Portal Search for remote search service. For details about how to do this refer to Configure Portal Search for remote search service.

 

Parent topic

Use remote search service

 

Related tasks


Preparing security for remote search service in a single-signon domain
Set the search user ID
Configure Portal Search for remote search service
Change between local and remote search services