› Modules and plugins › Folder Import module › Cloud HyperExtender plugin 2019.2 › Troubleshooting

Troubleshooting

Log file

The log file for the Cloud HyperExtender plugin is available in the following location:

<Ephesoft Installation Folder>JavaAppServer/webapps/ephesoft-cloud-client/WEB-INF/classes/log/cloud-client.log

Incomplete registration

If you attempt to configure the Cloud HyperExtender plugin with invalid connection details, an error message appears "Ephesoft Cloud registration is incomplete. Please ask your system administrator to register first."

If this error occurs, contact your Ephesoft Transact system administrator.

Test classification and extraction

When the Cloud HyperExtender plugin is configured and enabled within a batch class, the Test Classification and Test Extraction actions will not work in that batch class. As a result, an error message appears "Error occurred while breaking multipage tiff or pdf."

This error is expected, as these actions are not supported in batch classes that are configured to use the Ephesoft Cloud HyperExtender plugin.

Save the Cloud HyperExtender configuration

If a cloud-enabled batch fails, ensure that you have saved the Cloud HyperExtender configuration in the respective batch class.

  1. Open the batch class.
  2. Expand Modules > Folder Import > CLOUD_HYPEREXTENDER_PLUGIN, and select Configure. The Cloud HyperExtender configuration screen displays.
  3. Ensure that the plugin is configured and enabled. Click Save.

HTTPS not applied to property files

If your Cloud HyperExtender batches fail with error message, "I/O error on POST request for "http://…" (via the Batch Execution details pane in the Batch Instance screen), and Ephesoft Transact is installed as HTTPS, perform the workaround below to correct the error and change the property files. The same error can be seen in greater detail in the dcma-all.log (located in the following path: <Transact-Installation-Folder>/Application/logs/).

  1. Open the application.properties file in the following path:

    <Transact Installation Folder>/JavaAppServer/webapps/ephesoft-cloud-client/WEB-INF/classes

  2. Locate the following property: cloud.notification.transact-hybrid.url.
  3. Change the property from http://localhost:8080/dcma/ws/hybridplugin/status/notify to https://localhost:<port number>/dcma/ws/hybridplugin/status/notify.
  4. Open the cloud-plugin.properties file in the following path:

    <Transact Installation Folder>/Application/WEB-INF/classes/META-INF/cloud-plugin

  5. Locate the following property: cloud.client.url.
  6. Change the property from http://localhost:8080/ephesoft-cloud-client to https://localhost:<port number>/ephesoft-cloud-client.
  7. Restart the Ephesoft Transact service.
  8. If you have a multi-server environment, repeat steps 1–7 for all Transact nodes in your cluster.

Use Cloud HyperExtender plugin with Oracle 11g and 12c

To use Cloud HyperExtender Plugin with Oracle 11g and 12c, follow the steps below to configure the applications.properties file so that the plugin works as expected.

  1. Open the application.properties file in the following path:

    <Ephesoft_Installation_Directory>/JavaAppServer/webapps/ephesoft-cloud-client/WEB-INF/classes/application.properties

  2. Under the ## Data Source configurations section, make the following changes for the following options:

    • spring.jpa.properties.javax.persistence.schema-generation.create-source=metadata

    • spring.jpa.properties.javax.persistence.schema-generation.scripts.action=create

    • spring.jpa.properties.javax.persistence.schema-generation.scripts.create-target=${EPHESOFT_HOME}/JavaAppServer/webapps/ephesoft-cloud-client/WEB-INF/classes/schema.sql

      spring.datasource.initialization-mode=always

    • spring.datasource.continue-on-error=true

  3. Restart the Ephesoft Transact service.
  4. If you have a multi-server environment, repeat steps 1–3 for all Ephesoft Transact nodes in your cluster.