Knowledgebase: Advisories
Advisory: Java 9 RE usage with FileCatalyst Applications
Posted by Aly Essa, Last modified by Aly Essa on 30 October 2017 12:22 PM

Overview
With Oracle releasing Java 9, clients may encounter issues running older versions FileCatalyst applications. This issue will only impact clients using Windows and Linux Environments.

The resolution section will outline how to configure the various FileCatalyst Direct Applications for use with Oracle Java 9.

The parameter that needs to be added is located in the Java Additional Properties section in the FileCatalyst configuration file.

As of v3.7.1, the default Java Additional Properties Section contains the following:

# Java Additional Parameters
wrapper.java.additional.1=-XX:MaxDirectMemorySize=1G
wrapper.java.additional.2=-XX:+UseConcMarkSweepGC
wrapper.java.additional.3=-Dsun.java2d.noddraw=true
wrapper.java.additional.4=-Dcom.sun.management.jmxremote.authenticate=false
wrapper.java.additional.5=-Djava.rmi.server.hostname=localhost
wrapper.java.additional.6=-Dcom.sun.management.jmxremote
wrapper.java.additional.7=-Dcom.sun.management.jmxremote.port=11392
wrapper.java.additional.8=-Dcom.sun.management.jmxremote.ssl=false
wrapper.java.additional.9=-Dcom.sun.management.jmxremote.authenticate=false

Please note that if you modify the configuration file as instructed in the resolutions below, older versions of Java (JRE or JDK 6/7/8) will be unusable.

Environment
Oracle Java JRE/JDK v9.0 only.
FileCatalyst Direct Suite v3.7.1 and older.

Resolution

  1. FileCatalyst Server
    • Shutdown the FileCatalyst Server and the FileCatalyst Server Remote Admin.

      • Windows
        • Open the fcconf.conf file in a text editor.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the fcconf.conf file and start the FileCatalyst Server service.

      • Linux
        • Open the wrapper.conf file using vi or nano. This file can be found in the conf directory of your installation folder.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the wrapper.conf file and start the FileCatalyst Server service.

        • If your FileCatalyst Server is running standalone you will need to add the following parameter to the fc_server.sh file before the -jar:

          java -Djava.library.path=. -Dsun.java2d.d3d=false -Xms64M -Xmx1024M -XX:MaxDirectMemorySize=512M -XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind -jar

  2. FileCatalyst HotFolder
    • Shutdown the FileCatalyst HotFolder and the FileCatalyst HotFolder Remote Admin.

      • Windows
        • Open the fchf.conf file in a text editor.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the fchf.conf file and start the FileCatalyst Server service.

      • Linux
        • Open the wrapper.conf file using vi or nano. This file can be found in the conf directory of your installation folder.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the wrapper.conf file and start the FileCatalyst Server service.

        • If your FileCatalyst HotFolder is running standalone you will need to add the following parameter to the fc_hotfolder.sh file -jar:

          java -Djava.library.path=. -Dsun.java2d.d3d=false -Xms64M -Xmx1024M -XX:MaxDirectMemorySize=512M -XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind -jar

  3. FileCatalyst Central
    • Shutdown the FileCatalyst Central service.

      • Windows
        • Open the mawrapper.conf file in a text editor.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the mawrapper.conf file and start the FileCatalyst Central service.

      • Linux
        • Open the wrapper.conf file using vi or nano. This file can be found in the conf directory of your installation folder.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the wrapper.conf file and start the FileCatalyst Central service.

  4. FileCatalyst TransferAgent
    • Shutdown the FileCatalyst TransferAgent service or standalone application.

      • Windows
        • Open the tawrapper.conf file in a text editor.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the tawrapper.conf file and start the FileCatalyst TransferAgent service or standalone application.

      • Linux
        • Open the wrapper.conf file using vi or nano. This file can be found in the conf directory of your installation folder.
        • Locate the # Java Additional Parameters section.
        • Add the following property and increment the parameter integer. Using the defaults above your entry will look like:

          wrapper.java.additional.10=-XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind

        • Save and close the wrapper.conf file and start the FileCatalyst Central service.

        • If your FileCatalyst TransferAgent is running standalone you will need to add the following parameter to the fc_transferagent.sh file before the -jar:

          java -Djava.library.path=. -Dsun.java2d.d3d=false -Xms64M -Xmx1024M -XX:MaxDirectMemorySize=512M -XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind -jar

  5. FileCatalyst CLI/API/SDK

    • When constructing your call add the -XX:+IgnoreUnrecognizedVMOptions --add-modules=java.xml.bind parameter before you call the -jar file.

Comments (0)