6 Completing the Imaging Configuration

This chapter explains how to complete the initial configuration of Oracle WebCenter Content: Imaging in an Oracle WebLogic Server domain.

This chapter includes the following sections:

6.1 Completing the Initial Imaging Configuration

Before you complete the configuration of Imaging, your system needs to have Oracle WebCenter Content installed and configured. Imaging uses WebCenter Content for its repository.

You can use either WebCenter Content 11g or Oracle Universal Content Management (Oracle UCM) 10gR3 as the Imaging repository. For information about configuring WebCenter Content 11g, see Chapter 3, "Configuring Oracle WebCenter Content Applications," Chapter 4, "Completing the WebCenter Content Configuration," and Section 6.1.1.1, "Configuring WebCenter Content 11g to Work with Imaging." For information about using Oracle UCM 10gR3 as the repository, see Section 6.1.1.2, "Installing and Configuring Oracle UCM 10gR3 to Work with Imaging."

Note:

In a production system, Oracle WebCenter Content applications need to use an external Lightweight Directory Application Protocol (LDAP) authentication provider rather than the Oracle WebLogic Server embedded LDAP server, which is part of the default configuration. If you want to reassociate the identity store for Imaging with an external LDAP authentication provider, it is easier to do this before you complete the configuration of the Imaging Managed Server and before you connect it to the WebCenter Content 11g or Oracle UCM 10gR3 repository. For more information, see Section 3.9, "Reassociating the Identity Store with an External LDAP Authentication Provider."

The user who logs in first to an Imaging Managed Server is provisioned with full security throughout the server. When this user first logs in, Imaging provides a user interface to complete the configuration, including connecting to a repository or repositories and, optionally, to a workflow server.

If a value is specified in the DefaultSecurityGroup MBean before Imaging security is initialized, then when the first user logs in, the specified group is given full administrative permissions as well as the user logging in.

To complete the Imaging configuration, you need to perform all of the following tasks that apply to your system:

  1. Configuring a WebCenter Content Repository for Imaging

  2. Starting the Administration server and the WebCenter Content Managed Server, as described in Chapter 9, "Verifying the Oracle WebCenter Content Configuration"

  3. Starting the Imaging Managed Server and Accessing the Web Client

  4. Connecting to a WebCenter Content Repository

  5. Connecting to a Workflow Server

  6. Configuring the GDFontPath MBean for a UNIX System

  7. Setting DISPLAY for the Imaging Viewer in a UNIX Exalogic Environment with Solaris 11g

  8. Importing Definitions

6.1.1 Configuring a WebCenter Content Repository for Imaging

You can configure either WebCenter Content 11g or Oracle UCM (Oracle Content Server) 10g R3 as the repository for Imaging.

Note:

You will not be able to import or upload content to the Imaging system unless you have created a repository connection.

6.1.1.1 Configuring WebCenter Content 11g to Work with Imaging

WebCenter Content 11g is installed with Oracle WebCenter Content. When a WebCenter Content Managed Server and Imaging Managed Server are configured in an Oracle WebLogic Server domain on the same host machine, the configuration of WebCenter Content 11g to work with Imaging is automatic.

If WebCenter Content is installed in a domain that is later extended with Imaging, then WebCenter Content will not be reconfigured to work with Imaging until the next restart of the WebCenter Content Managed Server. In this case, you must restart WebCenter Content, as described in Section 9.3, "Restarting a Managed Server," before connecting to Oracle WebCenter Content Server from the Imaging web client, as described in Section 6.1.3, "Connecting to a WebCenter Content Repository."

If the WebCenter Content and Imaging Managed Servers are configured to run on different machines, configuring Imaging will not configure WebCenter Content to work with it. In this case, you must follow the manual configuration steps to configure WebCenter Content.

To configure WebCenter Content 11g manually to work with Imaging:

  1. Start the WebCenter Content Managed Server, as described in Section 9.2, "Starting Managed Servers."

  2. Access Content Server, as described in Section 4.3.1, "Starting Content Server."

  3. Enable the IpmRepository component:

    1. Choose Admin Server from the Administration tray or menu.

    2. On the Content Admin Server Component Manager page, select Integration.

    3. Select IpmRepository, and click the Update button.

      This option is selected by default if the Oracle WebLogic Server domain was configured with Fusion Middleware Configuration Wizard. If this option is already selected, you can close the Component Manager without clicking Update or restarting Content Server.

    4. Click the OK button to enable this feature.

    5. Restart Content Server, as described in Section 9.3, "Restarting a Managed Server."

      If IpmRepository was already selected, you do not need to restart the server.

6.1.1.2 Installing and Configuring Oracle UCM 10gR3 to Work with Imaging

For an Oracle UCM 10gR3 repository, Imaging requires Oracle Universal Content Management 10gR3 (10.1.3.3.3), also referred to as Oracle Content Server 10gR3. After installing and configuring Oracle Content Server 10gR3, you need to update the system with the Content Server 10g Update Bundle. Both are required for Oracle UCM 10gR3 to work with Imaging 11g.

Note:

When you install the Update Bundle, you also need to install the new Content Access component.

You can download both Oracle Content Server 10gR3 and the Content Server 10g Update Bundle from the Oracle Software Delivery Cloud or Oracle Technology Network (OTN). For more information about the software locations, see Section 1.2.2, "Software Downloads for Oracle WebCenter Content Installation and Configuration."

For information about installing and configuring Oracle UCM 10gR3, see the Oracle Content Server page on Oracle Technology Network at

http://www.oracle.com/technetwork/middleware/content-management/cs-088869.html

If you are using Imaging 11g with Oracle UCM 10gR3, make sure to update Oracle Content Server 10gR3 with the latest update patch.

6.1.1.2.1 Upgrading the JDK Version of Oracle UCM 10gR3

After you deploy Imaging to an Oracle WebLogic Server Managed Server, by creating or extending a domain, you need to upgrade the JDK version of your Oracle Content Server 10gR3 installation to the same JDK 1.6 version that Imaging uses. This is the JDK version that you specified for the Imaging Managed Server on the Configure Server Start Mode and JDK screen of the Fusion Middleware Configuration Wizard. For information about the JDK version that Imaging supports, see the Oracle Fusion Middleware Supported System Configurations page on Oracle Technology Network at

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

Refer to the Oracle Fusion Middleware 11g Release 1 (11.1.1.x) Product Area, System Requirements and Supported Platforms for Imaging and WebCenter Content (xls).

For information about changing the JDK version that Oracle Content Server 10gR3 uses, see Oracle Universal Content Management Content Server Installation Guide, version 10gR3, for your operating system.

6.1.1.2.2 Configuring Oracle Content Server 10gR3 to Work with Imaging

You need to configure Oracle Content Server 10gR3 before it can work with Imaging. During the configuration, restart Oracle Content Server 10gR3 whenever prompted to do so.

To configure Oracle Content Server 10gR3 to work with Imaging:

  1. Update the IP address filter:

    1. On the system where Oracle UCM 10gR3 is installed, run the following command:

      • UNIX command: UCM_ORACLE_HOME/bin/SystemProperties

      • Windows command: UCM_ORACLE_HOME\bin\SystemProperties

    2. With your system's DISPLAY environment variable set to a valid X Server, click the Server tab in the display.

    3. In the IP Address Filter field, add a vertical bar (|) followed by the IP address of the system where Imaging is installed.

      For example: 192.0.2.1|192.0.2.130

      The IP address is required for the Imaging system to have access to the Oracle UCM 10gR3 system without authentication.

    4. Click OK.

      This change will require a restart of Oracle Content Server 10gR3, which you can do at the end of this procedure, after installing the Oracle UCM 10gR3 components.

  2. Open the Oracle UCM 10gR3 web client in a web browser (http://managedServerHost:managedServerPort/location, such as http://myhost.example.com:8000/idc), and log in.

  3. Open the Administration tray.

  4. Upgrade the default file store:

    1. Under Administration, select Providers.

    2. Select Info in the Action column of the DefaultFileStore row.

    3. When asked if you want to upgrade the file store, click Upgrade, and then click Update in the Edit File Store Provider dialog box.

      Oracle UCM 10gR3 does the upgrade automatically.

    Imaging content is not accessible in a web store. Oracle Content Server 10gR3 traditionally uses a weblayout directory on a file system to store content in a format for viewing in a web browser, but this feature does not have much use in an Imaging solution and uses extra disk space. After the file store upgrade, you should disable the weblayout functionality in Oracle Content Server 10gR3 for any file store provider configured for use as an Imaging volume.

  5. Configure system properties:

    1. Confirm that the SearchIndexerEngineName variable matches the type of Oracle UCM 10gR3 system to use (DATABASE.METADATA, DATABASE.FULLTEXT, or OracleTextSearch).

    2. Under Administration tray, select Admin Server.

    3. Click idc.

    4. Select General Configuration, on the left.

    5. Select Automatically assign a content ID on check in.

    6. Specify an Auto Number Prefix value, such as ucm1.

    7. Set the EnableIdcProfileField variable to 1 by adding the following line to the Additional Configuration Variables box:

      EnableIdcProfileField=1
      
    8. Click Save.

  6. Install Oracle UCM 10gR3 components:

    1. Select Component Manager, on the left.

    2. In the Install New Component section, click Browse, browse to the /extras directory, and select any components you want to install.

    3. Click Open.

    4. Click Install.

      If the Component Manager redirects your request to port 80, you can reconfigure your web server to use port 80.

      Restart Oracle Content Server 10gR3 when prompted.

    5. Fill in any necessary details for each component you selected, and then click Continue.

      The menu displays several selections, some of which are checked. You can accept the default selections.

    6. Click here to return to the Component Manager.

    7. In the Install New Component section, click Browse.

    8. Browse to the WCC_ORACLE_HOME/ipm/lib directory, and select IpmRepository.zip.

    9. Click Open.

    10. Click Install.

      Restart Oracle Content Server 10gR3 when prompted.

    11. Click Continue.

    12. Click here to return to the Component Manager.

    13. In the Install New Component section, click Browse and browse to the /extras directory.

    14. Select any components in the /extras directory and IpmRepository.

    15. Click Enable.

    16. Fill in any necessary details for each component you selected, and then click Continue.

      Restart Oracle Content Server 10gR3 when prompted.

    17. Click here to return to the Component Manager.

    18. From the Options list on the left, select Start/Stop Content Server.

    19. Select Restart.

    20. Ensure that Oracle Content Server 10gR3 is running after you restart it.

6.1.1.2.3 Adding the Administrator User and Administrators Group to Oracle UCM 10gR3

You need to add the administrator user to Oracle UCM 10gR3 and assign it to the Administrators group before this user can perform administration tasks on Oracle UCM.

To add the administrator user and Administrators group to Oracle UCM 10gR3:

  1. In the Oracle UCM 10gR3 web client, select Admin Applets under Administration.

  2. Click User Admin.

  3. On the Security tab, select Permissions By Role.

  4. Select Add New Role.

  5. In the Role Name field, enter Administrators.

  6. Click OK.

  7. Click Close.

  8. Click Add.

  9. For Authorization Type: Local, click OK.

  10. Create the administrator user, and enter the password.

  11. Click the Roles tab.

  12. Click Add Role.

  13. Select Administrators, and then click OK.

  14. Click OK.

  15. Close the User Admin applet.

6.1.1.3 Configuring a File Store Provider for Content Storage

An administrator can configure a file store provider in Content Server 11g to control how and where files are stored and managed within Content Server. Instead of storing all content on a single file system, you can use a file store provider to store content across multiple file systems as well as within a database. The File Store Provider component is installed and enabled by default with WebCenter Content installation and configuration.

For Imaging, you should add a file store provider to use instead of the default file store provider. Also, you should disable the traditional web layout functionality for the file store.

The default storage provider configuration that is created during the installation of WebCenter Content is not intended for production document volumes. This default configuration is adequate for proof-of-concept or demonstration systems of fewer than 10,000 documents. Production system configurations require more advanced options to be chosen.

You can configure a file store provider for Oracle Database.

If your WebCenter Content installation uses a Microsoft SQL Server or IBM DB2 database, do not configure a file store provider. If you are configuring a WebCenter Content Managed Server with one of these databases, you need to disable the file store provider that is enabled by default for Content Server.

For more information, see "Managing a File Store System" in Oracle Fusion Middleware Administering Oracle WebCenter Content.

6.1.1.3.1 Configuring a File Store Provider

A file store provider can be a combination of any media supported by Content Server. Because the document storage location is not defined by the media being used for storage, the term volume is used to represent a storage location when an application is defined in the Imaging user interface. Imaging connects to a volume defined and configured in Content Server by an administrator. You cannot use Imaging to create or define a volume.

A Content Server administrator can configure a file store provider. For more information, see "Configuring the File Store Provider" in Oracle Fusion Middleware Administering Oracle WebCenter Content.

6.1.1.3.2 Disabling Web Layout Functionality for Imaging

Content Server traditionally uses a /weblayout directory on a file system to store content in a format for viewing in a web browser, even if the main storage volume is set up in a database. This file system store is useful for making content retrieval faster for a website or for storing a secondary file that describes the primary content item, but it does not have much use in an Imaging solution. Files copied to a /weblayout directory in an exclusively Imaging solution would never get used, taking up unnecessary storage space. Oracle recommends disabling the web layout functionality for any file store provider that is configured for use as an Imaging volume.

Caution:

If your Imaging system will use redactions, do not implement Web Layout. Users might be able to see an unredacted version of a document in the /weblayout directory if Web Layout (IBR) is turn on in an Imaging file store provider.

An administrator can disable the web layout functionality by selecting the Is Webless File Store option on the Add/Edit Storage Rule page for a file store provider in Content Server. For more information, see "Adding or Editing a Storage Rule" in the Oracle Fusion Middleware Administering Oracle WebCenter Content.

6.1.2 Starting the Imaging Managed Server and Accessing the Web Client

After you start the Administration server and the Imaging and WebCenter Content Managed Servers, you can access the Imaging web client.

To access the Imaging web client:

  1. Start the Imaging Managed Server, as described in Section 9.2, "Starting Managed Servers."

    Note:

    If Oracle WebCenter Content: AXF for BPM is deployed to the domain, proceed to Section 6.5.1, "Configuring and Verifying AXF for BPM," before performing any configuration on the Imaging server.

  2. Access the web client at this URL: http://managedServerHost:16000/imaging

    Log in with the administrator user name and password.

    Note:

    This first user to connect to the Imaging system is registered as the Imaging administrator.

6.1.3 Connecting to a WebCenter Content Repository

Before Imaging can use the WebCenter Content repository, you need to configure a connection to Content Server. You can create a connection to it from Imaging.

To connect to a WebCenter Content repository:

  1. Open a web browser, and navigate to this website:

    http://managedServerHost:16000/imaging

  2. Log in with the administrator user name and password.

  3. Navigate to the Manage Connections tray, and choose Create Content Server Connection from the list.

  4. Enter a name for the connection on the Basic Information page and, optionally, a description, and then click Next.

  5. You can change the selections and on the Connection Settings page:

    • SSL: Selected for secure SSL communications

    • Server Port: The IDC port of the WebCenter Content instance, 4444 for Imaging by default

    • Use Local Content Server: Selected by default if Content Server is on the same machine as the Imaging server.

      If the servers are not installed on the same machine, you will need to configure the Content Server machine name as part of the Content Server Pool.

  6. Click Next.

  7. Enter a Connection Security value for the connection.

    Select which users and groups should have permission to access, modify, delete, or grant others access to this connection definition. At least one user or group must have the grant access permission.

  8. Click Next.

  9. At the Summary screen, click Submit.

6.1.4 Connecting to a Workflow Server

A connection to a workflow server (Oracle SOA Suite) is required before you import the definition files. This connection will be necessary for your solution to retrieve your task list. Imaging connects to a workflow server when application fields are mapped to workflow payload elements.

To connect, the provider, port, and credential information is passed using Web Services Inspection Language (WSIL). WSIL uses the HTTP protocol and a specific XML format to allow for the discovery of the web service end points on a server. Imaging follows links in the WSIL that meet certain criteria to discover deployed composites.

The connection can be to an Oracle Business Process Management (Oracle BPM) or Business Process Execution Language (BPEL) server. For Imaging to take advantage of BPM and Oracle BPEL Process Manager within an existing domain, the domain must be extended with Oracle BPM Suite - 11.1.1.0. When Oracle BPM Suite was installed, it automatically selected Oracle SOA Suite - 11.1.1.0 as its dependency. If you want to use Oracle BPEL Process Manager and not Oracle BPM, you can extend the domain with an Oracle SOA Suite installation and configuration. For more information about the installation and configuration steps for Oracle SOA Suite and Oracle BPM, see Oracle Fusion Middleware Installation Guide for Oracle SOA Suite and Oracle Business Process Management Suite.

The following procedures describes how to configure a connection to a workflow server and register the connection in your database. For additional information, see "Creating a Workflow Connection" in Oracle WebCenter Content Administrator's Guide for Imaging.

6.1.4.1 Configuring a Connection to a Workflow Server

If you installed the Oracle SOA Suite for use with Imaging (noted in Section 2.4), such as for AXF for BPM or AXF for BPEL, you need to configure a connection to a workflow server.

To configure a connection to a workflow server:

  1. Open a web browser, and navigate to this website:

    http://managedServerHost:16000/imaging
    
  2. Log in with the administrator user name and password.

  3. Navigate to the Manage Connections tray, and choose Create Workflow Connection from the list.

  4. Enter a name for the connection on the Basic Information page and, optionally, a description, and then click Next.

  5. Optionally, change one or more of the following selections on the Connection Settings page:

    • HTTP Front End Address: The front end address of the workflow server, including the listening port, which is http://<server>:8001 for Oracle SOA Suite by default.

    • Credential Alias: The credential store key for obtaining user and password credentials for the workflow server.

    • Provider: The provider setting can be either the host name or IP address of a single machine, or a comma-separated list of host names or IP addresses for multiple machines in a cluster. The listening port and transport mechanism should be included in the setting.

  6. Click Test Connection to verify the settings.

  7. Click Next.

  8. Enter a Connection Security value for the connection.

    Select which users and groups should have permission to access, modify, delete, or grant others access to this connection definition. At least one user or group must have the grant access permission.

  9. Click Next.

  10. At the Summary screen, click Submit .

6.1.4.2 Adding the Connection to the Database

After you have created a workflow connection, enter the name of that connection in the AXF_SOLUTION_ATTRIBUTES table for your solution. For example, the parameter key for a BPEL server is named WORKFLOW_CONNECTION, and the HelloBPEL sample script uses the connection name test.

6.1.5 Configuring the GDFontPath MBean for a UNIX System

For conversions to work correctly on a UNIX operating system, it needs to have TrueType fonts available. If these fonts are not available on your system, you need to install them. To set the font path on a UNIX operating system, you need to configure the GDFontpath MBean. You can configure it through the System MBean Browser in Oracle Enterprise Manager Fusion Middleware Control.

To configure the GDFontPath MBean for a UNIX system:

  1. Access the Imaging domain in Fusion Middleware Control at the following URL:

    http://adminServerHost:adminServerPort/em
    

    For adminServerHost, specify the name of the computer that hosts the Administration Server for your domain. For adminServerPort, specify the listen port number for the Administration Server. The default number is 7001. For example:

    http://myHost.example.com:7001/em
    

    To log in, supply the user name and password that were specified on the Configure Administrator User Name and Password screen in the configuration wizard.

  2. In the navigation tree on the left, expand WebLogic Domain and the deployed domain.

  3. Right-click IPM_server1, and choose System MBean Browser from the menu.

  4. In the navigation tree on the System MBean Browser page, under Configuration MBeans, close the com.bea folder.

  5. Under Application Defined MBeans, expand the oracle.imaging folder.

  6. Expand the Server: IPM_server1 and config folders.

  7. Click config.

  8. Set the value of the GDFontPath attribute to the location of your True Type Fonts (TTF) files; for example:

    /usr/share/X11/fonts/TTF
    

    For systems on which Oracle WebLogic Server includes a JDK, you can find some TTF files in the JDK/jre/lib/fonts directory.

    Some standard font locations on different UNIX platforms follow:

    • Solaris SPARC: /usr/openwin/lib/X11/fonts/TrueType

      Note:

      For document conversions on a Solaris SPARC platform, Imaging requires the GNU Compiler Collection (GCC) package 3.4.2 or later in the /usr/local/packages directory.

      Install this package on the Solaris operating system that will run Imaging. You can download GCC from the Sunfreeware website at

      http://www.sunfreeware.com
      

      You also need to set the LD_LIBRARY_PATH environment variable to /usr/local/packages/gcc-3.4.2/lib before starting the Imaging Managed Server. If you are using a later version of GCC, set that version instead of 3.4.2.

    • AIX: /usr/lpp/X11/lib/X11/fonts/TrueType

    • HP-UX Itanium: /usr/lib/X11/fonts/TrueType

    • Linux: /usr/lib/X11/fonts/TrueType

  9. Click Apply.

  10. Restart Imaging, as described in Section 9.3, "Restarting a Managed Server."

6.1.6 Setting DISPLAY for the Imaging Viewer in a UNIX Exalogic Environment with Solaris 11g

In an Exalogic environment with Solaris 11g, you need to set the DISPLAY environment variable for the Imaging Viewer to work correctly in basic mode.

To set DISPLAY for the Imaging Viewer in a UNIX Exalogic Environment with Solaris 11g:

  1. Open a new terminal window and run this command:

    xhost +
    
  2. In the Imaging terminal, set the DISPLAY environment variable to the server where Imaging is running and the port, in this format:

    servername:port
    
  3. Restart Imaging, as described in Section 9.3, "Restarting a Managed Server."

6.1.7 Importing Definitions

At this point in the installation process, you can import previously exported Imaging definitions (applications, searches, and inputs). For more information, see "Exporting and Importing Definitions" in the Oracle WebCenter Content Administrator's Guide for Imaging.

For additional information about how to import definitions, see Section 6.5.1.2.2, "Importing Definition Files into Imaging."

6.2 Configuring the Full-Text Features in the WebCenter Content Repository

Imaging supports two types of full-text searching under WebCenter Content: DATABASE.FULLTEXT and OracleTextSearch. Imaging can use the full-text features if you configure full-text searching in the WebCenter Content repository first. For DATABASE.FULLTEXT systems, after the indexes are rebuilt, nothing needs to be done on the Imaging side. OracleTextSearch, however, requires that the index be rebuilt any time an application with FullText enabled is created, deleted, or has modifications that involve field definitions.

For more information on configuring full-text searching, see Section 4.5, "Configuring OracleTextSearch for Content Server."

For additional full-text configuration options, see "Configuring the Search Index" in Oracle Fusion Middleware Administering Oracle WebCenter Content.

After full-text is enabled in WebCenter Content, you will need to create an application and check the FullText option on the application. For more information, see "Configuring System Properties" in Oracle Fusion Middleware Administering Oracle WebCenter Content.

6.3 Setting Imaging System Security

On a new Imaging system, the first user to log in is automatically granted full permissions. Typically, this initial user associates other users or groups, after which his or her permissions are changed or revoked as needed.

Note:

If you configure Imaging for use with Oracle Access Manager, you must protect the imaging/faces/ directory. Failure to do so would prevent access to the Imaging Viewer.

If security provider changes are made after this initial user login to Imaging, take the following steps to reset Imaging system security. For example, if you later change the security configuration to point to an Oracle Internet Directory provider or a Microsoft Active Directory provider, you must reset Imaging system security.

  1. Manually create or migrate users and groups to the new external security provider, using utilities as needed.

    For more information, see Section 3.9, "Reassociating the Identity Store with an External LDAP Authentication Provider."

  2. Run the refreshIPMSecurity() WLST MBean command.

    For more information, see the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

    Note:

    During the refresh, users or groups for whom matching identifying information is not found are ignored. As security changes are made, invalid users or groups are removed from the Imaging database.

6.4 Configuring the Imaging Viewer Cache

The Imaging viewer can cache documents on the server outside of the repository to increase rendering speed on the client machine. Security for the cached documents is controlled by authentication for the server on which they are stored. If the server is considered secure, no additional security is necessary. If additional security is required, cached documents can be encrypted, as described in Section 6.4.2, "Encrypting Cached Documents."

To set the Imaging viewer to use cached documents:

  1. Verify that the Imaging Viewer Cache was successfully deployed:

    1. In the WebLogic Server Administration Console, click Deployments under Domain Structure on the left,

    2. In the imaging-vc row of the Deployments table, confirm that the State value is Active and the Health value is OK.

    If the State or Health value is different for imaging-vc, you need to fix the deployment or redeploy the feature before proceeding.

  2. Enable viewer caching by setting the ViewerCachePath MBean to the location where documents should be cached, using the method described in Section 6.1.5, "Configuring the GDFontPath MBean for a UNIX System." For example, to enable caching on an Imaging system running on a single computer, the relative path imaging/ViewerCache can be used. If no path is set, then caching of documents is disabled.

    Note:

    The ViewerCachePath MBean should be set to a location available to all servers in the cluster. If the directory path is not available to all servers, then each server will cache documents locally, resulting in multiple instances of the entire cache.

  3. Specify the number of days for documents to remain in the cache location after being viewed by setting the ViewerCacheDays MBean. Cached documents not viewed within the specified number of days are purged from the cache. If a document is viewed within the specified number of days, the ViewerCacheDays timer for that document is reset. Setting ViewerCacheDays equal to 0 (the default) prevents the cache from being purged.

  4. Set the ViewerCacheEnablePrecache MBean to true to cache documents when they are ingested into Imaging (precache) or to false to cache documents when they are first called by the viewer.

6.4.1 Changing the Viewer Cache Path

You can move the viewer cache to a new location provided the Imaging server is shut down and the new location uses the same file hierarchy as the old location.

  1. Shut down the Imaging server.

  2. Move the cached files to the new location, preserving the file hierarchy.

  3. Set the new path in the ViewerCachePath MBean.

  4. Start the Imaging server.

6.4.2 Encrypting Cached Documents

If additional security is required, Imaging can be configured to encrypt cached documents. Encryption makes additional processing necessary to decrypt a document for viewing and reduces rendering speed. Even if Imaging is configured to encrypt the cached documents, there is a brief period of time during caching when generated documents are not encrypted.

To enable encryption of cached documents:

  1. Add a new password credential to the domain with Oracle Enterprise Manager Fusion Middleware Control:

    1. Select the WebLogic Server domain for Oracle WebCenter Content.

    2. From the WebLogic Domain menu, select Security and then Credentials.

    3. Select the map oracle.imaging. If no map named oracle.imaging exists, click Create Map, enter oracle.imaging for the map name, and then select it.

    4. Click Create Key. Name the key viewer.cache, and select the type Password.

    5. Enter a user name. The user name does not need to exist in any system.

    6. Enter a password, confirm it, and then click OK.

  2. Enable encryption by setting the ViewerCacheEnableEncryption MBean, using the method described in Section 6.1.5, "Configuring the GDFontPath MBean for a UNIX System."

    Note:

    The password credential must exist on the domain before you set the ViewerCacheEnableEncryption MBean.

6.4.3 Disabling Encryption of Cached Documents

Encryption of cached documents can be disabled by setting the ViewerCacheEnableEncryption MBean to false. Subsequent calls to the viewer will cause unencrypted documents to be cached. Any encrypted documents still in the cache can be decrypted and viewed provided the password credential remains in the domain unaltered.

Purging the imaging.jks File If the Password Credential Is Removed or Altered

If the password credential is removed or altered, encrypted documents still cached must be manually purged.

To purge the imaging.jks file:

  1. Shut down the Imaging server.

  2. Delete the cached files from the cache directory.

  3. Delete the imaging.jks file from the cache directory.

  4. Start the Imaging server.

6.5 Installing and Configuring AXF for BPM and AXF for BPEL

Oracle WebCenter Content: AXF for BPM and Oracle Application Extensions Framework (AXF) for BPEL are installed automatically with Imaging, and AXF for BPEL is automatically deployed to the Imaging Managed Server. Before you can deploy AXF for BPM to the Imaging server, you need to create the required schemas with the Repository Creation Utility, as described in Section 2.2.2, "Creating Schemas for Oracle WebCenter Content Applications." Then when the domain is created or extended, you can select AXF for BPM to use it with Imaging, as described in Chapter 3, "Configuring Oracle WebCenter Content Applications."

You can configure either AXF for BPM or AXF for BPEL, or both, to run on the Imaging Managed Server:

  • AXF for BPM

    The newer AXF for BPM infrastructure takes advantage of the application development and configuration capabilities provided by technologies such as Oracle Business Process Management (Oracle BPM), Oracle Application Development Framework (Oracle ADF), Oracle Metadata Services Repository (Oracle MDS Repository), and Oracle Business Rules to create configurable business components. Administrators can use these business components to configure and develop integration solutions for WebCenter Content business applications.

    For more information, see Section 6.5.1, "Configuring and Verifying AXF for BPM."

  • AXF for BPEL

    The older AXF for BPEL infrastructure relies on AXF database tables (Imaging tables) as the basis for configuring AXF solutions, commands, and web tools. A solution developer or solution accelerator can implement and customize these solutions, commands, and tools.

    For more information, see Section 6.5.2, "Configuring and Verifying AXF for BPEL."

For additional information about configuring and using AXF for BPM or AXF for BPEL and the AXF for BPEL database tables (Imaging tables), see the Oracle WebCenter Administrator's Guide for Application Adapters.

6.5.1 Configuring and Verifying AXF for BPM

Before you configure AXF for BPM with Imaging, you need to install and configure 11gR1 (11.1.1.7.0) Oracle WebCenter Content and Oracle SOA Suite and create an AXF schema with the Repository Creation Utility as well as schemas for the following components:

  • Metadata Services

  • Oracle WebCenter Content Server - Complete

  • Oracle WebCenter Content: Imaging

  • SOA Infrastructure

  • User Messaging Service

When you create or extend the WebLogic Server domain, be sure the following product templates are selected:

  • Oracle SOA Suite

  • Oracle WebCenter Content: AXF for BPM

    Note:

    If AXF for BPM is on a separate host machine from the Oracle SOA Suite Managed Server, the domain will need to be extended with Oracle WSM Policy Manager.

  • Oracle WebCenter Content: Imaging

  • Oracle Universal Content Management - Content Server

    (for WebCenter Content)

  • Oracle Enterprise Manager

  • Oracle BPM Suite

After you create or extend a domain to include AXF for BPM and the components and products it depends on, you can configure it to work with Imaging using the WebLogic Server Administration Console, Oracle WebLogic Server Scripting Tool (WLST), and Oracle Enterprise Manager Fusion Middleware Control. Section 6.5.1.1, "Configuring AXF for BPM," describes how to do this. It also describes how to set up communications with Oracle Coherence between AXF for BPM and Imaging servers running on multiple domains or machines or to prevent multicast interference between AXF for BPM and Imaging in a single domain.

For verification that the AXF for BPM infrastructure is properly installed and configured, AXF for BPM includes the HelloBPM solution, which uses an Oracle BPM process to verify the BPM integration. Section 6.5.1.2, "Verifying the AXF for BPM Installation," describes how to deploy and use this solution.

6.5.1.1 Configuring AXF for BPM

Use the following procedure to configure AXF for BPM with the Imaging server. You can set up the Imaging server through the WebLogic Server Administration Console, create foreign JNDI with WLST, and configure the AXF for BPM CSF key through Fusion Middleware Control.

To configure AXF for BPM to work with Imaging Managed Servers that run in a cluster or other distributed configuration, you need to set up communications with Oracle Coherence, as Section 6.5.1.1.1, "Oracle Coherence Communications for Imaging Clusters, Multiple Domains, or Multiple Machines," describes. In a single domain, you can set up communications with Oracle Coherence to avoid interference from multicast traffic, as Section 6.5.1.1.2, "Oracle Coherence Communications for a Single Server or Domain," describes.

To configure AXF for BPM:

  1. Set up the Imaging server through the WebLogic Server Administration Console:

    1. The Administration Server should already be running. If not, start the Administration Server for your Oracle WebLogic Server domain, as described in Section 9.1, "Starting the Administration Server."

    2. Log in to the Administration Console.

    3. Under Domain Structure on the left, expand Environment, and click Servers.

    4. In the Servers table, click the Imaging server instance, such as IPM_server1.

    5. Click the Protocols tab.

      If the server is in production mode, you need to click the Lock & Edit button in the Change Center on the left before you can make changes on this tab.

    6. Click the HTTP subtab.

    7. Set these values:

      • Frontend Host: The name of the host machine for the Imaging server, such as myserver.example.com

      • Frontend HTTP Port: The port number for the Imaging instance, such as 16000

    8. Save the changes.

      If the server is in production mode, you need to activate changes after you save them, unless configuration editing is enabled.

  2. If the Oracle SOA Suite Managed Server is on a separate host machine from Imaging, set the targeting for the IPMDS and mds-axf data sources to the Oracle SOA Suite server:

    1. Log in to the Administration Console on the Oracle SOA Suite machine.

    2. Under Domain Structure on the left, expand Services, and click Data Sources.

    3. Choose Generic Data Source from the New menu.

    4. Enter jdbc/IPMDS in the JNDI Name field.

    5. Select your database type in the Database Type list, and click Next.

    6. Configure values for Data Source Properties to match the connection of the same name on the corresponding Imaging server, including using the same schema.

    7. Test the configuration to ensure everything is valid.

    8. Click Finish.

    9. On the Configuration tab of the Summary of JDBC Data
      Sources page, click IPMDS.

    10. Click the Targets tab.

    11. Select the name of the Oracle SOA Suite server.

    12. Click Save.

    13. Return to the Configuration tab on the Summary of JDBC Data
      Sources page, and click mds-axf.

    14. Click the Targets tab.

    15. Select the name of the Oracle SOA Suite server.

    16. Click Save.

  3. If the Oracle SOA Suite Managed Server is on a separate host machine from Imaging, create a SOALocalTxDataSource data source on the Imaging server as it is set up on the Oracle SOA Suite server:

    1. Log in to the Administration Console on the Imaging machine.

    2. Under Domain Structure on the left, expand Services, and click Data Sources.

    3. On the Configuration tab of the Summary of JDBC Data
      Sources page, choose Generic Data Source from the New menu.

    4. Enter SOALocalTxDataSource in the Name field.

    5. Enter jdbc/SOALocalTxDataSource in the JNDI Name field.

    6. Select your database type in the Database Type list, and click Next.

    7. Configure values for Data Source Properties to match the connection of the same name on the corresponding Oracle SOA Suite server, including using the same schema.

    8. Test the configuration to ensure everything is valid.

    9. Click Next to select targets.

    10. Select the name of the Imaging server.

    11. Click Finish.

  4. Create foreign JNDI with WLST:

    1. Navigate to the WCC_ORACLE_HOME/axf_bpm/scripts directory.

    2. Run the create-foreign-JNDI.py script against the Imaging server with WLST.

      The WebLogic Server should be the only server running when you execute the script, as follows:

      MW_HOME/oracle_common/common/bin/wlst.sh create-foreign-JNDI.py -h administration-server-host-name -p administration-server-port -u weblogic-user-name -c weblogic-password -t soa-host-name -v soa-host-port -s IPM_server1 -n JNDI-user-name -d jndi-password
       
       
      -h            WebLogic Server Administration Server host name
       
      -p            Administration Server port
       
      -u            WebLogic Server user name
       
      -c            WebLogic Server password for user name
       
      -t            JNDI target URI of Oracle SOA Suite host
       
      -v            JNDI target URI port
       
      -s            Managed Server name, for targeting the Imaging server
       
      -n            JNDI user name
       
      -d            JNDI password
      
  5. Configure the AXF for BPM CSF key:

    1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

    2. Navigate to the WebLogic Server domain and right-click the deployed domain (base_domain by default).

    3. In the resulting menu, choose Security and then Credentials.

    4. Create a new map:

      Specify the map name, oracle.wsm.security.

    5. Create a new key:

      • Specify a key name, such as ipmadmin.

      • Specify a valid administrator user, such as weblogic.

      • Specify the password.

      • After you specify the key name, user, and password, click OK.

6.5.1.1.1 Oracle Coherence Communications for Imaging Clusters, Multiple Domains, or Multiple Machines

If you are configuring AXF for BPM, you should configure communications with Oracle Coherence, which AXF for BPM utilizes. By default the server is set up for clustering with the following settings configured in the DOMAIN_HOME/bin/setDomainEnv.sh script:

-Dtangosol.coherence.clusteraddress=224.3.1.99
-Dtangosol.coherence.clusterport=3199
-Dtangosol.coherence.log=jdk

In an Imaging cluster, you need to set up AXF for BPM communications with Oracle Coherence with a unique multicast address and port to avoid unwanted multicast traffic from interfering with the system. For more information about configuring Oracle Coherence in clusters, see the Oracle Coherence Developer's Guide.

6.5.1.1.2 Oracle Coherence Communications for a Single Server or Domain

For a single-server or domain installation, you can configure Oracle Coherence to avoid the multicast traffic of other machines by editing the DOMAIN_HOME/bin/setDomainEnv.sh script as follows:

  1. Open the DOMAIN_HOME/bin/setDomainEnv.sh script in a text editor.

  2. Perform a search for "coherence" to locate any existing settings.

  3. Append the following two setting after any existing Oracle Coherence settings; for instance, after -Dtangosol.coherence.log=jdk:

    -Dtangosol.coherence.localhost=127.0.0.1
    -Dtangosol.coherence.ttl=0
    
  4. Save the settings.

  5. Restart any running Managed Servers on the domain for the changes to take effect.

6.5.1.2 Verifying the AXF for BPM Installation

You can verify the AXF for BPM installation and configuration with the HelloBPM solution, which uses a BPM process. The following sections describe how to deploy and use this solution:

6.5.1.2.1 Configuring the HelloBPM Solution

Before you can use the HelloBPM solution to validate the installation and configuration of AXF for BPM, you need to deploy and configure the solution on the Imaging Managed Server.

To configure the HelloBPM solution:

  1. Set up the database:

    1. Change to the WCC_ORACLE_HOME/axf_bpm/scripts directory.

    2. Edit the AXF_HELLO_BPM_DATA.sql script with a text editor.

    3. Replace the CSFKEY value, which is set to ipmadmin by default, to match the security credentials you set in Fusion Middleware Control.

    4. Replace all occurrences of MySOAServer:Port and MyIPMServer:Port with information corresponding to your environment.

    5. Save changes.

    6. Run the AXF_HELLO_BPM_DATA.sql script while connected to the Imaging database schema as the Imaging database user. This will insert the data necessary to run the HelloBPM solution.

  2. Start up the remaining servers in the following order. For more information about starting the servers, see Section 9.2, "Starting Managed Servers," and Section 9.4, "Using Node Manager with Oracle WebCenter Content."

    1. Weblogic Server Administration Server (should already be running)

    2. Oracle SOA Suite Managed Server

    3. Imaging Managed Server

    4. WebCenter Content Managed Server

  3. Verify that a URI is set on the deployed process:

    1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

    2. Navigate to the Oracle SOA Suite Managed Server, then soa-infra (soa_server1), and then default, and click axfHelloBPM.

    3. In the Component Metrics section, click SalesQuoteEntry.

    4. Click the Administration tab.

    5. If a valid URI is not set, create one with these settings:

      • Application Name: worklist

      • Host Name: The name of the host machine for the server

      • HTTP Port: The port of the host machine for the server

      • HTTPS Port: The secure port of the host machine for the server, or the default value if SSL is not configured

      • URI: /workflow/axfSolutionHelloBPM/faces/adf.task-flow?_id=SalesQuoteEntry_TaskFlow&_document=WEB-INF/SalesQuoteEntry_TaskFlow.xml

6.5.1.2.2 Importing Definition Files into Imaging

You can import definition files for tasks into the Imaging server through the Imaging Injector.

To import definition files into Imaging:

  1. Create the connections:

    1. Log in to Imaging as an administrator user, such as ipmadmin.

      Note:

      This first user to connect to the Imaging system is registered as the Imaging administrator. For more information, see Section 6.1, "Completing the Initial Imaging Configuration."

    2. In the navigation tree on the left, expand Manage Connections.

    3. Choose Create Content Server Connection from the drop-down menu, and configure the connection:

      • On the Create Connection: Basic Information page, specify a name for the connection, and click Next.

      • On the Create Connection: Content Server Settings page, specify whether to use SSL, then specify whether to use a local Content Server (default) or specify an external server through the Content Server Pool section, and then click Next.

      • On the Create Connection: Security page, add the Administrators group with full rights, and click Next.

      • Review your settings, and click Submit.

    4. Choose Create Workflow Connection from the drop-down menu, and configure the connection:

      • On the Create Connection: Basic Information page, specify a name for the connection, and click Next.

      • On the Create Connection: Workflow Settings page, specify the following information, and then click Next.

        HTTP Front End Address: Specify the fully qualified HTTP address for the Oracle SOA Suite server:

        http://managedServerHost:managedServerPort/
        

        Credential Alias This should be the CSF key name specified in Section 6.5.1, "Configuring and Verifying AXF for BPM,", Step 5, such as ipmadmin.

        Provider: Specify the fully qualified t3 address for the Oracle SOA Suite Server:

        t3://managedServerHost:managedServerPort/
        
      • On the Create Connection: Security page, add the Administrators group with full rights, and click Next.

      • Review your settings, and click Submit.

  2. Import the definition file, WCC_ORACLE_HOME/axf_bpm/ipm into Imaging, using the definition import tool.

    For more information on uploading definitions and resolving environment configurations, including the repository connection and BPEL server connection as well as the security configurations of the applications, see the Oracle WebCenter Content Administrator's Guide for Imaging.

    1. In the navigation tree on the left, expand Tools.

    2. Choose Import Definitions.

    3. Browse to and select the WCC_ORACLE_HOME/axf_bpm/ipm/HelloBPM.xml file.

    4. Click Next.

    5. On the Select Definitions step, select the Action for HelloBPM Application, HelloBPM Input, and HelloBPM Search.

    6. Click Next.

    7. On the Validation step, select Choose New for the Application Security field, and select the Administrators group. Also choose the Administrators group for the Applications, Document Security field, Inputs Security field, and Searches Security field.

    8. For the Workflow field, select Workflow Connection.

    9. Click Submit.

6.5.1.2.3 Accessing the Solution Administration Page

Before you can access the Solution Administration page, you need to set up an axfadmin group in WebLogic Server and assign your WebLogic Server user name to this group. For information about creating a group and adding a user to a group, see "Manage users and groups" in the WebLogic Server Administration Console Online Help.

To access administration functions for the solution application:

  1. Open the new driver page:

    http://machinename:16000/axf/faces/pages/axfadmin.jspx
    
  2. Click the Command Driver link, on the left.

  3. Use the following values:

    1. solutionNamespace: SalesQuoteEntry

    2. commandNamespace: StartSalesQuoteEntry

  4. Click the Execute Request button.

  5. Click the Execute Response button.

The Solution Administration page opens. Table 6-1 shows the example parameters for this page.

Table 6-1 Parameters for the Solution Administration Page

Parameter Value

solutionNamespace

SalesQuoteEntry

commandNamespace

StartSalesQuoteEntry

Username

The user name for the request


You can access the Business Rule Editor through the Solution Administration page and use this editor to perform any customizations. For more information, see the Oracle WebCenter Administrator's Guide for Application Adapters.

6.5.1.2.4 Injecting Tasks into Imaging

After you deploy the AXF for BPM process, you can inject tasks into Imaging either from the content input files, through the Imaging input agent, or from the Oracle SOA Suite server, through Oracle Enterprise Manager Fusion Middleware Control.

You can inject tasks into the HelloBPM solution from content input files that are installed with the AXF for BPM infrastructure. Injecting tasks through the Imaging input agent enables you to test solution application changes. If needed, you can modify the input files to match the HelloBPM workflows.

These content input files are in the following directory with WCC_ORACLE_HOME/axf_bpm/ipm/HelloBPM.xml, the Imaging application definition:

$WCC_ORACLE_HOME/axf_bpm/ipm/

This directory includes three input files:

  • TestSalesQuote.pdf

  • TestSalesQuote.txt

  • TestSalesQuote.xml

The following procedure is based on the assumption that InputDirectory is left with the default configuration (/IPM/InputAgent/Input).

To inject tasks through the input agent:

  1. Copy the PDF and XML files into the DOMAIN_HOME directory, and copy the TXT file into the DOMAIN_HOME/IPM/InputAgent/Input directory (default configuration). You also might need to change file permissions so that InputAgent has access to these files.

    For more information, see "Enabling Input Agent" in the Oracle Fusion Middleware Administrator's Guide for Oracle Imaging and Process Management.

    Within the specified time interval (15 minutes by default), the input agent picks up the input files and creates a document with metadata values from the text input file, an image from the PDF file, and supporting content from the XML file.

    Based on the workflow configuration in place with the HelloBPM solution, a task is created for the document that displays in the BPM task list.

  2. In the task list, click the newly injected task to view its details in the solution application.

  3. As needed, modify the metadata values in the text input file before injecting the input files again. For example, you might inject a task with missing account information to work with its human task flow.

6.5.2 Configuring and Verifying AXF for BPEL

To configure AXF for BPEL to work with Imaging Managed Servers that run in a cluster or other distributed configuration, you need to configure the Java Object Cache (JOC) to be distributed to all of the Managed Servers. For more information, see Section 6.5.2.1, "Configuring the Java Object Cache for AXF for BPEL in Distributed Imaging Managed Servers."

For verification that the AXF for BPEL infrastructure is properly installed, AXF for BPEL includes two simple solutions:

6.5.2.1 Configuring the Java Object Cache for AXF for BPEL in Distributed Imaging Managed Servers

For AXF for BPEL in Imaging Managed Servers that run in a cluster, you need to configure a Java Object Cache (JOC) to be distributed to all of the Managed Servers. You can use HA Power Tools from the Oracle WebLogic Server Administration Console to configure the JOC for all of the Imaging Managed Servers that run in distributed mode.

Note:

After configuring the Java Object Cache, restart all affected Managed Servers for the configurations to take effect. For more information, see Section 9.3, "Restarting a Managed Server."

In the following instructions, MW_HOME represents the path to a Middleware home, where Oracle Fusion Middleware is installed, and DomainHome represents the path to the Oracle home for an Oracle WebLogic Server domain.

To configure the Java Object Cache for a cluster of distributed Managed Servers:

  1. Enable HA Power Tools in the Oracle WebLogic Server Administration Console:

    1. Copy the following two WAR files from the MW_HOME/oracle_common/hapowertools directory to the DomainHome/console-ext directory:

      • powertools-core.war

      • powertools-configurejoc.war

      For example:

      cd middlewarehome
      cp oracle_common/hapowertools/powertools-co* user_projects/domains/base_domain/console-ext/
      
    2. Restart the Oracle WebLogic Server Administration Server.

      For more information, see Section 9.1, "Starting the Administration Server," and Section 9.3, "Restarting a Managed Server."

    3. Access the Oracle WebLogic Server Administration Console (at http://adminServerHost:adminServerPort/console), and click the name of your domain in the left navigation tree.

      The HA Power Tools tab appears on the Settings page for the domain.

  2. Configure the distributed cache:

    1. On the Settings page for your domain in the Administration Console, click the HA Power Tools tab.

    2. On the Configure JOC tab, select Configure JOC for Clusters.

    3. In the Cluster Name field, choose a cluster name from the list.

    4. In the Discover Port field, enter the listener port number for the cluster.

    5. In the Hosts field, enter the names of all the Managed Server hosts, separated by commas.

    6. Click the Configure JOC button.

  3. Restart the cluster of Managed Servers.

  4. Verify the JOC distributed cache mode:

    1. From the Middleware home on the host for one of the Managed Servers, run the CacheWatcher utility, as in the following example:

      java -classpath oracle_common/modules/oracle.javacache_11.1.1/cache.jar:oracle_common/modules/oracle.odl_11.1.1/ojdl.jar
      oracle.ias.cache.CacheUtil watch -config=user_projects/domains/base_domain/config/fmwconfig/servers/IPM_server2/javacache.xml
      

      In this example, the class paths for the two JAR files are relative to the current directory (MW_HOME).

      The javacache.xml file is the file used by one of the Imaging servers that is participating in the JOC distributed cache. For a distributed Java cache with either virtual or physical IP addresses, the listener address needs to be set in javacache.xml. Each of the files should contain all the distributor location entries but only one <listener-address> entry, set to the same port number for every cache member, as follows:

       <listener-address port="portNumber1" host="hostName1"/> 
       <distributor-location ssl="true" port="portNumber1" host="hostName1"/> 
       <distributor-location ssl="true" port="portNumber1" host="hostName2"/> 
       <distributor-location ssl="true" port="portNumber1" host="hostName3"/> 
       <distributor-location ssl="true" port="portNumber1" host="hostName4"/> 
      
    2. Enter the lc command to list the cache information:

      INFO: JOC is initialized from oracle.ias.cache.CacheUtil.main, . . .
      cache> lc
      
    3. In the output from the lc command, check that the Distributor Table shows an entry for each member of the distributed cache.

    4. Enter the exit command to stop the CacheWatcher utility.

For more information, see "Using HA Power Tools" and "Running CacheWatcher" in Oracle Fusion Middleware High Availability Guide.

6.5.2.2 Verifying the AXF for BPEL Installation and Configuration with HelloWorld

Follow these steps to enable the HelloWorld solution:

  1. As user who owns the Imaging schema, run the insertHelloCommand.sql script from one of the following directories.

    • UNIX path:
      MW_HOME
      /WCC_ORACLE_HOME/axf/drivers/HelloWorld/dbscripts

    • Windows path:
      MW_HOME
      \WCC_ORACLE_HOME\axf\drivers\HelloWorld\dbscripts

    Note:

    For IBM DB2 only, add the following line to beginning of the insertHelloCommand.sql script before you run it:

    CONNECT TO soadb USER am3_ipm USING oracle;
    
  2. Access the driver page of the AXF for BPEL web application using the following URL:

    http://host:port/imaging/faces/Driver.jspx
    
  3. Enter the following values:

    • Solution Namespace: HelloWorld

    • Command Namespace: Hi

    • User Name: jcooper

      Note:

      This user name is valid only if you are using the application server's built-in jazn.xml security

  4. Click Execute Command.

    An AXF for BPEL response should display with a populated Conversation ID. If the response is returned, the AXF for BPEL infrastructure is functioning correctly, and commands can be added and executed.

6.5.2.3 Verifying the AXF for BPEL Installation and Configuration with HelloBpel

The HelloBpel solution includes a BPEL process and a SQL script to set up the HelloBPEL solution namespace for use by that process. The BPEL process and database script are in the following directories.

  • UNIX path:
    MW_HOME
    /WCC_ORACLE_HOME/axf/drivers/HelloBpel

  • Windows path:
    MW_HOME
    \WCC_ORACLE_HOME\axf\drivers\HelloBpel

To enable the HelloBpel solution:

  1. Run one of the following HelloBPEL SQL scripts:

    • UNIX scripts:

      MW_HOME/WCC_ORACLE_HOME/axf/drivers/HelloBpel/dbscripts
      /oracle/insertHelloBPELData.sql
      
      MW_HOME/WCC_ORACLE_HOME/axf/drivers/HelloBpel/dbscripts
      /sqlserver-db2/insertHelloBPELData.sql
      
    • Windows scripts:

      MW_HOME\WCC_ORACLE_HOME\axf\drivers\HelloBpel\dbscripts
      \oracle\insertHelloBPELData.sql
      
      MW_HOME\WCC_ORACLE_HOME\axf\drivers\HelloBpel\dbscripts
      \sqlserver-db2\insertHelloBPELData.sql
      

    If you are using Oracle Database, then run the script from the oracle directory.

    If you are using an IBM DB2 or Microsoft SQL Server database, then run the script from the sqlserver-db2 directory.

    For IBM DB2 only, before you run the HelloBPEL SQL script, make the following changes to it:

    • Add this line to beginning of the script:

      CONNECT TO soadb USER am3_ipm USING oracle;
      
    • Change the following line to specify whatever the actual BPEL connection is in the Imaging Manage Connections section:

      Insert into AXF_SOLUTION_ATTRIBUTES (SOLUTION_NAMESPACE,PARAMETER_KEY,PARAMETER_VALUE) values ('HelloBPEL','BPEL_CONNECTION','test');
      
  2. Run the insertHelloBPELData.sql script.

  3. With Oracle JDeveloper 11g, open HelloBPEL.jws from following directory:

    • UNIX path:
      MW_HOME
      /WCC_ORACLE_HOME/axf/drivers/HelloBpel/bpel

    • Windows path:
      MW_HOME
      \WCC_ORACLE_HOME\axf\drivers\HelloBpel\bpel

    Deploy the process to your BPEL server. For assistance with this task, consult the Oracle JDeveloper documentation.

    Note:

    The HelloBPEL sample solution assigns instances to a group named California by default. You need to add the California group to the myrealm security realm through the Oracle WebLogic Server Administration Console.

    If you are using an alternate identity store, such as Oracle Internet Directory, you can change the group assignment by modifying the HelloBpelHumanTask.task file within Oracle JDeveloper before deployment.

  4. Access the driver page of the AXF for BPEL web application using the following URL:

    http://host:port/imaging/faces/Driver.jspx
    
  5. In the AXF Command Driver screen, enter the following values:

    • Solution Namespace: HelloBPEL

    • Command Namespace: StartHelloBPEL

    • User Name: A valid Imaging user; for example, weblogic

    The preceding Imaging user needs to be part of a group named California. If this group does not exist, then create it, and add the user to the group.

  6. Click Execute Command.

    A response should be displayed in the response screen.

  7. Click Execute Response, and log in when prompted.

    The AXF Task List screen should be displayed. If there are no tasks in the task list, open the BPEL Console, create a new instance of HelloBPELProcess, and refresh the task list.

6.6 Installing and Configuring Oracle Document Capture and Oracle Distributed Document Capture

Oracle Document Capture provides high-volume production scanning from a central location, while Oracle Distributed Document Capture provides a user-friendly web interface that enables distributed enterprises to capture images easily from remote locations.

For information about installing and configuring Oracle Document Capture, see the Oracle Document Capture Installation Guide and Oracle Document Capture Administrator's Guide.

For information about installing and configuring Oracle Distributed Document Capture, see the Oracle Distributed Document Capture Installation Guide and Oracle Distributed Document Capture Administrator's Guide.

The Imaging 11g Commit Driver is required to commit documents from either capture application to WebCenter Content. For information about using the Imaging 11g Commit Driver, see the Oracle Distributed Document Capture Installation Guide or Oracle Distributed Document Capture Administrator's Guide.