Audience
Technical Teams
Topic Details
If a Partner or Brand wishes to use Windows Command Prompt to run the Omnivore Agent installer package to Install the Omnivore and POS Agent software, we've created this guide to assist.
Quick Guide
Using the Windows Command Prompt to run the Omnivore Agent installer package can save time as well as enable additional custom options with the installer. To run the installer package via the Command Prompt, you'll need the path for the file, and you'll use that path and replace the <PATH> in the command listed below.
msiexec /i <PATH>
.\Omnivore.msi
Additional Commands
In addition to just running the Agent Installer package via Windows Command Prompt, this method can used to direct the Installer Package to perform additional tasks like installing a specific Agent version, activating the Agent for a specific Location ID, and skipping validation with Omnivore's Servers. These all have specific use cases, so please see below for more details.
Running the Agent Installer to Install a Specific Agent Version
The initial command used above will install the Omnivore Agent with the version that was the public release at the time of download. However in certain circumstances an Agent version above or below that release may be required for a Brand and their locations. The Command Prompt method can be used to install a specific version by adding AGENTVERSION="<AGENT VERSION>" to the initial command. For example, to run the Omnivore Agent installer for Agent version 24.1.30, the command should look like the one below.
msiexec /i <PATH> AGENTVERSION="24.1.30"
.\Omnivore.msi AGENTVERSION=25.5.15
***Be careful copying and pasting as different OS can change the formatting***
Running the Agent Installer and Activating a Specific Location ID with an Activation Code
In certain circumstances, like for bulk installation and activation of the Omnivore Agent for a Brand's rollout, the Command Prompt method can be used to activate the Omnivore Agent using a specific Activation Code to save time by adding /KEY=<ACTIVATION CODE> to the initial command.
For example, if our Activation Code was c8f841ac0afa4d17ad4bb913746476a5, the command should look like the one below.
msiexec /i <PATH> /KEY=c8f841ac0afa4d17ad4bb913746476a5
.\Omnivore.msi ACTIVATE="activation_code"
Running the Agent Installer to Skip Validating with Omnivore Servers
In certain circumstances, like for bulk installation and activation where networking on hardware may not be immediately available, the Command Prompt method can be used to activate the Omnivore Agent without validating with Omnivore's servers by adding /SKIPNETTEST to the initial command. Please note this command requires the Agent is also be activated using the /KEY command. Using the same Activation Code from the previous example, the command should look like the one below.
msiexec /i <PATH> /SKIPNETTEST /KEY=c8f841ac0afa4d17ad4bb913746476a5
.\Omnivore.msi SKIPNETTEST ACTIVATE="activation_code"