Mac OS X - Install Intrexx

Please note

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 Mac computer.

Step-by-step guide

To install Intrexx, proceed as follows:

  1. Run the downloaded setup file.

    The installation start dialog will appear.

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

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

  4. 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

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

  6. Click on "Next".

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

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

    You can change the installation directory here.

    If you want to perform an upgrade, i.e. a version change of Intrexx, you can select a directory here in which an earlier version of Intrexx has already been installed.

    By default, Intrexx is installed in the "Applications" directory. The dialog allows you to change the selected installation directory.

    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 user.

    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

    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. Mac user

    Please note that the user you select or create here is not an Intrexx user. Rather, it is the Mac 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.

    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 Mac user and adds it to the Sudoers group.

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

    Apache Solr search server

    Here you can set or change the host and HTTP port for the Apache Solr search server. This is only necessary if you do not want to install the Apache Solr search server on the same server on which you are installing Intrexx.

    Apache Solr search server 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). By default, port 8983 is suggested.

    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.

    Enter the IP address where you want to install the Apache Solr search server in this dialog. In addition, add the port where the Apache Solr search server can be reached. If necessary, add the required authentication details.

    More information

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

  8. Click on "Start".

    The installation process will start.

    You may be asked for your user password during the installation process.

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

  9. Click on "Finish".