HCL Commerce Developer

Installing Update Packages for HCL Commerce Developer (interactive method)

You can install HCL Commerce Developer Update Packages by using the IBM Installation Manager that you used to install HCL Commerce Developer. Ensure that you test your environment after installation. Update Packages contain fixes that correct known problems, so updating might prevent you from having to place a service call. Before you update, review the following information.

Before you begin

Important:
  • Ensure that you update both HCL Commerce and HCL Commerce Developer to the same level.
  • If you are upgrading from an HCL Commerce Version 9.0 to a HCL Commerce Version 9.1 release, you must back up and restore any signer certificates on your HCL Commerce development environments that you want to retain within the WebSphere Application Server trusted store.
  • Installing or updating the product to a later version is a processor and memory intensive operation. Your machine can become unresponsive for extended periods of time, during which you may observe applyUpdate.bat consuming large amounts of system resources.
    Note: Allow sufficient time for the install or update process to complete as the applyUpdate.bat progress indicator can remain at 99% for up to two hours on less powerful machines.
  • Stop any Java applications that are running on your machine.
  • Ensure that Rational Application Developer is not running.
  • Disable any Web server that you configured on your machine.
  • Log in to Windows as a user with Administrator privileges.
  • If you do not have the Update Package, download and extract the Update Package that you want to install.
    1. Log in to HCL License and Delivery portal.
    2. Search for the Update Package by part number. For information about available part numbers, see HCL Commerce releases.
      Note: The Update Package can update to the target version from any previous version. For example, if you are on 9.1.0.0 and want to update to 9.1.2.0, you only need to download the 9.1.2.0 Update Package.
    3. Download and extract the package.
  • Back up any customized files.

    Many files are updated. Files that might be changed include the JSP files for starter stores and HCL Commerce Accelerator, files for Management Center, and more. Back up files in case you need to reapply any customizations.

  • Back up your database. The database updates that are included in this update cannot be undone. If you want to undo the database update, you must restore your database from a back up. For more information about how to back up, see BACKUP DATABASE COMMAND.

Procedure

  1. Open Installation Manager.
  2. Add the HCL Commerce Developer Update Package 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. Navigate to the location of your HCL Commerce Developer Update Package directory, select the repository.config file, then click OK.
      The new repository location is listed.
    4. Click Test Connections to ensure that the Repository URL is available.
    5. Optional: If you want to save your current HCL Commerce Developer state as a back up before you install the update, then complete the following steps:
      1. On the Start page of Installation Manager, click File > >Preferences > Files for Rollback.
      2. Select Save files for rollback.
  3. From the Start page, click Update.
    The Installation Manager searches its defined repositories for available packages.
  4. Select the HCL Commerce Developer package and click Next.
    The Update packages wizard detects all of the applicable fixes. Recommended features are automatically selected.
  5. Select the updates that you want to apply and click Next.
    The update is automatically preselected.
  6. Click Next.
  7. Accept the license agreement and click Next.
    The Select the features to install panel is displayed. The feature is automatically selected.
  8. Click Next.
  9. Review the summary information and click Update to install the updates.
  10. Optional: Review the installation history by selecting File > Installation History
  11. Check for any issues in the WCDE_installdir\UpdateDelta\9.1.x.0\applyUpdate.log file.
    • The x values represent the Update Package level.
  12. Merge files as needed.
    If any files were added, updated or removed by the developer since the last installation, and also added, updated or removed by the update, these files are recorded during the process.
    1. Check for any issues in the WCDE_installdir\UpdateDelta\9.1.x.0\backup\merges.log file.
      Note:
      • All files that overlap with changes in the Update Package are backed up to the WCDE_installdir\UpdateDelta\9.1.x.0\backup directory before making any changes to your workspace. However, only the files that require review after installation are recorded in the merges.log.
      • It is possible that some files that are updated might have paths or information that is specific to your environment after installation. In these cases, the replacement file will contain an updated template version of the file, before any variables are replaced. You must manually merge these files, replacing the variables in the updated file with the values from the backup version of the file to ensure that your environment continues to function correctly.
    2. For each pair of files in merges.log, compare the original version with the updated version using a text file comparison tool.
    3. For each file that was described as deleted by the update process, review the original version to determine if it is still needed and make appropriate changes.
    4. If you deleted a compressed archive (ZIP, JAR, WAR) and the update process modifies that archive, the archive is recreated by the update process, but will only contain the changed files in the archive so it will be incomplete. In this case a warning is written to merges.log, recommending to rollback, restore the original archives, and reapply the update. For this reason, it is recommended that you do not delete any compressed archives, even if they are not used.
  13. Update the database to the latest HCL Commerce database schema.
    1. Back up the database.
      You need to back up because if you ever uninstall an update, you need to also restore the database to the earlier version. For more information about how to back up, see BACKUP DATABASE COMMAND.
    2. Run the updatedb utility to update your database.
  14. Configure the development database.
    Use the setdbtype utility to update the configuration of the development environment database.
    For more information, see Changing the development database type by using the setdbtype command.
    Important: This step is required when updating an existing HCL Commerce development environment.
  15. Set the spiuser password.
    Use the setSpiuserPassword utility to set the spiuser password.

    This step is required if you intend to update the spiuser password, or if you use the default spiuser password when updating HCL Commerce Developer from a version prior to 9.1.9.0, to a version that is 9.1.9.0 or greater.

    For more information, see Setting the spiuser password in HCL Commerce Developer.

  16. Optional: If you are planning on developing for the Elasticsearch-based search solution, set up your HCL Commerce Developer Search environment.
  17. Rebuild the search index by following these steps.
    Using Apache Solr as your search solution:
    1. Open HCL Commerce Developer in the RAD environment.
    2. Expand WebSphere Applicaton Server Liberty Profile > Servers > searchServer > resources > search > index, and delete managed-solr and solr folders.
    3. Start the Transaction server and Search server, and build the Solr search index.

      For more information about building the Solr index, see Building the HCL Commerce Search index.

    Using Elasticsearch as your search solution (for more information, see Setting up the HCL Commerce Developer Search environment):

    1. Issue the following command from within a REST client.
      POST: https://ingestServerHostname:ingestServerPort/connectors/auth.reindex/run?storeId=11
      Leave the Body empty, and use basic authentication with the username spiuser and the password spiuserPassword.
      Note:
      • The default password for the spiuser user is passw0rd for HCL Commerce 9.1.0.0 through 9.1.8.0, and QxV7uCk6RRiwvPVaa4wdD78jaHi2za8ssjneNMdu3vgqi for HCL Commerce 9.1.9.0 and greater.
      • It is essential to set your own spiuser password to secure your deployment. For more information, see Setting the spiuser password in your Docker images.

      In the example, the storeId is given as 11; replace this with the storeId for your own stores.

      The default values are:
      • AuroraESite: storeId=1
      • AuroraB2BSite: storeId=2
      • Emerald storeId=11
      • Sapphire storeId=12

      OR

      From a command prompt, issue the following command:

      curl --user spiuser:spi_plain_text_password --insecure -X POST "https://ingestServerHostname:ingestServerPort/connectors/auth.reindex/run?storeId=11"
      This call will return a runID value. For example:
      { "runId": "i-26144b4d-cd1c-4679-b2c2-870fc27e6095" }
    2. Wait for the index build to complete, or observe its status using its runID value.
      Issue the following GET REST command to obtain the build status.
      Use the returned value for runID from the previous step.
      GET http://ingestServerHostname:ingestServerPort/connectors/auth.reindex/runs/runId/status

      OR

      From a command prompt, issue the following command:
      curl --user spiuser:spi_plain_text_password --insecure -X GET "http://ingestServerHostname:ingestServerPort/connectors/auth.reindex/runs/runId/status"
      • If your build is in progress, a message similar to the following will provide details of its current status.
        {     "date": "2022-04-06T17:51:44.462",     "runId": "i-26144b4d-cd1c-4679-b2c2-870fc27e6095",     "fromType": "Ingest",     "message": "Indexing running, current progression of indexing is at process group: auth.reindex - WaitLink - Category Stage 1a",     "status": -1,     "progress": "30% (30 out of 101 pipes processed) " }
        Note: Progress percentage is a simple metric based on the number of pipes processed. It does not accurately reflect the progress in terms of time.
      • Once complete, a message similar to the following will detail the result of the completed build.
        "message": "Indexing run finished according to Nifi queue being empty for given connector. {\"start\":\"2022-04-06T17:50:17.821Z\",\"end\":\"2022-04-06T17:53:02.346Z\",\"run\":\"i-26144b4d-cd1c-4679-b2c2-870fc27e6095\",\"severities\":
        
        {\"I\":15,\"W\":2}
        ,\"codes\":{\"DI1002I\":14,\"DI1050W\":2},\"locations\":{\"warning\":
        
        {\"Others\":2}
        ,\"info\":{\"Others\":14,\"Price Stage 2, Copy Contract Prices\":1}},\"elapsed\":{\"absolute\":{\"connector\":164525,\"summary\":{\"Attribute Pipeline\":\"4548\",\"Catalog Pipeline\":\"5155\",\"Category Pipeline\":\"13956\",\"Price Pipeline\":\"2911\",\"Product Pipeline\":\"21389\",\"Store Pipeline\":\"25336\",\"URL 
        You can remove the /status at the end of the REST GET to obtain more detailed logs to review any encountered errors.

What to do next

  1. Verify your search index data.
    • Store data: http://ElasticSearchServerName:30200/auth.store/_search
    • Category data: http://ElasticSearchServerName:30200/auth.storeId.category/_search
    • Product data: http://ElasticSearchServerName:30200/auth.storeId.product/_search
  2. Refresh the workspace and republish the application after the update is completed.
    1. Open HCL Commerce Developer and switch to the Enterprise Explorer view.
    2. In the Explorer view, select all projects and select File > Refresh (or the F5 keyboard shortcut) to refresh the projects in the workspace.
    3. Start or restart the test server
    4. Right-click the test server in the Servers view and select Publish.
    5. Wait for the application to finish publishing and to restart.