Configure LikeMinds support for a Personalization server

 

+

Search Tips   |   Advanced Search

 

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

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

Password considerations: For security reasons, you should not store passwords in the wpconfig.properties file. It is recommended 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 Delete passwords.

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

  • WPSconfig.{sh|bat} task_name -D password_property_key=password_value

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

To configure LikeMinds support:

  1. LikeMinds requires a database. Use the same database used to store information for Portal Personalization, or we can create a new database specifically for LikeMinds information.

    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 properties files...

      portal_server_root/config/wpconfig.properties
      pzn_root/config/wpconfig_dbdomain.properties
      pzn_root/config/wpconfig_dbtype.properties

  3. Edit the properties files. Uncomment and verify the properties for the environment.

  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.

    • UNIX:

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

    • Windows:

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

    • i5/OS:

      WPSconfig.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 is installed; for example, wp_profile.

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

    • UNIX:

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

    • Windows:

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

    • i5/OS:

      WPSconfig.sh -profileName profile_root likeminds-database -Dlikeminds.DbPassword=password

      ...where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal 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:

    • UNIX:

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

    • Windows:

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

    • i5/OS:

      WPSconfig.sh -profileName profile_root setup-likeminds -Dlikeminds.DbPassword=password

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

 

Unconfiguring the LikeMinds Recommendation Engine

To unconfigure LikeMinds support:

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

  2. Enter the following commands:

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

    • UNIX:

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

    • Windows:

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

    • i5/OS:

      WPSconfig.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 is installed; for example, wp_profile.

 

Configure the MovieSite sample

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 .

  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:

    • UNIX:

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

    • Windows:

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

    • i5/OS:

      WPSconfig.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 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

To unconfigure the MovieSite sample:

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

  2. Enter the following command:

    • UNIX:

      ./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 is installed; for example, wp_profile.

 

Next steps

You have completed this step. Continue to the next step by choosing one of the following topics: