Migrating IBM Websphere Commerce Version 8 assets for the Assets tool

After the reintroduction of the Assets tool in Management Center for HCL Commerce with HCL Commerce version 9.1.8.0, you can migrate your IBM Websphere Commerce Version 8 assets, and ensure that your Assets tool configuration is correct, to continue using the tool in HCL Commerce Version 9.1.

To learn more about the Assets tool in Management Center, see Assets tool.

Before you begin

The Assets tool requires HCL Commerce version 9.1.8.0 or greater. Ensure that you are using this version at minimum for the remainder of these steps.
Ensure that your migrated assets tool configuration is updated or set for use with the Assets tool in HCL Commerce Version 9.1. This is covered earlier in the migration process in the topic Migrating your IBM Websphere Commerce Version 8 configuration files.
Ensure that your existing environments do not have pending scheduled jobs for persisting managed files, and that all managed files are already persisted on the file system.

Procedure

Configure persistent storage for managed files in your new environments.
- For Docker-based deployments, see Creating a Network File System share for the Assets Tool persistent volume.
- For Kubernetes-based deployments, see Setting up persistent storage volumes for a Kubernetes deployment.
Update your deployment configuration to point to the new persistent volume storage.
- For Docker-based deployments:
  This is done automatically for Docker-based deployments. Simply redeploy with a version of HCL Commerce version 9.1.8.0 or greater.
- For Kubernetes-based deployments:
  Update your Persistent volume for the Assets Tool configuration in the HCL Commerce Helm Chart.
Migrate your existing assets from your old environments into your new environments.

Simply copy the files from your old WebSphere Commerce persisted storage into their new persisted storage location created in step #1.
Optional: Redeploy any existing deployments to apply the changes.
At this point you can continue your migration. If you are enabling the Assets tool for a previous migration, you must redeploy your deployment for the Assets tool to function.
- For Docker-based deployments:
  Redeploy HCL Commerce.
- For Kubernetes-based deployments:
  Redeploy the HCL Commerce Helm Chart to apply the changes to your HCL Commerce Version 9.1 deployment.

Results

You have configured persistent storage, and your new HCL Commerce Version 9.1 environments are configured and redeployed to use it for files that are added to the Assets tool within Management Center. Your site also contains all of the same files from your migrated WebSphere Commerce installation.