🥯
Everything
  • Best Practices and Guidelines
    • ChatGPT Prompts
    • Documentation Guideline
    • GitBook Spaces
    • GitHub Guideline
    • Internal Usage
  • Tools
    • End to End Order Flow
      • Order Creation
      • Order Import
      • Order Brokering
      • Order Fulfillment
      • Order Fulfillment Notification
    • Git
      • How to Create Issue on Git
    • Jira
      • Feature Request on Jira
    • Launchpad
      • Fulfillment
        • Stuck Orders in Fulfillment App
      • Job Manager
        • Check Job Frequencies
        • Job Runtime Error
        • Mismatch Time Zone
    • Napita
      • Glossary
      • Schedule Processors
      • View and Manage Processors
      • Flow Definitions
      • Verify Processor Properties
      • Bulletins
      • Data Provenance
      • Troubleshooting
        • Data Export Errors
        • Queue Errors
        • Fetch Put SFTP Retry
    • Netsuite
      • Managing Saved Searches
    • Ofbiz
      • Orders
        • Multicurrency Sales Orders
        • POS Order Refresh Failure
        • Pre-Order Catalog Sync
        • Reindex Order after Solr Down Time
      • Products
        • Product Duplication
      • Inventory
        • Add New Variance Reason
      • Data Manager Configuration
        • Create a Job Using Data Manager Configuration
        • SFTP Issue
    • Shopify
      • How to Access Shopify POS APP
      • How to Create Draft Order in Shopify
    • Tathya
      • Database Configuration
        • Additional Settings
      • Charts Creation
        • Selecting Database & Schema
        • View & Save Chart
        • Charts Access
        • Create Multiple Charts
        • LogInsight Charts
      • Understanding Dashboards
        • Configuring Dashboards
        • Dashboards Access
        • Dashboard Options
        • Dashboard Customizations
        • Link Configuration
        • Set Multi-Day Filters
      • Configuring Alerts & Reports
        • Creating Alerts
        • Creating Reports
        • Alternate Interfaces to Schedule Reports
      • Creating Roles
        • List & Modify Roles
      • Creating User
        • Creating LDAP Account
        • Tathya Authentication
        • Listing User in Tathya
        • User Permissions
      • Troubleshoting
        • Reporting Discrepancies
        • Tathya login Issue
      • How to
        • How to Create User on Tathya
        • How to Create Alpha Role on Tathya
        • How to Request for the Report
  • Client Communication
    • Templated Replies
    • Ticket and Release Mangemnet
  • Monitoring
    • Sanity Checklist
    • System Monitoring Guide
  • Hotwax Deployment & Versions
    • HotWax Commerce Deployment
    • Launch Machine
    • Update OMS Version
    • Rollback OMS Version
    • Optional Plugins
Powered by GitBook
On this page
  • Configure your machine
  • Verify your machine
  • Initial Setup
Edit on GitHub
Export as PDF
  1. Hotwax Deployment & Versions

Launch Machine

Learn how to set up a machine to deploy a new OMS instance.

PreviousHotWax Commerce DeploymentNextUpdate OMS Version

Last updated 3 months ago

To deploy a new OMS instance you first have to setup a machine. These are deployed using Jenkins.

UAT environments are usually deployed internally so they may have different steps, connect with the System Admin team for that.

  1. Go to

  2. Login with your credentials and proceed to deploy a new instance under oms-env-setup segment.

  3. Select oms-prod-launch-deploy from the preset options.

In case, you are setting a test production environment, use oms-launch-deploy. Test production accounts are basically replica of production accounts, helping test real challenges faced during production spin up.

Configure your machine

Click on Build with Parameters from the left menu options and enter required details:

1. Enter a HOST name

The host name is should be the client name followed by uat or oms depending on what kind of environment you're setting up. Replace xxx-oms with instance name.

For example, if a company were named Wasatch Ski Company, the instance name could be wasatchski-oms and wasatchski-uat.

The name or abbreviation of the company has to be unique.

Multi-instance names contain an additional identifier between the name and instance type.

For example, wasatchski-us-oms and wasatchski-ca-oms will be seperate instances for each country

Domain name is prefilled as hotwax.io. Do not change this.


2. Select version


3. Choosing a machine type

The machine size should be confirmed by internal administration team.

Select the machine size from the EC2_INSTANCETYPE dropdown. Based on the business order size/day we can select the Instance type.

  • C5a.xlarge: Less than or equal to 100 orders orders per day.

  • C5a.2xlarge: More than 100 orders orders per day.


4. Timezone

The default AWS region is us-east-1. Do not change this without explicit confirmation.

Select the timezone where the client’s business is headquartered.

If the preferable timezone is not present in the dropdown, ask the system admin team to create it.

Refer this table to know which timezone to be selected:

Client Time Zone
Offset
Daylight Saving Time
Proximate Locations

AEST (Australia Eastern)

UTC+10

No

Brisbane, Sydney

ACST (Australia Central)

UTC+09:30

No

Adelaide, Darwin

AFT (Afghanistan)

UTC+04:30

No

Afghanistan

AKST (Alaska Standard)

UTC-09

Yes (ADKT)

Alaska

AST (Atlantic Standard)

UTC-04

Yes (ADT)

Antigua and Barbuda, Barbados, US Virgin Islands

CAT (Central Africa)

UTC+02

No

Botswana, Malawi, Namibia, Rwanda, Sudan

CET (Central European)

UTC+01

Yes (CEST)

Albania, Algeria, Austria, Belgium, Denmark

CST (Central Standard)

UTC-06

Yes (CDT)

Houston, Mexico City, Winnipeg

EAT (East Africa)

UTC+03

No

Ethiopia, Kenya, Madagascar, Somalia

EET (Eastern European)

UTC+02

Yes (EEST)

Bulgaria, Finland, Greece, Lithuania

EST (Eastern Standard)

UTC-05

Yes (EDT)

New York, Toronto, Atlanta

MSK (Moscow Standard)

UTC+03

Yes (MSD)

Russia (parts), Belarus, Ukraine

MST (Mountain Standard)

UTC-07

Yes (MDT)

Denver, Phoenix, Calgary

PST (Pacific Standard)

UTC-08

Yes (PDT)

Vancouver, Los Angeles, Las Vegas

WAT (West Africa)

UTC+01

No

Angola, Chad, Morocco, Nigeria

WET (Western European)

UTC+00

Yes (WEST)

United Kingdom, Ireland, Portugal


5. Build_Command

Default value loadOmsDefaultData should not be changed.


6. OFBIZ_INSTANCE_PREFIX

Default value HotWax should not be changed.


7. Plugins

You're now prepared to build your machine; simply click the build function.

It can take up to 15 minutes for an instance to become active after deployment. Until the instance comes online, the following message will show:

The site can’t be reached

If it takes longer than 25 minutes for your instance to come online, alert the system admin team.


Verify your machine

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

In the stage view, red box colors indicate an error. If this happens please report the error to the system admin team.

To check your deployment in the Build History screen.

  1. Go to Build History

  2. Click on the instance which is generally latest record to open the latest record.

  3. Click to Console output to open the output.

  4. Go to the bottom of the output and verify that you see a Finished: Success message.

Go to your instance, it should be online and working. If not, refresh your window and a login screen appears, your system is now online.


Initial Setup

The ECR_IMAGE value selects the version of the OMS to deploy the system onto. To determine the current version/tag of the image for deployment, please consult the and locate the ECR_IMAGE value. If there's a need to deploy the system using a different ECR_IMAGE version, kindly use the specified image version accordingly.

External system integrations are referred to as plugins. If your instance incorporates integrations with external systems, include those plugins here. To identify the current versions of the plugins for deployment, please refer to the and locate the relevant plugin information.

Jenkins
OMS 1.0 Releases documentation
OMS 1.0 Releases documentation