Install > Installing or enabling additional software


Install Gift Center

You can install IBM Gift Center, an optional separately purchased component of WebSphere Commerce, using an installation script.


Procedure

  1. Log onto the system as root, and switch to the non-root user, such as wasuser. For example, su - wasuser.

  2. Modify the SOAP request timeout value:

    1. Switch to the following directory:

    2. Edit the soap.client.props file, under this directory by locating the SOAP Request Timeout section within the file, and then changing the com.ibm.SOAP.requestTimeout value to 0.

      The following is an example of the required change:

      #----------------- 
      # SOAP Request Timeout 
      # 
      # - timeout (specified in seconds [default 180], 0 implies no timeout) 
      #-----------------     
      com.ibm.SOAP.requestTimeout=0  
      

    3. Save the soap.client.props file.

    4. Stop and restart the WCS instance. Stop and restart the WebSphere Commerce test server instance.

  3. For each of the WebSphere Application Server applications under an instance other than the one you are using with WebSphere Commerce, stop these applications. For example, if the WebSphere Commerce instance is called demo, do not stop this. If you have another instance called default, then stop it.

    The following is an example of stopping WebSphere Application Server, using server1 as the WebSphere Application Server application and default as the instance name:

    WAS_HOME/profiles/default/bin/stopServer.sh server1
    


    WAS_userdir/profiles/demo/bin/stopServer server1
    


    WAS_HOME/profiles/default/bin/stopServer.bat server1
    

    Stop any test server instance other than the one used for the WebSphere Commerce test environment.

  4. Stop the WebSphere Commerce test server instance. If you have the server started, the IBM Gift Center for WebSphere Commerce will not be installed properly.

  5. From a command prompt, run the IBM Gift Center for WebSphere Commerce enablement script as follows:

    1. Switch to the following directory:

    2. Run the following command:

      ./config_ant.sh -buildfile WC_INSTALL/components/GiftCenter/xml
      /enableGiftCenterForServer.xml -DinstanceName=instance 
      -DdbUserPassword=database_user_password
      


      config_ant.bat -buildfile "..\components\GiftCenter\xml\
      enableGiftCenterForServer.xml" -DinstanceName=instance 
      -DdbUserPassword=database_user_password   
      

      • Complete one of the following commands, depending on the database configuration:

        • A local DB2 database:

          enableGiftCenterForToolkit.bat -DdbType=DB2 -DdbName=database_name 
          -DdbUserName=database_user_name -DdbUserPassword=
          database_user_password -DschemaName=database_schema_name
          

        • A remote DB2 database:

          enableGiftCenterForToolkit.bat -DdbType=DB2Remote -DdbHost=
          database_host_name -DdbUserName=database_user_name 
          -DdbUserPassword=database_user_password 
          

        • A local Oracle database:

          enableGiftCenterForToolkit.bat -DdbType=Oracle -DdbName=
          database_name -DdbUserName=database_user_name 
          -DdbUserPassword=database_user_password
          

        • A remote Oracle database:

          enableGiftCenterForToolkit.bat -DdbType=Oracle -DdbHost=
          database_host_name -DdbUserName=database_user_name 
          -DdbUserPassword=database_user_password
          

        • A Derby database:

          enableGiftCenterForToolkit.bat -DdbType=Cloudscape
          

      Verify the Rational Application Developer, WebSphere Commerce, and WebSphere Commerce Developer installation directories on Windows 2000 do not contain spaces and use a shortened format, for example, C:\WCToolkit.

      Where:

      database_host_name

      (Remote database only) The host name of the database, if you are using a remote DB2 database with WebSphere Commerce. If you are using a remote DB2 or Oracle database with WebSphere Commerce, do not specify -DdbName=database_name; use this parameter instead.

      database_name

      The name of the database you are using with WebSphere Commerce (for example, mall). If you are using a remote DB2 or Oracle database with WebSphere Commerce, do not use this parameter; use -DdbHost=database_host_name instead.

      database_user_password

      The password for the database used with WebSphere Commerce.

      database_schema_name

      The database user ID (schema owner). This value should be the same as the value for database_name. If you are enabling the IBM Gift Center for WebSphere Commerce script on WebSphere Commerce, specify the schema name in capital letters (for example, MYSCHEMA). This parameter is only required if you are using DB2 as your database.

      database_type

      The type of database management system you are using with WebSphere Commerce. Depending on the type database you are using, specify one of the following:

      DB2

      if you are using DB2 Database with a local database (that is, the database is on the same system as where we will enable IBM Gift Center for WebSphere Commerce).

      Oracle

      If you are using Oracle with a local database (that is, the database is on the same system as where we will enable IBM Gift Center for WebSphere Commerce).

      DBRemote

      if you are using DB2 Database or Oracle with a remote database (that is, the database is on the a different system as where we will enable IBM Gift Center for WebSphere Commerce).

      database_user_name

      Your database user name, used when connecting to this database.

      Depending on memory and speed of the processor, the enablement script may take several minutes to over an hour complete. Once complete, you should see a status message to indicate that the script has been enabled successfully.

  6. Stop and restart the WCS instance. Stop and restart the WebSphere Commerce test server instance.

  7. Verify that the IBM Gift Center for WebSphere Commerce enablement script ran successfully by ensuring the gc.enabled.component file is located...

    • WC_INSTALL/instances/instance/properties/version/gc.enabled.component

    • WC_EAR/properties/version/gc.enabled.component

    If you encounter errors when enabling IBM Gift Center for WebSphere Commerce, refer to Troubleshoot: Errors when enabling IBM Gift Center.

  8. Optional: You can optionally download and install the IBM Gift Center for WebSphere Commerce sample applications, which include the IBM Gift Center for WebSphere Commerce user interfaces for the Web (online), in-store Gift Consultant, and in-store kiosk channels.

    To download the sample applications for WebSphere Commerce Version 6.0, see WebSphere Commerce and WebSphere Commerce Developer 6.0 sample applications Technote #1232098.


+

Search Tips   |   Advanced Search