Linux – Installing Intrexx via the graphical user interface

Before installing Intrexx, please check whether all requirements are met and that all necessary preparations have been made.

You can also find detailed help for this here:

Start setup

The following provides a step-by-step guide for installing Intrexx.

It is assumed that you select the option "Intrexx Portal Server production installation (single server)". With this option, you install Intrexx with all available components on a (virtual) Linux server.

Step-by-step guide

To install Intrexx, proceed as follows:

  1. Go to the directory of the installation files.

  2. Start the installation with the following command:

    sudo ./setup.sh

    The installation start dialog will appear.

  3. Click on "Next".
    The conditions of the license agreement will appear.

  4. Read the license agreement. Then activate the "I accept all conditions of the license agreement" checkbox

  5. Click on "Next".

    The dialog where you can specify the installation directory will appear.

    Please note that the path to the installation directory must not contain any spaces.

  6. Click on "Next".

    The dialog appears where you can select different Intrexx components.

    Intrexx Portal Server Production Installation (Standalone)

    With this option, an optimized distribution set of components for The set contains the Portal Server, Portal Manager, search server and various database drivers.

    Intrexx Portal Server Production Installation (Distributed Cloud/Cluster)

    With this option, an optimized distribution set of components for cloud or cluster use. The set contains the Portal Server, Portal Manager, cloud components, search server and various database drivers.

    Further information on cloud installation can be found in the section Installing Intrexx in the cloud

    Intrexx Portal Server Minimal Installation

    With this option, a reduced distribution set optimized for you platform is installed. The compilation contains Portal Server, Portal Manager, Search Server and the most important database drivers.

    Compare composition You can see which installation variant contains which components by clicking on "Compare composition".

    The Portal Manager is not offered for download here as it does not require installation.

    You can download Portal Manager from the following links:

    Windows

    		 Download

    Linux

    		 Download

    Mac

    		 Download

  7. Select the option "Intrexx Portal Server production installation (single server)".

  8. Click on "Next".

    The dialog that provides a summary of the installation options will appear.

    In this dialog, you can check the previously selected settings again and change them if necessary.

    You can also change default settings that Intrexx makes during the installation without explicitly asking you. This includes the installation as an "intrexx user", the specification of the instance name or the selection of ports.

    Installation directory

    The previously created installation directory is displayed here.

    Packages to be installed

    You have already selected which Intrexx components you would like to install in the "Select installation" dialog box. At this point, you can once again view the Intrexx components to be installed and make changes if necessary.If you would like to install the Intrexx Administration API, you must select the corresponding installation package here.

    Advanced settings

    You can change a number of default settings at this point.

    intrexx user installation - root installation

    Please note in particular that you can choose here between installation as "root" and installation as another Linux user.

    Detailed information on selecting the appropriate daemon user account can be found in the following section Linux - Install Intrexx.

    Steady Track - Silent Track

    You can also specify whether you want to follow the Steady Track or the Silent Track here.

    Advanced settings

    This step during the installation is relevant for you if you want to install multiple instances of Intrexx on the server.

    Advanced settings

    Default instance

    With this option, the current installation will be used as the default instance.

    Activate this option if you only want to install or run one instance of Intrexx (default instance).

    Named instance

    Give the Intrexx instance its own name if you want to install or run multiple Intrexx instances. The different names help to distinguish between the different Intrexx instances. At the same time, this option enables the parallel installation of Intrexx.

    Java Runtime

    JDK provided by Intrexx installer

    With this option, the JDK included within the scope of supply.

    JDK already installed on this system

    With this option, a suitable Java home directory that is already on the system can be entered. Intrexx will use the JDK located there. The JDK used must be at least JDK 21 compatible.

    Make sure that the JDK is compatible with Intrexx. If you are unsure about compatibility, please contact United Planet support.

    Selected JDK

    Displays the version of the currently selected JDK.

    Product updates

    Release track

    Here you can select the release track you want to follow.

    You can switch from the Silent Track to the Steady Track at any time. It is possible to change from the Steady Track to the Silent Track once a year at a defined sync time. This is usually the case in March.

    Detailed information on release tracks can be found in the following section Silent and Steady Track.

    Use proxy server for update

    If you have set up a proxy server in your infrastructure for the connection to the Internet or to the Intrexx Update Server, you can make the corresponding entries here.

    Daemon user account

    Root permissions are required to install Intrexx.

    In this dialog, you can choose whether you want to run the installation directly as "root" or with a user who belongs to the Sudoer group.

    Local administrator (root)

    Select this option if the installation of Intrexx should be executed as "root".

    If you can or would like to install and operate Intrexx in an isolated environment, then you can follow the "root installation". This method does not pose a safety risk in isolated environments.

    A VM where you run Intrexx exclusively can serve as an isolated environment. Furthermore, you can run Intrexx in a Docker container. This also allows you to rule out security risks associated with root privileges.

    Detailed information on selecting the appropriate daemon user account can be found in section Linux - Install Intrexx.

    Other user account

    Select this option if you do not want to run the Intrexx installation with "root".

    By default, the installation routine suggests automatically creating an "intrexx" user. This user is then added to the Sudoer group and therefore has sufficient permissions to install Intrexx. After the installation, all Intrexx files belong to this user. In addition, the Supervisor service (Supervisor Daemon) and the Solr service run under this user.

    You can also select other users from the drop-down list.

    Intrexx user vs. Linux user

    Please note that the user you select or create here is not an Intrexx user. Rather, it is the Linux user meaning a user at the operating system level. The Intrexx interface allows you to create a user for the operating system at this point.

    Detailed information on selecting the appropriate daemon user account can be found in the following section Linux - Install Intrexx.

    If not available, create an account.

    You can enter a user name in the "Other user account" selection list that is not displayed in the selection list.

    When you do this, Intrexx creates a new Linux user and adds it to the Sudoers group.

    You will then be prompted to enter a password for the new Linux user. You will be asked for this password later when you execute something in Intrexx that requires root privileges at the operating system level.

    New user password

    Administration API configuration

    The "Administration API configuration" tab is only displayed if you have previously installed the "Intrexx Administration API" package in the step " Packages to be installed".

    Detailed information on the Intrexx Administration API can be found in the section Intrexx Administration API.

    Apache Solr search server

    You can change the Apache Solr search server details here. This is necessary, for example, if you do not want to install the Solr search server on the same server on which you have installed Intrexx.

    Authentication on the Solr search server

    The Intrexx Portal Server authenticates itself with a user and password on the Solr search server.

    By default, the Apache Solr search server is installed with Intrexx. It provides the search functionality for your portal.

    By default, the Apache Solr search server is installed on the same server as Intrexx. Therefore, "127.0.0.1" (localhost) is preset as the host. The suggested port is 8983.

    However, you also have the option of installing the Apache Solr search server on another server. In that case, you need to adjust the specifications accordingly.

    The Intrexx Portal Server uses the user and password for authentication to the Solr search server. Change default authentication data.

    More information

    Custom Solr configuration

    More information

    https://solr.apache.org/resources.html

    https://solr.apache.org/guide/solr/latest/getting-started/tutorial-solrcloud.html

  9. Click on "Start".

  10. The installation process will start.

  11. Once the installation routine has been completed, the "Finish" button becomes active.

    Create portal

    Select this checkbox to create a portal immediately after installation.

    If you have activated the checkbox, a dialog ("Portal Builder") is started automatically after the installation has been completed, with which the creation of a portal is started.

    Start Intrexx Portal Manager

    Activate this checkbox to start the Intrexx Portal Manager immediately after installation is complete.

    After installation, you can also start the Portal Manager from the Start menu or the desktop icon, which has been automatically created.

    View log file

    During installation, Intrexx creates a log file that logs the installation. If you have activated the checkbox, the log file is automatically displayed after the installation has been completed.

  12. Click on "Finish".