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 via 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 along with the --configFile or --installationPath parameters. |
--silent -s |
When you use this parameter, the detailed progress information is suppressed during the setup. Note The --silent parameter does not have anything to do 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.
You can download the Portal Manager from the following links:
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
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