Skip to main content
Skip table of contents

LEIP Enterprise

LEIP Enterprise provides a web application to analyze and graph metrics from all your LEIP experiments. For this to happen, you need to deploy the application either on-premise or on the cloud, and connect to it from the LEIP SDK container.

On-premise Server Setup

Prerequisites

We recommend that you have at least 4 GB of RAM available to Docker.

Installation Script

Download the following file to a directory called leip-enterprise on your computer:

run.py

Starting Server

To configure and start the server, run python3 run.py start. This will interactively ask you some details to generate the configuration files: docker-compose.yml and .env. Then it will automatically start the server.

If you also want to include the Kibana service, you may do so by running python3 run.py start --kibana.

Here’s an example run:

CODE
% cd leip-enterprise
% python run.py start
***** Latent AI, Inc.
***** LEIP Enterprise lifecycle script
Docker version 20.10.13, build a224086
Docker Compose version v2.3.3

Do you want to include sample data (50 experiments)?
 (yes/no) [Default: no]: yes

Do you wish to configure the SMTP service for sending emails?
This is used to send account info to all LEIP Enterprise users, but it is optional.
 (yes/no) [Default no]: yes
    SMTP TLS (yes/no) [Default: no]: yes
    SMTP Host: smtp.gmail.com
    SMTP Port: 587
    SMTP User: noreply@example.com
    SMTP Password: smtp-password

[+] Running 4/4
 ⠿ db Pulled                                                                                                             1.5s
 ⠿ elasticsearch Pulled                                                                                                  1.7s
 ⠿ frontend Pulled                                                                                                       2.2s
 ⠿ backend Pulled                                                                                                        2.2s

[+] Running 7/7
 ⠿ Network leip-enterprise_net                Created                                                                    0.0s
 ⠿ Volume "leip-enterprise_app-db-data"       Created                                                                    0.0s
 ⠿ Volume "leip-enterprise_elasticsearch"     Created                                                                    0.0s
 ⠿ Container leip-enterprise-elasticsearch-1  Started                                                                    0.7s
 ⠿ Container leip-enterprise-db-1             Started                                                                    0.6s
 ⠿ Container leip-enterprise-backend-1        Started                                                                    1.0s
 ⠿ Container leip-enterprise-frontend-1       Started                                                                    1.5s

Successfully started LEIP Enterprise Server
You can access it at http://localhost
Username: admin
Password: <password>

LEIP Enterprise will keep running on the background, and will restart automatically if a service ever fails.
You may configure it yourself with 'docker-compose'
DONE.

The script output will include your administrator account details for the LEIP Enterprise UI, and the optional account for the Kibana UI. After about 30 seconds, all services should be ready, and the locally deployed application will be available at http://localhost.

Stopping Server

When you need to stop the services, run:

BASH
python3 run.py stop

Clearing Configuration

If you want to clear the current configuration to start over, run:

BASH
python3 run.py clear

UI Access

You may open the LEIP Enterprise UI at http://localhost and login with your configured administrator account from the output of the run script.

If you accepted the inclusion of sample data, you can visualize those already.

Before you configure your LEIP SDK container to send events to LEIP Enterprise, you may want to add a new user, a project, and permissions between them, so that you can associate events with that user and project. To create them, use the configuration button on the top right and click “Configure users” and/or “Configure projects”.

LEIP SDK Container Setup

To easily connect your LEIP SDK container to LEIP Enterprise, determine the name or hash of your running SDK container (usually leip) and then run this (outside of the container):

CODE
docker network connect leip-enterprise_net leip

And then, switch back to the SDK container and configure LEIP Enterprise by running:

BASH
leip enterprise init 

Here you will set these values:

  • Server host: http://backend:8080.

  • Username: admin (or any user you previously set in LEIP Enterprise UI).

  • Password: the password for admin, indicated in the output of the start command, or the password set by you in the LEIP Enterprise UI.

  • Project: Select a project from the list (if you created one and gave the user permission) or just select <None>.

You may change any of these values at any time using individual commands (See leip enterprise --help for details).

General Usage

After the LEIP Enterprise server is up and a LEIP SDK container is configured, you may run any LEIP commands on the LEIP SDK container as usual and will be able to visualize metrics data on the LEIP Enterprise application.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.