Install on linux

From ITR Wiki

On Linux systems we recommend you use docker.

Create start setup

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
  • 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 en 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.

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.
rm prepareITR.sh
curl https://raw.githubusercontent.com/Quopt/ITR-Docker/master/prepareITR.sh -O 
chmod +x prepareITR.sh
./prepareITR.sh
  • 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 !

Prepare with https certificate

This is not tested yet.

  • 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 . Copy the prepareITR.sh file to prepareITR4Me.sh .
  • open this file. Find the lines
export WWW=training.testdimensions.com
export EMAIL=certificates@testdimensions.com
  • and change them to your domain name for the certificate and your mail address
  • Also find the line in the file
# UNCOMMENT FOR certificate support
# envsubst < /data/ITR-Docker/nginx/nginx.conf.template.public > /data/ITR-Docker/nginx/nginx.conf
  • Uncomment the envsubst command.
  • Save and run prepareITR4Me.sh
  • If you are still running on virtualbox op 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.