---
title: "Upgrade"
slug: "guide/installation/upgrade"
sidebar:
  order: 5
---

Software upgrades and OFML data updates are separate tasks. To update manufacturer data in an existing environment, use the configured [DataClient update script](/pCon/configuratorOnline/specs/guide/installation/ofml-data).

## Prepare a software upgrade

Check the [System Requirements](/pCon/configuratorOnline/specs/guide/prerequisites), including Java 21, before upgrading. Back up the existing installation, licenses and configuration, and retain the currently installed packages so that you can restore the previous environment if necessary. Plan a maintenance window and stop client traffic before stopping the services.

## Windows

The Windows installer is intended for initial installation. To use it when replacing an existing installation, prepare the old installation as follows. Here, `<installPath>` represents the destination configured in `config.xml`, with the `pCon` subdirectory below it. Use the existing installation's path when backing up or removing old files and the new package's configured path when restoring them.

1. Stop `OCF_EAIWS` and `OCF_Licenseserver` in Windows Services.
2. Back up the license files from `<installPath>\pCon\EAILS\etc\licenses` and retain the complete installation backup.
3. Remove the old `<installPath>\pCon\EAILS` directory and, if present, the old bundled `jdk1.8*` directory under `<installPath>\pCon`. Only remove the Java directory belonging to this installation.
4. Rename the existing `<installPath>\pCon\EAIWS` directory, for example to `EAIWS_old`, so its plugins and configuration remain available.
5. Open Command Prompt as administrator and remove the old service registrations:

```bat
sc.exe delete OCF_Licenseserver
sc.exe delete OCF_EAIWS
```

6. In the new package's `config.xml`, retain the required paths and settings and set the `install` attributes of both `iis` and `dataclient` to `false`. This preserves the existing IIS and DataClient setup during reinstallation.
7. Run the installer as described in [Windows Installation](/pCon/configuratorOnline/specs/guide/installation/windows) and check its output.
8. Copy the following directories from the saved EAIWS installation into the new `<installPath>\pCon\EAIWS` directory. The listed paths are relative to the EAIWS directory:

   - `plugins`
   - `etc/pricing`
   - `etc/plugins`
   - `etc/startup`

   Check the [Download Center](https://download-center.pcon-solutions.com/?cat=7) for updated versions of your plugins. Review any other custom settings from your backup before applying them to the new installation.

9. Restore the `.lic` files to `<installPath>\pCon\EAILS\etc\licenses` in the new installation.
10. Stop `OCF_EAIWS` and `OCF_Licenseserver` if the installer has already started them.
11. Start `OCF_Licenseserver` and check the latest EAILS log for errors.
12. Once EAILS is running correctly, start `OCF_EAIWS` and check the latest EAIWS log.
13. Complete [Verify the Installation](/pCon/configuratorOnline/specs/guide/installation/verification) before restoring client traffic.

## Linux

Use the replacement RPM or DEB packages appropriate for the supported distribution. The [Linux Installation](/pCon/configuratorOnline/specs/guide/installation/linux) page documents package prerequisites and installation order. Retain your existing data, license files, plugins and custom configuration during the upgrade.

Stop the EAIWS and EAILS services before replacing the packages. After package installation, review the retained configuration and any package-manager configuration-file prompts, start EAILS before EAIWS, and check both logs. Complete [Verify the Installation](/pCon/configuratorOnline/specs/guide/installation/verification) before restoring client traffic.
