Skip to main content
Kofax

MarkView File Capture - Setting up multiple JVMs for a single OC4J instance - MarkView File Capture restrictions

Summary 

4601

Applies To

  • ERP System: ( Oracle, SAP )
  • MarkView Version: (All versions with File Capture Installed.)

Behavior

  • OC4J executes on the Java Virtual Machine (JVM) of the standard Java Development Kit (JDK). By default, each OC4J instance uses one JVM. Is it possible to configure an OC4J instance to run on multiple JVMs in an environment with File Capture installed?

Known Causes

  • You can modify the number of JVMs an OC4J instance runs on by modifying the Server Properties page for the OC4J instance. However there are some restrictions.
    The File Capture module cannot be in an OC4J group that runs multiple JVMs.

Resolution

  • If you wish to scale up the number of JVMs, you must:
    1. Un-deploy the "filecapture" module from the existing OC4J group (i.e. the group that currently contains all of the modules).
    2. Set up a second OC4J group containing the "filecapture" module which will run on only one JVM.
  • Though specific instruction may depend on your OAS version, and your own configuration approach, the following steps have been used to successfully implement the approach detailed above.
    1. Create a new OC4J instance and assign it to a new group:
      • Go to Clustered Topology, click on the application server link and click on "Create OC4J instance".
      • Enter the name of the instance (e.g., "filecapture") and choose a new group (e.g., "filecapture_group")
      • This group should look just like the "markview" group from the configuration point of view, except that it will run on only 1 JVM, so ensure that you set all the server properties to be the same as thos in the original group.
      • After you created the "filecapture" group, click on it (on Groups section), go to the Administration tab and click on Server Properties.
      • Set Maximum heap size to 1024m, Initial heap size to 512m
      • Check that under start parameters java options you have -XX:MaxPermSize=128M (If you do not have this option, you will need to add it).
        NOTE: These memory parameter values are the minimum requirements, you should, however, set them to the same values as those in the original group.
    2. Using the nterprise Manager you will need to manually create the Connection Pool, and Data source for the new database following the steps below:
      • Launch the Oracle Enterprise Manager in a web-browser and select the OC4J server where you want the MarkView OC4J's installed.
      • Select Administration.
      • Select JDBC Resources ¦ Go to Task.
      • Under the Connection Pools heading, click Create.
      • Keep the default settings, click Continue, and complete the fields as follows:
      • For Name, enter MVConnectionPool.
      • For JDBC URL, replace the default text (jdbc:oracle:thin@//localhost:1521/mydb.com) with information about the database where MarkView is installed.
        For example, jdbc:oracle:thin@//server.company.com:port/SID
        Note: Do not click Test Connection until you enter user information.
      • Under Credentials, enter the username and password of the MarkView user.
      • Click Test Connection, which verifies that you entered correct information.
      • Click Finish.
      • Under the Data Sources heading, click Create.
      • Keep the default settings (Managed Data Source), click Continue, and complete the fields as follows:
        • For Name, enter MarkViewDS.
        • For JNDI location, enter jdbc/MarkViewDS.
        • For Connection Pool, select MVConnectionPool. Keep the defaults for the other fields, and click Finish.
    3. Check if you still have the product distribution on your system. If you don't have it, then copy the filecapture.ear from ${ORACLE_HOME}/j2ee/<name of the original oc4j instance>/applications/ into a place from where you can take them when you want to deploy them (Step 4)
    4. Un-deploy "filecapture" from the OC4J instance you used to install "filecapture" initially. 
      • To do so, launch the Oracle Enterprise Manager in a Web browser and select the new OC4J server (filecapture).
      • Go to the Applications tab, "filecapture" and click un-deploy.
    5. Deploy "filecapture" on the new OC4J you created ("filecapture" here).
      • To do so, launch the Oracle Enterprise Manager in a Web browser and select the new OC4J server (filecapture).
      • Go to the Applications tab, click deploy and deploy the "filecapture" ear file.
    6. Confirm that the File Capture application is operational.

Keywords: mvfc, filecapture