Linux – Install Intrexx via the terminal (headless)

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:

Configuration settings during installation

Start installation

The following instructions assume that you select "Intrexx Portal Server Production Installation (Single Server)" when selecting the components. With this option, you install Intrexx with all available components on a (virtual) Linux server.

Switch to the installation files directory "IX_11.X.0".

Start the installation with the following command:

sudo ./setup.sh -t

Optional parameters

You can use the following optional parameters for the installation:

--logging=plain When you use this parameter or value, all the individual installation steps are displayed.
In the log output, the animation (a spinning slash) is disabled.
--configFile=<cfgfile> If you use this parameter, you can install Intrexx using a configuration file (see Install Intrexx using a configuration file (headless).
--update
- d
If you use this parameter, you can perform an "Unattended Update". Use the parameter together with the parameters --configFile or --installationPath.

--silent

-s
When you use this parameter, the detailed progress information is suppressed during the setup.

Note The parameter --silent parameter is not related to the Intrexx Silent Track. You select the release track at a later time during the installation.

--help You can use this parameter to display additional parameters.

Example

sudo ./setup.sh -t --logging=plain --silent

Accept the license conditions

*** Intrexx Portal Server Linux (AMD64/EM64T) für Linux (AMD64/EM64T) ***

To install this product, you must agree to the license agreement.

Please read it carefully

Do you accept the license conditions (yes/no/view)?

Select component

The following components are available. Choose one.

1) Intrexx Portal Server Production Installation (Standalone)

2) Intrexx Portal Server Production Installation (Distributed Cloud/Cluster)

3) Intrexx Portal Server Minimal Installation

Components (1-3)?

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.

More information about the cloud installation is available in the section Install Intrexx in the cloud.

Intrexx Portal Server Minimal Installation

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

Compare distribution sets You can see which installation option contains which components by clicking on "Compare distribution sets".

The Portal Manager is not offered as a download at this point as it does not need to be installed.

Windows

Download

Linux

Download

Mac

Download

Select packages

The following packages will be installed:

Java Runtime Environment

Installation system

Portal Server

Portal Server single server support

Apache Solr search server

Optional database drivers

Portal Manager

Yes

Do you accept the selection (Yes/No)?

Enter "Yes" to install all packages.

If you enter "No", you can decide whether or not to install each package individually.

If you do not want to install the Java Runtime Environment delivered with Intrexx, enter "No" for this package. Please note that you will then need your own, compatible Java Runtime Environment to install and run Intrexx.

Select JDK

Please specify the desired JDK.

JDK-Pfad [/home/johndoe/Downloads/professional/java/packaged/linux/amd64]

Press "Enter" to select the JDK delivered with Intrexx. If you want to use a different JDK, specify the path here.

Specify the installation directory

Installation directory [/opt/intrexx]:

Press "Enter" to select the suggested installation directory. The directory "intrexx" is then created automatically.

Define the instance name

Please choose an instance name.

To continue the installation with a blank instance name, please enter $.

Installation instance [<default instance>]:

This installation step is relevant if you want to install multiple instances of Intrexx.

Enter the $ sign if you want to install only one instance of Intrexx (default instance).

Give the Intrexx instance its own name, if you would like 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.

Specify release track

Please specify your release track (Steady, Silent) [SILENT]

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 about the release tracks is available in the section Silent and Steady Track.

Press "ENTER" to select the suggested release track.

Define the daemon 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 belonging to the Sudoer group. By default, the installation routine suggests the technical user "intrexx".

Daemon account [intrexx]?

intrexx

Press "Enter" if you want to install Intrexx with the suggested user "intrexx".

The "intrexx" user is then automatically created and added to the Sudoer group. The user therefore has sufficient permissions to be able to install Intrexx. After the installation, all Intrexx files belong to this user. The Solr service also runs under this user.

You can also freely assign another user name and enter it at this point. A user with the corresponding name is then created. This user will also be added to the Sudoer group.

You can also enter an existing Linux user. If this user does not already belong to the Sudoer group, it will be added to it.

The account intrexx does not exist. Do you want to create a new account and continue (Yes/No)? Yes

Please enter a password for the new user.

Please repeat the password.

Please note that - as usual in Linux - the cursor does not move when entering the password.

You will be asked for this password later when you execute something in Intrexx that requires root privileges at the operating system level.

root

If you can or would like to install and run Intrexx in an isolated environment, then 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.

If you want to run the root installation, then enter "root" here.

Detailed information on selecting the appropriate daemon user account is available in the section Linux - Install Intrexx.

Select language character set

Setting for the system character set

 

1) c

2) German (Austria)

3) German (Belgium)

4) German (Switzerland)

5) German (Germany)

6) German (Italy)

7) German (Liechtenstein)

8) German (Luxemburg)

9) English (Antigua and Barbuda)

10) English (Australia)

11) English (Botswana)

12) English (Canada)

13) English (Denmark)

14) English (United Kingdom)

15) English (Hong Kong Special Administrative Region)

16) English (Ireland)

17) English (Israel)

18) English (India)

19) English (Nigeria)

20) English (New Zealand)

[more]

After selecting the language character set, you will be prompted to configure the Solr service.

Configure Solr

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

Authentication for the Solr search server

The Intrexx Portal Server uses the user and password for authentication on the Solr search server.

Apache Solr configuration

 

Host:       127.0.0.1

HTTP port:  8983

User:       solr

Password (default "SolrRocks"): ********

 

Do you want to accept this Solr configuration? (Yes/No)? Yes

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, the default host is "127.0.0.1" (localhost). 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

Installation routine is performed

After you have made all configuration settings, the (actual) installation routine starts.

Installation...

1) Installing Java Runtime Environment

* 100% finished

2) Installing installation system

* 100% finished

3) Installing Apache Solr Search Server

* 100% finished

4) Installing Portal Server

* 100% finished

5) Installing Portal Server single server support

* 100% finished

6) Installing Portal Manager

* 100% finished

7) Installing optional database drivers

* 100% finished

8) Configuring Java Runtime Environment

* 100% finished

9) Configuring Apache Solr

* 100% finished

10) File permissions are set.

* 100% finished

11) Starting Apache Solr Search Server

* 100% finished

12) Configuring the portal server

* 100% finished

13) Configuring single server support

* 100% finished

14) Configuring the Portal Manager

* 100% finished

15) Setup is copied to the installation.

* 100% finished

16) File permissions are set.

* 100% finished

17) Starting the portal server services

* 100% finished

After the installation

Configured services

The following service is available after installation:

  • Solr

    Shell script: upixsolr

The service is started automatically after installation. However, this requires that the port selected during installation is not already being used by other services.

The installed shell scripts for the services can be viewed here: /opt/intrexx/bin/linux.

Intrexx user installation

johndoe@linux:~$ ls -la /opt/intrexx/bin/linux/upix*

-rwxr-xr-x 1 intrexx intrexx 105496 Aug 19 18:32 /opt/intrexx/bin/linux/upixsolr

-rw-r--r-- 1 intrexx intrexx 8 Sep 13 09:46 /opt/intrexx/bin/linux/upixsolr.java.status

-rw-r--r-- 1 intrexx intrexx 5 Sep 13 09:46 /opt/intrexx/bin/linux/upixsolr.pid

-rw-r--r-- 1 intrexx intrexx 8 Sep 13 09:46 /opt/intrexx/bin/linux/upixsolr.status

root installation

johndoe@linux:~$ ls -la /opt/intrexx/bin/linux/upix*

-rwxr-xr-x 1 root root 105496 Aug 19 18:32 /opt/intrexx/bin/linux/upixsolr

-rw-r--r-- 1 root root 8 Sep 13 09:46 /opt/intrexx/bin/linux/upixsolr.java.status

-rw-r--r-- 1 root root 5 Sep 13 09:46 /opt/intrexx/bin/linux/upixsolr.pid

-rw-r--r-- 1 root root 8 Sep 13 09:46 /opt/intrexx/bin/linux/upixsolr.status