Skip to main content

Full local installation

Download​

Make sure you have downloaded layline.io for your respective operating system. You can check and download the latest version from our main website here.

Linux

On linux, or MacOS you can also download via curl:

Depending on your CPU architecture:

curl -O https://download.layline.io/releases/layline-linux-amd64-<currentVersion>.sh

or

curl -O https://download.layline.io/releases/layline-linux-arm-<currentVersion>.sh

You can check recent changes in our Release Notes.

Installation​

Let's go ahead and run the installation now.

Windows / MacOS​

Run the installer:

Run:

Windows
layline-windows-amd64-<currentVersion>.exe

Hit next until you see:

676af8dc.png

These are standard communication ports required by layline.io. If they don't collide with anything you are already running, then just leave the defaults.

The installation should finish without issues.

Linux​

Prerequisite

You must have libfreetype6 installed. If it is not installed you need to so prior to running the installer, or else it will fail with an error:

Debian
apt-get install -y libfreetype6
CentOS
yum install freetype

Next, pick and run the installer for your target processor architecture:

AMD
chmod +x layline-linux-amd64-<currentVersion>.sh
./layline-linux-amd64-<currentVersion>.sh

Accept the defaults or change according to your environment (example for AMD).
root@b8a9e28ce031:/layline# ./layline-linux-amd64-1.0.2.sh
Unpacking JRE ...
Starting Installer ...
This will install layline.io on your computer.
OK [o, Enter], Cancel [c]

Click Next to continue, or Cancel to exit Setup.
Select the folder where you would like layline.io to be installed, then
click Next.
Where should layline.io be installed?
[/usr/local/layline]

Choose the listening ports for the layline components
Config Server REST Port
[5841]

Reactive Engine REST Port
[5842]

Reactive Engine Streams Port
[5843]

Create symlinks?
Yes [y, Enter], No [n]

Select the folder where you would like layline.io to create symlinks, then click Next.
[/usr/local/bin]

Extracting files ...
Setup has finished installing layline.io on your computer.

Uninstall​

If you want to uninstall layline.io, you can run the respective uninstallers on Windows or MacOS.

On Linux there is an uninstaller in your installation directory:

root@b8a9e28ce031:/usr/local/layline# ./uninstall
Are you sure you want to completely remove layline.io and all of its components?
Yes [y, Enter], No [n]

Uninstalling layline.io 1.0.2 ...
layline.io was successfully removed from your computer.
Finishing uninstallation ...
caution

Project data will not be uninstalled In case you have created some Projects with layline.io, these will remain and must be deleted manually.

Understand moving parts​

Let's first understand what needs to run at a minimum. layline.io consists of three major elements:

Configuration Server​

A process which

  • Serves the Web-based Configuration Center
  • Handles some configuration support services
  • Manages the Project storage

Configuration Center​

A web-based UI which is used for

  • the configuration of layline.io Projects
  • the deployment of Projects to a Reactive Engine / Reactive Engine Cluster
  • the monitoring of one or more Reactive Engine Clusters

Reactive Engine​

A process which

  • executes a Project and Project Workflows
  • is spawned 1..n times on 1..n nodes.

Starting everything​

Starting the Config Server​

Option 1: Start from Start Menu

  1. Open the Start Menu and locate Layline
  2. Invoke Config Server

7e15eaf4.png

  1. The Configuration Server is started:

d96293eb.png

Option 2: Start from command line

  1. Open a command windows and go to the bin folder in the installation directory.
    C:\Program Files\Layline.io\layline>cd bin

  2. Start the Configuration Server from the command window:

C:\Program Files\Layline.io\layline\bin>config-server.exe

09:35:21.916 INFO  ConfigServer                         - [LAY-00050] ###################################################################
09:35:21.916 INFO  ConfigServer                         - [LAY-00050] #        Layline Config Server 1.0.2 (2022-...)                   #
09:35:21.916 INFO  ConfigServer                         - [LAY-00050] #                                                                 #
09:35:21.916 INFO  ConfigServer                         - [LAY-00050] #  Copyright (C) 2018-2021  layline.io GmbH <https://layline.io>  #
09:35:21.916 INFO  ConfigServer                         - [LAY-00050] ###################################################################
09:35:26.291 INFO  ConfigServer.Plugins                 - [LAY-10014] successfully registered plugin 'processor_mapping' ('io.layline.config.plugin.processor.mapping.PluginFactory')
09:35:26.322 INFO  ConfigServer                         - [LAY-10016] starting the configuration server root actor
09:35:26.322 INFO  ConfigServer.Plugins                 - [LAY-10014] successfully registered plugin 'format_generic' ('io.layline.config.plugin.format.generic.PluginFactory')
09:35:26.385 INFO  ConfigServer.Plugins                 - [LAY-10014] successfully registered plugin 's3' ('io.layline.config.plugin.common.s3.PluginFactory')
09:35:27.025 INFO  ConfigServer.RestServer              - [LAY-00360] rest server is listening on address '127.0.0.1', port 5841
09:35:27.025 INFO  ConfigServer                         - [LAY-10018] layline configuration server is up and running ...

Start the Reactive Engine​

Option 1: Start from Start Menu

  1. Open the Start Menu and locate Layline
  2. Invoke Reactive Engine

fba01fba.png

  1. The Configuration Server is started:

92443cb5.png

Option 2: Start from command line

  1. Open a command windows and go to the bin folder in the installation directory.

C:\Program Files\Layline.io\layline>cd bin

  1. Start the Reactive Engine from the command window:
C:\Program Files\layline.io\layline\bin>reactive-engine.exe
2021-10-21 10:02:38.964 INFO  Layline                                            - [LAY-00050] ###################################################################
2021-10-21 10:02:38.964 INFO  Layline                                            - [LAY-00050] #       Layline Reactive Engine 1.0.2 (2022-...)                  #
2021-10-21 10:02:38.964 INFO  Layline                                            - [LAY-00050] #                                                                 #
2021-10-21 10:02:38.964 INFO  Layline                                            - [LAY-00050] #  Copyright (C) 2018-2021  layline.io GmbH <https://layline.io>  #
2021-10-21 10:02:38.964 INFO  Layline                                            - [LAY-00050] ###################################################################
2021-10-21 10:02:45.245 INFO  Layline.DeploymentStorage                          - [LAY-11500] deployment storage created
2021-10-21 10:02:45.292 INFO  Layline.ClusterMonitor                             - [LAY-11415] starting the cluster monitor
2021-10-21 10:02:45.448 INFO  Layline                                            - [LAY-11600] starting the activation controller

...

2021-10-21 10:02:46.417 INFO  Layline.StreamMonitor                              - [LAY-11410] recovery of the stream monitor completed
2021-10-21 10:02:46.449 INFO  Layline.SchedulerMaster                            - [LAY-12010] node akka://layline@127.0.0.1:5843 reports the following roles: [dc-default]
2021-10-21 10:02:46.464 INFO  Layline.SchedulerSlave                             - [LAY-12003] successfully registered at master on node akka://layline
2021-10-21 10:02:46.527 INFO  Layline.RestServer                                 - [LAY-00360] rest server is listening on address '0.0.0.0', port 5842
2021-10-21 10:02:46.542 INFO  Layline                                            - [LAY-11008] all system components are up and running
Firewall settings

You may get a firewall warning. Please Allow Access for the Reactive Engine:

8ce8b469.png

Open the Config Center Web UI​

It's time to check if we can start the web-based Configuration Center.

Please note

The Configuration Center is served by the Configuration Server. So make sure that it is up and running.

Open a web browser and enter the url: http://localhost:5841. In case you have installed the Configuration Server on another machine reachable through a different url, then enter the respective url instead of localhost. Should you have changed the port number during installation, you also need to change the port number to what you have set it to.

You should be taken to the login page:

efb40761.png

The default login is admin with password admin. Once logged in, you should see this:

9641e48f.png

Starting issues​

Issues when upgrading from previous version

Should you be upgrading a previously installed version, there is a chance that you may encounter starting issues with the Configuration Server and/or Reactive Engine. The reason being that there are still old configuration elements lingering around. The easiest way to fix the issues would be to follow these steps:

  1. Uninstall layline.io
  2. Locate your layline configuration directory:
C:\Users\<username>\.layline

  1. Delete the above directory (Keep a backup until you know everything runs well post fix)
  2. Reinstall layline.io

The problem should be fixed.

Can't find what you are looking for?

Please note, that the creation of the online documentation is Work-In-Progress. It is constantly being updated. should you have questions or suggestions, please don't hesitate to contact us at support@layline.io .