General

Installation

Intrexx versioning

The Intrexx versioning follows the pattern below:

Version

The version of Intrexx is determined by the first four numbers. The first two numbers refer to the year that the version was released, and the last two to the month.

Online Update (patch level)

Updates are provided at irregular intervals for each Intrexx version. These software updates are known as "Online Updates". You can activate a setting in the Intrexx Portal Manager that it should check whether Online Updates are available for your version of Intrexx every time it is started. You can download these from the Intrexx download server and then install them.

Please note: If your server is not connected to the Internet, you can download the Online Updates with a computer, which is connected to the Internet, as a ZIP file. Afterwards, you can install the Online Update by transferring the ZIP file to the server and selecting "Installation from .zip file on Intrexx server" as the installation source.

Every time an Online Update is installed, the so-called patch level of the respective Intrexx version increases. The patch level corresponds to the number of the corresponding Online Update. You can view the version and patch level of your Intrexx installation via the "Help" menu -> "About Intrexx...".



Install Intrexx, update Intrexx, and upgrade Intrexx

This section will explain the difference between installing, updating and upgrading Intrexx.

Install Intrexx "Install" refers to the first or a new installation of Intrexx. Intrexx is usually installed in an empty directory in this case.

Update Intrexx "Update" refers to the installation of the Online Updates available for the respective version. The patch level increases after the update. However, the Intrexx version is not changed.

Upgrade Intrexx When "upgrading", you change the version of Intrexx. This is the case, for example, when switching from Intrexx 18.03 to 20.03. You can upgrade to a new version by installing it "over the top" of a previous Intrexx version, meaning you install it in the same directory where the previous version was. Or you can create a new directory (on another server). This corresponds to a new installation. Afterwards, you need to transfer your portal and/or data from the previous version to the new Intrexx version.

More detailed information about each option is available at the following links:

Certificates

From Intrexx 19.03 onwards, only encrypted connections between the browser and the web server are allowed.
Intrexx encrypts transferred data via HTTPS. The data is encrypted with SSL or TLS. To establish a secure connection, an SSL/TLS certificate is required for the server that the secure connection should be established to. Self-signed certificates can also be integrated. However, the authenticity of the data is not certified by an external authority in this case. You can create self-signed certificates via OpenSSL.
You should already have your certificate available before installing Intrexx.

Intrexx and third-party software

Intrexx works together with third-party software. Some of these are provided with Intrexx. So that you can run Intrexx, you require a database system, a web server and usually a reverse proxy, among other things. Furthermore, you need a Java Runtime Engine.
More detailed information about this is available in the system requirements.
Please note that you should install and configure the reverse proxy (in particular) first. You should only install or upgrade Intrexx after this.

Intrexx in your system landscape

Intrexx fits into your system landscape. You can run Intrexx in a Windows or Linux system landscape. Accordingly, different web servers, such as IIS from Microsoft or NGINX (Linux), can or must be used.
In addition, there may be security aspects that affect the use and configuration of a reverse proxy and also the use and corresponding configuration of firewalls.
More detailed information about this is available in the chapter Intrexx architecture.

Before you update or upgrade Intrexx

help.2.upgrade-fuer-intrexx-durchfuehren.html

Typical installation process

The Intrex installation can be performed in different ways. A typical installation process could look something like this:

Actions outside of Intrexx

Before you start the actual Intrexx installation, you need to perform a few actions outside of Intrexx. These include the definition of a hostname, under which your portal can be accessed in the browser, the creation or purchase of a certificate for a secure connection between the browser and web server (SSL) and the creation of the hostname in the (respective) Domain Name System (DNS) so that your portal can be accessed in the browser.

Moreover, the required third-party software needs to be installed and configured. This includes the desired database system and the corresponding reverse proxy (IIS for Windows, NGINX for Linux).

Install Intrexx

There are two key steps to the installation of Intrexx. In the first step, the "basic version" of Intrexx is installed. The "basic version" does not include the Online Updates that have been released at the time of installation. These Online Updates are installed in the second step.

Create a portal

You can create a portal during the Intrexx installation process. Intrexx provides this option before Online Updates have been installed. When the Online Updates are installed, Intrexx performs a so-called portal patch. During the portal patch process, Intrexx checks whether your portal that was created in an earlier Intrexx version or with another patch level needs to be modified before it can continue to be used.

You can also create a portal once the installation is completed. A portal patch is therefore not required during the installation process.

Configure the portal properties

Once a portal has been created, some settings still need to be made in the portal properties so that your portal can be accessed in the browser. This primarily concerns settings that relate to the reverse proxy (IIS or NGINX, respectively).

Overview of the next chapters

Architecture This chapter provides a description of the Intrexx architecture. The interaction between Intrexx or the "embedded Tomcat" and the reverse proxy is described here. Understanding the architecture will help simplify the individual steps of the installation/upgrade process.

System requirements The system requirements provide a detailed list of what is required for your Intrexx installation and system landscape.

The chapters that follow these provide a detailed step-by-step guide to help you install or upgrade Intrexx.