Installing ISRT

For the installer just hit it – for the ZIP file, just unzip and go!

Windows

Download the Zip file, uncompress and ensure all the code is in one directory. It should all be good, since I pack it in one folder before zipping it up. Move the folder to wherever you like it to reside – best is doing this before you run the ap for the first time. I recommend putting the folder somewhere, you don’t need admin access for, because this would always ask you for Admin permissions if you would run the app, since I constantly read and write from the database.

Prerequisites:

  • Windows 10: None!
  • Windows 7: Installlation of Update KB2533623 required Download KB

Note that if you store the ISRT directory in the Program Folder or any other Admin-related folder, you need to start the app with Administrator permissions, because I read/write a lot in the database, and altering files in such folders requires Admins permissions. Otherwise ISRT won’t work. So you better store it somwhere else, like your documents folder or your AppData folder.

Once done and there, you will find two exe files inside the folder (forget about the manifest file in the screenshot):

Run the “isrt.exe” for the first time. This initializes the app and gives you the chance to import an old database and checks for updates etc. After that you can either open the “isrt.exe” or the “isrt_monitor.exe”. Both work independantly. Normally though, you would open the Monitor from the in-app button “Open Server Monitor”.

Beware that both are depending on the database file in the “db” folder, so if you move this, the app breaks.

I decided to use no installer, since it is just unneccessary and produces more problems for code signing etc. then benefits. For uninstall, just delete the folder – you may consider saving your database in the DB folder for later use.

If you now want to have a wonderful desktop shortcut, you can follow this link, where I describe this step-by-step.

Linux

For Linux the Exe files are not working of course. To make this work on those systems, you need to get the pure python code from the Download page and run the “isrt_<version>.py” or the “isrt_monitor.py” – once again having all of the files in one folder. The rest works the same. You have to make sure that you have python 3.7.x or above and libPyQt5 installed. Follow the guide below – first to update your system.

You don’t need to do the following step, if you already have a running Python and PyQt5 installation:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install python3 python3-pip

However, after installing, ensure that we have a symbolic link reachable for the python app by calling python. You check that by opening a terminal/console and typing the following:

user@maschine:~$ which python
user@maschine:~$ 

If you get no response, that means you ahve to create a symbolic link to the python3 interpreter. First look, where python3 resides, then take the result and create a link using ln:

user@maschine:~$ which python3
/usr/bin/python3
user@maschine:~$ sudo ln -s /usr/bin/python3 /usr/bin/python

Afterwards you should be able to call the python interpreter correctly:

user@maschine:~$ python
Python 3.8.5 (default, Jul 28 2020, 12:59:40) 
[GCC 9.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> 

That done, you can now go ahead and install the required packages. We first uninstall newer versions of PyQT5, because something has changed in the newer version that produce an error for some reason. Then we install the correct versions.

pip3 uninstall PyQt5 PyQt5-plugins PyQt5-tools
pip3 install pyqt5==5.15.1 pyqt5-tools==5.15.1.3.0.2 requests psutil datetime pathlib pillow

If that doesn’t work for some reason try this instead:

sudo python3 -m pip3 uninstall PyQt5 PyQt5-plugins PyQt5-tools
sudo python3 -m pip3 install pyqt5==5.15.1 pyqt5-tools==5.15.1.3.0.2 requests psutil datetime pathlib pillow

You can now go ahead to download and extract ISRT for Linux.

Go into your ISRT folder and right click on the isrt_<version>.py file and choose Properties.

Select Python3.8 or any other installed python interpreter for the app to be opened with (3.9 would be optimal).

Same for the isrt_monitor.py file:

After that ensure that both, the isrt and the monitor file are executable as program.

Now you can start the app by double clicking on the isrt_<version>.py file and it will run like a charm! If you would like to have a desktop shortcut in Linux, follow this link for a tutorial.

If that doesn’t work for whatever reason you simply try to open a terminal and call the below from console from inside the ISRT directory! If everything runs, you are setup perfectly.

user@maschine:~$ python3 isrt.py

MacOS

Please bear in mind, that I’m primarily developping for Windows users, as INS is a Windows app and does not have a MAC port. However, it is working with some prerequisites fulfilled although I would need a bit of GUI adaptation if I have enough users with MAC. The Exe files are also not working of course. To make this work on your Mac, you need to get the pure python code from the Download page and run the “isrt_<version>.py” or the “isrt_monitor.py” – once again having all of the files in one folder. The rest works the same.

Prerequisites:

  • Python 3.7x or above
  • libPyQt5 (plus modules: psutil, requests & certifi)

You have to make sure that you have python 3.7.x or above and libPyQt5 plus a couple of modules installed. Here’s what you need to do:

  1. Goto python.org and download the 3.7.x MacOS installer file

2. Install it by clicking on the downloaded file:

3. Let it install and provide your password for Admin access

4. Open a Terminal and run the following commands:

python3 -m pip install --upgrade pip
python3 -m pip install PyQt5 psutil requests certifi

and finally update the Python certificates

python3 -m pip install --upgrade certifi

Alternatively to the last step, you can move into your Finder -> Application Folder to Python 3.x and hit “Install Certificates.command”

5. Finally you are there – open the ISRT folder and run the isrt_<version>.py file, and it should open up:

Doesn’t look perfectly designed for MacOS, but it works – I’ll have to improve that, if I have enough users for MacOS.