7 Troubleshooting

This chapter contains the following topics:

7.1 Manually Deploying the EnterpriseOne Container and ADF Application to Weblogic

This section describes how to deploy the JDEADFContainer .EAR file.

  1. Open the Weblogic Server application.

  2. In the Domain Structure area located on the left side of the screen, click Deployments.

  3. In the Change Center area located on the left side, above the Deployments area, click the Lock & Edit button.

  4. In the Summary of Deployments area, click the Install button.

    The Install Application Assistant displays.

  5. In the Deployment Archive section, click the Choose File button.

  6. Locate the JDEADFContainer.ear file, select it, and then click the OK button.

  7. Click the Next button.

  8. Click the Next button.

  9. Click the Next button.

  10. In the Available targets for JDEADFContainer-2 section, select the ADF server to which you want to install the JDEADFContainer.ear file, and then click the Next button.

  11. Click the Finish button.

    The JDEADFContainer.ear file installs on the ADF server.

  12. After the JDEADFContainer.ear file installs, in the Change Center area located on the left of the screen, click the Activate Changes button.

  13. On the Control tab located in the center of the screen, select the ADF Server you just installed, and then select the Servicing all Request option located on the corresponding drop-down menu.

  14. Click the Yes button to start the JDEADFContainer.ear file.

    The Start Deployments screen displays.

  15. Click the Yes button.

  16. Verify that final state of the container is Active.

7.2 Build Scripts Additional Information

There are two Ant scripts required to install and deploy ADF libraries on a Weblogic server. Both Ant scripts use the wldeploy task to deploy artifacts to server instances or clusters on a Weblogic server. Both of the Ant scripts provide these additional targets:

Ant Script Target Description
clean Removes the build and deploy directories.
usage Displays a list of command line options that will provide additional information about Ant or the build scripts.
undeploy Removes the JDEADFContainer.ear or the JDETaskFlowLibrary.war from Weblogic server, depending on which ant script is executed.

7.3 Executing the Build Script from JDeveloper

The JDE Ant build files can be executed from within JDeveloper by adding the Ant targets to the Tools menu as External Tool executables.

To execute Ant Targets from JDeveloper menu

  1. In JDeveloper, click Tools, then External Tools, and then select New from the External Tools dialog box.

  2. Click Next.

  3. Browse to the Ant build file you want to run, and click Next.

  4. Move the build-and-deploy target to the Selected Targets field, and then click Next.

  5. Set the Weblogic username and password properties needed for the build-and-deploy, deploy, and undeploy targets only. For any other Ant target in the script, these properties are not used.

    The administrative username - weblogic.username

    The administrative password - weblogic.password

  6. Select the Use Default Ant Version option, and then click Next.

  7. Specify the options for the Ant process, and then click Next.

  8. The Weblogic.jar includes the class definition for the wldeploy Ant task used to deploy/undeploy files to/from a Weblogic server. The Weblogic.jar file can be found in the <Weblogic_HOME>/server/lib directory, where Weblogic_HOME is the top-level directory of your Weblogic Server installation. This step is not necessary for any other Ant target in the build scripts.

  9. Enter a caption for the menu item, and then click Next.

  10. Select the Tools Menu option for the Add Items to Menus list, and then click Next.

  11. Select Always, and then click Finish.

    Once the Ant target is added, it can be executed from the Tools menu. During execution, the Apache Ant log will display the Ant target's status and display messages if any exceptions are thrown.

7.4 EnterpriseOne ADF Deployment Additional Information

EnterpriseOne ADF application deployment supports clustering.

7.5 Error Messages and their Meanings

This section describes error messages you may see and provides an explanation of what they mean:

  1. Error: System issues prevent the application from opening. Please contact your system administrator.

    The EnterpriseOne HTML server Jas log would contain additional information: "The external application launch has failed. The handshake id is null or never completed its initialization. Verify that your system is running and its ini settings are properly configured."

    As the message notes, the handshake ID is either null or blank. Potential reasons for this situation could be 1. jasWhitelist on ADF server is not configured correctly and 2. AIS or ADF server(s) is (are) down.

  2. Error: Invalid application data. Please contact your system administrator.

    Ensure that the proxy application associated with the EnterpriseOne ADF application is properly defined and secured. Users could see this error message if the EnterpriseOne task containing the EnterpriseOne ADF application lacks a proxy app and/or task flow path/url. See the JD Edwards EnterpriseOne Tools Solution Explorer guide for additional details on this EnterpriseOne ADF application task).

7.6 ADF Charts

The ADF charts continue trying to load when there is not a monitor associated with the server. When this happens, the following error appears in the Weblogic Server Diagnostic logs:

Can't connect to X11 window server using '' as the value of the DISPLAY variable.

To fix this circumstance, configure the server instances with the following Java property set to "true":


Setting this property to "true" prevents the Java runtime from attempting to find a monitor to get the DISPLAY variable.

To configure this property in WebLogic Server:

  1. On the Server Start tab, add -Djava.awt.headless=true in the Arguments field.

  2. Click Save.

  3. Restart the managed instance.

7.7 Host Verification Errors, or Failure to Open ADF Application

If you have configured a reverse proxy and enabled Secure Sockets Layer (SSL), ensure that the Host Verification setting is set to None. You can locate this setting on your Web Logic Server, on the SSL tab, in the Advanced section.