Linux - Installing IAA using a configuration file

You have the option of installing the Intrexx Administration API via the command line using a configuration file.

You then do not need to interactively enter the individual parameters or specifications, such as the installation directory or ports, during the installation. Instead, the setup obtains the respective information from the configuration file.

.yml / .yaml

Note that the file format "yml" has been in use since Intrexx Steady Track 10.1.0. In the previous versions a .properties file was used.

You can also use "yaml" instead of the "yml" file format.

You must create the .yml file manually.

Installation

Change to the directory of the installation files "IX_12.X.X".

Start the installation with the following command:

./setup.sh -t --configFile=<path-to-configuration-file>configuration.yml

configuration.yml

The following is an example of a configuration file that includes the installation of the Intrexx Administration API.

Create your own configuration file with the information that suits you.

jre:
  linked: false
lucy_server_portal:
  charset: de_DE.UTF-8
packages:
  database_drivers: true
  installer: true
  jre: true
  lucy_manager_portal: true
  lucy_server_portal: true
  lucy_server_portal_standalone: true
  solr: true
  lucy_server_irma_standalone: true
setup:
  installationDir: /opt/intrexx
  instance:
    createDaemonUser: true
    daemonManager: SYSTEMD
    daemonUser: intrexx
    name: intrexx-12
    serviceStartType: AUTO_START
  javaHomeDir: /opt/intrexx/java/packaged/linux/amd64
  javaProvided: true
  sourceDir: /home/setup-intrexx/intrexx-setup-12.0.1
  update:
    releaseTrack: STEADY
  version: 10160000
  irma:
    username: irma
    password: irma
solr:
  cloudMode: false
  host: 127.0.0.1
  password: ixape-v1:79CA1AAF732D7DAE76F123456789
  port: 8984
  user: solr

Explanations

Line

Parameter/value

Comment
13 lucy_server_irma_standalone: true This parameter is required to install the Intrexx Administration API.
24 sourceDir: /home/setup-intrexx/intrexx-setup-12.0.1 Enter the directory in which the Intrexx setup file is located here. In addition to Intrexx, the Intrexx setup file also contains the Intrexx Administration API.
28 irma The user name and password for the Intrexx Administration API are "irma".
29 username: irma
30 password: irma

Check the start of the IAA service

After the installation, you can check whether the Intrexx Administration API service has been started.

Start a terminal.

Check the started services with "systemctl".

The following entry is displayed when the Intrexx Administration API is started. (The name displayed on the left contains the value of the "name" parameter in line 20. You can freely assign this value)

upix_admin_api_intrexx-12.service loaded active running Intrexx Administration API

 

Delete configuration file after installation
After installing the Intrexx Administration API, it is recommended to delete the manually created configuration.yml, as it contains passwords in plain text.
You can assign a new password for IAA users at any time. See section Assign and manage passwords.

More information

Install Intrexx using a configuration file (headless)