Install on linux

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

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.

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

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

Prepare with https Let's encrypt certificate

This will only work on an already installed internet facing Ubuntu 18 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 (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. 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.

Prepare with https certificate manual

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