Chapter 16. Administering Your System with the BPEL Web Console

Procedure 16.1. Task

1. Launch a web browser and go to http://localhost:8080/bpel-console.
2. Input your user name and password.
3. Click on the Manage Instances tab to see which BPEL processes are currently deployed. You will also see version information for each of these processes.
4. Select a process definition to open it. In the bottom panel you will see a list of process instances that are active for that particular definition.

   Note

   Only one version of a process can be active at a time. When you open a process definition, the active version is automatically selected.
5. Sometimes you will find that you need to manage a "retired" version (for example, in order to terminate running instances). In these cases, click More - Change Version and then select the version you want.

   Note

   If there is no version for a particular process archive, (such as Quickstart_bpel_simple_invoke.jar), it is treated as version zero. (In this case, Quickstart_bpel_simple_invoke-1.jar, will be the next version deployed.)

Procedure 16.2. Task

1. Launch a web browser and go to http://localhost:8080/bpel-console.
2. Input your user name and password.
3. Click on the Manage Instances tab to see which BPEL processes are currently deployed. You will also see version information for each of these processes.
4. Select a process definition to open it. In the bottom panel you will see a list of process instances that are active for that particular definition.
5. Use the Execution History to produce a chart. Here you can specify a particular period of time to review and choose whether or not to include failed and terminated instances in the chart.

Procedure 16.3. Task

1. Open the deploy.xml file in a text editor (for the bpel_helloworld quick start, this would be vi SOA_ROOT/jboss-as/samples/quickstarts/bpel_hello_world/bpelContent/deploy.xml
2. Edit the file as follows:

   <deploy xmlns="http://www.apache.org/ode/schemas/dd/2007/03"
    xmlns:bpl="http://www.jboss.org/bpel/examples" 
    xmlns:intf="http://www.jboss.org/bpel/examples/wsdl">
   
    <process name="bpl:HelloGoodbye">
     <active>true</active>
           <process-events generate="all"/>
     <provide partnerLink="helloGoodbyePartnerLink">
      <service name="intf:HelloGoodbyeService" port="HelloGoodbyePort"/>
     </provide>
    </process>
   </deploy>
   

3. Save the file and exit.
4. Open the bpel.properties file in the text editor: vi SOA_ROOT/jboss-as/server/PROFILE/deploy/riftsaw.sar/bpel.properties
5. Switch on the process-events option for the particular process you want to log and make sure that org.jboss.soa.bpel.console.bpaf.BPAFLogAdapter is enabled.
6. Save the file and exit.

Procedure 16.4. Task

1. Launch a web browser and go to http://localhost:8080/bpel-console.
2. Input your user name and password.
3. Click on the Manage Instances tab to see which BPEL processes are currently deployed. You will also see version information for each of these processes.
4. Select a process definition to open it. In the bottom panel you will see a list of process instances that are active for that particular definition.

   Note

   Only one version of a process can be active at a time. When you open a process definition, the active version is automatically selected.
5. Click the Instance Data button.
6. The View tab shows the instance execution graph, while the Source tab below it shows all of the "activity" events.

Procedure 16.5. Task

1. Launch a web browser and go to http://localhost:8080/bpel-console.
2. Input your user name and password.
3. Click on the Manage Instances tab to see which BPEL processes are currently deployed. You will also see version information for each of these processes.
4. Select a process definition to open it. In the bottom panel you will see a list of process instances that are active for that particular definition.

   Note

   Only one version of a process can be active at a time. When you open a process definition, the active version is automatically selected.
5. Click on the Execution Path button to see an instance execution graph for the process.

Procedure 16.6. Task

1. Log into the BPEL Web Console.
2. Choose a process definition and a process status from the list box.
   You can also optionally choose to input the correlation key, the start time and the end time as search criteria.
3. Go to the History Instances List and double-click on a row. A window will pop up showing you all of the execution events that happened when that process ran.

Procedure 16.7. Task

1. Launch a web browser and go to http://localhost:8080/bpel-console.
2. Input your user name and password.
3. Click on the Runtime tab.
4. Select the Deployments option.
   You will now be able to see the version information and current status (active or retired) of each process definition.
5. Select the particular version of the process definition you want to retire and then press the Retire button.

   Note

   If you undeploy a process, its end-points will only deactivate if no previous versions of that process have ever existed.

Procedure 16.8. Task

1. Launch a web browser and go to http://localhost:8080/bpel-console.
2. Input your user name and password.
3. Click on the Runtime tab.
4. Select the Deployments option.
   You will now be able to see the version information and current status (active or retired) of each process definition.
5. Select the retired version you want to reactivate and press the Activate button (found on the bottom-right of screen.)

Procedure 16.9. Task

1. Check your database to make sure UTF-8 encoding is being used by default.
2. Launch a text editor and open the database's configuration file.
3. Add these settings to the file:

   hibernate.connection.useUnicode=true
   hibernate.connection.characterEncoding=UTF-8
   

4. Save the file and exit.