Support portal Case studies Schedule a demo

Installation

Following instructions will guide you how to install getint.io

Step by step instructions (~10mins)

Requirements

  1. Ubuntu / Debian / Redhat / Windows server / Docker

  2. Root user access

  3. Your getint.io binary and License files prepared by getint.io. If you do not have one support@getint.io

Server requirements

Minimum

Recommended

2GB Ram

4GB Ram

1 vCPU

2 vCPU

60 GB HDD

60 GB SSD

Steps for Ubuntu

Below steps are tested and working with following operating systems:

System Name

Versions

Ubuntu

18.04 LTS , 20.04 LTS

1/4 Sign in with ssh to the server

Sign in as a root user to the machine

ssh yourusername@iporhostname

2/4 Prepare ubuntu machine

Download server preparation script. This script is going to install PostgreSQL, Java and Nginx on your server. If any of them is already installed, script will just skip its installation.

cd /tmp
curl -O https://artifactory.getint.io/install_ubuntu.sh
sh install_ubuntu.sh

During installation script will ask you to provide access data to the PostgreSQL instance. If you installed PostgreSQL on same machine script autogenerated access data and you can hit ENTER for each access part (host, username etc). If you are going to use some externally hosted PostgreSQL (like AWS PostgreSQL) you can provide now host, username, password and port that should be used when getint.io will use to connect with database. 

Done !
Executing command (Ctrl+C to stop)

PostgreSQL, host (enter to accept 'localhost'):
   accepting default value: localhost
PostgreSQL, username (enter to accept 'getintio'):
   accepting default value: getintio
PostgreSQL, password (enter to accept 'clusterpass'):
   accepting default value: clusterpass
PostgreSQL, database (enter to accept 'cluster'):
   accepting default value: cluster
PostgreSQL, port (enter to accept '5432'):
   accepting default value: 5432
   
Installation was successful
Setting up configs
Done

3/4 Run getint.io instance

Run getint.io instance by running below script

cd /opt/getint/cluster
./manager.sh version <GETINTIO_BINARY_PATH_PROVIDED_BY_GETINTIO_TEAM>

Instance will be started in background mode. It means you can exist logs displayed during startup with CTRL+C.

In default getint.io will start on 80 port

Accessing getint.io

Those are credentials you can use to access getint.io installation via your browser.

username: platformadmin
password: admin

Open browser and type url which is the machine IP address. Alternatively if you have any domain name assigned to the machine on which getint.io is installed, you can type that domain name.

Other commands you can use to manage getint.io instance in the future.

./manager.sh stop
./manager.sh restart
./manager.sh start

Video tutorial

Here is a video tutorial showing demonstrating how to install a onpremise version

Uninstallation

1) Uninstall PostgreSQL

sudo apt-get remove postgresql
sudo apt-get remove pgdg-keyring postgresql*
sudo rm -rf /var/lib/postgresql
sudo rm -rf /var/log/postgresql
sudo rm -rf /etc/postgresql
sudo deluser postgres
sudo delgroup postgres

Steps for Windows Server 2016

1) Install PostgreSQL

https://content-www.enterprisedb.com/postgresql-tutorial-resources-training?cid=437

2) Install JAVA JDK 11

https://download.oracle.com/otn/java/jdk/11.0.12%2B8/f411702ca7704a54a79ead0c2e0942a3/jdk-11.0.12_windows-x64_bin.exe

3) Download Trial version of getint.io (.jar file)

Getint.io team will provide you url to download trial version

4) Create directory and copy to it downloaded .jar file

5) Create in that directory logs directory

6) Create in that directory run.bat file and copy below content to it

set PORT=8089
set SPRING_DATASOURCE_USER=<POSTGRESUSER>
set SPRING_DATASOURCE_PASSWORD=<POSTGRESPASSWORD>
set SPRING_DATASOURCE_URL=jdbc:postgresql://<HOST>:<PORT>/<DBNAME>
set LOGGING_DIR=<PATHTODIRECTORY>\logs
java -jar <NAMEOFJARFILE>.jar

Replace below placeholders with correct values:

  • <POSTGRESUSER> - username used to authenticate to PostgreSQL server

  • <POSTGRESPASSWORD> - password used to authenticate user

  • HOST - host to to reach databse, mostly "localhost"

  • PORT - port to reach database, mostly "5432"

  • DBNAME - name of the databse

  • <PATHTODIRECTORY> - path to the directory in which logs dir was created

  • <NAMEOFJARFILE> - name of getint.io trial version file downloaded in steo 3

Final content of the file could look like this

7) Open command line, navigate to that directory

Files structure will look like this (in our example we created main directory under C:\Users\Administrator\getintio path, access.txt file will appear after first run of getint.io)

8) Execute below command

call run.bat

Running .bat file in above way, will execute commands which are within it in a foreground mode. So it means that until console is opened, it will let process to be running. Closing console will result in stopping the process, so getint.io .jar file will be not running any more.

To make it permanently working you need to set the .bat file as a Windows Service (guide will be delivered soon by getint.io team)

9) Open browser and type url which is the machine IP address. Alternatively if you have any domain name assigned to the machine on which getint.io is installed, you can type that domain name.

If you have used port other than 80, remember to include it in the address (e.g. url would be http://10.0.0.32:8089).

You should see a login page where you can provide:

username: platformadmin
password: admin

Docker installation

Please watch following youtube video for deploying getint.io with Docker. In this tutorial we will setup getint.io with Oracle database hosted with AWS RDS.

Steps for deployment

  1. Install docker. You can use below script which we have used to install Docker and docker-compose under Debian 11

  2. Unzip getint.io installation package

  3. Navigate to getint/synchronizer/docker directory

  4. Edit conf/variables.env if you want to change getint.io configuration variables e.g. database connection details. To connect with Oracle hosted on AWS we have used:

    SPRING_DATASOURCE_URL=jdbc:oracle:thin:@database-10.clujpqmsyrp4.eu-central-1.rds.amazonaws.com:1521/ORCL
SPRING_DATASOURCE_USER=admin
SPRING_DATASOURCE_PASSWORD=Admin123!!
SPRING_DATASOURCE_DRIVER=oracle.jdbc.driver.OracleDriver

  5. Navigate to scripts directory

  6. Run command sh start.sh which will run docker-compose file and start getint.io application on port 80. There are also stop.sh and destroy.sh scripts for stopping containers and purging getint.io related docker components.

Docker install script for Debian 11

sudo apt-get update
sudo apt -y install apt-transport-https ca-certificates curl gnupg2 software-properties-common
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt-get update
apt-get install docker-ce docker-ce-cli containerd.io
docker –version
sudo systemctl status docker
apt-get install docker-compose
PreviousArchitectureNextCluster High Availability

Last updated