Solutions

Litmus Edge File Browser

13min

Overview

Document image


Provided capabilities

The Litmus Edge File Browser solution allows litmus edge users to interact with the Litmus Edge core file system to provide additional management capabilities.

This does address some customer requests to have more options such as:

  • be able to manage Litmus flows and its log files more directly
  • be able to manage files in the FTP directory without the need to use an ftp client or enable the ftp server and make it more usable as a customer drive folder
  • Be able to manage the space occupied by Litmus Edge update files

Currently the Litmus Edge File Browser solution provides access to:

  • FTP Data -> through the folder ftp-data
  • Litmus Flows files -> through the folder flows

At this point, Litmus Edge File Browser provides the user with the capability to:

  • create files and folders
  • delete files and folder
  • download files
  • upload files

Further can users:

  • change the password
  • change the language

Requirements

A Litmus Edge Instance exists.

Running the application using the downloaded Tar File

  1. After Checkout, a tar.gz file is expected to be downloaded
  2. Log in to your Litmus Edge, Navigate to Applications -> Images
  3. Click on Upload Image and upload the tar file there
  4. Navigate back to Applications -> Containers and enter the following command there:
docker run -d --restart=unless-stopped -p 41260:8080 --name litmusedge_filebrowser -v /var/lib/customer/ftp-data/:/data/ftp-data -v /var/lib/loopedge-flows-ui/flows/:/data/flows litmus/litmusedge_filebrowser:latest

After running the command, the container will be running.

Document image


The Litmus Edge File Browser is now ready and can be accessed through its WebUI.

Logging into the Litmus Edge File Browser

Open the web browser of your choice and enter into the address bar

<IP of your Litmus Edge>:41260

Example:

192.168.2.10:41260

The Login Page opens.

Document image


The initial Login is:

Username: litmusedge

Password: litmusedgefilebrowser

Note: The user can change the password after the initial login through the Settings.

Document image


(Optional) How to add the Litmus Edge File Browser solution to Litmus Edge Manager Marketplace

Note: This is an optional way to deploy the Litmus Edge File Browser solution on a Litmus Edge.

This deployment requires that a Litmus Edge is connected to a deployed Litmus Edge Manager. The user also should have experience in adding applications to the LEM Marketplace.

The file to be uploaded into the LEM Docker Registry is the tar.gz file litmusedge_filebrowser.tar.gz

After uploading the docker image into the LEM Docker registry and setting up the means for authentication, the next step is to prepare the marketplace import.

Step 1: Download the file Litmus-Edge_File-Browser_Marketplace.json through the Download button with the label (LEM Marketplace Listing of Litmus Edge File Browser), to import the application to LEM Marketplace.

Document image


Step 2: Open the JSON file with a editor such as notpad++.

Step 3: Within the file replace.

<registry-ip>

The IP or URL of the LEM.

<registry-user>

The username setup for docker registry authentication.

<registry-password>

The password setup for docker registry authentication.

Examples for replacing these placeholders using notepad++.

Document image

Document image

Document image


Step 4: Access the LEM User UI via your browser.

Step 5: Access your company and project and select the Features menu. ​

Document image


Step 6: Select the Marketplace option.​​

Document image


Step 7: Select the catalog you want to use.​​

Document image


Step 8: Select the Add or Import an Application icon.​

Document image


Step 9: Import the downloaded json file. ​

Document image


Step 10: The application is now part of the catalog. ​​

Document image


(Optional) How to deploy Litmus Edge File Browser from Litmus Edge Manager Marketplace

Note: This is an optional way to deploy the Litmus Edge File Browser solution on a Litmus Edge.

This deployment requires that a Litmus Edge is connected and that the solution has been added to a LEM Marketplace catalog previously.

It is expected, that users are knowledgeable about how applications and solutions are deployed from LEM.

Deploying Litmus Edge File Browser from LEM has one optional parameters to be provided.

Document image


Parameter

Description

PORT

Used to set the port command -p <PORT>:8080.

By default port 41260 will be used but the User is able to change this to another port.