Installing and enabling WebSphere Commerce RVU Order Line Metrics

Use WebSphere Commerce Order Line Metrics to run reports on your complete order lines for auditing purposes.

Before you begin

Ensure that you ordered the IBM WebSphere Commerce V8.0 RVU Order Line Metrics product. Otherwise, you will not be able to download the eAssembly from Passport Advantage. For more information, contact your IBM Sales representative.
Log in to WebSphere Commerce as the wcsuser.
Start the WebSphere Application Server administrative console.
1. If WebSphere Commerce is managed by the WebSphere Application Server Deployment Manager (DMGR), start the deployment manager and all node agents.
2. Start your cluster.
3. If WebSphere Commerce is not managed by the WebSphere Application Server Deployment Manager (DMGR), start WebSphere Application Server server1.

Procedure

Download WebSphere Commerce Order Line Metrics from HCL License and Delivery portal.

IBM Passport Advantage: WebSphere Commerce Order Line Metrics

Part number Product name

CRY4XML IBM WebSphere Commerce V8.0 RVU Order Line Metrics for Multiplatform Multilingual eAssembly

Note: If you cannot find the part number on Passport Advantage, then you do not have the proper entitlements to download the product. For more information, contact your IBM Sales representative.
Install WebSphere Commerce RVU Order Line Metrics by using the IBM Installation Manager.

The IBM Installation Manager installs and manages packages on your computer.
1. Install the 32-bit IBM Installation Manager.
2. Add the IBM WebSphere Commerce Version 8.0 Order Line repository location to the Installation Manager:
  1. On the Start page of Installation Manager, click File > Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and whether they are connected.
  2. On the Repositories page, click Add Repository.
  3. In the Add Repository dialog box, click Browse. Go to the location of your WebSphere Commerce Order Line directory, select the WebSphere Commerce Version 8.0 RVU Order Line repository, then click OK. The new repository location is listed.
  4. Click Test Connections to ensure that the Repository URL is available.
  5. Click OK to close the repositories page.
3. In the Installation Manager, click Install. The Installation Manager searches its defined repositories for available packages.
4. On the Install Packages page, select WebSphere Commerce Version 8.0 RVU Order Line Version 8.0.0.0. Click Install.
5. On the License page, review and accept the license.
6. On the Install Packages Location page, click Create a new package group. Select the WebSphere Commerce installation path (WC_installdir) as the location where you want to install the product in the Installation Directory field. Click Next.
  Note: If you encounter the following warning message about 64-bit mode support, you can safely ignore the message.
```
The following packages do not support the 64-bit version of Installation Manager that you are using:
WebSphere Commerce V8.0 RVU Order Line Metrics version 8.0.0.0. If you continue, you might have issues with installation and deployment.
```
7. On the Install Packages Features page, click Next.
8. On the Edition page, select the WebSphere Commerce edition that is installed.
9. On the Install Packages Summarypage, click Install.
10. After installation is complete, check the final page to ensure that there are no warnings or errors.
  If there are no warnings or errors, then the installation was successful. Click Finish to exit the installation process. If there are warning or error messages, refer to Troubleshooting: WebSphere Commerce installation issues.
11. Close IBM Installation Manager.
In a text editor, open WC/wc.ear/xml/config/com.ibm.commerce.order/wc-admin-component.xml.

Search for the following XML element:

<_config:configgrouping
name="CreateOrderLineAuditRecordUponSubmission">
   <_config:property name="enabled" value="false"/>
</_config:configgrouping>

Change the enabled value from false to true: <_config:property name="enabled" value="true"/>. Save the file.
Create a temporary folder with the following directory structure tempdir/xml/config/com.ibm.commerce.order.
Copy the wc-admin-component.xml file that you updated, to the directory that you created in 6.
Compress the xml folder from 6.
For example, compress the folder and name the output to partialApp.zip. The resulting path would be tempdir/partialApp.zip.
Run updateEAR to install a partial application update by using the compressed file from 8.
- 1. Go to the following directory: WC_installdir/bin
  2. Run the following command: config_ant.sh -DinstanceName=instance_name -DupdateType=partialapp -DpartialApp=parialAppLocation UpdateEAR
- 1. Go to the following directory: WC_installdir\bin
  2. Run the following command: config_ant.bat -DinstanceName=instance_name -DupdateType=partialapp -DpartialApp=parialAppLocation UpdateEAR
parialAppLocation is the full path to the compressed folder. For example, tempdir/partialApp.zip.
Note: Ensure that you use / (forward slash) when you provide the full path to the compressed folder.