Introduction

Skill level

This tutorial-style sample is designed for new users. Step-by-step instructions are provided to guide you through the process development life cycle, from the beginning to setting up a test runtime server, to designing and developing a process, to finally monitoring the process. You are expected to have some familiarity with the eclipse environment.

System requirements

The sample that is included with this tutorial runs on Microsoft® Windows® operating systems.

Prerequisite software

Before you build the sample, you must install the following products. For the tutorial steps, it is assumed that the products are installed according to the instructions provided in the Installation Details section. Any deviation from the specific versions or instructions may result in differences from the tutorial steps or screenshots. You are advised to follow the installation instructions exactly.

For more information about the products that are involved in this tutorial, refer to the product documentation.

1. Install the WebSphere V6.2 products

   There are two options for installing the required WebSphere products, choose the appropriate option for your environment.

   1. WebSphere Dynamic Process Edition (WDPE) Installation

      Use this option if the machine you are installing on does not have any other products installed with IBM Installation Manager. Check in your Start > Programs menu for IBM Installation Manager. If you see this entry, skip this step and continue at step 1b: Individual Product Installation

      1. Extract the files of the WDPE V6.2 installer. This will create the following directory structure:
         
      2. Download the files for each product and extract them into the appropriate subdirectory in WDPEInst
      3. Run installers/install_wdpe_win.exe and follow the instructions in the installer

      Continue at Step 2: Update the WebSphere Products to V6.2.0.1

   2. Individual Product Installation

      Run this installation procedure only if you did not install the WebSphere Dynamic Process Edition in step 1a.

      1. Install WebSphere Integration Developer with the following features:
         • Integrated development workbench (selected by default)
         • The test environment without a profile. Be sure to uncheck the profile
         
         Note: IBM Installation Manager will install or upgrade with the first product that is installed from the IBM WebSphere Dynamic Process Edition suite. In this sample, the IBM Installation Manager will be installed when WebSphere Integration Developer is installed.
      2. Install WebSphere Business Modeler Advanced V6.2
         1. Install into the WebSphere Integration Developer package group
            
         2. Use default installation features:
            
      3. Install WebSphere Business Monitor Toolkit
         1. Install into the WebSphere Integration Developer package group as you did for WebSphere Business Modeler
         2. Select features:
            • Monitor Development Environment: Monitor Model Editor
            • Monitor Development Environment: WebSphere Integration Developer support for monitor model generation
            • Monitor Test Environment: WebSphere Business Monitor profile on WebSphere Process Server
            
      4. Install WebSphere Business Services Fabric tool pack V6.2 into WebSphere Integration Developer with the Files Only and the Install Composition Studio features selected.
         
      5. Augment the Monitor server profile with Fabric functionality.
         1. In order to start the augmented monitor profile without exceptions the OSGi cache needs to be flushed. Delete all folders starting with org.* in <WID62_Install>\pf\WBMonSrv_wps\configuration.
         2. Run the Profile Management Tool (PMT). This can be found at: <WID62_Install>\runtimes\bi_v62\bin\ProfileManagement\pmt.bat .
         3. Click Augment to augment the existing monitor profile. If the defaults were used this will be named WBMonSrv_wps.
         4. Select WebSphere Business Services Fabric as the augment to apply to the monitor profile.
         5. Select Typical profile augmentation as the profile augmentation option.
         6. Enter the user id and the password for the monitor profile created during the installation of the WebSphere Business Monitor toolkit. The default username is admin and the default password is also admin.
         7. Review the summary and then click Augment
            
         8. Validate that the augment was successful by reviewing the log. The log is located at <WID62_Install>\bi_v62\logs\mangeprofiles\WBMonServ_sps_augment.log. Near the end of the log, there should be a message Profile augmentation succeeded.

2. Update the Websphere Products to V6.2.0.1
   1. Use IBM Installation Manager to update the products to V6.2.0.1. All products are installed into the WebSphere Integration Developer package, so this is the only package that needs to be updated.
      
   2. On the next screen, select Show All and select Version 6.2.0.1 for each product
      Note: Other versions may be recommended and highlighted, however the steps and screenshots in this tutorial are for Version 6.2.0.1 and are not guaranteed to be the same in later versions.

      
      Note: You may receive a message informing you that you need to update the IBM Installation Manager. If this is your first time using the IBM Installation Manager to update an installed package. Select yes.

      Follow the prompts for the remainder of the update installation.

3. Create the FabricAdministrators group and add the admin user to that group
   Note: Even though there is a user created by the installer that has WebSphere Process Server administrative privileges, this user does not automatically have Administrator privileges to do Governance in Business Space. To grant this user Administrator privileges, a group called FabricAdministrators must be created and the admin user (or other users) must be added to the group. In this sample, which uses the default VMM, this can be done in the WebSphere Process Server administrative console. If you were using LDAP, Local OS, etc. you would create this group in the appropriate system.
   1. Start WebSphere Integration Developer with the default workspace
   2. In the Servers view, right click the server WebSphere Business Monitor Server and select Start. (This will take a few minutes)
   3. When the Server status is Synchronized, right click the server again and select Administration > Run administrative console
   4. Log into the WebSphere Monitor Server admin console. Navigate to "Users and Groups/Manage Groups". Create a new group with name FabricAdministrators.
      
   5. Add user ID admin to the FabricAdministrators group.
      
   6. Close the Administrative console.
   7. In the servers view, right click the WebSphere Business Monitor server and select stop.
   8. After the server status changes to stopped, exit WebSphere Integration Developer.

4. Install Lotus Forms Designer V3.5 into WebSphere Integration Developer. This will also enable it in WebSphere Business Modeler.
   1. Create a directory called forms_designer in the same parent directory where you extracted the Websphere Integration Developer installation files. This directory should now contain 3 directories: disk1, disk2 and forms_designer.
   2. Extract the Lotus Forms Designer V3.5 files in the new forms_designer directory.
   3. Run the WebSphere Integration Developer launchpad and select the option to Install Lotus Forms Designer
   4. During the installation you will be prompted for a valid installation directory where an IBM Software Development Platform package is installed. This is the WebSphere Integration Developer directory. For example, if you installed using the WDPE installer, the default directory is C:\ProgramFiles\IBM\WDPE\WID62. If you installed the WebSphere products individually, the default directory is C:\ProgramFiles\IBM\WID62

   Refer to Installing Lotus Forms software in the WebSphere Integration Developer product documentation for full install information.

5. Install Lotus Forms Viewer V3.5 Fix pack 1 into WebSphere Integration Developer. This will also enable it in WebSphere Business Modeler.
   Because this is a fix pack, You must use a different install procedure, not the launchpad. To install IBM Lotus Forms Viewer 3.5 fix pack 1 perform the following steps:
   1. In your Web browser, go to http://www.ibm.com/support/fixcentral.
   2. Download IBM Lotus Forms Viewer 3.5 fix pack 1.
   3. Double-click the downloaded file.
   4. Follow the instructions in the installation wizard.
   5. When prompted for the install location, enter the WebSphere Integration Developer installation directory.

   Refer to Installing Lotus Forms software in the WebSphere Business Modeler product documentation for full install information.

6. Install Lotus Forms Sever into WebSphere Integration Developer.

   Refer to Installing Lotus Forms software in the WebSphere Integration Developer product documentation for full install information.

   1. Create a directory called forms_server in the same parent directory where you extracted the Websphere Integration Developer installation files. This directory should now contain 4 directories: disk1, disk2, forms_designer and forms_designer.
   2. Extract the Lotus Forms Designer V3.5 files in the new forms_designer directory.
   3. Run the WebSphere Integration Developer launchpad and select the option to Install Lotus Forms Server - API
   4. When prompted for the install location, enter the WebSphere Integration Developer directory.
   5. Install the SDK version of the server
      
   6. Select the checkbox for deploy to WebSphere Process Server
      
   7. For the location of the server, use <WID62_Install>\runtimes\bi_v62