How to download, install and run

The process of downloading, installation and running the IUCLID Integration Platform is nearly identical to the one of the CropLife Europe eSubmission builder, as the technical architecture is identical. Also, the installation and runtime requirements are identical (e.g. supported browser types).

Therefore, please read the respective information for the eSubmission builder first. You can then apply those instructions one by one, by modifying the information respectively (e.g. the path name, the name of the startup scripts etc.). Please note that the version of the application server WildFly can differ between the two programs, which is not relevant to the installation procedure.

After starting the IIP with the startup script in the root directory, a successfull startup looks like this:

 

Please minimize this window and pay attention that you do not click inside of it. Do not close this window, as this will stop the application.

After the IIP being sucessfully started as in the example above, you can click on the shortcut supplied in the root installation folder to open the application in the standard browser.

Installation configuration

Demo mode

The IIP supports a demo mode for CSV upload. This means that a specific field in the target entity is filled with a fixed string "Created by IUCLID Integration Platform", eventually overwriting the data provided in the CSV.

The demo mode allows to

  • quickly see the instances created / updated by the IIP (eventually use the Advanced Search in the IUCLID web interface)
  • delete all instances created in demo mode - to repeatedly test the functionality of the IIP (see the Administration perspective). Please note that the deletion will only affect the instances with the respective fixed string, not any other instances.

The demo mode can be turned on / off in the configuration file "wildfly-23.0.0.Final\standalone\configuration\standalone.xml" by setting the value of the property iuclid.demoMode to true or false:

    <system-properties>
        <property name="iuclid.demoMode" value="true"/>
        ...
    </system-properties>

Accept all certificates

In case you enter the IUCLID connection information and you receive an error of type

Iuclid request failed: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

then this means, that the certificate of IUCLID is not trusted and not part of the local Java certificate cache cacerts. If you cannot solve the root problem directly, you can configure the IIS to accept all incoming certificates by setting the configuration parameter security.trustall to "true". It is set to "false" by default.

The parameter can be changed in the configuration file "wildfly-23.0.0.Final\standalone\configuration\standalone.xml":

    <system-properties>
        <property name="security.trustall" value="true"/>
        ...
    </system-properties>

Proxy server configuration

If the IIP and the IUCLID instance are in different networks separated by a proxy server, the IUCLID connection may fail. In this case, the proxy information has to be supplied as JVM parameters either in the startup scripts of the application server or in its admin consule. This has to be tested individually. Please consult your local IT for details.