

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:
- Switch to the following directory:
WAS_installdir/profiles/WC_instance_name/properties
WAS_userdir/profiles/WC_instance_name/properties
WCDE_installdir\wasprofile\properties
- 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
- Save the soap.client.props file.
- Stop and restart your WebSphere Commerce instance.
Stop and restart your WebSphere Commerce test server instance.
- Switch to the following directory:
-
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:
- Switch to the following directory:
WC_installdir/bin
WCDE_installdir/components/GiftCenter/bin
- 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
- A local DB2 database:
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.
- Switch to the following directory:
-
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.