Installing eProcess 5.2 Connectivity Bundle for IBM FileNet Integrated Dcoument Management Open Client 4.0.3

© Copyright IBM Corporation 2011. All Rights Reserved.

Install the eProcess 5.2 Connectivity Bundle for IDM Open Client 4.0.3

The instructions in this document are for use with IBM FileNet IDM Open Client versions 4.0.3. Use the following procedure to install the eProcess Connectivity Bundle on your web server.

Requirements

The following software must be installed on the web server prior to installing the eProcess Connectivity Bundle.

TIP These instructions assume that you install the software at the default locations. If you install at custom locations, please adjust these instructions accordingly.

NOTE If you are installing the eProcess Connectivity Bundle on a web server where VWService has been running, you must uninstall both IDM and the Open Client software before you reinstall. In addition, use the Administrative Tools to stop the VWService and delete the pwbin (/IBM/IDM/pwbin) directory and the files it contains.

Install the JRE and the Process Connectivity Bundle software

  1. Install the Java Runtime Environment (JRE) 1.4.2.
    1. On the IBM FileNet Web WorkFlo and Toolkit CD, locate the JRE 1.4.2 installation file in the downloads directory and copy it to a temporary location on the web server.
    2. Run the JRE installation.
  2. Copy the following files from the Filenet Web WorkFlo and Toolkit installable.
  3. From the website, download and install the latest eProcess 5.2 Open Client patch, A valid IBM FileNet username and password are required.

    https://www-947.ibm.com/support/entry/myportal/Overview/Software/Information_Management/FileNet_Product_Family

    Unzip the downloaded file and copy the FileNet folder in the patch to the location where the IDM Open Client software is installed — \IBM\...

  4. Download and install the latest Jiglue patch from the above site.

Register the components and start the eProcess Services

  1. At a command prompt, navigate to the \IBM\IDM\PWBin directory.
  2. Enter the following commands:
  3. If the JRE and the IBM FileNet software are installed in the default locations, the paths in Process.reg will probably be correct. If you installed the IBM FileNet software in a different location, locate Process.reg in the IBM directory on the web server, and use Notepad or a similar editor to edit the file.
  4. After you have saved the updated Process.reg, double-click the file to update the web server's registry.
  5. Run regedit and confirm the ImagePath setting for VWServices. The default path is <drive>:\IBM\IDM\PWBIN\VWServices.exe.

    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VWServices]

  6. Start the eProcess Service on the web server.
    1. At a command prompt in the PWBin directory, enter the following command:
      vwservices.exe -install
    2. From the Start menu, select Programs > Administrative Tools > Services.
    3. Select Panagon eProcess Services Manager and click Start Service on the toolbar. Exit the Services dialog.

Reset the execute permissions on the Download directory

Execute permissions must be set to None to allow the JRE to be downloaded to the client computer, if necessary.

  1. On the web server, right-click My Computer and select Manage.
  2. Under Internet Information Services, open the Open Client directory, and the eprocess directory.
  3. Right-click the Download directory and select Properties.
  4. On the Directory tab, set Execute Permissions to None.

Start a router and initialize an isolated region

Use the following steps to start the eProcess Services Administrator and to define and start one or more routers. To complete this procedure, you need to know the name of your workflow server and a valid administrator name and password (eProcess) you can use to log on.

  1. On the web server, locate eProcess.msc in the PWBin folder.
  2. Right-click the file and create a shortcut, then move the shortcut to your desktop.
  3. Double-click the shortcut to start the eProcess Services Administrator.
  4. Open eProcess Services Administrator. Right click Panagon eProcess Router and choose New.
  5. In the Router properties dialog, enter the following:

    For the router name, enter vwrouter, or any name you like.

    For PPM Server, enter the name of your workflow server.

    Enter a Process administrator username and password.

    Select Automatically started.

    For additional information about creating a router, see the online Help for Process Task Manager.

  6. When you have finished entering the router properties, select the new router and click Start on the toolbar to start the router.
  7. Exit and save the console settings.

Use Process Configuration Console to initialize a corresponding isolated region for each router that you started.

  1. On a client workstation, enter the URL for Open Client on the web server. The default is

       http://web-server-name/OpenClient

    Wait for the IDM Open Client page to display. This may take several minutes the first time.

  2. On the IDM Open Client page, select Process.
  3. On the Tools tab, select Process Configuration Console. At the prompt, log on as an eProcess administrative user.
  4. In Process Configuration Console, select the name of the router/isolated region, then choose Initialize isolated region from the Action menu.

    For additional information about initializing an isolated region or security considerations, see the online Help for Process Configuration Console.

At this point, the installation process is complete and the Process applications are available for use.

Uninstall the eProcess 5.2 Connectivity Bundle for IBM FileNet IDM Open Client

Use the following steps to uninstall the Process software

  1. On the web server, in the Control Panel, select Add/Remove Programs.
  2. In the Add/Remove dialog, select IBM FIleNet OpenClient, then choose Modify and de-select Open Client eProcess Integration. This uninstalls the Process Integration for Open Client and allows the remaining IBM FileNet software to run without it.

    NOTE  If you also have Process for FileNet Web Services Client running on this web server and you wish to retain it, stop here. Otherwise, if you have only Process for IBM FileNet Open Client on this web server, continue with steps 3 through 5 below to disable the Process software. The software will remain on the web server, but it will not be running.

  3. Run eProcess.msc to access the eProcess Services Administrator. There should be a shortcut to eProcess.msc on the desktop.
  4. Select any running routers and stop them, then delete them.
  5. Start Administrative Tools > Services. Select Panagon eProcess Services Manager and stop the service and then set the restart to Manual.

Notices and Copyrights

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY  10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
3-2-12, Roppongi, Minato-ku, Tokyo 106-8711 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA  95141-1003
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All ofthese names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.

Portions of this product are:

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product, and service names may be trademarks or service marks of others.