Launch Machine
Learn how to set up a machine to deploy a new OMS instance.
Last updated
Learn how to set up a machine to deploy a new OMS instance.
Last updated
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.
Go to
Login with your credentials and proceed to deploy a new instance under oms-env-setup segment.
Select oms-prod-launch-deploy from the preset options.
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.
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
Select the timezone where the client’s business is headquartered.
Refer this table to know which timezone to be selected:
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.
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.
Go to Build History
Click on the instance which is generally latest record to open the latest record.
Click to Console output to open the output.
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.
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.