Skip to main content

Install POS

The following describes how to download and install the POS application. Select the applicable platform below:

Once POS is installed, download configuration data to the POS terminals:

Android

To install POS on Android:

  1. From a Web browser, go to Google Play.

  2. In the search field at the top of the screen, search for Genius.

  3. From the list of search results in the Apps section, select Genius.

  4. From the Genius page, select Install.

  5. Once the installation is complete, select Open.

  6. In the provided fields on the Login page, type the email address and password.

    • Type the login credentials that were registered with the Portal.

  7. Select Login.

iOS

To install POS on iOS:

  1. From a Web browser, go to iTunes App Store.

  2. Using the search function, search for Genius.

  3. From the list of search results, select Genius or Genius Shell.

  4. From the Genius page, select Install.

  5. Once the installation is complete, select Open.

  6. In the provided fields on the Login page, type the email address and password.

    • Type the login credentials that were registered with the Portal.

  7. Select Login.

Windows

To install POS on Windows:

  1. Login to Xenial Cloud Portal.

  2. From the upper-right of the Portal, open the 4-Dot Menu.

  3. From the dropdown, select Download Genius.

  4. From the Platform field on the Downloads popup, select Windows.

  5. Select Download Installer.

  6. Please wait for the installer to download.

  7. Open the installer and follow the prompts to complete the installation.

Silent Install

The following describes how to install and configure POS and Kitchen Management without having to interact with the Shell or Data Management.

Windows (Production Only)

To perform a silent install, use the following command-line:

  • Xenial_Shell_Installer.exe /S /company={company_id} /site={site_id} /terminal={kitchen_station_id or terminal_entity_id} /app={pos or xkm} /email={portal email} /password={portal password}

For each parameter in the command-line, provide the applicable value:

Parameter

Description

/S

Indicates the installation type is Silent.

/company

Type the applicable company_id.

/site

Type the applicable site_id.

/terminal

Type the applicable kitchen_station_id or entity_id.

/app

For the POS, type pos.

For Kitchen, type xkm.

/email

Type the email address that is used to access the Portal.

/password

Type the password that is used to access the Portal.

Windows (All Environments)

To perform a silent install:

  1. Create a file named xenial.app.config.json that includes the following object:

    { "company_id": "{company_id}", "site_id": "{site_id}", "terminal_id": "{terminal / station id}", "app": "pos / xkm", "email": "UserEmail@example.com", "password": "UserPassWord", "environment": "qa" }

  2. For each property in the object, provide the applicable value.

    Property

    Description

    company_id

    Type the applicable company_id.

    site_id

    Type the applicable site_id.

    terminal_id

    Type the applicable kitchen_station_id or entity_id.

    app

    For the POS, type pos.

    For Kitchen, type xkm.

    email

    Type the email address that is used to access the Portal.

    password

    Type the password that is used to access the Portal.

    environment

    Type the name of the applicable environment.

  3. Run the Shell installation file and accept the license agreement.

  4. Save the xenial.app.config.json file to the following folder:

    • C:\Users\WindowsUser\AppData\Roaming\Xenial\

  5. From the Shell app, click Finish to complete the installation.

Android

To perform a silent install on an Android device:

  1. Install Shell via MDM tools.

  2. Create a file named xenial.app.config.json that includes the following object:

    { "company_id": "{company_id}", "site_id": "{site_id}", "terminal_id": "{terminal / station id}", "app": "pos / xkm", "email": "UserEmail@example.com", "password": "UserPassWord", "environment": "qa" }

  3. For each property in the object, provide the applicable value.

    Property

    Description

    company_id

    Type the applicable company_id.

    site_id

    Type the applicable site_id.

    terminal_id

    Type the applicable kitchen_station_id or entity_id.

    app

    For the POS, type pos.

    For Kitchen, type xkm.

    email

    Type the email address that is used to access the Portal.

    password

    Type the password that is used to access the Portal.

    environment

    Type the name of the applicable environment.

  4. Shell reads the configuration file from an SDcard (external file system storage). Save the xenial.app.config.json file to the following location:

    • /sdcard/Android/data/com.xenial.shell.app/xenial.app.config.json

  5. Run the application.

Note

When Reset Terminal is initiated from the POS, the silent install configuration file is not used.

Download Data to Terminals

After POS is installed, the company site list opens. To download configuration data to POS terminals at a site:

  1. From the site list, select the applicable site.

  2. From the lower-right of the screen, select Next.

  3. From the terminal list, select the terminal.

  4. From the lower-right of the screen, select Download Configuration Data.

  5. Please wait for the configuration data to download.

  6. Select Done.

Replace a Terminal

To replace an "In Use" terminal:

  1. From the terminal list, select the terminal.

  2. From the popup menu, select Replace.

  3. From the confirmation prompt, select Yes.

Remove a Terminal

To remove a terminal:

  1. From the terminal list, select the terminal.

  2. From the popup menu, select Remove.

  3. From the confirmation prompt, select Yes.