Install IBM Workplace Web Content Management integration for WebSphere Commerce on the Web Content Management system
Before you can complete the tasks outlined in this topic, ensure that you have copied the IWWCMAssets.zip file to your IBM Workplace Web Content Management system.
To install IBM Workplace Web Content Management integration for WebSphere Commerce on the Web Content Management system:
- Extract the IWWCMAssets.zip file from the ZIP file you downloaded to obtain IBM Workplace Web Content Management integration for WebSphere Commerce. Copy the IWWCMAssets.zip file to a temporary directory on your Web Content Management system.
- Extract the contents of the IWWCMAssets.zip file to a temporary location.
- Update the WCIWWCMIntegration.properties file with values for your
system. The file is located in the following location in the WCSIWWCM.war
file:
WEB-INF/classes/com/ibm/wcsiwwcm/WCIWWCMIntegration.properties
To update the file:
- Open the WCIWWCMIntegration.properties file in a text editor.
- Uncomment the following line in the file:
#AUTH_SERVLET_PATH=/[CONTEXT_ROOT]/AssociateAuthoringTemplates
- Replace [CONTEXT_ROOT] with the context root you want to use. Record the context root, you will need this value when you install the standalone WAR. For example, AUTH_SERVLET_PATH=/iwwcmassets/AssociateAuthoringTemplates.
- Update the USER_ID and PASSWORD values with the Web Content Management user ID and password used to manage WebSphere Commerce content in Web Content Management.
- Uncomment the following lines in the file:
#WEB_APP_URL=http://[HOST]:[PORT]/wps/wcm/connect
#LOGIN_URL=http://[HOST]:[PORT]/wps/wcm/login
Replace [HOST] with the fully-qualified host name of your Web Content Management system. Replace [PORT] with the port used to access Web Content Management.
In the following line, provide the
Web content library name that will be used for containing WebSphere Commerce
content.
LIBRARY_NAME=Web Content
You may leave the line unchanged if you are using the default library Web Content. If you want to use a Web content library other than the default one and have not yet created a new library, you can provide the new library name that you plan to use and create a new library with the same name later, when you follow the instructions provided in Preparing IBM Workplace Web Content Management to create WebSphere Commerce content. - Save your changes and exit the text editor. Ensure that the
updated file replaces the version of the file in the WCSIWWCM.war file.
- Install the WCSIWWCM.war standalone WAR file into your WebSphere Portal application server.
To install the standalone WAR file, follow the instructions provided in the
Installing a new application Installing application files with the console topic
in the WAS Information Center.
You will require the following information when installing the WAR file:
- Context root
- iwwcmassets (Recommended context root. Ensure that this value matches that specified for the [CONTEXT_ROOT] value set in the properties file.)
- Virtual host
- default_host
- Application name
- WCSIWWCM_war
Also, ensure that you:
- Map the wcswccm Web module to the default_host virtual host. See step
10 in Installing a new application topic Installing application files with the console in
the WAS Information Center for
instructions.
- Map the wcswccm Web module to the WebSphere Portal application server.
See step 11 in Installing a new application topic Installing application files with the console in
the WAS Information Center for
instructions.
Unless specified, accept the default values provided by WAS.
- Enable prerendering for your WebSphere Commerce site in Web Content
Management:
- On your WebSphere Commerce system, create a folder in which to put the prerendered content. Share the folder and provide write access to the folder.
- On your Web Content Management system, map to the folder on the WebSphere Commerce system
- Enable prerendering for your WebSphere Commerce site in Web
Content Management. For more information about pre-rendering in Web Content
Management, refer to the Pre-rendered sites Pre-rendered sites topic in the WebSphere Portal Information Center.
When enabling prerendering, ensure the value element of the <DestDir> tag
is set to the shared drive, while the value element of the <TempDir> tag
is set to a subdirectory of the share drive. For example, if F: is the mapping
to the shared drive on the WebSphere Commerce system, set the tags as follows:
<DestDir value="F:\" /> <TempDir value="F:\temp\" />
If you have not created a new site and site area to contain WebSphere Commerce content, you cannot update the <Sites> tag at this point. You can update this tag later, when you follow the instructions provided in Prepare IBM Workplace Web Content Management to create WebSphere Commerce content.
When enabling prerendering, ensure
the value element of the DestDir property is
set to the shared drive, while the value element of the TempDir property
is set to a subdirectory of the share drive. For example, if F: is the mapping
to the shared drive on the WebSphere Commerce system, set the tags as follows:
DestDir=F:\ TempDir=F:\temp\
If you have not created a new site and site area and Web content library to contain WebSphere Commerce content, you cannot update the Sites property at this point. You can update this property later, when you follow the instructions provided in Prepare IBM Workplace Web Content Management to create WebSphere Commerce content.
- Restart WebSphere Portal.
For instruction on stopping and starting WebSphere Portal, see the
Starting and stopping WAS and WebSphere Portal Starting and stopping WAS and WebSphere Portal topic in the WebSphere Portal Information Center.
Once you have completed these steps, you can continue with Install IBM Workplace Web Content Management integration for WebSphere Commerce on the WebSphere Commerce system.
Related Concepts
IBM Workplace Web Content Management integration for WebSphere Commerce
Related tasks
Overview: Integrating WebSphere Commerce and IBM Workplace Web Content Management