Feature Pack 7

Installing and configuring the WebSphere Commerce Search Connector

You can use the WebSphere Commerce Search Connector to connect and communicate with the BloomReach SNAP services.

You install the WebSphere Commerce Search Connector using the IBM Installation Manager, then configure the WebSphere Commerce Search Connector using the enablement script.

Before you begin

Complete the following installation and enablement tasks:
Complete the following tasks so that the enablement script in this task functions correctly:
  • SolarisLinuxAIXEnsure that you are logged on as the WebSphere Commerce non-root user.
  • For IBM i OS operating systemEnsure that you are logged on as a user that has *SECOFR authority.
  • Ensure that your administrative server is started. For example:
    • If WebSphere Commerce is managed by WebSphere Application Server Deployment manager (dmgr), start the deployment manager and all node agents. Your cluster can also be started.
    • If WebSphere Commerce is not managed by WebSphere Application Server Deployment manager (dmgr), start the WebSphere Application Server server1.
  • Ensure that your WebSphere Commerce search server is started.
Complete the onboarding tasks. For example, where:
  • Your WebSphere Commerce information is created in the BloomReach system.
  • Your WebSphere Commerce information is configured to work with the BloomReach SNAP platform.
  • An FTP account is created to store your WebSphere Commerce configuration and other files that might be required for your integration to function correctly.
  • Your setup and account information is shared with you as part of the onboarding process between you and the BloomReach team.

Procedure

  1. Download the WebSphere Commerce Search Connector from IBM Passport Advantage: Passport Advantage.

    IBM Passport Advantage: WebSphere Commerce Search Connector
    Product identifier Product name License Information ID
    5724-I38 IBM WebSphere Commerce Search Connector L-JTAG-9GQMFN
  2. Install the WebSphere Commerce Search Connector using the IBM Installation Manager.

    The IBM Installation Manager installs and manages packages on your computer.

    1. Install the IBM Installation Manager
    2. Add the WebSphere Commerce Search Connector repository location to the Installation Manager:
      1. On the Start page of Installation Manager, click File > Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and whether they are connected.
      2. On the Repositories page, click Add Repository.
      3. In the Add Repository dialog box, click Browse. Go to the location of your WebSphere Commerce Search Connector directory, select the WebSphere Commerce Search Connector repository, then click OK. The new repository location is listed.
      4. Click Test Connections to ensure that the Repository URL is available.
      5. Click OK to close the repositories page.
    3. In Installation Manager, click Install. The Installation Manager searches its defined repositories for available packages.
    4. On the Install Packages page, select WebSphere Commerce Search Connector and click Next.
    5. Read and accept the license agreement.
    6. Select the WebSphere Commerce installation path as the location where you want to install the product in the Installation Directory field and click Next.
      For example, WC_installdir.
    7. The Installation Manager detects all of the applicable features. Recommended features are automatically selected. Select any additional features that you want to install and click Next.
    8. Review the installation summary and click Install to begin the installation process.
    9. After installation is complete, check the final page to ensure that there are no warnings or errors.
      If there are no warnings or errors, click Finish to exit the installation process. If there are warning or error messages, refer to Troubleshooting: WebSphere Commerce installation issues.
    10. Take one of the following actions:
      • Close IBM Installation Manager.
      • Open First Steps and learn more about what you can do now that the WebSphere Commerce Search Connector is installed.
  3. Configure the WebSphere Commerce Search Connector using the enablement script.

    The enablement script adds new services and updates the existing services to support the WebSphere Commerce Search Connector.

    1. Log on with appropriate authority:
      • SolarisLinuxAIXA WebSphere Commerce non-root user.
      • WindowsA user ID that is a member of the Windows Administration group.
      • For IBM i OS operating systemA user profile that has *SECOFR authority.
    2. Go to the following directory:
      • WC_installdir/bin
    3. SolarisLinuxAIXIf you encounter a file error message, as the WebSphere Commerce non-root user, increase the file handle limit.
      • SolarisAIXIncrease the file handle limit with the command: ulimit -n 8192
      • LinuxAs the root user grant USE authority to the non-root user. Switch to the non-root user and issue the command: ulimit -n 8192. You can also issue the command as the root user, then switch to the non-root user.
    4. Run the enablement script:
      • Windowsconfig_ant.bat -buildfile WC_installdir/components/foundation/subcomponents/search/bloomreach/deploy/xml/deployBrConnector.xml -DinstanceName=instance_name -DdbUserPassword=db_password
      • For IBM i OS operating systemSolarisLinuxAIX./config_ant.sh -buildfile WC_installdir/components/foundation/subcomponents/search/bloomreach/deploy/xml/deployBrConnector.xml -DinstanceName=instance_name -DdbUserPassword=db_password
      Where:
      instance_name
      The name of the WebSphere Commerce instance with which you are working (for example, demo).
      db_password
      The password for the user who is connecting to the database.
      If the script runs successfully:
      • SolarisLinuxAIXWindowsThe message BUILD SUCCESSFUL is displayed in the console and in the WC_installdir/instances/instance_name/logs/deployBrConnector_timestamp.log file. For more information, open the file and review the contents.
      • For IBM i OS operating systemThe message BUILD SUCCESSFUL is displayed in the console and in the WC_instance_root/instances/instance_name/logs/deployBrConnector_timestamp.log file. For more information, open the file and review the contents.

What to do next

After you install and configure the WebSphere Commerce Search Connector, you can use it to connect and communicate with the BloomReach SNAP services.