Version 0.9.2
Date: April 2022

# 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 (opens new window).

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-0.9.2.sh

or

curl -O https://download.layline.io/releases/layline-linux-arm-0.9.2.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:

    Hit next until you see:

    Installer port configuration (Quickstart)

    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:


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

      Accept the defaults or change according to your environment.

      root@b8a9e28ce031:/layline# ./layline-linux-amd64-0.7.4.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 Akka 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 0.7.4 ...
      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

        # Start the Reactive Engine

          # 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: https://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:

          Log in to Configuration Server (Quickstart)

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

          Logged in to Configuration Server (Quickstart)

          # 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:
          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.

          Last Updated: 5/6/2022, 11:12:16 AM