Siebel Business Process Framework: Workflow Guide > Administering a Workflow Process > Recovering a Workflow Process >

Process of Using the Workflow Recovery Manager

To use the Workflow Recovery Manager, you do the following tasks:

1. Enabling the Workflow Recovery Manager
2. Preparing to Test the Workflow Recovery Manager
3. Testing the Workflow Recovery Manager

Enabling the Workflow Recovery Manager

This task is a step in Recovering a Workflow Process.

The status of the Workflow Recovery Manager is Online after it starts. Siebel CRM does not display any server tasks unless it recovers a workflow process instance after a server failure. If you run following command, and if Siebel CRM returns no server tasks, then this situation indicates that there are no failed instances, which is expected behavior:

List Tasks For Comp Wfrecvmgr

A Workflow Recovery Manager that is in an Active status indicates that it is up and running.

To enable the Workflow Recovery Manager

1. In the Server Manager command-line interface, enter the following command:

   enable compgrp workflow

   This step makes sure that Siebel CRM activates the component group for Siebel Workflow on the Siebel Server. For more information about Server Manager usage, see Siebel System Administration Guide.

2. In the Siebel client, navigate to the Administration-Server Management screen, and then the Components view.
3. Query for Workflow Recovery Manager.
4. If Workflow Recovery Manager is not Online, then click Start Up.

   This step starts the Workflow Recovery Manager. It is not necessary to set other parameters.

Preparing to Test the Workflow Recovery Manager

This task is a step in Recovering a Workflow Process.

In this topic, you prepare to test the Workflow Recovery Manager.

To prepare to test the workflow recovery manager

1. Connect to the Server Manager from the Siebel Server.

   You must use the smgr> prompt. For more information about Server Manager usage, see Siebel System Administration Guide.

2. To determine if the Workflow component group is active, enter the following command:

   smgr>list compgrp

3. If the Workflow component group is not active, then do the following:
   1. Enter the following command:

   smgr> enable compgrp workflow

   2. Stop, and then restart the Siebel Server.
4. In the Siebel client, navigate to the Administration-Workflow Process screen, and then the Workflow Deployment view.
5. Make sure a workflow process is running, and then fails.

   In order for the Workflow Recovery Manager to attempt recovery, a workflow process instance must run, and then fail. To make sure such a workflow exists, you can examine the Active Workflow Processes list.

Testing the Workflow Recovery Manager

This task is a step in Recovering a Workflow Process.

In this topic, you test the Workflow Recovery Manager.

To test the workflow recovery manager

1. Open a Telnet session connected to the Siebel Server, enter the following command, and then make a note of the Process Id of the Siebel Server:

   siebps

   If you are using Windows, then use Windows Task Manager instead of Telnet.

2. Open a second Telnet session, and then connect to the Server Manager prompt.
3. To start the workflow process, enter the following command from the smgr> prompt:

   Start task for comp wfprocmgr with processname = 'AutoRec_NN'

   The Siebel Server starts a new server task for the Workflow Process Manager server component that includes the task Id of the task it started.

4. From the first telnet session you opened, determine if the Inloop.txt file is created.

   The session adds numeric values to the file over time.

5. To reset the Siebel Server, enter the following command:

   Reset_server -e enterprise -M server name

   This step causes the workflow process that you are monitoring to fail.

6. Restart the Siebel Server, and then enter the siebps command as you did in step Step 1.

   The Siebel Server process restarts.

7. To resume running the workflow process from the point of failure, connect back to the smgr> prompt, and then enter the following command:

   smgr>start task for comp wfrecvmgr

   The Siebel Server starts a new server task for the Workflow Recovery Manager server component that includes the task Id of the task it started.

8. To examine the contents of the file, enter the following command in the Telnet session:

   tail -f inloop.txt

   The session adds numeric values to the file until the file reaches 2999.

9. To examine the last value entered in the file, enter the following command:

   outfile.txt

   The last and only value in this file must be 3000.

10. Enter the following command:

    list tasks for comp WfRecvMgr

    Observe that the list now includes one or more server tasks. Workflow Recovery Manager performs several tasks to recover workflow processes that are interrupted when you reset the Siebel Server in Step 5.