Installation of the programming environment.

The first rule about computer's (your data) safety is: "you must avoid unencrypted HTTP (without ending 'S') resources". If you download a file from an unencrypted resource (HTTP), then you must at least check its "CHECKSUM". It's usually SHA1, SHA256 or SHA512. You must use software from official, well known sources. Sometimes search engines list scam resources at the fist lines.

You must use the latest version of a reliable browser. Beigesoft WEB interface is based on HTML5 dialogs. Google Chrome and Opera support it (HTML5 dialogs), so you have to use one of them.

Installing JDK on Unix-like OS.

I recommend Debian with LXDE interface. To install OpenJDK on Debian based linux just run as "root" "apt-get install openjdk-8-jdk" or "sudo apt-get install openjdk-8-jdk". On Red Hat based Linux run "dnf install java-1.8.0-openjdk-devel". Then set environment variables in the .bashrc file, for Debian example:

export ANT_HOME=$HOME/programmer/java/apache-ant-1.10.8

export CATALINA_HOME=$HOME/programmer/java/apache-tomcat-7.0.105

export TOMCATA_HOME=$HOME/programmer/java/apache-tomcat-7.0.68a

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64

export H2DRIVERS=$HOME/.m2/repository/org/postgresql/postgresql/42.2.16/postgresql-42.2.16.jar:$HOME/.m2/repository/org/xerial/sqlite-jdbc/3.32.3.2/sqlite-jdbc-3.32.3.2.jar:$HOME/.m2/repository/mysql/mysql-connector-java/8.0.21/mysql-connector-java-8.0.21.jar

export ANDROID_HOME=$HOME/Android/Sdk

export PATH=$PATH:$HOME/programmer/java/apache-maven-3.6.3/bin:$ANT_HOME/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools

export GPG_TTY=$(tty)

* You should create the folders that are described in the environment variables. The maven artifacts will be downloaded automatically in the next steps.

Installing JDK on MS Windows.

You can use OpenJDK included in "Android Studio". You will need Android Studio to make the application for Android. You should install it first. This is not difficult even for beginners, just download it from the official Android site https://developer.android.com and install by default settings. You will no need to check its signature by hand, MS Windows will show it.

Installing Apache Maven.

Maven 3.6.3 signed by signature that is in https://archive.apache.org/dist/maven/KEYS.

Just create folder e.g. "$HOME/programmer/java/" for Unix like OS, or "C:\programmer\java" for MS Windows. Then download apache-maven-3.6.3.zip from https://maven.apache.org/, check its checksum and unpack it there.

To check checksum on MS Windows open Power Shell (or CMD) in the Downloads folder (there is the file) and type in the command line:

certUtil -hashfile [pathToFileToCheck] [HashAlgorithm]

i.e. run:

certUtil -hashfile apache-maven-3.6.3-bin.zip SHA512

and check it against SHA512 on the site: https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.zip.sha512

To check checksum on Unix like OS type "SHA1SUM [pathToFile]" or "SHA256SUM [pathToFile]" or "SHA512SUM [pathToFile]". GnuPg is already installed:

1. Open terminal and login as root

2. download public keys:

wget https://archive.apache.org/dist/maven/KEYS

3. import public keys:

gpg --import KEYS

4. download Maven:

wget https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz

5. download Maven's signature:

wget https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz.asc

6. check signature:

gpg --verify apache-maven-3.6.3-bin.tar.gz.asc

On Unix like OS you have to download installation files under the ROOT user. This guaranty that only ROOT can change these binary files.

Installing Beige libraries sources.

Just download the first release of beige-blc from https://github.com/demidenko05/beige-blc/releases and beige-web from https://github.com/demidenko05/beige-blc/releases. Then unpack them into "programmer/java" folder.

* It might arise an error during unpacking ZIP archives on MS Windows, so if it's not all needed files are unpacked, then try tar.gz archive (7zip or 8zip)

Making environment variables on MS Windows.

On MS Windows 10 open "Search" and type "env" then "Edit the system environment variables" will be listed, so choose it, "System Properties" window will be appeared, switch to "Advanced" then push "Environment variables", then add or change:

  • Set JAVA_HOME to standard location C:\Program Files\Android\Android Studio\jre (check it out)

  • ANDROID_HOME - in Android Studio open SDK manager to see Android SDK Location

  • Path - leave all entries and add

    • C:\programmer\java\apache-maven-3.6.3\bin

After saving, check it: open Power Shell and type "$env:JAVA_HOME" or "$env:Path"

Installing Maven artifacts - all 3-d party libraries.

We need at least downloaded SQlite library for H2 datbase tool. Just open Power Shell in the source code beige-blc folder and type "mvn clean install". Maven will download all needed libraries into "C:\users\[your name]\.m2\repository" on MS Windows or "[your home]/.m2/repository" on Unix-like OS.

Making environment variable H2DRIVERS on MS Windows.

Open "System Properties" - "Environment variables" as described above, then add variable H2DRIVERS and choose just downloaded file "C:\users\[your name]\.m2\repository\org\xerial\sqlite-jdbc\3.32.3.2\sqlite-jdbc-3.32.3.2.jar". After saving, check it: open Power Shell and type "$env:H2DRIVERS"

Installing Apache Tomcat.

Install its latest 7.0.105 version from https://tomcat.apache.org/download-70.cgi by using the same way as Maven installation. Copy these libraries into its "lib" folder from local Maven repository:

  • [path to maven local repository]\.m2\repository\org\xerial\sqlite-jdbc\3.32.3.2\sqlite-jdbc-3.32.3.2.jar

  • [path to maven local repository]\.m2\repository\org\slf4j\slf4j-api\1.7.30\slf4j-api-1.7.30.jar

  • [path to maven local repository]\.m2\repository\com\zaxxer\HikariCP\3.4.5\HikariCP-3.4.5.jar

Installing H2 database.

We never use H2 database. We will use its very useful SQL tool with WEB interface (H2 console). Install it from https://www.h2database.com/html/download.html (last version platform independent ZIP, check its SHA1 and unpack it into "programmer\java" folder).

Installing a text editor.

I recommend Geany https://www.geany.org/download/releases/ . On Debian-like OS you can install it "apt-get install geany".