Datacap Navigator installation steps

Datacap Navigator is installed as a plug-in to IBM® Content Navigator.

Before you begin

Ensure that the following prerequisites for using Datacap Navigator are met:

  • Datacap Web Services (wTM) are installed and configured. For instructions, see Datacap Web Services installation steps.
  • Appropriate version of IBM Content Navigator is installed and running. For more information on compatible version, see Software compatibility report.
  • Datacap applications are configured.
  • You have administrator privileges on your scan workstation. The first time that you scan, you are prompted to download and run an installation program for Web TWAIN Scan. Workstation Administrator privileges are required to run the installation program. Alternatively, you can install Web TWAIN manually by using an MSI file: Datacap_installation\tmweb.java\DynamicWebTWAINHTML5Edition.msi. You can also deploy Web TWAIN to client computers by using a Windows Group Policy; for instructions, see https://support.microsoft.com/en-us/kb/816102.

Procedure

To install Datacap Navigator:

  1. Access the IBM Content Navigator administration tool. In a browser, enter a URL with the following format: 
    http://host_name:port_number/context_root/?desktop=admin
    By default, the context root is navigator.
  2. Select Plug-ins and click the New Plug-in button.
  3. In the JAR file path field, enter the location of the Datacap Navigator plug-in file: DatacapWebPlugin.jar. You can enter the URL or the fully qualified path of the plug-in file.
    By default, the plug-in file is installed in the Datacap_install/tmweb.java/ directory. If the plug-in file can be accessed directly, enter the fully qualified path of the plug-in file.
    For example:
    On Windows: C:\datacap\tmweb.java\DatacapWebPlugin.jar
    On AIX: opt/DatacapWebPlugin.jar

    If the plug-in file is published on a web server, you can enter the URL of the plug-in file.

    Attention: Ensure that the plug-in file is not in your JDBC directory or in a directory that is included in the class path of your web application server. Otherwise, the plug-in will fail to load and the following error will be generated:
    java.lang.NoClassDefFoundError: com.ibm.ecm.extension.Plugin
  4. Click Load.
    The Datacap Client plug-in configuration page loads.
  5. Optional: In the Application field, enter the name of the application to use with default Datacap desktops.
    Later, you can add more applications. For instructions, see Adding applications to Datacap Navigator.
  6. Optional: In the Datacap wTM URI field, enter the Datacap Web Services URI that will be used to connect to your Datacap server.
    For example: http://9.126.73.125:808/ServicewTM.svc.
  7. Optional: Click Generate Default Desktop to create default Datacap desktops.
    To modify the default desktops or create more desktops, see Customizing Datacap Navigator desktops.
  8. Click Save and Close.
  9. Logon to your client browser and clear browser cache.
  10. If Datacap Web Services are installed on IBM WebSphere® Application Server, restart WebSphere Application Server.
  11. Validate that you can access Datacap Navigator.
    For more information, see Datacap Navigator access.