Install on linux

From ITR Wiki

On Linux systems we recommend you use docker.

Create start setup with Ubuntu on a Windows system

You need to build your own production setup off course. But if you want to play around with the ITR now you can do the following.

  • Install Oracle VirtualBox
  • Download the ubuntu server ISO v18
  • Create a new virtual machine with Oracle virtual box, mount the ubuntu server ISO and install ubuntu fom scratch with the settings you want. You will need internet access though. Recommended server settings are 4 Gbyte RAM and 20 GB storage. This will be more than enough. Make sure to note down the user and password you entered. Otherwise you will have to start again.
  • You may want to clone the server installation at this point because it is a good fall back point.
  • Make sure you forward port 80 on your virtual machine. Right click on the machine, Settings - Network - Advanced - Port forwarding. And then add a rule. TIP : If you want to use your own terminal emulator like putty or mobaxterm then open port 22 too. Start the container in headless mode, wait for it to start and open an ssh connection on port 22 to localhost.
  • Login to your server

This might be a point where you can also start with a production linux system or your own ubuntu desktop if you dont want to use VirtualBox.

Setup on Ubuntu

Now the ITR will be installed and build. This will take about 30 minutes on a normal system

  • Check if there are no current installations running.
ps -A | grep apt
  • If there are processes running give them 5 minutes to complete. Otherwise stop the processes or reboot the machine and try again. sudo shutdown -r now is the command.
  • now enter the following commands. You will need to change the last line to the values you want (or leave them like this for reviewing). Please note that the database password can be set ONLY the first time and cannot be changed afterwards. Run ./prepareITR.sh separately (without parameters) to get an overview of the options you can use.
rm prepareITR.sh
curl https://raw.githubusercontent.com/Quopt/ITR-Docker/master/prepareITR.sh -O 
chmod +x prepareITR.sh
./prepareITR.sh training.testdimensions.com info@testdimensionss.com ITR2018! NOSSH
  • If you are installing on the raspberry pi 4 or later (version with 8 Gbyte is recommended) then the ./prepareITR.sh command with the appropriate parameters needs to be run twice
  • You are asked to enter the sudo password for your account. Please do so. If you do not have a sudo password then try the password you used to login to the container. If that does not work either contact your system administrator.
  • Now wait.
  • The installation ends with an overview of docker containers that have been started . The containers however need to install even more stuff. Give them 5 minutes to start.
  • Point your browser to localhost. You should see the login screen now. If you see 500 error in the bottom of the screen refresh your screen.

You can login with the default user name 

Admin

and password 

22CentigradeInArequipaToday

If logging in does not work the first time try again. You may have made a typo.

The system asks you to change the password. Please do so. Otherwise anybody can log in.

You have successfully installed the ITR ! Go to server settings in the Organisation menu to complete your installation. You can set your mail server there for example, and your organisation name and copyright string.

You might also want to install open source components. At least install the screen templates. In the Server settings screen click on the button "Install open source publics". In the following screen click on "Install all test screen templates". If there are other things, like translations, you would like to install then please do so.

Prepare with https Let's encrypt certificate

This will only work on an already installed internet facing Ubuntu 18 server. Ports 80 and 443 need to be opened to the server.

  • Check if there are no current installations running.
ps -A | grep apt
  • If there are processes running give them 5 minutes to complete. Otherwise stop the processes or reboot the machine and try again. sudo shutdown -r now is the command.
  • now enter the following commands. You will need to change the last line to the values you want (they MUST be changed). Please note that the database password can be set ONLY the first time and cannot be changed afterwards. Also enter the SSH option ONLY on first server installation, or Let's encrypt will not accept you any more at some point.
rm prepareITR.sh
curl https://raw.githubusercontent.com/Quopt/ITR-Docker/master/prepareITR.sh -O 
chmod +x prepareITR.sh
./prepareITR.sh training.testdimensions.com info@testdimensionss.com ITR2018! SSH
  • Wait 5 minutes. Point your browser to the domain name you entered and follow the rest of the instructions from the previous paragraph.

NOTE: If you want to refresh and restart your installation change SSH to SSHPRIVATE. Example 

./prepareITR.sh training.testdimensions.com info@testdimensionss.com ITR2018! SSHPRIVATE

If you would like to refresh and open the postgresql to the internet (you will need to secure this with iptables !) 

./prepareITR.sh training.testdimensions.com info@testdimensionss.com ITR2018! SSHPRIVATE $(curl -s http://whatismyip.akamai.com/)

Prepare with https certificate manual

This is not tested yet.

Ports 80 and 443 need to be opened to the server.

  • Place your certificates in /data/ITR-data/nginx/certificates. Name them certificate.crt and certificate.key.
  • Go back to your own folder by typing cd .
  • now enter the following commands. You will need to change the last line to the values you want (they MUST be changed). Please note that the database password can be set ONLY the first time and cannot be changed afterwards. Also enter the SSH option ONLY on first server installation, or Let's encrypt will not accept you any more at some point.
rm prepareITR.sh
curl https://raw.githubusercontent.com/Quopt/ITR-Docker/master/prepareITR.sh -O 
chmod +x prepareITR.sh
./prepareITR.sh training.testdimensions.com info@testdimensionss.com ITR2018! SSHPRIVATE
  • If you are still running on virtualbox open port 443 to your virtual server. go to https://<<YOUR DNS NAME>> . It should work.

This HTTPS version would be a good inspiration to work on your production server configuration with your requirements.

Retrieved from "http://wiki.itr365.com/index.php?title=Install_on_linux&oldid=259"