Installing Gift Center

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

Procedure

Log on to your system as root, and switch to your non-root user, such as wasuser.
For example, su - wasuser.
Modify the SOAP request timeout value:
1. Switch to the following directory:
  - WAS_installdir/profiles/WC_instance_name/properties
  - WAS_userdir/profiles/WC_instance_name/properties
  - WCDE_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.
  Stop and restart your WebSphere Commerce test server instance.
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:
```
WAS_installdir/profiles/default/bin/stopServer.sh server1
```
```
WAS_userdir/profiles/demo/bin/stopServer server1
```
```
WAS_installdir/profiles/default/bin/stopServer.bat server1
```
Stop any test server instance other than the one used for your WebSphere® Commerce test environment.
Stop your WebSphere Commerce test server instance. If you have the server started, the IBM® Gift Center for WebSphere Commerce does not install properly.
From a command prompt, run the IBM Gift Center for WebSphere Commerce enablement script as follows:
1. Switch to the following directory:
  - WC_installdir/bin
  - WCDE_installdir/components/GiftCenter/bin
2. Run the following command:
```
./config_ant.sh -buildfile WC_installdir/components/GiftCenter/xml
/enableGiftCenterForServer.xml -DinstanceName=instance_name 
-DdbUserPassword=database_user_password
```
```
config_ant.bat -buildfile "..\components\GiftCenter\xml\
enableGiftCenterForServer.xml" -DinstanceName=instance_name 
-DdbUserPassword=database_user_password   
```
  - Complete 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
  Note:
  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.
Stop and restart your WebSphere Commerce instance.

Stop and restart your WebSphere Commerce test server instance.
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
- WC_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.