Upgrade
Software upgrades and OFML data updates are separate tasks. To update manufacturer data in an existing environment, use the configured DataClient update script.
Prepare a software upgrade
Check the System Requirements, 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.
- Stop
OCF_EAIWSandOCF_Licenseserverin Windows Services. - Back up the license files from
<installPath>\pCon\EAILS\etc\licensesand retain the complete installation backup. - Remove the old
<installPath>\pCon\EAILSdirectory and, if present, the old bundledjdk1.8*directory under<installPath>\pCon. Only remove the Java directory belonging to this installation. - Rename the existing
<installPath>\pCon\EAIWSdirectory, for example toEAIWS_old, so its plugins and configuration remain available. - Open Command Prompt as administrator and remove the old service registrations:
sc.exe delete OCF_Licenseserver
sc.exe delete OCF_EAIWS
-
In the new package’s
config.xml, retain the required paths and settings and set theinstallattributes of bothiisanddataclienttofalse. This preserves the existing IIS and DataClient setup during reinstallation. -
Run the installer as described in Windows Installation and check its output.
-
Copy the following directories from the saved EAIWS installation into the new
<installPath>\pCon\EAIWSdirectory. The listed paths are relative to the EAIWS directory:pluginsetc/pricingetc/pluginsetc/startup
Check the Download Center for updated versions of your plugins. Review any other custom settings from your backup before applying them to the new installation.
-
Restore the
.licfiles to<installPath>\pCon\EAILS\etc\licensesin the new installation. -
Stop
OCF_EAIWSandOCF_Licenseserverif the installer has already started them. -
Start
OCF_Licenseserverand check the latest EAILS log for errors. -
Once EAILS is running correctly, start
OCF_EAIWSand check the latest EAIWS log. -
Complete Verify the Installation before restoring client traffic.
Linux
Use the replacement RPM or DEB packages appropriate for the supported distribution. The Linux Installation 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 before restoring client traffic.