¶¶Òõ

Skip to main content

Install ¶¶ÒõCloud POS

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

Once ¶¶ÒõCloud POS is installed, download configuration data to the POS terminals at the company sites.

Android

To install ¶¶ÒõCloud POS on Android:

  1. From a Web browser, go to .

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

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

  4. From the Xenial 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 ¶¶ÒõCloud Portal.

  7. Select Login.

iOS

To install ¶¶ÒõCloud POS on iOS:

  1. From a Web browser, go to .

  2. Using the search function, search for Xenial.

  3. From the list of search results, select Xenial or ¶¶ÒõShell.

  4. From the Xenial 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 ¶¶ÒõCloud Portal.

  7. Select Login.

Windows

To install ¶¶ÒõCloud POS on Windows:

  1. Login to ¶¶ÒõCloud Portal.

  2. In the upper-right of the ¶¶ÒõCloud Portal, open the 4-Dot Menu.

  3. From the dropdown, select Download Xenial.

  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 ¶¶ÒõOrdering (POS) and ¶¶ÒõKitchen Management (XKM) and configure the application settings programmatically without having to interact with the ¶¶ÒõShell or Data Management UI.

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 Ordering application, type pos.

For the XKM application, 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 Ordering application, type pos.

    For the XKM application, 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 Ordering application, type pos.

    For the XKM application, 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.

Nota

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

Download Data to Terminals

After ¶¶ÒõCloud 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. From the Ready to Use Xenial screen, 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.