Article ID: 112182, created on Sep 2, 2011, last review on Aug 12, 2014

  • Applies to:
  • Operations Automation 5.4

Additional information

Description

WPE Request Tracer Tool is the tool application, which allows to trace and analyze WPE requests submitted to Parallels Windows Provisioning Engine (WPE).

WPE Request Tracer Tool shows WPE requests as a 'call tree'. For more information see the Understanding WPE Requests in WPE Request Tracer Tool section.

Installation

WPE Request Tracer Tool is automatically installed on the WPE Service host(s) (WPESRVDB, WPESRV01, WPESRV02) as a part of the WPE Service.

Understanding WPE Requests in WPE Request Tracer Tool

A WPE Request is a sequence of calls to WPE procedures. The WPE procedures are used to create, modify, or remove some objects in the POA Windows Hosting Infrastructure. The input and output data are passed in the XML format: WPE request XML and WPE response XML. For example, the POA Management Node submits a WPE request to WPE to provision IIS Web Sites, Exchange Mailboxes, etc

WPE Request Tracer Tool shows WPE requests as a 'call tree'. If a WPE request is submitted to WPE, and you have started a real-time tracing with WPE Request Tracer Tool, WPE Request Tracer Tool will look like this:

WPE Request's Properties (Response XML)

WPE Request's Properties (Request XML)

The node selected in the picture represents the WPE request as received by WPE. When you scroll down in the right-hand pane, you will see additional information including the XML of the WPE response.

If you expand the selected node and select a child node in the tree, it will look like the following:

WPE Request's Details

To view in-depth information for any node in the tree, click on the desired node and view the contents of the right-hand pane.

Note: In the 'call tree' window, with the help of the context menu you may remove all nodes, expand all nodes, collapse all nodes and so on. For example, to remove all existing nodes from the 'call tree' window, right-click any node and click Clear all requests.

Real-time Tracing

Starting Real-time Tracing

To start a real-time tracing of WPE requests follow these steps:

  1. Log on to the host where the WPE Service is installed. For example: WPESRVDB, WPESRV01, WPESRV02.
  2. Go to Start > All Programs > Parallels > Parallels Windows Provisioning Engine and click WPE Request Tracer Tool.
  3. In the WPE Request Tracer Tool window, in the top menu, click Live Tracing. The real-time tracing process starts.

Stopping Real-time Tracing

To stop the real-time tracing process, in the WPE Request Tracer Tool window, click Live Tracing.

Important: WPE Request Tracer Tool shows WPE requests, which are submitted after a live tracing process has been started. For example, a POA task is in the Running state for a long time and the task executes a WPE request. If you start the live tracing process, this WPE request will not be shown in WPE Request Tracer Tool. You may use the WPE log files or gather a trace data to an ETL file to find out a reason of the problem. See the Viewing Parallels Windows Provisioning Engine Logs and Gathering Trace Data to ETL File sections for details.

Gathering Trace Data to ETL File

You may trace WPE requests and save the gathered trace data to a trace file in the Windows Event Trace Log (ETL) format:

  1. Log on to the host where the WPE Service is installed. For example: WPESRVDB, WPESRV01, WPESRV02.
  2. Go to Start > All Programs > Parallels > Parallels Windows Provisioning Engine and click Gather traces in ETL file. The PowerShell window opens and the real-time tracing process starts.
  3. To stop the real-time tracing process, click any key in the window. The trace file will be saved on your Desktop.

Opening/Saving Trace Files

Opening Trace Files

To open the existing trace files in WPE Request Tracer Tool, perform the following actions:

  1. Go to Start > All Programs > Parallels > Parallels Windows Provisioning Engine and click WPE Request Tracer Tool.
  2. In the WPE Request Tracer Tool window, in the top menu, click File, and then click Open.

    - OR -

    Press CTRL+O.

  3. Select the required trace file format:
    • ETL files - for trace files in the Windows Event Trace Log (ETL) format;
    • WPE data files - for trace files in the WPE XML format;
  4. Select the required trace files and click Open.

* Note:* WPE Request Tracer Tool merges the trace data of opened files with the trace data of the 'call tree'. Then, the merged trace data is ordered by a time in the 'call tree'.

Saving Trace Files

To save the collected WPE requests to a trace file, perform the following actions:

  1. In the WPE Request Tracer Tool window, in the top menu, click File, and then click Save As.

    - OR -

    Press CTRL+S.

  2. Specify the required file name and click Save. The trace file will be saved in the WPE XML format.

Tracing WPE Requests on WPE Cluster

To perform tracing on a WPE Cluster, you may use the following approaches:

  • Run WPE Request Tracer Tool on each WPE Cluster Node (WPESRV01, WPESRV02, etc). Then, start a real-time tracing in the opened WPE Request Tracer Tool applications.
  • On each WPE Cluster Node (WPESRV01, WPESRV02, etc), gather a trace data to the trace files in the Windows Event Trace Log (ETL) format. Then, put the trace files on the host having WPE Request Tracer Tool installed and open the trace files in WPE Request Tracer Tool. The trace files will be represented in a merged view.

Note: WPE Request Tracer Tool merges the trace data of opened files with the trace data of the 'call tree'. Then, the merged trace data is ordered by a time in the 'call tree'.

Viewing Parallels Windows Provisioning Engine Logs

To view the log files of the WPE service, perform the following actions:

  1. Log on to host where the WPE service is installed as Domain Administrator.
  2. Go to the WPE installation directory (the default WPE installation directory is the C:\Program Files\Parallels\Windows Provisioning Engine\), and then go to the Logs directory.

Documentation

WPE Requests Tracer Tool is also described in the POA Windows Hosting Infrastructure Deployment Guide >> Deploying Windows Hosting Infrastructure > Deploying Parallels Windows Provisioning Engine > Using WPE Request Tracer Tool

Search Words

Migrate Address List to Exchange 2010

Attachments

5356b422f65bdad1c3e9edca5d74a1ae caea8340e2d186a540518d08602aa065 ac82ce33439a9c1feec4ff4f2f638899 2554725ed606193dd9bbce21365bed4e e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF