README

IBM® Gift Center for WebSphere® Commerce
Online or Web Channel Sample Application
for AIX®, i5/OS®, z/OS®, Linux™, Solaris Operating Environment, and Windows®

Professional and Enterprise
Version 6.0

Last updated: March 27, 2006
 

Important

Contents

What's in this README

This README contains information on how to install the IBM Gift Center for WebSphere Commerce sample application for the online or Web gift registry channel. This README is applicable to the following:

You can use the sample application on top of your existing version of the IBM Gift Center to take advantage of a richer multichannel gift registry solution. The sample is packaged as a series of three SAR files (the Web or online SAR being one of them) that work on top of the ConsumerDirect starter store. The instructions in this README teach you how to publish the Web or online channel SAR.

Note: If you plan to use any of the other channels (gift consultant, or kiosk), you must publish this SAR first.

For the Web or online gift registry channel, typically, a customer logs onto their personal computer to create, manage, or buy from gift registries within the store. The IBM Gift Center sample application provides functionality for gift registrants who create or update gift registries online, and features for gift givers who shop for gifts.

The sample application includes various features and functions in addition to the base IBM Gift Center solution. With this channel, registrants can create and manage their gift registries, and gift givers can buy gifts, by logging onto an online store. For details on this channel, refer to the IBM WebSphere Commerce 6.0 Information Center (expand Developing > IBM Gift Center > Using the IBM Gift Center sample application).

Documentation

In addition to the installation instructions provided in this README, you can obtain other IBM Gift Center for WebSphere Commerce documentation:

Path variables

This README file uses the following variables to represent directory paths:
  • ConsumerDirect_store_ID
    The unique store ID (such as 10001) for the ConsumerDirect starter store. This ID is system generated, when you publish the store using the WebSphere Commerce Administration Console. To determine the ConsumerDirect store ID, run the following SQL statement:
     
    select * from store
     
    This SQL statement queries the STORE database table. Look for ConsumerDirect under the DIRECTORY column, and note the value for STORE_ID for ConsumerDirect.
     
    hostname
    The host name of the machine where you installed WebSphere Commerce or WebSphere Commerce Developer.
     
    instance_name
    The name of the WebSphere Commerce instance. The default instance name is demo.
     
    WCDE_installdir
    The installation directory for the WebSphere Commerce Developer. The default installation directory is as follows:
    WC_installdir
    The installation directory for the WebSphere Commerce. The default installation directory is as follows:
    WC_userdir
    (i5/OS only) The directory for all the data that is used by WebSphere Commerce which can be modified or needs to be configured by a user. An example of such data is WebSphere Commerce instance information. This directory is unique to i5/OS. The WC_userdir variable represents the following directory: /QIBM/UserData/CommerceServer60.

    Installation prerequisites

    Before you install the IBM Gift Center for WebSphere Commerce solution, ensure you have completed the following prerequisites, on the same system where you will install the IBM Gift Center sample application:

    1. You have installed the following software:
    2. You have published the WebSphere Commerce starter store (called ConsumerDirect):
      1. If you specified non-ATP inventory, ensure you can successfully launch the ConsumerDirect starter store in a browser using
        http://hostname/webapp/wcs/stores/servlet/ConsumerDirect/index.jsp.

        Note If you have already published the ConsumerDirect store with ATP inventory, you can update the database to change the store to non-ATP by setting the STORE.INVENTORYSYSTEM value to -2 for your store. To remove ATP from the store, run the following SQL statement:

        update store set inventorysystem=-2 where store_id=ConsumerDirect_store_ID

      2. If you specified no catalog data when publishing the ConsumerDirect store, update:

        /WEB-INF/stores/StoreAssetsDir/data/store-data-assets.xml

        located in the GiftCenterConsumerDirect.sar .

        Remove the line &catalog_update.xml. Save the changes and package back into the GiftCenterConsumerDirect.sar.

      Installing the IBM Gift Center sample application: online or Web channel

      To install the online or Web channel of the IBM Gift Center sample application:

      1. On the same machine where you have installed WebSphere Commerce or WebSphere Commerce Developer, create a sar directory:
        • AIX, z/OS, Linux, Solaris Operating Environment, and Windows:
          WC_installdir/instances/instance_name/sar
        • i5/OS:
          WC_userdir          /instances/instance_name/sar
          (The sar directory may already exist on your IBM system i5 server; that is, /QIBM/UserData/CommerceServer60/sar may exist. Simply ensure that the sar directory is there.)
        • WebSphere Commerce Developer:
          WCDE_installdir\conf\sar
           
      2. From the same Web site where you obtained this README file, download and save the GiftCenterConsumerDirect.sar file to the sar directory created in step 1.
         
      3. Ensure that permissions are set to 750 on the following directory and file:
        • AIX, z/OS, Linux, and Solaris Operating Environment:
          WC_installdir/instances/instance_name/sar
          WC_installdir/instances/instance_name/sar/GiftCenterConsumerDirect.sar
        • i5/OS:
          WC_userdir          /instances/instance_name/sar
          WC_userdir/instances/instance_name/sar/GiftCenterConsumerDirect.sar
         
      4. Ensure that the following directory and file belong to the WebSphere Commerce user and group.  For example wasuser : wasgroup could be specified.
        • AIX, z/OS, Linux, and Solaris Operating Environment:
          WC_installdir/instances/instance_name/sar
          WC_installdir/instances/instance_name/sar/GiftCenterConsumerDirect.sar
        5.  
      5. Publish the GiftCenterConsumerDirect.sar as follows:
         
        1. Open the WebSphere Commerce Administration Console at:

          https://hostname:8002/adminconsole

          Hint: If you cannot access the Administration Console, ensure that both your Web server and WebSphere Commerce application server (that is, your WC_instance_name), or WebSphere Commerce test environment server have started.
        2. Log on using your WebSphere Commerce administrator ID and password.
        3. From the Administration Console Site/Store Selection page, select the Site radio button and click OK. The Site Administration Console home page displays.
        4. From the menus at the top, select Store Archives > Publish. The Store Archives page displays listing the SAR files available for publishing.
        5. From the list, select the check box next to GiftCenterConsumerDirect.sar and click Next.
        6. The Parameters page displays. From the Value list, select ConsumerDirect and click Next.
        7. The Summary page displays, listing the store archive and store selected, as well as the location to which the store archive will be published. After reviewing the summary information, click Finish.
        8. A confirmation dialog displays, telling you the number of the publishing job. Click OK. The Publish Job Status page displays. The publishing state is reflected in the Publish Status column.
        9. Click Refresh to update the status. Once publishing is complete, the Publish Status column displays Successful.
        10. (Optional) To see more details about this job, select GiftCenterConsumerDirect.sar from the list. Click Details. The Publish Details page displays. Review the publishing details.
        11. Log out of WebSphere Commerce Administration Console by selecting the Logout link at the top left of the page.

        Note: To ensure that all the new JSPs are applied, please recompile all the JSPs. You can recompile the JSPs by doing the following:

        • For Windows:
          • If you are using WebSphere Commerce server, delete the ConsumerDirect folder under the WAS_profiles\temp directory (for example, WAS_installdir\profiles\instance_name\temp\WC_instance_name_node\server1\WC_instance_name\Stores.war\ConsumerDirect).
          • If you are using WebSphere Commerce development environment, delete the ConsumerDirect folder under the WCDE_installdir\wasprofile\temp directory (for example, WCDE_installdir\wasprofile\temp\localhost\server1\WC\Stores.war\ConsumerDirect).
        • For all non-Windows platforms, use a touch utility to touch all of the files under your published ConsumerDirect store.

      Verifying your installation

      To verify that you have successfully published the Web or online channel of the IBM Gift Center sample application and that it works successfully with IBM Gift Center, use ConsumerDirect to ensure that you can access gift registry features by accessing the store's Web site. If you can successfully view the pages, then your installation is successful. To verify your installation:

      1. Open a Web browser and launch the ConsumerDirect starter store, using the following URL:
        http://hostname/webapp/wcs/stores/servlet/ConsumerDirect/index.jsp
         
      2. From the ConsumerDirect home page, select the language with which you want to work.
         
      3. From the top of the ConsumerDirect page that displays, click Gift Registry.

        You should see the gift registry home page for the ConsumerDirect store. On this page you should see a gift registry graphic at the top, and sections to give a gift, create your registry, and edit your registry.
         
      4. Create a birthday gift registry:
        1. From the Create a Registry list, select Birthday, and click Create.
        2. Since you have not registered with the ConsumerDirect store before, provide a registration logon ID and password in the fields at the top. This is a one-time set up; the next time you access the ConsumerDirect store, you can use the Sign In link and log on as a a returning registered customer.
        3. Provide information for all mandatory field, denoted by an asterisks (*).
        4. In the Registry Password and Password Confirmation fields, specify a password so that only the registrant can access the gift registry. This password is also used if you plan to publish the SAR file for the kiosk channel.
        5. Click Create Registry. If you have successfully installed the sample application, the system does the following:
          • Creates a birthday gift registry for the ConsumerDirect store.
          • E-mails a confirmation to the e-mail address used when creating the gift registry (if e-mail is set up on your WebSphere Commerce system. Refer to the IBM WebSphere Commerce 6.0 Information Center for details.)
          • Displays the registry list page, with a congratulatory message and summary of your gift registry information at the top.
        6. You can start adding items to this gift registry by clicking Add products to registry.

      Notices

      This information was developed for products and services offered in the U.S.A.

      IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

      Any reference to an IBM licensed program in this publication is not intended to state or imply that only IBM's licensed program may be used. Any functionally equivalent product, program, or service that does not infringe any of IBM's intellectual property rights may be used instead of the IBM product, program, or service. Evaluation and verification of operation in conjunction with other products, except those expressly designated by IBM, is the user's responsibility.

      IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

      IBM Director of Licensing
      IBM Corporation
      North Castle Drive
      Armonk, NY 10504-1785
      U.S.A.

      For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

      IBM World Trade Asia Corporation
      Licensing
      2-31 Roppongi 3-chome, Minato-ku
      Tokyo 106, Japan

      The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

      INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

      This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

      Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

      IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

      Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

      IBM Canada Ltd.
      Office of the Lab Director
      8200 Warden Avenue
      Markham, Ontario
      L6G 1C7
      Canada

      Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee.

      The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

      Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

      Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

      All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

      This information is for planning purposes only. The information herein is subject to change before the products described become available.

      This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

      Credit card images, trademarks and trade names provided in this product should be used only by merchants authorized by the credit card mark's owner to accept payment via that credit card.

      Trademarks and service marks

      The following terms are trademarks or registered trademarks of IBM Corporation in the United States and other countries or both:

      Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

      Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

      Other company, product, or service names may be trademarks or service marks of others.

      **************************************************************************

** COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2006

** ALL RIGHTS RESERVED.

**************************************************************************

      Note to US Government Users -- Documentation related to restricted rights -- Use, duplication, or disclosure is subject to restriction set forth in GSA ADP Schedule Contract with IBM Corp.

      End of README file