All pages
Powered by GitBook
1 of 1

Loading...

Update OMS Version

Discover the importance of updating your OMS for enhanced security, performance, and efficiency, including crucial security enhancements, improved performance, and bug fixes.

Updating OMS is vital for security, performance, and efficiency. The latest versions often include essential security enhancements, safeguarding your business and customer data. Performance improvements lead to smoother operations, faster order processing, and enhanced user experience. Regular updates also address bugs, preventing disruptions in your order management process. In essence, OMS updates are a simple yet crucial step in maintaining the integrity and effectiveness of your business processes.

You know about OMS versions you can refer to OMS Release Version { % endhint %}

How to update OMS to the latest release version?

Please check the current release version of your Order Management System (OMS) before you initiate any updates. This practice helps anticipate potential challenges, especially when transitioning from a significantly older version to a new one. Such updates may require manual data input and adherence to specific SQL processes. Failing to follow the correct procedures during the OMS update could lead to version management conflicts.

To check your OMS current release version, follow these steps:

  1. Go to your OMS instance: https://{instanceName}.hotwax.io

  2. Open the Hamburger menu and scroll to the bottom of the page.

  3. Click on the 'Powered by HotWax Commerce' icon to access the Dashboard.

  4. In the Dashboard, you'll find a table displaying the current release versions for oms and omssetup

Name
Branch

The oms version reflects your current OMS version. Compare it with the version you intend to deploy for accurate version management. This step ensures a seamless and informed update process.

Updating from a Recent Version to a New Version:

  1. Log into Jenkins:

    • Link:

    • Use your credentials for authentication.

  2. Navigate to oms-env-setup

Information
Input
  1. Initiate Build:

    • Click on the "Build" button to execute the update process.

  2. Verify your Machine:

    • Wait until the processing is finished, and the box in the stage view turns green.

Certainly! Here's the information in a structured Markdown code snippet:

Updating from an Older Version to a New Version:

1-9. Follow the Steps for Updating from a Recent Version to a New Version:

  • Log into Jenkins.

  • Navigate to oms-env-setup.

  • Access oms-update on the OMS update page.

  • Initiate build with parameters.

Information
Input
  • Initiate the build.

  • Verify your machine.

  • Check deployment in build history and ensure the system is online.

10. Update Data:

Neglecting to update the upgrade steps and SQL may lead to version management conflicts. Therefore, it is essential to meticulously update both the upgrade steps and SQL to align with the new version.

  • Go to .

  • Refer to for the chosen release version and upgrade steps.

  • Copy the data from the document.

  • In web tools, go to Import/Export > XML data import > Complete XML document.

11. Repeat the Update Process:

  • Continue the process iteratively until the OMS is on the latest version.

Updating UAT Instances: A Step-by-Step Guide

Always verify the Docker instance configuration with the development team before deployment. { % endhint %}

Overview Process for updating UAT instances on the Jenkins platform, providing clear instructions for different deployment scenarios.

Prerequisites

  • Access to Jenkins: [link to Jenkins.hotwax.co]

  • Necessary permissions to deploy to the target UAT instance

Deployment Scenarios

New Release Tag

  • Access Jenkins and locate the desired UAT instance.

  • Navigate to the deployment page and select "Build with parameters".

  • Input the release tag (e.g., v5.14.0) in the "Docker branch" field.

  • Specify required plugins in the "Plugins" field (format: plugin_name=develop=https://git_url).

Development Branch

  • Follow the same steps as for a new release tag, but input "Main" as the Docker branch and select "Dev" as the Docker instance.

Feature Tag

  • Follow the same steps as for a new release tag, but input the feature tag (e.g., v5.15.0-86cw63t1f-beta) as the Docker branch and select "UAT" as the Docker instance.

By following these steps and considering the outlined best practices, you can effectively update UAT instances to support various development and testing needs.

:
:
  • Click on the oms-env-setup option from the available segments.

  • Access oms-update on the OMS update page:

    • Locate and click on the oms-update section.

  • Initiate Build with Parameters:

    • Select "Build with parameters" from the side menu.

  • Complete the Form:

  • Solr Version

    Latest version

    Plugins

    Any additional plugins to be added to the instance.

    In the stage view, red box colors indicate an error. Report any errors to the system admin team.

  • Check Deployment in Build History:

    • Go to the "Build History" screen.

    • Click on the instance, generally the latest record, to open the latest record.

    • Click on "Console Output" to open the output.

    • Verify the presence of a "Finished: Success" message at the bottom.

  • Verify System Online:

    • Check your instance; it should be online and working.

    • If not, refresh your window. If a login screen appears, your system is now online.

    • Open the Hamburger menu and scroll to the bottom of the page.

    • Click on the 'Powered by HotWax Commerce' icon to access the Dashboard.

    • In the Dashboard, find a table displaying the current release versions for oms and omssetup, reflecting the new updated version.

  • Complete the form with the following information:

    Solr Version

    Confirm the ready-to-deploy version from the Admin team.

    Plugins

    Any additional plugins to be added to the instance.

    Enter the data between <entity-engine-xml>{put the data here}</entity-engine-xml> and click Import Text.

  • Return to the document, find Update SQL, click on the links, and open webtools in a new tab.

  • On the Main page, go to ENTITY ENGINE TOOLS > Entity SQL Processor > Select Group as org.apache.ofbiz.

  • Add the SQL Commands as per the document and click Send.

  • Select "UAT" as the "Docker instance" and verify its configuration with the dev team.

  • Trigger the deployment.

  • oms

    currentReleaseVersion

    omssetup

    currentReleaseVersion

    Host

    Instance name for the update.

    Domain

    hotwax.io

    ECR Image

    289432782788.dkr.ecr.us-east-1.amazonaws.com/omscoreimage

    ECR Image Tag

    Select the next release tag.

    Build Command

    ofbiz --load-data readers=ext-upgrade (for updating from recent to latest version), build (for updating from older to latest version)

    Run Copy Image

    NO

    Host

    Instance name for the update.

    Domain

    hotwax.io

    ECR Image

    289432782788.dkr.ecr.us-east-1.amazonaws.com/omscoreimage

    ECR Image Tag

    Select the next release tag.

    Build Command

    'build' (for updating from older to latest version)

    Run Copy Image

    NO

    https://jenkins.hotwax.co/
    webtools
    this document