WebSphere

 

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

 

Configure LikeMinds support for Personalization

Personalization contains a dynamic recommendation system based on LikeMinds. LikeMinds is software that is used with your e-commerce applications. LikeMinds analyzes user interactions that occur on your Web site and generates real time predictions and recommendations to your Web site users.

Before you can use the LikeMinds Recommendation Engine , configure it for use. The recommendation system is configured by default when you install WebSphere Portal Express, but it is optional when you install a Personalization Server. If you do not select to configure Likeminds when installing a Personalization Server, you can configure it later. In addition, you can install the MovieSite sample to see how LikeMinds works, either in a WebSphere Portal Express or in a Personalization Server.

 

Password considerations: For security reasons, you should not store passwords in the wpconfig.properties file. IBM recommends that you edit the wpconfig.properties prior to running a configuration task, inserting the passwords needed for that task. Then, after the task has run, you should delete all passwords from the wpconfig.properties file. For more information, see Deleting passwords.

Alternatively, you can specify the password on the command line using the following syntax:

As with other properties, each password property must have the -D prefix and be set equal to (=) a value. If you have multiple properties in a single command, use a space character between each -Dproperty=value setting.

Also, if a value is specified for WasPassword, a value must also be specified for WasUserid. If WasPassword is left blank, WasUserid must also be left blank.

 

Configure LikeMinds after installation

Follow these steps to configure LikeMinds support:

  1. LikeMinds requires a database. You can use the same database used to store information for Portal Personalization, or you can create a new database specifically for LikeMinds information. If you choose to create a new database, refer to the Creating databases and users section of Configuring databases before continuing.

    If you are using a local IBM DB2 Universal Database™ Enterprise Server Edition database and you want to create a separate database for LikeMinds information, Personalization can create the database for you, as part of the instructions provided below.

  2. Locate the portal_server_root/config/wpconfig.properties, pzn_root/config/wpconfig_dbdomain.properties, and pzn_root/config/wpconfig_dbtype.properties files.

    pzn_root indicates the root directory of WebSphere Portal Express Personalization Server.

  3. Use a text editor to open the properties files. Uncomment and verify the properties for your environment. See Configuring Personalization after installation for a list of properties.

  4. Open a command prompt and change to the directory pzn_root/config.

  5. If you are using a local DB2 database and are creating a new database for LikeMinds information, run the following command from the pzn_root/config directory. Perform this step only if you are creating a new database for LikeMinds. Any data in an existing database will be lost.

    • Linux:

      ./WPSconfig.sh create-db2-database-likeminds -Dlikeminds.DbPassword=password

    • Windows:

      WPSconfig.bat create-db2-database-likeminds -Dlikeminds.DbPassword=password

    • i5/OSWPSconfig.sh -profileName profile_root create-db2-database-likeminds -Dlikeminds.DbPassword=password

      where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

  6. If the LikeMinds database has been created, run the following command from the pzn_root/config directory:

    • Linux:

      ./WPSconfig.sh likeminds-database -Dlikeminds.DbPassword=password

    • Windows:

      WPSconfig.bat likeminds-database -Dlikeminds.DbPassword=password

    • i5/OSWPSconfig.sh -profileName profile_root likeminds-database -Dlikeminds.DbPassword=password

      where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

    Check the output for any error messages before proceeding with the next task. If any of the configuration tasks fail, verify the values in the wpconfig.properties, wpconfig_dbdomain.properties, and wpconfig_dbtype.properties files.

  7. To complete the LikeMinds configuration, run the following command from the pzn_root/config directory:

    • Linux:

      ./WPSconfig.sh setup-likeminds -Dlikeminds.DbPassword=password

    • Windows:

      WPSconfig.bat setup-likeminds -Dlikeminds.DbPassword=password

    • i5/OSWPSconfig.sh -profileName profile_root setup-likeminds -Dlikeminds.DbPassword=password

      where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

 

Unconfiguring the LikeMinds Recommendation Engine

Follow these steps to unconfigure LikeMinds support:

  1. Open a command prompt and change to the directory pzn_root/config.

  2. Enter the following commands:

    • Linux:

    • Windows:

    • i5/OSWPSconfig.sh -profileName profile_root drop-database-tables-domain-likeminds -Dlikeminds.DbPassword=password

      where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

  3. If you are using a local DB2 database, run the following command from the pzn_root/config directory:

    • Linux: ./WPSconfig.sh remove-likeminds-database-db2 -Dlikeminds.DbPassword=password

    • Windows:

      WPSconfig.bat remove-likeminds-database-db2 -Dlikeminds.DbPassword=password

    • i5/OSWPSconfig.sh -profileName profile_root remove-likeminds-database-db2 -Dlikeminds.DbPassword=password

      where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

 

Configure the MovieSite sample

Follow these steps to configure the MovieSite sample:

The MovieSite sample is only supported on IBM DB2 Universal Database Enterprise Server Edition

  1. Ensure that the LikeMinds Recommendation Engine is configured, as described in Configuring LikeMinds with WebSphere Portal Express.

  2. Enable Logging:

    1. Open pzn_root/shared/app/config/services/FeedbackService.properties

    2. Ensure that the following property is set to true: loggingEnabled = true

    3. Restart the WebSphere Application Server where the Personalization Runtime is installed.

  3. Open a command prompt and change to the directory pzn_root/config.

  4. To set up the MovieSite sample, run the following command from the pzn_root/config directory:

    • Linux:

      ./WPSconfig.sh cfg-likeminds-samples -Dlikeminds.DbPassword=password -DPortalAdminPwd=portalpassword

    • Windows:

      WPSconfig.bat cfg-likeminds-samples -Dlikeminds.DbPassword=password -DPortalAdminPwd=portalpassword

    • i5/OSWPSconfig.sh -profileName profile_root cfg-likeminds-samples -Dlikeminds.DbPassword=password -DPortalAdminPwd=portalpassword

      where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

    Check the output for any error messages before proceeding with the next task. If any of the configuration tasks fail, verify the values in the wpconfig.properties, wpconfig_dbdomain.properties, and wpconfig_dbtype.properties files.

  5. If you are using an external HTTP server, make sure the server plug-in has been regenerated and restart the server.

  6. Use http://hostname:port/MovieSite to log in to the MovieSite.

 

Unconfiguring the MovieSite sample

Follow these steps to unconfigure the MovieSite sample:

  1. Open a command prompt and change to the directory pzn_root/config.

  2. Enter the following command:

    • Linux:

      ./WPSconfig.sh remove-likeminds-samples -Dlikeminds.DbPassword=password

    • Windows:

      WPSconfig.bat remove-likeminds-samples -Dlikeminds.DbPassword=password

    • i5/OS:

      WPSconfig.sh -profileName profile_root remove-likeminds-samples -Dlikeminds.DbPassword=password

      where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

 

Parent topic:

Installing Personalization without WebSphere Portal Express