---
title: "Linux Installation"
slug: "guide/installation/linux"
sidebar:
  order: 2
---

## Prepare the packages

Check the supported distributions and required libraries in [System Requirements](/pCon/configuratorOnline/specs/guide/prerequisites). Download the Linux [EAIWS installation package](https://download-center.pcon-solutions.com/?cat=7) for your distribution and the [DataClient package](https://download-center.pcon-solutions.com/?cat=90).

Extract the EAIWS ZIP archive, for example under `/tmp/EAIWS_4.20`. It contains packages for EAILS, EAIWS, their service integration (`eails-init` and `eaiws-init`), and the `eaiws` account (`eaiws-user`). Use the filenames supplied in your package; replace the example filenames below if they differ.

Run the package installation and service-management commands as root, or with `sudo`. The examples use `/opt/pCon` as the installation root.

## Install EAIWS and EAILS

### RPM packages

Ensure that [Java 21](/pCon/configuratorOnline/specs/guide/prerequisites/java-runtime-environment) and the [required Linux libraries](/pCon/configuratorOnline/specs/guide/prerequisites/operating-system) are installed. Install the RPM packages from the extracted directory:

```sh
yum install /tmp/EAIWS_4.20/*.rpm
```

### Debian packages

Install `gdebi-core` and Java 21. The following example configures the Eclipse Adoptium repository and installs Temurin 21:

```sh
apt install gdebi-core
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list
apt update
apt install temurin-21-jdk
```

Change to the directory containing the extracted DEB packages and install them in this order:

```sh
gdebi eaiws-user_1.0.0-1_all.deb
gdebi eails_1.3.0-1_amd64.deb
gdebi eails-init_1.0.1-1_amd64.deb
gdebi eaiws_4.20-1_amd64.deb
gdebi eaiws-init_1.0.0-1_amd64.deb
```

### Installed directories and services

The installation creates `/opt/pCon/EAILS` and `/opt/pCon/EAIWS` and registers `eails.service` and `eaiws.service`.

## Install required plugins

Download any required EAIWS plugins from the [Download Center](https://download-center.pcon-solutions.com/?cat=7) and extract them into `/opt/pCon/EAIWS/plugins`. Plugins are installed manually. Ensure that the EAIWS service account can access the extracted files.

## Activate licenses and start the services

Find the host name and host ID near the beginning of an EAILS log file in `/opt/pCon/EAILS/var/log`. Send the log file, or its `hostname=..., hostid=...` line, to [EasternGraphics support](mailto:support@easterngraphics.com).

Place the supplied `.lic` files in `/opt/pCon/EAILS/etc/licenses`, then restart the license server:

```sh
systemctl restart eails.service
```

If the services do not start correctly, stop them and start each service individually:

```sh
systemctl stop eails.service
systemctl stop eaiws.service
systemctl start eails.service
systemctl start eaiws.service
```

Check both services:

```sh
systemctl status eails.service
systemctl status eaiws.service
```

Both should report `active (running)`. Review the EAILS and EAIWS logs for startup or license errors. See [Licensing](/pCon/configuratorOnline/specs/guide/licensing) for details.

## Install pCon.update DataClient

1. Create `/opt/pCon/DC` for the `eaiws` account.
2. Extract `pCon.update_DataClient_Linux.zip` into this directory.
3. Ensure that the extracted files belong to `eaiws` and the scripts are executable.
4. As `eaiws`, change to `/opt/pCon/DC/pCon.update/DataClient/bin` and run the PMV enable script once:

```sh
sh ./dc4eaiws_pmv.sh
```

Continue with [OFML Data Setup](/pCon/configuratorOnline/specs/guide/installation/ofml-data).
