WebSphere Commerce EnterpriseWebSphere Commerce Professional

Installing Gift Center

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

Procedure

  1. SolarisLinuxAIX Log on to your system as root, and switch to your non-root user, such as wasuser.
    For example, su - wasuser.
  2. Modify the SOAP request timeout value:
    1. Switch to the following directory:
      • SolarisLinuxWindowsAIXWAS_installdir/profiles/WC_instance_name/properties
      • For IBM i OS operating systemWAS_userdir/profiles/WC_instance_name/properties
      • WebSphere Commerce DeveloperWCDE_installdir\wasprofile\properties
    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.
      For example
      
      #----------------- 
      # 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 your WebSphere Commerce instance.

      WebSphere Commerce DeveloperStop and restart your WebSphere Commerce test server instance.

  3. For each of your WebSphere Application Server applications under an instance other than the one you are using with WebSphere Commerce, stop these applications.
    For example, if your WebSphere Commerce instance is called demo, do not stop the demo instance. If you have another instance that is called default, then you must stop the default instance.
    The following command is an example of stopping WebSphere Application Server, using server1 as your WebSphere Application Server application, and default as your instance name: SolarisLinuxAIX
    
    WAS_installdir/profiles/default/bin/stopServer.sh server1
    
    For IBM i OS operating system
    WAS_userdir/profiles/demo/bin/stopServer server1
    Windows
    WAS_installdir/profiles/default/bin/stopServer.bat server1
    WebSphere Commerce DeveloperStop any test server instance other than the one used for your WebSphere® Commerce test environment.
  4. WebSphere Commerce Developer Stop your WebSphere Commerce test server instance. If you have the server started, the IBM® Gift Center for WebSphere Commerce does not install properly.
  5. From a command prompt, run the IBM Gift Center for WebSphere Commerce enablement script as follows:
    1. Switch to the following directory:
      • SolarisLinuxWindowsAIXFor IBM i OS operating systemWC_installdir/bin
      • WebSphere Commerce DeveloperWCDE_installdir/components/GiftCenter/bin
    2. Run the following command: SolarisLinuxAIXFor IBM i OS operating system
      
      ./config_ant.sh -buildfile WC_installdir/components/GiftCenter/xml
      /enableGiftCenterForServer.xml -DinstanceName=instance_name 
      -DdbUserPassword=database_user_password
      
      Windows
      
      config_ant.bat -buildfile "..\components\GiftCenter\xml\
      enableGiftCenterForServer.xml" -DinstanceName=instance_name 
      -DdbUserPassword=database_user_password   
      
      • WebSphere Commerce DeveloperComplete one of the following commands, depending on your 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
          
      WebSphere Commerce DeveloperNote:

      Ensure that your 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 that is 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 needed only 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 options:
      DB2
      if you are using DB2 database with a local database (that is, IBM Gift Center for WebSphere Commerce and the database are on the same system).
      Oracle
      If you are using Oracle with a local database (that is, IBM Gift Center for WebSphere Commerce and the database are on the same system).
      DBRemote
      if you are using DB2 database or Oracle with a remote database (that is, IBM Gift Center for WebSphere Commerce and the database are on different systems).
      database_user_name
      Your database user name, used when you are connecting to this database.

      Depending on memory and speed of your processor, the enablement script might take several minutes to over an hour complete. Once complete, a status message displays to indicate that the script was enabled successfully.

  6. Stop and restart your WebSphere Commerce instance.

    WebSphere Commerce DeveloperStop and restart your WebSphere Commerce test server instance.

  7. Verify that the IBM Gift Center for WebSphere Commerce enablement script ran successfully by ensuring that the gc.enabled.component file is in the following directory:
    • WC_installdir/instances/instance_name/properties/version/gc.enabled.component
    • WebSphere Commerce DeveloperWC_eardir/properties/version/gc.enabled.component
    Note:
    • If you encounter errors when you are enabling IBM Gift Center for WebSphere Commerce, refer to Troubleshooting: Errors when enabling IBM Gift Center
    • To view the Gift Center installation log file, open WC_installdir/instances/instance_name/logs/giftCenter_creationtime.log

      where creationtime is the approximate time stamp of when you installed Gift Center.