Windows Installation
Use these steps for an initial installation. For an existing environment, follow Upgrade first.
Prepare the packages
Check the System Requirements. Download the Windows EAIWS installation package and DataClient package. Extract the EAIWS package into a temporary directory.
The installer uses the directory configured by installPath in config.xml as its destination. Throughout this guide, <installPath> represents that directory. Replace this placeholder with your actual configured path; the pCon subdirectory is appended to it. The directory where you extract the installation package does not determine the installation destination.
Install EAIWS and EAILS
- Edit the package’s
config.xml, includinginstallPathanduseSSL, to match your environment. - Open PowerShell as administrator and change to the package’s
installdirectory. - Run the installer:
PowerShell.exe -ExecutionPolicy Bypass -File .\install.ps1
Check the installer output. The installation creates the pCon\EAILS and pCon\EAIWS directories under the directory specified by installPath and registers the Windows services OCF_Licenseserver and OCF_EAIWS.
Install required plugins
Download any required EAIWS plugins from the Download Center. Extract their ZIP packages into the pCon\EAIWS\plugins directory under the directory specified by installPath in config.xml. Plugins are installed manually rather than through a separate installer.
Activate licenses and start the services
- Find the host name and host ID near the beginning of an EAILS log file in
<installPath>\pCon\EAILS\var\log. - Send the log file, or its
hostname=..., hostid=...line, to EasternGraphics support to obtain the license files. - Place the supplied
.licfiles in<installPath>\pCon\EAILS\etc\licenses. - Open Windows Services and restart
OCF_Licenseserver. Ensure thatOCF_EAIWSis running as well. - Check the latest EAILS and EAIWS logs for license or startup errors.
See Licensing for the detailed reference.
Install pCon.update DataClient
Complete the following steps in order: extract DataClient, install the Microsoft Visual C++ Redistributable (VCRedist), and run the PMV enable script. Before configuring licensing in DataClient, continue to OFML Data Setup and complete the account, server-license and refresh-token preparation described there.
Extract the DataClient package
Create <installPath>\pCon\DC and extract pCon.update_DataClient_Windows.zip into it. The extracted DataClient directory should be <installPath>\pCon\DC\pCon.update\DataClient.
Install Microsoft Visual C++ Redistributable (x64)
Install the VCRedist prerequisite supplied with DataClient by opening:
<installPath>\pCon\DC\pCon.update\DataClient\prerequisites\vc_redist.x64.exe
Complete the redistributable’s installation before running the PMV enable script or using DataClient. Extracting the ZIP archive alone does not perform this installation.
Alternatively, run the installer from Command Prompt using the commands below. Replace YOUR_INSTALL_PATH with the value of installPath from config.xml, without a trailing backslash. PCON_ROOT is a variable for these commands; the installer does not set it automatically.
set "PCON_ROOT=YOUR_INSTALL_PATH\pCon"
"%PCON_ROOT%\DC\pCon.update\DataClient\prerequisites\vc_redist.x64.exe"
Run the PMV enable script
After installing VCRedist, run the following batch file once:
<installPath>\pCon\DC\pCon.update\DataClient\bin\dc4eaiws_pmv.bat
If using the same Command Prompt with PCON_ROOT defined above, run:
"%PCON_ROOT%\DC\pCon.update\DataClient\bin\dc4eaiws_pmv.bat"
Complete OFML setup prerequisites before configuring DataClient licensing
Before configuring licensing in DataClient, first follow the account and refresh-token instructions in OFML Data Setup. Ensure that the pCon.login account has a pCon.update DataClient for Server license and obtain its refresh token. These prerequisites must be ready before you configure DataClient authentication in the update script.
Follow the sequence on that page:
- Prepare the pCon.login account, server license and refresh token.
- Then configure DataClient licensing and authentication using that token in the Windows update script. Set the DataClient and EAIWS paths, data destination, update source and startup-file refresh command as described in OFML Data Setup.
- Run the update script to install OFML data from pCon.update Server or a local package directory.
- Create the EAIWS session start-up file and connect it to the installed catalog profiles or registration file.
Finally, Verify the Installation. DataClient installation is only the first part of making OFML data available to EAIWS.