Skip to main content
Version: 1.2.x

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 ...
warning

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

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 .