Download/Install

The Flexter download process.

Repository Setup

There are two repositories available for Redhat and Debian-based Linux operating systems

YUM/DNF Repository

Yum has been the main package installation tool for Redhat-based Linux distributions. It has been recently replaced by dnf. However, both dnf and yum are mutually compatible.

  • Red Hat Enterprise Linux (RHEL)
  • CentOS Stream
  • Rocky Linux
  • AlmaLinux
  • Fedora
  • Oracle Linux
  • Amazon Linux

Flexter repository configuration should be added under the standard yum location. Please note it will normally require root access to create/edit, e.g.:

$ sudo vi /etc/yum.repos.d/sonra-flexter.repo

Below are the recommended settings to be added. The values for and should be altered accordingly with credentials provided by Sonra.

[sonra-flexter]
name=Sonra Repository
baseurl=https://yum.sonra.io/flexter
username=<USER>
password=<PASS>
gpgkey=https://yum.sonra.io/RPM-GPG-KEY-Sonra
gpgcheck=0
enabled=0
priority=1

The repository is disabled (enabled=0) by default. It helps to avoid unwanted upgrades, e.g., when the server administrator only wants to upgrade the server packages, not necessarily include Flexter itself.

In this case the parameter –repo should always be explicitly used with def or yum commands as in the example below:

Installing the latest version

$ sudo dnf --repo=sonra-flexter install xml2er xsd2er json2er merge2er flexchma flexter-ui

Installing the specific version

$ sudo dnf --repo=sonra-flexter install xml2er-2.4.5 xsd2er-2.4.5 json2er-2.4.5 merge2er-2.4.5 flexchma-2.4.5 flexter-ui-2.4.5

APT Repository

APT has been the main package installation tool for Debian-based Linux distributions. Recently it has been mostly replaced by SNAP in Ubuntu-based distributions.

Example of Debian-Based distributions:

  • Debian
  • Ubuntu
  • Linux Mint
  • MX Linux
  • Kali Linux
  • Raspberry Pi OS
  • Pop!_OS

Please note write access (sudo/root) to the following folders will most likely be required: /etc/apt/sources.list.d/ and /etc/apt/auth.conf.d/.

Please also make sure you have the apt-transport-https, curl and gpg installed:

$ sudo apt update
$ sudo apt install apt-transport-https curl gpg

The first step is to bring the public keys to recognize the repository’s authenticity and avoid warnings from apt. Depending on the exact distribution and version, one of the two commands should work:

$ curl -sL https://apt.sonra.io/DEB-GPG-KEY-Sonra | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/DEB-GPG-KEY-Sonra

Then, the new list file needs to be created, sonra-flexter.list:

$ sudo echo "deb [arch=all signed-by=/etc/apt/trusted.gpg.d/DEB-GPG-KEY-Sonra] https://apt.sonra.io/flexter releases main #Sonra Flexter" > /etc/apt/sources.list.d/sonra-flexter.list

Also, the new authentication auth file, sonra-flexter.conf, with the and values adapted using credentials provided by Sonra:

$ sudo echo "machine apt.sonra.io login <USER> password <PASSWORD>" > /etc/apt/auth.conf.d/sonra-flexter.conf

After updating the indexes and the Flexter packages can be installed:

Installing the latest version

$ sudo apt update
$ sudo apt install xml2er xsd2er json2er merge2er flexchma flexter-ui

Installing the specific version

$ sudo apt update
$ sudo apt install xml2er=2.4.5 xsd2er=2.4.5 json2er=2.4.5 merge2er=2.4.5 flexchma=2.4.5 flexter-ui=2.4.5

APT Repository Enable/Disable (Optional)

The repository is enabled by default. We recommend disabling it after installations to avoid unwanted upgrades, eg. when the server administrator wants to upgrade the server packages, not Flexter itself.

Disable

To disable it, rename the /etc/apt/sources.list.d/sonra-flexter.list and add the .disabled extension:

$ sudo mv /etc/apt/sources.list.d/sonra-flexter.list{,.disabled}

Enable

To re-enable it, rename the /etc/apt/sources.list.d/sonra-flexter.list.disabled and remove the .disabled extension:

$ sudo mv /etc/apt/sources.list.d/sonra-flexter.list{.disabled,}

Manual Download

In cases where the repository hasn’t been set up, the packages can be downloaded directly and installed manually as the procedures below.

Make sure the curl or wget command is available. All examples are based on curl, but you can use wget instead.

# curl approach
$ curl -u "<USER>:<PASS>" -OL <URL>

# wget approach
$ wget --user "<USER>" --password "<PASS>" <URL>

URL pattern:

https://download.sonra.io/flexter/<MODULE>[-VERSION].<EXTENSION>

Examples:

# latest version
$ https://download.sonra.io/flexter/xml2er.rpm

# specific version
$ https://download.sonra.io/flexter/xml2er-2.4.5.rpm

# different package
$ https://download.sonra.io/flexter/xml2er-2.4.5.tgz

Redhat-Based

Example of Redhat-Based distributions:

  • Red Hat Enterprise Linux (RHEL)
  • CentOS Stream
  • Rocky Linux
  • AlmaLinux
  • Fedora
  • Oracle Linux
  • Amazon Linux

Download installers

$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexchma.rpm
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xml2er.rpm
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xsd2er.rpm
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/json2er.rpm
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/merge2er.rpm
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexter-ui.rpm

Checking hash (optional)

Checking if the files were downloaded correctly with the md5 hash algorithm.

$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexchma.rpm.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xml2er.rpm.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xsd2er.rpm.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/json2er.rpm.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/merge2er.rpm.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexter-ui.rpm.md5

# helper function
$ md5ck() { md5sum -c <(echo `cat $1.md5` $1); }

$ md5ck flexchma*.rpm
$ md5ck xml2er*.rpm
$ md5ck xsd2er*.rpm
$ md5ck json2er*.rpm
$ md5ck merge2er*.rpm
$ md5ck flexter-ui*.rpm

Installing the packages

$ sudo dnf install -y xml2er*.rpm xsd2er*.rpm json2er*.rpm merge2er*.rpm flexchma*.rpm flexter-ui*.rpm

Debian-Based

Example of Debian-Based distributions:

  • Debian
  • Ubuntu
  • Linux Mint
  • MX Linux
  • Kali Linux
  • Raspberry Pi OS
  • Pop!_OS

Download installers

$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexchma.deb
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xml2er.deb
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xsd2er.deb
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/json2er.deb
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/merge2er.deb
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexter-ui.deb

Checking hash (optional)

Checking if the files were downloaded correctly with the md5 hash algorithm.

$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexchma.deb.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xml2er.deb.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xsd2er.deb.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/json2er.deb.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/merge2er.deb.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexter-ui.deb.md5

# helper function
$ md5ck() { md5sum -c <(echo `cat $1.md5` $1); }

$ md5ck flexchma*.deb
$ md5ck xml2er*.deb
$ md5ck xsd2er*.deb
$ md5ck json2er*.deb
$ md5ck merge2er*.deb
$ md5ck flexter-ui*.deb

Installing the packages

$ sudo apt install xml2er*.deb xsd2er*.deb json2er*.deb merge2er*.deb flexchma*.deb flexter-ui*.deb

Unix-Based

For the other type of distros, not compatible with Redhat-Based or Debian-Based, the .tgz packages can be downloaded and installed manually:

Examples of other Unix-Based distributions:

  • Mac OS
  • Alpine Linux
  • Arch Linux
  • Gentoo
  • OpenBSD
  • FreeBSD
  • NetBSD
  • Solaris
  • OpenSolaris
  • OpenIndiana

Download installers

$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexchma.tgz
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xml2er.tgz
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xsd2er.tgz
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/json2er.tgz
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/merge2er.tgz
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexter-ui.tgz

Checking hash (optional)

Checking if the files were downloaded correctly with the md5 hash algorithm.

$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexchma.tgz.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xml2er.tgz.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/xsd2er.tgz.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/json2er.tgz.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/merge2er.tgz.md5
$ curl -u "USER:PASS" -OL https://download.sonra.io/flexter/flexter-ui.tgz.md5

# helper function

$ md5ck() { md5sum -c <(echo `cat $1.md5` $1); }

$ md5ck flexchma*.tgz
$ md5ck xml2er*.tgz
$ md5ck xsd2er*.tgz
$ md5ck json2er*.tgz
$ md5ck merge2er*.tgz
$ md5ck flexter-ui*.tgz

Installing the packages - with root access

# flexchma
$ sudo tar xzf flexchma*.tgz -C /usr/share
$ sudo ln -s /usr/share/flexter/flexchma/bin/flexchma /usr/bin/ 
# xml2er
$ sudo tar xzf xml2er*.tgz -C /usr/share
$ sudo ln -s /usr/share/flexter/xml2er/bin/xml2er /usr/bin/xml2er

# xsd2er
$ sudo tar xzf xsd2er*.tgz -C /usr/share
$ sudo ln -s /usr/share/flexter/xsd2er/bin/xsd2er /usr/bin/xsd2er

# json2er
$ sudo tar xzf json2er*.tgz -C /usr/share
$ sudo ln -s /usr/share/flexter/json2er/bin/json2er /usr/bin/json2er

# merge2er
$ sudo tar xzf merge2er*.tgz -C /usr/share
$ sudo ln -s /usr/share/flexter/merge2er/bin/merge2er /usr/bin/merge2er

# flexter-ui
$ sudo tar xzf flexter-ui*.tgz -C /usr/share

# complete the installation
$ sudo mkdir -p /etc/flexter
$ sudo ln -s /usr/share/flexter/conf /etc/flexter/conf

Installing the packages - without root access

$ mkdir -p ~/.local/share ~/bin
# flexchma
$ tar xzf flexchma*.tgz -C ~/.local/share
$ ln -s ~/.local/share/flexter/flexchma/bin/flexchma ~/bin/flexchma
# xml2er
$ tar xzf xml2er*.tgz -C ~/.local/share
$ ln -s ~/.local/share/flexter/xml2er/bin/xml2er ~/bin/xml2er

# xsd2er
$ tar xzf xsd2er*.tgz -C ~/.local/share
$ ln -s ~/.local/share/flexter/xsd2er/bin/xsd2er ~/bin/xsd2er

# json2er
$ tar xzf json2er*.tgz -C ~/.local/share
$ ln -s ~/.local/share/flexter/json2er/bin/json2er ~/bin/json2er

# merge2er
$ tar xzf merge2er*.tgz -C ~/.local/share
$ ln -s ~/.local/share/flexter/merge2er/bin/merge2er ~/bin/merge2er

# flexter-ui
$ tar xzf flexter-ui*.tgz -C ~/.local/share

# complete the installation

$ mkdir -p ~/.config
$ ln -s ~/.local/share/flexter/conf ~/.config/flexter
# optional - add ~/bin in the path if it isn't there
echo 'export PATH="$PATH:$HOME/bin"' >> ~/.bash_profile
source ~/.bash_profile