Installation (version >= 1.21)
Following instructions will guide you how to install getint.io

Step by step instructions (~10mins)

Requirements
  1. 1.
    Ubuntu / Debian / Windows server
  2. 2.
    Root user access
  3. 3.
    Your getint.io binary and License files prepared by getint.io. If you do not have one [email protected]
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
Copied!

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.
1
cd /tmp
2
curl -O https://artifactory.getint.io/install_ubuntu.sh
3
sh install_ubuntu.sh
Copied!
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.
1
Done !
2
Executing command (Ctrl+C to stop)
3
​
4
PostgreSQL, host (enter to accept 'localhost'):
5
accepting default value: localhost
6
PostgreSQL, username (enter to accept 'getintio'):
7
accepting default value: getintio
8
PostgreSQL, password (enter to accept 'clusterpass'):
9
accepting default value: clusterpass
10
PostgreSQL, database (enter to accept 'cluster'):
11
accepting default value: cluster
12
PostgreSQL, port (enter to accept '5432'):
13
accepting default value: 5432
14
15
Installation was successful
16
Setting up configs
17
Done
18
​
Copied!

3/4 Run getint.io instance

Run getint.io instance by running below script
1
cd /opt/getint/cluster
2
./manager.sh version <GETINTIO_BINARY_PATH_PROVIDED_BY_GETINTIO_TEAM>
Copied!
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
When getint.io instance successfully run it will dump login and password to the file. Those credentials you can use to access getint.io installation via your browser.
To preview credentials
1
cd /opt/getint/cluster
2
cat access.txt
3
​
4
# You should see output like below
5
​
6
{
7
"password": "2161fuyagda287e",
8
"apiKey": "023cee2e-94b7-459d-a6cd-86972d6c54f9",
9
"username": "platformadmin"
10
}
Copied!
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. You should see a login page where you can provide username and password from the above access.txt file.

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

1
./manager.sh stop
2
./manager.sh restart
3
./manager.sh start
Copied!

Video tutorial

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

Uninstallation

1) Uninstall PostgreSQL
1
sudo apt-get remove postgresql
2
sudo apt-get remove pgdg-keyring postgresql*
3
sudo rm -rf /var/lib/postgresql
4
sudo rm -rf /var/log/postgresql
5
sudo rm -rf /etc/postgresql
6
sudo deluser postgres
7
sudo delgroup postgres
Copied!

Steps for Windows Server 2016

1) Install PostgreSQL
2) Install JAVA JDK 11
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
1
set PORT=8089
2
set SPRING_DATASOURCE_USER=<POSTGRESUSER>
3
set SPRING_DATASOURCE_PASSWORD=<POSTGRESPASSWORD>
4
set SPRING_DATASOURCE_URL=jdbc:postgresql://<HOST>:<PORT>/<DBNAME>
5
set LOGGING_DIR=<PATHTODIRECTORY>\logs
6
java -jar <NAMEOFJARFILE>.jar
Copied!
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
1
call run.bat
Copied!
​
​
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) After successful run new file should be created called access.txt . In that file you will find username and password that can be used to sign in.
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 and password from the access.txt file.
​