How-To Guides
Litmus Edge Manager User UI Gu...

Deploy an Application to Edge Devices

8min

You can deploy an application to one or more edge devices.

After selecting Launch App for an application, see the information below on deploying the application.

Before You Begin

  • Connect a repository. See Add new repository in Registry Management.
  • Create a marketplace catalog for your application and then add the application. See Add Catalog and Add or Import an application in Marketplace: Catalogs and Applications.
  • Submit the application release you want to deploy. See Submit Release in Manage Application Releases.
  • Ensure each of Litmus Edge devices have enough disk space to receive the Docker application release’s associated Docker image(s).

Step 1: Select at least one online device

Deploy an Application Step 1 : Select at least one online device
Deploy an Application Step 1 : Select at least one online device


[1] Filter by Groups

[2] Select all displayed edge devices

[3] Select edge device

[4] View Data | Control status

To select one or more edge devices:

  1. (Optional) From Edge Devices tab, select one or more groups.
  2. Select one or more edge devices.
  3. Click Next.

Step 2: Application Settings

Deploy an Application Step 2 : Select application settings
Deploy an Application Step 2 : Select application settings


[1] Change Application Name

[2] Change Application Release

[3] Set Application Parameters: Unique set of parameters for each Application. See Set Up Variables for an Application Release for details on how set up the parameters for each application. The parameters will be applied to the application’s respective Docker image. When the Litmus Edge receives this application and its respective Docker image, these parameters will be passed as runtime variables to this application’s respective Docker container.

To configure application settings:

  1. From Apps Settings tab, select a submitted release from the Application Release drop-down list.
  2. (Optional) Make changes to other parameters, then click Next. Update options depend on the application selected.

Step 3: Preview

Deploy an Application Step 3 : Preview
Deploy an Application Step 3 : Preview


[1] Review Device(s) names

[2] Review Application Name and Release

[3] Review Parameter Settings

To preview application deployment configurations:

  • From the Preview tab, review your selections, and then click Launch.

Step 4: Result

Deploy an Application Step 4 : Result
Deploy an Application Step 4 : Result


[1] View Edge Device Details: Apps

[2] View Message

To finalize application deployment:

  1. From the Result tab, wait for values under the Message column to confirm successful deployment(s).
  2. Click App Details.

The selected edge devices appear in the Edge Device list on the selected Application Details pane. The initial App Status for the deployed devices should be PULLINGIMAGESTARTED. Wait for the Docker image pull operation to complete or fail. A new App Status will be shown.

Step 5: Verify Deployed Application is Running

To verify the deployed application is running:

  1. From the Application Details pane, click the edge device ID link.
  2. The selected application is displayed as running on the Apps tab in Edge Device Details. See Apps.

If the App Status displays as a LAUNCHERROR. It indicates that the Docker image pull operation failed. Ensure that the Application’s respective Docker image registry location is a valid one (See Set Up Docker Container Configurations for an Application Release) or your Litmus Edge instances can connect and access the registry location.

Step 6: Verify the Application on the Edge Device

For the edge device, check its Containers section to verify the respective application container is running for the application.