0% found this document useful (0 votes)
68 views106 pages

Dispatcher Install and Configure

The document provides a comprehensive guide for installing and configuring the Dispatcher component of Teamcenter 12.2. It includes sections on deployment considerations, installation steps, post-installation tasks, and configuration options for both the Dispatcher server and client. Additionally, it covers enabling default translators and adding custom translators to enhance functionality.

Uploaded by

cad cad
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
68 views106 pages

Dispatcher Install and Configure

The document provides a comprehensive guide for installing and configuring the Dispatcher component of Teamcenter 12.2. It includes sections on deployment considerations, installation steps, post-installation tasks, and configuration options for both the Dispatcher server and client. Additionally, it covers enabling default translators and adding custom translators to enhance functionality.

Uploaded by

cad cad
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 106

SIEMENS

Teamcenter 12.2

Installing and
Configuring
Dispatcher
PLM00562 • 12.2
Contents

Introduction to Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1


Install and configure Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Why use Dispatcher? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Dispatcher components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Dispatcher deployment considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1


Selecting hardware for Dispatcher Server components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Criteria for choosing hardware for Dispatcher Server components . . . . . . . . . . . . . . . . . . . . . 2-1
Dispatcher deployment strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Planning the deployment of the dispatcher components . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
All local (same host) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Distributed on multiple hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Install and configure Dispatcher components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1


Install Dispatcher using TEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Install Dispatcher components using TEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Install all Dispatcher components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Install Dispatcher components on an existing Teamcenter installation or on different
machines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Post-installation tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Create a dispatcher client access rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Set up the common staging directory for translator input and output files . . . . . . . . . . . . . . 3-6
Start Dispatcher services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Stop, pause Dispatcher services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
View Dispatcher service runtime information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Verify the Dispatcher installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Verifying your Dispatcher installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Verify Dispatcher components by performing a doc to zip file translation . . . . . . . . . . . . . 3-10
Test Dispatcher by translating files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Test the installation by creating a translation request . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
Configure Dispatcher components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Enable Dispatcher to work with Security Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Update Dispatcher components to work with UTF-8 configuration . . . . . . . . . . . . . . . . . 3-15
Switch from a 4-tier Dispatcher client to a 2-tier version . . . . . . . . . . . . . . . . . . . . . . . . 3-15
Set preferences for repeating tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
Set system and environment variables to run dispatcher client as a Windows service . . . . 3-15
Enable log files for dispatcher requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
Using logs for error handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17

Configure the Dispatcher server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1


Configure Dispatcher Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

PLM00562 12.2 Installing and Configuring Dispatcher 3


Contents
Contents

Configure the Dispatcher client for default translators . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

How to configure the Dispatcher client for default translators . . . . . . . . . . . . . . . . . . . . . . . . . 5-1


Create validation rules to disallow the same primary object from being translated twice . . . . . . . 5-1
Specify default filters to set translation rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Set up options to automatically clean up completed translations . . . . . . . . . . . . . . . . . . . . . . 5-2
Configure the dispatcher client properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

Enable default translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Planning for enabling translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1


Introduction to translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
Enable translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
Editing the translator.xml file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Creating an exclusion list for error messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
Modifying tessellation configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
Enable the default translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
Enable asynchronous services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
Enable PLM XML based translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13
Enable BatchPrint and PublishBatch translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Enable CAD part translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18
Enable CAD drawing translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19
Enable the ContMgmtPublish translator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20
Enable FMSTransfer, ImportObjects, JtToBBoxAndTso, and mmvindexgen translators . . . 6-21
Enable PcbToFatf, PartUtility, and PdfGenerator, and populateFSC translators . . . . . . . . . 6-23
Enable QSEARCH_process_queue, QueryScos, and RenderMgtTranslator translators . . . 6-25
Enable Simulation Process Management translators . . . . . . . . . . . . . . . . . . . . . . . . . . 6-27
Enable the store_and_forward translator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-29
Enable Teamcenter Substance Compliance services . . . . . . . . . . . . . . . . . . . . . . . . . . 6-30
Enable NX translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-31
Enable tc3dpdftrans and tcmfg_update_productviews translators . . . . . . . . . . . . . . . . . . 6-33

Add custom translators to Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

How to add custom translators to Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1


Create custom filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
What are filter classes? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Develop custom Dispatcher client filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
Extract data and load data required for translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
What is the extract-transform-load (ETL) model? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
What is the Dispatcher request object? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Dispatcher request object attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5
Dispatcher request states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
Translation process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7
Create dispatcher requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7
Why create dispatcher requests? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7
Create dispatcher requests in Teamcenter rich client . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
Create Dispatcher requests using ITK APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
Creating Dispatcher requests using Teamcenter Services . . . . . . . . . . . . . . . . . . . . . . . . 7-9
Batch translations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
Workflow translations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

4 Installing and Configuring Dispatcher PLM00562 12.2


Contents

Integrate new translators in the rich client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9


Add customizations during the Dispatcher client startup . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11
Translation menu integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12
The Translation menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12
Create a new menu item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12
Create a dispatcher request using a new menu item . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12
Customizing Translation Selection dialog box behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13
Why customize the Translation Selection dialog box behavior? . . . . . . . . . . . . . . . . . . . 7-13
Create a custom plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14
Create a custom class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

Monitor and administer translation requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1


Dispatcher request administration console interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
Refresh, resubmit, delete, or filter Dispatcher requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
View dispatcher properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
View logs attached to dispatcher requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3
Dispatcher request administration console performance tuning . . . . . . . . . . . . . . . . . . . . . . . 8-4

Customize the rich client for Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1


Enable translation options in the user interface by adding Dispatcher preferences . ...... . . . 9-1
Create a Dispatcher request and extract the data required for the translation using sample
preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...... . . . 9-3
Customizing the Dispatcher request administration console . . . . . . . . . . . . . . . . ...... . . . 9-3
Why customize the Dispatcher request administration console? . . . . . . . . . . . ...... . . . 9-3
Filter requests in the Dispatcher request administration console . . . . . . . . . . . ...... . . . 9-3
Create a new submenu under the Translation menu . . . . . . . . . . . . . . . . . . . ...... . . . 9-4

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
Troubleshoot Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
Checklist to handle errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
Isolate translation problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
Setting debug levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3
Query translation request objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
Unable to run Dispatcher components as Windows service due to missing DLL file . . . . . . 10-4
Optimizing performance of the dispatcher client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5
Dispatcher requests go to terminal state due to large number of files open . . . . . . . . . . . 10-5
Troubleshoot Translators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5
NXToPvDirect translations hang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5
View runtime status of Dispatcher services and Dispatcher client history . . . . . . . . . . . . . 10-7

PLM00562 12.2 Installing and Configuring Dispatcher 5


Chapter 1: Introduction to Dispatcher

Install and configure Dispatcher


A typical workflow for installing and configuring Dispatcher is as follows:

• Plan your deployment strategy

• Install Dispatcher components on different machines as per the deployment strategy

• Configure Dispatcher Server

• Configure the Dispatcher client

• Enable default translators

• Add custom translators to Dispatcher

• Troubleshoot Dispatcher or troubleshoot translators

Why use Dispatcher?


Dispatcher comprises the integration of two components: Dispatcher Server and Teamcenter.
Dispatcher enables Teamcenter users to manage job distribution and execution.
With Dispatcher, you can:
• Asynchronously distribute jobs to machines with the resource capacity to execute the job. (The
jobs can also be done in a synchronous manner on the local client machines, but this can
introduce performance and administration issues based on the job load.)

• Reduce server load by distributing resource-intensive activities.

PLM00562 12.2 Installing and Configuring Dispatcher 1-1


Chapter
Chapter 1: 1: Introduction
Introduction to Dispatcher
to Dispatcher

• Schedule high-CPU or high-memory jobs for off-hours processing.

• Get a grid technology solution to manage the job distribution, communication, execution, security,
and error handling. You can scale and customize the Dispatcher system to meet specific site
requirements.

Dispatcher is used to translate data files that are managed by Teamcenter to 3D or 2D file formats.
You can:
• View, edit, and mark up data without requiring the original data’s authoring tool.

• Share the data with other companies without distributing the original raw data (such as CAD
and MS Office).

• Generate a lightweight data format known as visualization data. The visualization data can be
attached along with the raw data and can be viewed by Teamcenter viewers or by third-party
applications capable of reading and displaying the format.

Dispatcher components
• Dispatcher Client
This component provides the framework to extract and load data to Teamcenter. It provides the
communication mechanism to use the other Dispatcher Server components.

• Scheduler
This component manages the distribution of translation requests across modules. Translation
tasks are submitted to the scheduler by Teamcenter via RMI communication. The scheduler
tracks which modules are available and the translators available with each module. It uses
this information to distribute the translation tasks to keep each module running to its maximum
capacity.
The scheduler is a Java™-based RMI application. It comprises exposed interfaces used by the
Dispatcher Client to send and receive information about Dispatcher requests. The scheduler
communicates with the module using RMI.

• Module
This component is used for sending tasks to specific translators required for the translation tasks.
It provides the infrastructure for a common way to plug in and execute any translator and support
the various command line options, parameters, and configuration files unique to each translator.
The module is a Java-based RMI application. It has exposed RMI interfaces used by the
scheduler to send and receive information about translation requests.

• Translators
The translators used in the Dispatcher system are a combination of translators developed by
Siemens PLM Software and those developed by a third party. Translators can be driven by the
Dispatcher system to use specific configuration files or parameters to support translation-specific
behavior.

1-2 Installing and Configuring Dispatcher PLM00562 12.2


Introduction to Dispatcher

• Dispatcher request administration console


This component manages and monitors the status of a task submitted for translation. You can
use the Dispatcher request administration console in the rich client to:

o View all translation requests.

o Resubmit a translation request for processing.

o Delete a translation request.

PLM00562 12.2 Installing and Configuring Dispatcher 1-3


Chapter 2: Dispatcher deployment considerations

Selecting hardware for Dispatcher Server components


Selecting hardware for the module and translators
The module is where all the intense computational process of translations occur. It must be sized
sufficiently to handle the expected translation throughput.
The module hardware requirement is governed by the translator hardware requirements, number
of translators installed, and the number of maximum potential translation tasks (number of users
simultaneously submitting tasks).
An enterprise class server machine is highly recommended for the module, as these machines have
the ability to scale the number of CPUs and memory much more than a normal workstation.

Selecting hardware for the scheduler


The scheduler provides the communication from Teamcenter clients and manages the queue and job
distribution to the modules.
The scheduler is only a pipeline mechanism to manage the translation requests used by modules.
The scheduler requires minimum machine resource to run; however, it does hold an object in memory
for each translation request that it is managing.

Selecting hardware for the dispatcher client


The dispatcher client sends the translation task from Teamcenter to Dispatcher Server. Only one
dispatcher client is required per Teamcenter server installation.
The dispatcher client for Teamcenter manages the data extraction and data loading into Teamcenter.
While the data extracting and loading are not computationally intensive, it does require a machine
with communication pipeline to the server as well as enough disk space and memory needed for
the operations. Although not required, the recommended approach is to have the Dispatcher client
running on the same machine as the Teamcenter server.

Criteria for choosing hardware for Dispatcher Server components


Prior to determining the type of machines to use for translations, determine the Dispatcher Server
system usage to set up the correct environment to support the expected throughput.

Number of users
The number of users submitting translation tasks must be accounted for when trying to get the
maximum amount of throughput.
If a site has 100 users who can potentially submit 100 simultaneous translation tasks, and the
expected throughput is 1 hour, there must be sufficient computational capacity to handle the load.

PLM00562 12.2 Installing and Configuring Dispatcher 2-1


Chapter
Chapter 2: 2: Dispatcher
Dispatcher deployment
deployment considerations
considerations

This can be accomplished by providing enough CPU and memory to handle the 100 tasks. Increasing
load capacity can also be handled by adding additional modules to handle the additional throughput.
As throughput requirements increase or decrease, modules can be started or stopped dynamically to
handle the load requirements.

Size and complexity of the translation models


Knowing the average size of the models that use the system gives an idea as to the minimal
requirements required for supporting the normal day-to-day operational needs. Consider the size of
the models to be submitted for translation estimates when planning for the number of translations
that can be executing simultaneously.

Note
If a machine has 10 GB memory available, and the average size of the model requires 4
GB of memory to translate, the maximum number of translators that should be configured
to run at a given time should be two.

Model complexity influences translation times. Models with many curves are more geometrically
complex to translate than models with many straight edges.

Computational ability of the translation machine


The components required to get the data from Teamcenter to the translators are mainly pipeline
mechanisms for moving data and communication and require proper network bandwidth for the
expected data load, which is unique to each site. The machine performing the actual translation task
must have enough CPU, memory, and disk space capacity to load and translate the models.

Disk space requirements


Understanding the disk space requirements needed ensures that the translations do not run out of
disk space during a translation. To obtain the required disk space requirements, multiply the average
sized model with the number of possible simultaneous translations.
Average model size * number of translations = Average disk space needed at any given time
You also need to account for the generated data, logs, and CAD system files while calculating the
disk space needed.

Dispatcher deployment strategies

Planning the deployment of the dispatcher components


Many deployment strategies for Dispatcher Server components can be defined to meet specific
needs. The main goal of defining a deployment layout is to have the Dispatcher Server components
run on machines that have the resource capacity (CPU, memory, disk space, and network bandwidth)
to handle the expected throughput of the site.
You can install Dispatcher Server components on the same machine. While this minimizes the
administrative overhead, it reduces the scalability. A deployment across multiple machines allows

2-2 Installing and Configuring Dispatcher PLM00562 12.2


Dispatcher deployment considerations

distribution of the needed computing resources and provides scalability. However, distributing the
services across machines increases administrative overhead.
The Dispatcher Server components can be configured to support various domain requirements. You
can select from various deployment layouts based on your requirements.

All local (same host)


All Dispatcher Server components run on the same host. This deployment is typically used if the
translation load on your site is less or if you have a high-end machine with a large amount of CPU,
memory resources, and sufficient disk space capable of handling the expected translation throughput.
A typical 2-tier installation is as follows.

To install Dispatcher Client, run TEM, select Corporate Server, select Teamcenter Foundation
(default for 2-tier) and Dispatcher Client, specify the Teamcenter data directory of the Teamcenter
server, and the host name and the host port of the machine on which scheduler is installed.

Distributed on multiple hosts

A 4-tier installation with a separate module

This deployment strategy is to install the Teamcenter server and the Dispatcher client on the same
machine and the scheduler and the module on separate machines.

PLM00562 12.2 Installing and Configuring Dispatcher 2-3


Chapter
Chapter 2: 2: Dispatcher
Dispatcher deployment
deployment considerations
considerations

1. To install scheduler on Machine 3, run TEM on Machine 3, select Dispatcher Server and specify
the Teamcenter root directory and the Teamcenter data directory of the Teamcenter server (that
is, Machine 2).

2. To install the module on Machine 4, run TEM on Machine 4, select Dispatcher Server, and
specify the staging directory (separate machine) and the host name and host port of the machine
on which the scheduler is installed (that is, Machine 3).

A 4-tier installation with two separate modules

Here, Teamcenter server, the Dispatcher client, the scheduler, and modules are installed on separate
machines.

2-4 Installing and Configuring Dispatcher PLM00562 12.2


Dispatcher deployment considerations

1. To install the Dispatcher client on Machine 3, run TEM on Machine 3, select Dispatcher Client
and select the RMI option, and specify the Dispatcher server host name and the Dispatcher
server port (that is, Machine 2).

In addition, specify the staging directory and the Dispatcher client proxy user name and
password. The staging directory can be a separate machine.

2. To install scheduler on Machine 4, run TEM on Machine 4, select Dispatcher Server, and specify
the Dispatcher client host name and host port (that is, Machine 3).

3. To install the module on Machine 5, run TEM on Machine 5, select Dispatcher Server, and
specify the staging directory (separate machine) and the host name and host port of the machine
on which scheduler is installed (that is, Machine 4).

A 4-tier installation with two separate modules where one module is for a high throughput,
dedicated translator

There are two setups in this example.

• The first is a dedicated setup for a high throughput, dedicated translator. This has Teamcenter
server and the Dispatcher client installed on the same machine, and scheduler and the module
are installed on separate machines.

• The second is a setup for multiple translators on a single machine. This has Teamcenter server,
the Dispatcher client, the scheduler, and the module installed on separate machines.

PLM00562 12.2 Installing and Configuring Dispatcher 2-5


Chapter
Chapter 2: 2: Dispatcher
Dispatcher deployment
deployment considerations
considerations

2-6 Installing and Configuring Dispatcher PLM00562 12.2


Chapter 3: Install and configure Dispatcher components

Install Dispatcher using TEM

Install Dispatcher components using TEM

Install the following components as per your deployment strategy:


• Install the scheduler on a separate machine that communicates with both the Dispatcher client
and the modules.

• Install Dispatcher client on the same machine as the Teamcenter server or on a different machine
that communicates with the server manager.

• Install modules on different machines depending on the translation load.

• Install Dispatcher Client for rich client on the servers where you install Teamcenter. This is for
the Dispatcher user interface, that is, the translate menu and the right-click translate options in
the rich client.

• (Optional) Install Admin Client on the server where you install Teamcenter. This is to verify
the Dispatcher Server installation.

Install all Dispatcher components

Note
The following instructions are for installing Dispatcher with a new installation of Teamcenter.

1. Start Teamcenter Environment Manager (TEM).


If you are installing Dispatcher on an already existing Teamcenter server, launch TEM from your
Teamcenter environment.
If this is a first-time installation of a Teamcenter server and you want to include Dispatcher, run
the TEM.bat (Windows) or TEM.sh (UNIX) file from your installation source.

2. In the Solutions panel, select Dispatcher (Dispatcher Server).

3. Perform the following steps in the Select Features panel:

PLM00562 12.2 Installing and Configuring Dispatcher 3-1


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

a. Under Enterprise Knowledge Foundation, select the following:


• Dispatcher Client for Rich Client
Installs the Dispatcher client on the rich client.
This feature requires either the Teamcenter two-tier rich client or the Teamcenter four-tier
rich client.

• Dispatcher Server
Installs Dispatcher Server components: scheduler, module, and Admin Client.

• Dispatcher Client (4-tier)


Installs the Dispatcher client in 4-tier mode.
Siemens PLM Software recommends the 4-tier mode as it requires a smaller footprint
and is more scalable.

• Dispatcher Client (2-tier)


Installs the Dispatcher client in 2-tier mode.
Siemens PLM Software recommends the 4-tier mode.

4. Enter information as needed in subsequent panels.

5. In the Dispatcher Components panel, do the following:


a. In the Dispatcher Root Directory box, type or select the Dispatcher root directory.
Keep the Dispatcher root directory as close to the Teamcenter root directory as possible.
This directory is referred to as DISP_ROOT.

b. Select the Install Scheduler check box to install the scheduler.

c. Select the Install Module check box to install the module.


If you select the Install Module check box, the Staging Directory box is activated.
In the Staging Directory box, you can choose the default staging directory or type a new one.

Note
If you are installing the module and the scheduler on the same machine, the
Scheduler Host and the Scheduler Port boxes are disabled.

d. Select the Install Admin Client check box to install the Admin Client.

e. Click Next.

6. In the Dispatcher Settings panel, do the following:


a. Select the logging level in the Enter Logging Level box.

3-2 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

The Dispatcher Services Log Directory is automatically populated with the location of
the log directory.

b. Select the Install Documentation check box to install Javadocs for the Dispatcher
components.

c. In the Documentation Install Directory box, type or browse to the location where you
want the documentation installed.

d. If you want to start Dispatcher services after installation, select the Starting Dispatcher
Services check box.
• To start Dispatcher services as a Windows service, click Start Dispatcher Services
as Windows Services.

• To start Dispatcher services from the console, click Start Dispatcher Services at
console.

e. Click Next.

7. In the Select Translators panel, select the translators you want to enable and click Next.

8. In the Translator Settings panel, provide configuration information for the translators you
selected in the Select Translators panel and click Next.

9. In the Dispatcher panel, do the following:


a. In the Dispatcher Server Hostname box, type the name of the server where the translation
server is hosted.

b. In the Dispatcher Server Port box, type the port to be used for the Dispatcher Server.
The default port number is 2001.
The scheduler port is used.
Make sure that the port you choose is not used by any other process.

c. In the Staging Directory box, type or browse to the location to be used as the staging
directory for the Dispatcher client.

d. In the Dispatcher Client Proxy User Name box, type the name of the proxy user who
uses Dispatcher services.

e. In the Dispatcher Client Proxy Password box, type the password for the proxy user.

f. In the Dispatcher Client Proxy Confirm Password box, type the password for the proxy
user.

g. In the Polling interval in seconds box, type the time in seconds that the Dispatcher client
should wait for before querying for Dispatcher requests.

h. In the Do you want to store JT files in Source Volume? box, select Yes if you want to
store visualization files in the associated visualization dataset.

PLM00562 12.2 Installing and Configuring Dispatcher 3-3


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

If you select No, the visualization files are stored in the Dispatcher Client Proxy User default
volume.

i. Click Next.

10. In the Dispatcher Client panel, do the following:


a. Select the logging level in the Enter Logging Level list.

b. The Dispatcher Client Log Directory is automatically populated with the location of the log
directory.

c. In the Advanced Settings section, do the following:


A. In the Do you want to Update Existing Visualization Data? box, select Yes if you want
to update existing visualization data to the latest version.

B. In the Deletion of successful translation in minutes box, specify the time (in minutes)
that the dispatcher client should wait before querying and deleting successful translation
request objects.
If the interval is set to zero, the translation request cleanup is not performed.

C. In the Threshold time in minutes for successful translation deletion box, specify
the time (in minutes) that must pass after a successful translation request object is last
modified before it can be deleted.

D. In the Deletion of unsuccessful translation in minutes box, specify the time (in
minutes) that the dispatcher client should wait before querying and deleting unsuccessful
translation request objects.

E. In the Threshold time in minutes for unsuccessful translation deletion box, specify
the time (in minutes) that must pass after an unsuccessful translation request object
is last modified before it can be deleted.

d. Click Next.

11. In the Confirm Selections panel, click Next.


The installation starts.

Install Dispatcher components on an existing Teamcenter installation or on


different machines

Deciding what Dispatcher components to install


If you are installing Dispatcher components to different machines, decide what components are
to be installed on what machines. This should be based on machine resources and throughput
requirements for the installation.

Install Dispatcher while creating a new configuration


1. Start Teamcenter Environment Manager.

3-4 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

2. In the Maintenance panel, choose the Configuration Manager option and click Next.
Teamcenter Environment Manager displays the Configuration Maintenance panel.

3. In the Configuration Maintenance panel, choose the Add new configuration option and
click Next.
Teamcenter Environment Manager displays the New Configuration panel.

4. Enter a description of and unique ID for the configuration you are creating and click Next.
Teamcenter Environment Manager displays the Solutions panel.
Ensure that you select the Dispatcher (Dispatcher Server) option.

5. Select the components to include in the configuration and click Next.


Teamcenter Environment Manager displays the Select Features panel.

6. In the Select Features panel, select the Dispatcher components.


The Dispatcher components are available under Extensions→Enterprise Knowledge
Foundation.
From this point, the procedure is the same as for the first configuration in an installation.
Teamcenter Environment Manager displays additional panels depending on the components you
are including in the configuration.

Install Dispatcher while performing maintenance on an existing configuration

1. Start Teamcenter Environment Manager.

2. In the Maintenance panel, choose the Configuration Manager option and click Next.

3. In the Configuration Maintenance panel, choose the Perform maintenance on an existing


configuration option and click Next.

4. From the list of configurations, select the configuration you want to modify and click Next.

5. In the Feature Maintenance panel, select Add/Remove Features and click Next.

6. In the Select Features panel, select the Dispatcher components.


The Dispatcher components are available under Extensions→Enterprise Knowledge
Foundation.
From this point, the procedure is the same as that for the first configuration in an installation.
Teamcenter Environment Manager displays additional panels depending on the components you
are including in the configuration.

PLM00562 12.2 Installing and Configuring Dispatcher 3-5


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

Post-installation tasks

Create a dispatcher client access rule


After installation, you must add a rule to the access rule tree permitting the translation service proxy
user to update attributes of a DispatcherRequest object. If this access rule is not created correctly,
the dispatcher client reports errors.
1. Log on to the Teamcenter rich client as a system administrator.

2. Open Access Manager.

3. In Access Manager, add the following rule to the rule tree under Has Class
(POM_application_object)→Working:
Condition =Has Class

Value =DispatcherRequest

ACL Name =DispatcherRequest

ACE Type of Accessor =User

ACE ID of Accessor =DC-Proxy-User-ID

ACE Privilege =Write

ACE Privilege Value =Grant

ACE Privilege =Delete

ACE Privilege Value =Grant

Note
This rule applies only to the standard Access Manager rule tree. If custom rules
are specified for the installation, your custom rules must be modified to provide the
equivalent access of this rule. The DC-Proxy-User must be the same user that was
specified during installation using Teamcenter Environment Manager.

Set up the common staging directory for translator input and output files
The RMI mode supports translations within a firewall and requires a common staging directory. In
this mode, the Dispatcher Server clients can directly communicate with the scheduler and perform
the translations without a web server and file server. Unlike the web mode, the RMI mode does not
require file transfers from the Dispatcher Server client locations and module locations.
The following are the prerequisites for setting up the staging directory:
• The clients and Dispatcher Server should point to the common staging directory and both should
have read and write permissions to that directory.

3-6 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

This avoids the need for file transfers from the client and module locations. The client writes the
translator input files to the common staging directory, and the module writes the translator result
files to the staging directory in the results directory. For example, if d:\StagingDir is the common
staging directory for the module machine, then \\ModuleMachine\StagingDir on the client machine
(can be a different machine) must be the same directory, that is, StagingDir.

• The client and Dispatcher Server should be installed by the same user to avoid directory access
issues as the client and dispatcher modules use the same staging location.

• In the common staging directory configuration, the dispatcher module must have permissions to
create directories and write access to files on the client staging location using the network.
This means that when you access the staging location from the module machine, you should be
able to access or list (in UNIX systems) the directory contents of the staging location. The staging
location can be a shared location on the network.

• The physical location of the machine on which the common staging directory is configured must
be in closer proximity to the module machines than the dispatcher server client machines.
This helps the translators to access files faster. The translators create temporary files and read
the source files from the common staging directory.

Start Dispatcher services


During installation of the Dispatcher components, you specified the Dispatcher root directory. This
directory is referred to as DISP_ROOT.
To fully process a Dispatcher request, all of the following services must be running in this order:
scheduler, module, and dispatcher client.
During installation of the Dispatcher feature, you have the option of installing the Dispatcher services
either as a service or as a console process.

Start scheduler

• Run the following command:


Windows systems:
DISP_ROOT/Scheduler/bin/runscheduler.bat

UNIX systems:

DISP_ROOT/Scheduler/bin/runscheduler.sh

Start module

• Run the following command:


Windows systems:
DISP_ROOT/Module/bin/runmodule.bat

UNIX systems:

DISP_ROOT/Module/bin/runmodule.sh

PLM00562 12.2 Installing and Configuring Dispatcher 3-7


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

Start dispatcher client


• Ensure that the scheduler and module services are running before starting the dispatcher client.
Run the following command:
Windows systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.bat

UNIX systems:

DISP_ROOT/DispatcherClient/bin/runDispatcherClient.sh

Stop, pause Dispatcher services


If you have installed Dispatcher services as a service, you can stop them by using the stop command.

Tip
The sequence for stopping services is the reverse of starting services and it is important
to follow the sequence.

Stop dispatcher client


• Run the following command:
Windows systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.bat —stop

UNIX systems:

DISP_ROOT/DispatcherClient/bin/runDispatcherClient.sh —stop

Stop module
• Run the following command:
Windows systems:
DISP_ROOT/Module/bin/runmodule.bat —stop

UNIX systems:

DISP_ROOT/Module/bin/runmodule.sh —stop

Stop scheduler
• Run the following command:
Windows systems:
DISP_ROOT/Scheduler/bin/runscheduler.bat —stop

UNIX systems:

DISP_ROOT/Scheduler/bin/runscheduler.sh —stop

3-8 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

Pause dispatcher client

• The pause command stops processing requests that are in the INITIAL state. This means
the dispatcher client does not accept any new tasks. Tasks that are In Progress continue to
be processed.
To pause the dispatcher client, run the following command:
Windows systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.bat —pause true

UNIX systems:

DISP_ROOT/DispatcherClient/bin/runDispatcherClient.sh —pause true

• To start the dispatcher client after pause, run the following command:
Windows systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.bat —pause false

UNIX systems:

DISP_ROOT/DispatcherClient/bin/runDispatcherClient.sh —pause false

View Dispatcher service runtime information


You can view the runtime status of Dispatcher services using the ping command.

Note
The ping command is performance intensive; use it only when required.

View runtime status of scheduler

• Run the following command:


Windows systems:
DISP_ROOT/Scheduler/bin/runscheduler.bat —ping

UNIX systems:

DISP_ROOT/Scheduler/bin/runscheduler.sh —ping

View runtime status of module

• Run the following command:


Windows systems:
DISP_ROOT/Module/bin/runmodule.bat —ping

UNIX systems:

DISP_ROOT/Module/bin/runmodule.sh —ping

PLM00562 12.2 Installing and Configuring Dispatcher 3-9


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

View runtime status of dispatcher client


• Run the following command:
Windows systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.bat —ping

UNIX systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.sh —ping

View history of tasks performed by dispatcher client


• The history command parses the history logs and shows the detailed summary of tasks
performed per day.
Run the following command:
Windows systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.bat —history

UNIX systems:
DISP_ROOT/DispatcherClient/bin/runDispatcherClient.sh —history

Verify the Dispatcher installation


Verifying your Dispatcher installation
To verify that the Dispatcher installation was successful, check the following:
• The scheduler, module, and dispatcher client are installed, and you should be able to successfully
start these services.

• If you installed dispatcher client for the rich client, you see the Translation menu in My
Teamcenter.

• You are able to perform a test translation with the tozipfile translator.

Caution
In the TC_ROOT directory, you see a directory called Dispatcher. You must not use the
contents of this directory for Dispatcher customizations or configurations.
All Dispatcher components are installed in a separate directory (DISP_ROOT). This
directory is defined during Dispatcher installation. You must use this directory for
Dispatcher customizations or configurations.

Verify Dispatcher components by performing a doc to zip file translation


Siemens PLM Software recommends that you do a test tozipfile translation to make sure that
Dispatcher components are working correctly.

3-10 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

Note
Make sure that you have created a dispatcher client access rule and started the Dispatcher
services.

1. In My Teamcenter, select an item revision.

2. Choose File→New→Dataset and in the New Dataset dialog box, select MSWord as the type
for the new dataset.

3. In the New Dataset dialog box, click Import to import your Microsoft Word file.

4. In the Import File dialog box, select the Microsoft Word file you want to import into My
Teamcenter and click Import.

5. Click OK to close the New Dataset dialog box.


Your file is imported as the new dataset type.

6. Select the imported dataset and choose Translation→Translate to translate your Microsoft
Word to the ZIP format.

7. In the Translation Selection dialog box, choose the tozipfile service.

8. Click Finish to start the translation process.

9. (Optional) Choose Translation→ Administrator Console –All to see the progress of the
translation.
After the translation is complete, the ZIP file appears in the item revision.

Test Dispatcher by translating files


1. In My Teamcenter, select an item revision.

2. In the item revision, select a CAD dataset and choose Translation→Translate.

3. In the Translation Selection dialog box, select the appropriate values for the Provider and
Service lists.

4. Select the translation time, priority, and translation by repeating schedule options from the Date
and Time Properties section.

5. Click OK to start the translation.

6. (Optional) Choose Translation→Administrator Console –All to see the progress of the


translation.

7. After the translation is complete, the translated CAD file appears in the item revision.

If your site has the Teamcenter lifecycle visualization embedded viewer installed, you can view the
translation result in the Viewer data pane in My Teamcenter or in the Viewer tab in Structure Manager.

PLM00562 12.2 Installing and Configuring Dispatcher 3-11


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

Test the installation by creating a translation request

Different ways of creating a translation request


Dispatcher provides two ways to create a translation request:
• From the Translation→Translate menu command in My Teamcenter

• Using the dispatcher_create_rqst utility

Create translation requests in My Teamcenter


1. In the navigation pane, select one or multiple datasets, item revisions, or structure context
objects for translations.

2. Choose Translation→Translate.
The Translation Selection dialog box shows the selected objects for translation.

3. In the Translation Selection dialog box, choose appropriate values from the Provider and
Service lists.

4. Click Finish to start the translation of all the objects.


The default translator arguments are used for the translation.

5. If you want to specify translator arguments and other properties, click Next.
Teamcenter shows the Translation Selection dialog box for the service.

3-12 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

6. In the Translation Arguments section, you add, modify, or delete Key and Value arguments.

7. In the Priority and Time Properties section, you can set the following options:
a. Time
Choose the time for the translation to start.
Click the Admin Time and Date properties button to display the Date and Time dialog
box.

In the Date and Time dialog box, type the translation start time and click OK.

b. Priority
Choose the priority for the translation task.

c. Repeating
Choose this option if you want to repeat the translation.

PLM00562 12.2 Installing and Configuring Dispatcher 3-13


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

Note
The Repeating option does not appear by default. You must set the
ETS.Repeating_UI.<ProviderName>.<ServiceName> preference to TRUE to
display the repeating tasks functionality.

Note
To avoid unpredictable behavior, the (time) interval in repeating tasks must be
greater than the translation time.

8. Click Finish to start the translation.


If there are other objects for translation, they are translated with the default values.

9. If you want to specify translator arguments and other properties for the remaining objects, click
Next.

Create translation requests from the command line

You can create a translation request from the command line by using the dispatcher_create_rqst
utility. This utility is located in the TC_ROOT/bin directory.
You can get the usage details of this utility by typing the following on the command line:
dispatcher_create_rqst —h

Configure Dispatcher components

Enable Dispatcher to work with Security Services


1. Install the dispatcher client using TEM. This ensures that Teamcenter creates a Dispatcher
Client Proxy User (dcproxy).

2. Create the same Dispatcher Client Proxy User in LDAP.

3. Ensure that the values of the following properties in the Service.properties file match the LDAP
values:
• Service.Tc.Group=dba

• Service.Tc.User=dcproxy(Dispatcher Client Proxy User)

4. Create an encrypted password file by running encryptPass.bat/sh LDAP password for


Dispatcher Client Proxy User.

5. Start dispatcher client.

3-14 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

Update Dispatcher components to work with UTF-8 configuration


When Teamcenter is set up to work in UTF-8, you can configure Dispatcher processes to support
UTF-8. To do this, update the startup scripts for all Dispatcher components (Dispatcher Client,
Scheduler, and Module) by adding the following JAVA VM option:
-Dfile.encoding=UTF-8

Note
If your translator uses JAVA, you must update its startup script.

Switch from a 4-tier Dispatcher client to a 2-tier version


To switch from a 4-tier Dispatcher client to a 2-tier version:
1. Update the values of the TC_ROOT and TC_DATA entries in the runDispactherClient.bat file
or the runDispactherClient.sh file.

2. Open the DispatcherClient\conf\Service.properties file and comment the following property:


Tc.URL=http://localhost:7001/tc

Set preferences for repeating tasks


• Set the ETS.Repeating_UI.<ProviderName>.<ServiceName> preference to TRUE to display
the repeating tasks functionality.

Caution
Repeating task functionality is an intensive option. This functionality increases the load
on the Dispatcher Server.

Set system and environment variables to run dispatcher client as a Windows


service
On Windows systems, you can optionally configure the dispatcher client as a Windows service.

Note
If you run the dispatcher client as a service, Siemens PLM Software recommends running
the scheduler and modules also as a service.

1. Set TC_DATA and TC_ROOT in the System variables section of the Windows Environment
Variables dialog box.
Examples:
TC_DATA=C:\Progra~1\Siemens\tcdata
TC_ROOT=C:\Progra~1\Siemens\Teamcenter8

PLM00562 12.2 Installing and Configuring Dispatcher 3-15


Chapter
Chapter 3: 3: Install
Install and configure
and configure Dispatcher
Dispatcher components
components

Note
When you install Teamcenter, TEM automatically sets the FMS_HOME system
variable.
The Dispatcher Client service fails to start as a Windows service if you do not set the
TC_DATA and TC_ROOT system variables.

2. Based on whether you use Teamcenter Key Manager, set the following environment variables:
a. If you use Teamcenter Key Manager, set the TC_KEY_MANAGER_PIPE environment
variable as a system variable.
You can find the value of this environment variable in the TC_ROOT\install\tem_init.bat
or the TC_ROOT/install/tem_init.sh file.

b. If you do not use Teamcenter Key Manager, set the value of the TC_USE_KEYMANAGER
environment variable to false.

3. Run the runDispatcherClientWinService.bat file from the DispatcherClient\bin directory.

4. From the Windows Services console, right-click DispatcherClientversion service and choose
Properties.

5. In the Log On pane, choose the This account option to assign a log on account for the
Dispatcher Client service.

Note
You must provide administrator privileges for the Dispatcher Client service.

6. Start the Dispatcher Scheduler.

7. Start the DispatcherClientversion service.

Note
Start the scheduler and modules before you start the dispatcher client to avoid connection
delays and translation failures.

Enable log files for dispatcher requests


To attach log files to dispatcher requests, update the following value in the Service.properties file.
The Service.properties file is located in the DISP_ROOT/DispatherClient/Conf directory.
• To attach log files to the dispatcher request when translation is successful, set
Translator.Provider name.Translator name.LogsForComplete to true.

3-16 Installing and Configuring Dispatcher PLM00562 12.2


Install and configure Dispatcher components

Example
Translator.SIEMENS.tozipfile.LogsForComplete=true

Note
By default, this attribute is set to false. If you do not want to attach log files to
the dispatcher request (for successful translation), remove the entry from the
Service.properties file.

• In case of translation failure, the log is automatically attached to the dispatcher request.

Using logs for error handling


When you install Dispatcher using TEM, you can specify a single root location for all log files. Logs
are written in the following format for all the Dispatcher components.
• Log-volume-location/category/process

• Log-volume-location/category/task

Log-volume-location is the central repository of log files and


category refers to Dispatcher components. In addition,
process is the directory for all process logs. Process logs are the main log files for Dispatcher
components. Finally,
task is the directory for all task logs. Task logs are log files specific to tasks such as submitting
files for translation or generating translated files.
You can also view logs of a particular translation in the Dispatcher request administration console.

PLM00562 12.2 Installing and Configuring Dispatcher 3-17


Chapter 4: Configure the Dispatcher server

Configure Dispatcher Server

• Configure the scheduler


To change the default values for the scheduler port, log volume location, and some other optional
properties, edit the DISPATCHER_ROOT\Scheduler\conf\transcheduler.properties file.

• Configure modules
For each module you have installed as per the deployment strategy, edit the following files:

o To change the default values for the staging directory, scheduler URL, scheduler port, log files
location, maximum number of tasks allowed in a module at a particular instant, and some other
optional properties, edit the DISPATCHER_ROOT\Module\conf\transmodule.properties
file.

o To activate translators, edit the DISPATCHER_ROOT\Module\conf\translator.xml file.

• (Optional) Configure the Admin Client


To change the default values for the Dispatcher Server URL, staging
directory, log files location, and some other optional properties, edit the
DISPATCHER_ROOT\AdminClient\conf\transclient.properties file.

PLM00562 12.2 Installing and Configuring Dispatcher 4-1


Chapter 5: Configure the Dispatcher client for default translators

How to configure the Dispatcher client for default translators


The following is the typical workflow for configuring default translators or translators available with
the installation kit.

• Set up the common staging directory for translator input and output files

• Create a dispatcher client access rule

• Create validation rules to disallow the same primary object from being translated twice

• Specify default filters to set translation rules

• Set up options to automatically clean up completed translations

• Enable translation options in the user interface by adding Dispatcher preferences

Create validation rules to disallow the same primary object from


being translated twice
The dispatcher client does a duplicate check by default to make sure that the same primary
object is not sent for translation. You can define translator-specific duplicate check by setting the
Service.CheckForDuplicateRequests property in the property file of the translator. If this property is

PLM00562 12.2 Installing and Configuring Dispatcher 5-1


Chapter
Chapter 5: 5: Configure
Configure the Dispatcher
the Dispatcher clientclient for default
for default translators
translators

not set for the translator, the default Service.CheckForDuplicateRequests property value is used.
Translator-specific duplicate check helps override the default Service.CheckForDuplicateRequests
property.

Example
Translator.provider name.translator name.Duplicate=false

Specify default filters to set translation rules


You can control translation services using dispatcher client filters. These provide a convenient way to
control dispatcher request objects that are exposed to the dispatcher client for processing. If filters
are specified for a dispatcher client, all dispatcher requests must pass this filter, or the dispatcher
request is not processed by the dispatcher client.
Configuration of dispatcher client filter is specified in the Service.properties file, located in the
DISP_ROOT/DispatcherClient/conf directory.
The Dispatcher client filters are implemented as a subclasses of the RequestFilter class. Dispatcher
supplies three request filters:
• TranslatorFilter
Filters dispatcher requests that do not contain the specified providers or translators.

• PriorityFilter
Filters dispatcher requests that have a priority lower than the specified priority.

• OwningUserFilter
Filters dispatcher requests that do not match the specified owning user name.

Set up options to automatically clean up completed translations


To clean up temporary files, use the Service.RequestCleanup options in the
DISPATCHER_ROOT\DispatcherClient\conf\Service.properties file.
You can use the Service.RequestCleanup options to automatically cleanup completed translation
request objects in the database, staging directory, and the logs. The system automatically deletes
translation requests for both successful and unsuccessful translation states.
There are six options available: three each for setting the translation interval, translation threshold,
and deleting logs for successful translations and three other options for the same settings for
unsuccessful translations.
For examples, see the DISPATCHER_ROOTDispatcherClient\conf\Service.properties file.

5-2 Installing and Configuring Dispatcher PLM00562 12.2


Configure the Dispatcher client for default translators

Configure the dispatcher client properties


The Tc.URL property is used to connect to Teamcenter to make SOA calls. By default, Dispatcher
uses the 4-tier mode. For the 2-tier mode, you must comment out this property.
In addition, you can specify the Teamcenter group that the dispatcher client logs on as, the relogin
interval, the owner of visualization datasets created by the dispatcher client, and other properties. For
more information, see the DISPATCHER_ROOT\DispatcherClient\conf\Service.properties file.

PLM00562 12.2 Installing and Configuring Dispatcher 5-3


Chapter 6: Enable default translators

Planning for enabling translators

Introduction to translators
Some system translators require a postprocessor translator and some require preprocessor
translators. Typically, postprocessor translators are used to generate a 2D preview or thumbnail
image of translated 3D data.
All presupplied translators require a postprocessor translator. These translators generate the 2D
preview image of the 3D data.
Some authoring tools require different translators for 3D (part) and 2D (drawing) engineering data.
Both formats must be translated to JPEG to create preview images. Typically, to support the full
range of translations for a given tool, you must install, enable, and configure both the part and the
drawing translators for that tool (in addition to the postprocessors).

Translators list

In your installation directory, refer to the Dispatcher_Root\Module\Translators directory for a


complete list of translators. Each translator directory contains a Readme.txt file for the specific
translator. This file provides a description of the translator, prerequisites, required licenses, and
the installation instructions.

Enable translators
1. Run TEM to install Dispatcher components as per your deployment strategy.

2. Run TEM to install each translator on the appropriate module as per your deployment strategy.
Alternatively, to manually configure the translators, locate the Dispatcher Server
software distribution image for your platform and copy the Translators directory to the
Dispatcher_Root\Module directory on each module machine.

Note
You must copy the Translators directory to the Dispatcher_Root\Module directory.
The configuration assumes absolute and relative addresses based on this directory.

3. Install the required software as per specifications. For example, some CAD translators require
the CAD software to be installed on the dispatcher machine.
You can follow the installation procedures provided by the software vendor to install the required
software for CAD parts, CAD drawings, postprocessor and file translator.

PLM00562 12.2 Installing and Configuring Dispatcher 6-1


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Note
Some CAD systems have a file path length limitation. The module must be installed in
a root-level directory to avoid this problem.

4. Install the translator. Each translator has specific installation instructions. Refer to the related
documentation for translator-specific installation instructions. Ensure that each translator is
properly licensed.

5. Before integrating the translator with the Dispatcher Server, perform a manual test of the
translation locally.

Note
If the manual test is successful, it is easier to isolate issues specific to the file server,
the scheduler, and the module.

6. Back up the translator.xml file, modify it to activate each installed translator, and then associate
each translator with a translator module.

Caution
Incorrect modifications to the translator.xml file can cause some or all translators
to fail.

7. Some translators require additional configuration, such as setting batch file environment variables
or tessellation configuration.

8. After implementing each translator, run the dispatcher module to include the translator so that
you can progressively troubleshoot for any file translation errors.

9. Repeat the same steps for each translator you want to enable.

Editing the translator.xml file

Editing the translator.xml file


Each translator is associated with a translator module by specifying the required information in the
translator.xml file in the Dispatcher_Root\Module\conf directory. Similar to any XML file, it consists
of elements and attributes.
• Each translator is defined within a unique element
Each supported translator is defined in its own element (for example, ToZipfile), all nested within
a <Translators> element. Nested within each translator element are elements that define the
location of the translator and any required software, supported file name extensions, classpath
definitions, or any other required data.

• Modifying the isactive attribute to activate a translator

6-2 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

To activate a translator, modify the isactive attribute to true. Retain it as false to keep the
translator turned off.

Note
By default, the isactive value is set to false for all translators in the translator.xml file.

• Wrapper class attribute for defining a wrapper


Most translators have a wrapper class attribute used to define a wrapper. Wrappers are used
for managing translations including threading, process control (start and stop), status checking,
error handling, and completion status.
Example:

<ToZipfile provider="SIEMENS" service="tozipfile" maxlimit="1"


isactive="true" NoOfTries="1" OutputNeeded="true" MaximumProgress="100"
WaitTimeBetTrans="0" WaitTimeForReTries="0" ExclExitVal="1"
wrapperclass="com.teamcenter.tstk.translator.DefaultTranslator">

Note
You need not modify the wrapperclass attribute unless you write a custom wrapper to
manage your translator.

• Modifying attributes to associate a translator


To associate a translator with the translator module, modify the attributes that point to various
executable files or the classpath. In some cases, you must define additional elements to
accommodate additional file extensions.

• Modifying input and output extensions


The InputExtensions and OutputExtension elements define valid input and output file
extensions for each translator.

Note
If your site uses nonstandard file extensions (extensions that are not specified in the
translator.xml file) for certain file types, you can add that file extension to the list
of supported extensions.

PLM00562 12.2 Installing and Configuring Dispatcher 6-3


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Example:
<FileExtensions>
<InputExtensions nitem="1">
<InputExtension extension=".pkg"/>
</InputExtensions>
<OutputExtensions nitem="2">
<OutputExtension extension=".jt"/>
<OutputExtension extension=".cgm"/>
</OutputExtensions>
</FileExtensions>

As shown in the example above, you must change the nitem attribute based on the number of
input or output file extensions for each translator.

• Editing the maxlimit, NoOfTries, and OutputNeeded properties.


o maxlimit defines the maximum number of translation that can run simultaneously. The
default value is 1.

o NoOfTries defines the number of tries to make in case the translation fails. The default
value is 1, that is, no retry.

o OutputNeeded defines whether a result file is expected from the translation. The default
value is true.

Define entities
1. Open the translator.xml file from the Dispatcher_Root\Module\conf directory.

2. Locate the <!ENTITY> elements located at the start of the file.

3. For each translator you want to activate, set the isactive attribute to true.
Example:

<!-- Configuration of the Pro Engineer to JT translator -->


<ProEToJt provider="Siemens" service="proetojt" isactive="true"
wrapperclass="&EAIWRAPPER;">

4. For each installed translator, verify the MODULEBASE property.


Example of a translator startup file called from the Dispatcher_Root\Module\Translators
directory:
<TransExecutable dir="&MODULEBASE;/Translators/catiatojt/v5/UGS"
name="catiav5tojt.sh" />

Example of a deamon executable called from the directory where the translator is installed:

<Daemon exec="/proe<ver>/sun4_solaris/nms/nmsd" args="-noservice"/>

Modify input extensions


1. Open the translator.xml file from the Dispatcher_Root\Module\conf directory.

6-4 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

2. Locate the <InputExtensions> tag for the translator you want to modify. Increment the value of
the nitem parameter to the total number of file extensions you want to support.

3. For each additional file extension, add an <InputExtension extension=" "> tag. Specify the file
extension (including the dot) in the extension attribute.

The following example shows the IdeasToJt translator definition modified with the <InputExtension
extension=""> tag to accept files with the SLDASM extension:
<FileExtensions>
<InputExtensions nitem="1">
<InputExtension extension=".pkg"/>
</InputExtensions>
<OutputExtensions nitem="2">
<OutputExtension extension=".jt"/>
<OutputExtension extension=".cgm"/>
</OutputExtensions>
</FileExtensions>

Creating an exclusion list for error messages

Creating an exclusion list for error messages


Translators display error messages or warning messages while performing translations. The
dispatcher module cannot distinguish between serious errors that result in translation failures and
simple warnings. For example, the following warning can prevent the dispatcher module from
completing the translation:
This is not an error string

The Dispatcher Server provides an exclusion list in the translator.xml file to ignore simple
warnings and continue the translation. The translator.xml file contains predefined InputStream
and ErrorStream error strings with keywords such as cannot, error, exception, and failed. The
dispatcher module checks both the streams for the error displayed by the translator, verifies whether
the same error is defined in the exclusion string, and if they are the same, the module continues with
the translation.
You can add specific error strings to the exclusion list to prevent the dispatcher module from stopping
translations. For example, you can add Not a Failure within the TransErrorExclStrings tags of the
ToZip translator in the translator.xml file to prevent this translator from failing.

Error strings
The error tags can be either translator specific or global. You can use:
• Translator-specific error tags for specific translators defined in the translator.xml file.

• Global error tags for all active translators in the dispatcher module.

Note
When you use translator-specific error tags, the dispatcher module ignores global error
strings.

PLM00562 12.2 Installing and Configuring Dispatcher 6-5


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Sample translator-specific error tags:


<UgToPvDirect provider="Siemens" service="ugtopvdirect"
maxlimit="1" debug="&DEBUG">
<TransExecutable name="ugtopvdirect.sh" dir="&MODULEBASE;/Translators/
ugtopvdirect"/>
<Options>
<!-- Option name="" string="" value="-single_part"
description=""/ -->
<Option name="ConfigMapFile" string="-configmap"
value="&MODULEBASE;/Translators/ugtopvdirect/
ConfigMap.properties"
description="Property file which has the Map between Client
passed in Criteria and the location of config file to be used"/>
<Option name="inputpath" string=""
description="Full path to the input file."/>
</Options>
<TransErrorStrings>
<TransInputStream string="Cannot"/>
<TransInputStream string="Error"/>
<TransInputStream string="exception"/>
<TransInputStream string="ERROR"/>
<TransErrorStream string="Errored"/>
<TransErrorStream string="failed"/>
</TransErrorStrings>
<!-- Postprocess provider="Siemens" service="copyugrelstatus"/ -->
</UgToPvDirect>

Sample global error tags:


<ErrorStrings>
<InputStream string="Error"/>
<InputStream string="error"/>
<InputStream string="Null"/>
<InputStream string="Exception"/>
<InputStream string="ERROR"/>
<ErrorStream string="Error"/>
<ErrorStream string="error"/>
<ErrorStream string="Exception"/>
<ErrorStream string="termination"/>
<ErrorStream string="Bad"/>
<ErrorStream string="Null"/>
<ErrorStream string="ERROR"/>
</ErrorStrings>

Exclusion tags

Similar to error tags, the exclusion tags can be either translator specific or global. You can use:
• Translator-specific exclusion tags for specific translators defined in the translator.xml file.

• Global exclusion list for active translators in the dispatcher module.

6-6 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

Note
When you use translator-specific exclusion tags, the dispatcher module ignores the global
exclusion list.

Sample translator-specific exclusion tags:


<!-- Configuration of the To Zip translator -->
<ToZipfile provider="Siemens" service="tozipfile" maxlimit="1"
debug="&DEBUG">
<SysExecutable name="java"/>
<Options>
<Option name="classpath" string="-cp" system="java.class.path"
description="Classpath to the java virtual machine." />
<Option name="classname" string=""
value="com.sdrc.intellivis.translator.ZipUtility"
description="Zip Utility class."/>
<Option name="zip" string="-zip" value=""/>
<Option name="inputpath" string=""
description="Full path to the input file or directory."/>
<Option name="outputpath" string=""
description="Full path to the output zip file."/>
</Options>
<TransErrorStrings>
<TransInputStream string="Error"/>
<TransErrorStream string="Null"/>
</TransErrorStrings>
<TransErrorExclStrings>
<TransInputStreamExcl string="Not a Failure"/>
<TransErrorStreamExcl string="Translator did not fail."/>
</TransErrorExclStrings>
<FileExtensions>
<OutputExtensions nitem="1">
<OutputExtension extension=".zip"/>
</OutputExtensions>
</FileExtensions>
</ToZipfile>

Sample global exclusion list tags:


<!-- Translator input and error stream keywords to
exclude as error conditions. -->
<!-- These are common to all translators. Translator specific
keywords must be-->
<!-- provided in the configuration of the specific translator.-->
<ErrorExclStrings>
<InputStreamExcl string="Error Reporting mechanism"/>
<ErrorStreamExcl string="This is not an error"/>
</ErrorExclStrings>

Modifying tessellation configuration files


Tessellation is a process that translates a CAD file to a visualization file.
The table that follows describes the translators for which you can modify tessellation output options.

PLM00562 12.2 Installing and Configuring Dispatcher 6-7


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Note
If you do not specify any options, the translator service generates a default output.

Translator Modify which file?


CATIA 4 Part Translator (Theorem) .bat or .sh script of the translator to point to the
Catiav4ToJt tessellation configuration file of the translator
CATIA 4 Part Translator (UGS) .sh script of the translator to point to the tessellation
Catiav4ToJt configuration file of the translator1
CATIA 5 Part Translator Catiav5ToJt Dispatcher_Root\Module\conf\
translator.xml
NX Part Translator NxToPv .bat or .sh script of the translator

Note
You must edit either the translator.xml file or the startup script (.bat or .sh) for each
translator to ensure that the Dispatcher Server uses the latest tessellation options.

Enable the default translators

Enable asynchronous services

Configuring asynchronous services


The AsyncService translator independently processes asynchronous requests constructed by the
Teamcenter server using Teamcenter SOA native C++ framework in the background mode.
Background operations are accomplished by using Dispatcher to hold and schedule the asynchronous
request and to initiate the operation as a standard services oriented architecture (SOA) request in a
separate Teamcenter four-tier session. Operations are executed using the Teamcenter middle tier
for session management and load balancing.
The operation can be executed either on the local site or on a remote site. When running the
operation on a remote site, the asynchronous facility uses the same configuration and authentication
information in the site object as used by Teamcenter Multi-Site.
If the site uses Teamcenter Security Services single sign-on (SSO), the asynchronous facility uses
SSO tokens to authenticate to the remote site. After the request is completed, the Teamcenter event
or notification, or subscription service is used to inform the user that the background task is complete.
The asynchronous session is initiated in a new session as the same user, group, or role and locale as
the original session.
• Authentication without Security Services

1. This translator is available only in UNIX.

6-8 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

The original Teamcenter server session generates a unique authentication token for the user,
encrypts it, and stores it with the background request. When the request is executed, this token is
decrypted and used in place of a password to authenticate the user’s session.

• Remote invocation
The asynchronous facility can execute the operation on a remote site if the installation is
configured for Multi-Site.

Configuring the AsyncService


1. Set up a four-tier environment.

2. Set SOA URL for your site.


Use the Organization application to create a site and add the middle tier system’s URL to the
SOA URL field in the site object of your local site and each remote site to which you wish to send
asynchronous requests. This should have the same base value as used to set up and configure
the middle tier and to run the web client and the rich client.
Example:
http://localhost:7001/tc
If you use SSL to access Teamcenter, that is, if the address starts with "https:", ensure that a
valid certificate is stored in the business logic server's trust certificate store file.

3. Configure the dispatcher.


Install Dispatcher and set up the dispatcher client, scheduler, and module.

4. (Optional) Configure Security Services.


The asynchronous facility supports Security Services for authentication of the asynchronous
session. When calling requests on a different site, both the calling and destination site must use
the same Teamcenter Security Services directory. In addition, you must configure Teamcenter
and Security Services to define a shared mediator key.

5. Enable the AsyncService.


The AsyncService translator independently processes asynchronous requests constructed by
the server using the Teamcenter service-oriented architecture (SOA) native C++ framework
in background mode.

6. Configure the async_invoker service.


You must set up the operating system user name on which you run the Dispatcher module that
runs the AsyncService service to execute Teamcenter utilities in autologon mode. That is, make
sure there is a Teamcenter user who has the same OS user name setting as the operating system
user running the module service.

Configuring Dispatcher
• Install Dispatcher and set up the dispatcher client, scheduler, and module.

• Set the maxlimit parameter to run multiple requests.

PLM00562 12.2 Installing and Configuring Dispatcher 6-9


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

By default, the dispatcher module runs only one request of a particular type at a time. This
limits your throughput as users may submit many requests. However, ensure that you
do not allow more requests than what your server manager pool can handle at a time.
To configure this value, add the maxlimit parameter to the AsyncService element in the
Dispatcher_Root\Module\conf\translator.xml file.
Example:
<AsyncService provider="SIEMENS" service="asyncservice"
maxlimit="2" isactive="true">

• Clean up temporary files.


To clean up temporary files, use the Service.RequestCleanup options in the
DispatcherClient/conf/Service.properties file.
For more information, see the DispatcherClient/conf/Service.properties file.

Configuring Security Services


The asynchronous facility supports Security Services for authentication of the asynchronous session.
When calling requests on a different site, both the calling and destination site must use the same
Teamcenter Security Services directory. In addition, you must configure Teamcenter and Security
Services to define a shared mediator key.
A type of Teamcenter Security Services token is used only in conjunction with mediating applications.
Mediating applications (such as Teamcenter when invoking the AsyncService service) can assume
the role of a Security Services session agent and submit special Security Services log on requests.
All log on requests to Security Services return a Teamcenter Security Services application token built
for the target application, but the token that Teamcenter Security Services returns to the mediating
application has a special structure: It contains an inner token, which is intended for the target
application. This token is returned to the mediating application wrapped in an outer token that is
separately encrypted. The mediating application decrypts the outer token and extracts and forwards
the inner token to the target Teamcenter Security Services application, which subsequently validates
that token back with Security Services.

Note
Configuring asynchronous services with Security Services depends on a valid security
services session that has not been affected by a timeout or expiration.

To configure Teamcenter Security Services application tokens:


• Set a mediator password in Security Services (using Web Application Manager while building
Security Services).

• Set the same mediator password for Teamcenter (using install_encryption_keys).


Run the install_encryptionkeys utility as follows, and enter the mediator password when the
utility prompts for the password:
install_encryptionkeys -u=infodba -p=<pw> -g=dba -f=install_mediator_key

If the default one week lifetime is not adequate, set the ASYNC_credentials_lifetime site preference.

6-10 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

When the server calls an asynchronous request, it obtains an special double-encrypted token
from the Security Services Identity Service and stores it in the DispatcherRequest along with the
other information for the request. When the Dispatcher schedules and invokes the request, the
AsyncService service uses the mediator key to decrypt the token and uses it to log on to the new
Teamcenter session as the original user.
Configure HTTP enabled Multi-Site for single sign-on
If you use Security Services single sign-on (SSO) functionality, configure the
TC_SSO_app_id_of_site_site-name preference at the site. Here, site-name represents the name
of the site, and this preference does not exist by default. The preference value must match the
Application ID value for the site as defined in the Application Registry table.

Note
All sites that are using SSO must be in the same SSO domain.

Enable the AsyncService translator

The AsyncService translator independently processes asynchronous requests constructed by the


server using Teamcenter service-oriented architecture (SOA) native C++ framework in background
mode.
Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file in the Dispatcher_Root\Module\conf directory.
<AsyncService provider="SIEMENS" service="asyncservice" isactive="false">
<TransExecutable name="asyncservice.bat" dir="&MODULEBASE/Translators/
asyncservice"/>
<Options>
<Option name="inputpath" string=""
description="Full path to the input file or directory ."/>
<Option name="outputdir" string=""
description="Full path to the output file."/>
<Option name="OutputFileName" string="" value="output.txt"
description="Name of the output file."/>
</Options>
<TransErrorStrings>
<TransInputStream string="AsyncInvoker Report"/>
<TransErrorStream string="AsyncInvoker Report"/>
</TransErrorStrings>
</AsyncService>

2. Set the isactive attribute to true to activate this translator.

3. Edit the CHANGE_ME tags in the asyncservice.bat (Windows) or asyncservice.sh (UNIX) file
in the Dispatcher_Root\Module\Translators\asyncservice directory.
For more information, see the respective files.

4. Create the input required for this translator.


Example 1:

PLM00562 12.2 Installing and Configuring Dispatcher 6-11


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Create an item revision, right-click the item revision, and send it to Structure Manager. Select
File→Duplicate and select the Run in Background option.
Example 2:
Create a workflow task in Workflow Designer. When you create this workflow task, be sure to
select the Process in Background option in the Attributes dialog.
The system creates an input.txt file. You can use this file as the input for this translator.

5. From the command prompt, run the translator in standalone mode to verify whether it is working
properly.
For information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher_Root\Module\Translators\asyncservice directory and call
asyncservice.bat -help (Windows) or asyncservice.sh -help (UNIX).
To run this translator in standalone mode, you must specify the full path name of the file that holds
the async request arguments by editing the asyncservice.bat file.
Example:
asyncservice.bat C:\Dispatcher\input.txt C:\Dispatcher\result\output.txt
ARG1 is a full path name of the file which holds the async request arguments.
ARG2 is the location of the result files (log, output, etc).
ARG3 is the output file name that the async invoker program generates.

Where C:\Dispatcher\input.txt is the full path name of the file used as the input for this translator
and is generated by running the workflow task (step 4) and C:\Dispatcher\result\output.txt is
the output file that the AsyncService translator generates.

Configure async_invoker service

Set up automatic log on for async_invoker service

You must set up the operating system user name on which you run the Dispatcher module that runs
the AsyncService service to execute Teamcenter utilities in autologon mode. That is, make sure
there is a Teamcenter user who has the same OS user name setting as the operating system user
running the module service. This Teamcenter user needs no special privileges and can be a new
unique Teamcenter user or an existing administrative user.
• Use the Organization application to create or find this user, and specify a valid OS Name field for
the Teamcenter user.

• Use this operating system name to log on to Windows or UNIX, or to set up the log on information
for the Windows service for the Dispatcher module that runs the AsyncService service.

• Test the autologon mode by running a Teamcenter utility called list_users without providing
a user name or password.

6-12 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

Note
This ensures that the Dispatcher module does not prompt for the Teamcenter user
name and password. If autologon is not working, the AsyncService service hangs
waiting for input from the non-interactive standard input stream and the Dispatcher
module cannot complete the request.

Configure the user name and password file log on


Configure the user name and password file log on.
In the Dispatcher_Root\Dispatcher\Module\Translators\asyncservice\asyncservice.bat file
(asyncservice.sh file for UNIX) add the -u and -pf parameters to the end of the line that invokes
the asyncinvoker program.
Windows example:
"async_invoker.exe" %1 %2 %3 %4 %5 -u=tcadmin -pf=C:\teamcenter_creds\pwf.txt

Note
Ensure that password files are managed well and private. Only users who run Teamcenter
servers, in this case, the Dispatcher module, should have access to password files.

In a Teamcenter Security Services environment, remove or comment the following lines to allow
Teamcenter Security Services authentication to take place:
rem disable SSO for asyncservice so that auto-login can complete.
set TC_SSO_APP_ID=
set TC_SSO_SERVICE=
set TC_SSO_LOGIN_URL=

Configure connection retries


If the async_invoker service cannot connect to the four-tier environment, it reattempts a configurable
number of times (60), at a configurable interval (60 seconds), before failing. To change the retry
count or interval, set the following preferences:
preferences_manager -u=user–id -p=password -g=dba -mode=import
-preference=ASYNC_connection_retries -scope=SITE -values=1 -action=OVERRIDE

preferences_manager -u=user–id -p=password -g=dba -mode=import


-preference=ASYNC_connection_retry_interval -scope=SITE -values=10
-action=OVERRIDE

Enable PLM XML based translators

Enable the CreateAssemblyPLMXML translator


The CreateAssemblyPLMXML dispatcher task creates a PLMXML file of the configured assembly
and loads it in a dataset related to the root item revision. The dispatcher task invokes the controlled
replication mechanism to replicate the configured assembly.

PLM00562 12.2 Installing and Configuring Dispatcher 6-13


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Note
Teamcenter and the Multi-Site Collaboration feature must be installed to use this translator.

Enable the translator in a non-SSO environment


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_Root\Module\conf directory.

2. Set the isactive attribute to true to activate this translator.

3. Edit the CHANGE_ME tags in the createassemblyplmxml.bat or createassemblyplmxml.sh


file in the Dispatcher_Root\Module\Translators\createassemblyplmxml directory.
For more information, see the respective files.

4. From the command prompt, run the translator in standalone mode to verify whether it is working
properly.
For information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher_Root\Module\Translators\createassemblyplmxml directory and call
createassemblyplmxml.bat -help.

Enable the translator in an SSO environment


1. Stop Dispatcher services.

2. Choose a DBA user, for example, user (dcproxy is the default user).

3. Create a password abc.txt file containing the password for the dcproxy user.
The default password file for the dcproxy user is TC_BIN\PasswordFile.txt.

4. Edit the following files:


• createassemblyplmxml\createassemblyplmxml.sh (UNIX) or
createassemblyplmxml\createassemblyplmxml.bat (Windows)

• replicateplmxml\replicateplmxml.sh (UNIX) or replicateplmxml\replicateplmxml.bat


(Windows)

• plmxmlbasedsync\plmxmlbasedsync.sh (UNIX) or
plmxmlbasedsync\plmxmlbasedsync.bat (Windows)

• importobjects\importobjects.sh (UNIX) or importobjects\importobjects.bat (Windows)

5. Change as follows.
• UNIX example: TC_ROOT/bin/data_share -u=dcproxy -pf=TC_ROOT/PasswordFile.txt
-f=remote_import
Change to:
TC_ROOT/bin/data_share -u=user -pf=/usr/securepwds/abc.txt -f=remote_import

6-14 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

• Windows example: TC_ROOT\bin\data_share.exe -u=dcproxy


-pf=TC_ROOT\PasswordFile.txt -f=remote_import %*
Change to:
TC_ROOT\bin\data_share.exe -u=user -pf= C:\dispatchpwds\abc.txt -f=remote_import %*

6. Start Dispatcher.

Enable PLMXMLBasedSync, plmxmltojt, plmxml_import_export, and ReplicatePLMXML


translators

• PLMXMLBasedSync service
The PLMXMLBasedSync dispatcher task parses the PLMXML file of a configured assembly,
identifies item revisions that need sync or import and performs the import as per the controlled
replication mechanism.
Prerequisites:
Teamcenter and the Classic-Multisite feature must be installed to use this translator.

• plmxmltojt translator
Translates PLMXML files (.plmxml) to JT (.jt) and directly stores the default configuration JT files
in Teamcenter Engineering.
Prerequisites:
Teamcenter and the supported plmxmltojt utility must be installed to use this translator.

• plmxml_import_export translator
Imports and exports objects into Teamcenter asynchronously through the rich client. Currently, it
supports only exporting objects. The translator uses the plmxml_export utility in the background
to transfer objects.
During export, the system replaces the reserved key characters such as space, comma,
semicolon, tab, and equal in the target file name with the underscore (_) character.

• ReplicatePLMXML service
Executes data_share -f=remote_import for a given items list.
Prerequisites:
Teamcenter Engineering and Classic-Multisite feature must be installed.

Enable the translators

Skip these steps if you use TEM to enable the translators.


1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

PLM00562 12.2 Installing and Configuring Dispatcher 6-15


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

4. Run the translator in standalone mode from the command prompt to verify whether it is working
properly.
For more information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher\Translators\translator_name directory and run the appropriate
command for your platform:

Note
For more information, see the Readme file in the Translators\translator_name
directory.

• Windows: translator_name.bat -help

• UNIX: translator_name.sh -help

5. (Optional) To set up dcproxy as the owner of the translated files, make the following change to
the translator_name.bat (Windows) or translator_name.sh (UNIX) file.
NxTransDirect translator example:
"%UGII_BASE_DIR%\ugmanager\run_nxtrans.bat" -u=dcproxy -p=dcproxy
-changeOwnerToCad=false "-pim=yes" %*

If you set up dcproxy as the owner of the translated files, you must create a dispatcher client
access rule.
After installation, you must add a rule to the access rule tree permitting the translation service
proxy user to update the attributes of a DispatcherRequest object. If this access rule is not
created correctly, the dispatcher client reports errors.

Enable BatchPrint and PublishBatch translators


• BatchPrint service
The BatchPrint Dispatcher client handles calls from the rich client to process the batch printing
of files. This translator processes batch print requests submitted by the BatchPrint Dispatcher
client. The batchprint.bat (for Windows) or batchprint.sh (for UNIX, Linux, and Mac OS) file
invokes the Vis Print application to print the selected files.
Prerequisites:

o Vis Home Path location, that is, the path to the visualization directory while installing
BatchPrint using TEM.

6-16 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

o Vis License location while installing BatchPrint using TEM.

• PublishBatch translator
Prerequisites:
The Dispatcher infrastructure for scheduling create and update features.

o The translator is supported on Windows only.

o VisAutomationApp, Microsoft Visio, FMS file client cache (FCC), and the Teamcenter SOA
client installed on the translator machine.

Note
The VisAutomationApp is installed automatically when you install Lifecycle
Visualization.

For more information about installing Lifecycle Visualization and MS Visio, see the
Teamcenter lifecycle visualization Install Guide and the Microsoft Visio Online Help,
respectively.

o The startPublishBatch.bat file is installed in a directory that is specified during installation of


the PublishBatch translator. Each setting in this file must be modified as specified in the file.

o The transmodule.properties file in the module/conf directory has a setting called


MaximumTasks that defaults to 3. This defines the maximum number of instances of publish
batch tasks that can run simultaneously. Do not increase this value above 3.

o The clients and Dispatcher Server should point to the common staging directory with
read/write permissions to the directory.

o (Optional) Open the startPublishBatch.bat file and add the –log option to the
TRANS_PATH\tcpublish_batch attribute. Teamcenter then adds detailed progress and
error entries to the task’s log file.
The startPublishBatch.bat file is installed in a directory that is specified during installation
of the PublishBatch translator. Follow the instructions in the file to add the –log option.
Teamcenter stores the log files in the directory you specify during installation.

Enable the translators

Skip these steps if you use TEM to enable the translators.


1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

Note
By default, this attribute is set to false.

PLM00562 12.2 Installing and Configuring Dispatcher 6-17


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

Enable CAD part translators


• Catiav4ToJt translator
Translates Catia V4 (.model) files to JT (.jt) files.

• Catiav4ToJt translator (UNIX)


Translates Catia V4 (.model) files to JT (.jt) files.
The CATIA 4 part translator (Siemens) is supported only on UNIX systems.

• Catiav5ToJt translator
Translates Catia V5 (.CATPart) files to JT (.jt) files.
After you enable the Catiav5ToJt service, this service is not available from the default Translate
menu in My Teamcenter. There is a separate CATIA V5 menu that you can use to perform a
conversion to JT files.

• JtToCatia translator
Translates JT (.jt) files to Catia (.CATPart and .CATProduct) files.

• ProEToJt translator
Translates Pro/ENGINEER drawing (.drw) files to DXF (.dxf) files. It supports all Pro/ENGINEER
drawing files.
Prerequisites for this translator:

o Norton AntiVirus may cause Pro/ENGINEER translators to hang. Disable it on the translation
module that includes the Pro/ENGINEER translator.

o Do not install the Vis Mockup translator on any dedicated translation module machine used
to run the ProEToJt translator as these translators cause conflicts.

o If the Pro/ENGINEER translator is installed in a directory with spaces in the directory name
(for example, Program Files), ensure that the value of the PROE_CMD variable in the
proetojtversion.bat file is set in quotation marks. For example:
PROE_CMD="D:\Program Files\proe<ver>\bin
\proe<ver>.bat”

• SolidWorksToJt translator
Translates SolidWorks part and assembly files to the Direct Model (.jt) visualization format.

Enable the translators


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

6-18 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

2. Set the isactive attribute to true to activate this translator.

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.

For more information about CHANGE_ME tags, see the .bat file for the translator.

Enable CAD drawing translators

• NxToCgmDirect translator

Translates UG (.prt) files to CGM (.cgm) files. It connects to Teamcenter to perform the
translations.
Prerequisites:

o This is not supported on four-tier or SSO environments.

o Ensure that a matching user name is available in Teamcenter for the user name of the user
running the translator module. This user must have all read and write and checkin and
checkout privileges to perform translations.

Note
To overcome this limitation, modify the Dispatcher_Root\Module\Translators\
nxtocgmdirect\nxtocgmdirect.bat (Windows) or Dispatcher_Root\Module\
Translators\nxtocgmdirect\nxtocgmdirect.sh (UNIX) file to add the -u, -p, or
-pf arguments.

• NxToPv translator

Translates UG (.prt) files to JT (.jt) files.

• NxToPvDirect translator

Translates UG (.prt) files to JT (.jt ) files.


Prerequisites:

o This is not supported on four-tier or SSO environments.

o Ensure that a matching user name is available in Teamcenter for the user name of the user
running the translator module. This user must have all read/write and checkin/checkout
privileges to perform translations.

PLM00562 12.2 Installing and Configuring Dispatcher 6-19


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Note
To overcome this limitation, modify the Dispatcher_Root\Module\Translators\
nxtopvdirect\nxtopvdirect.bat (Windows) or
Dispatcher_Root\Module\Translators\nxtopvdirect\nxtopvdirect.sh (UNIX) file
to add the -u, -p, or -pf arguments.

• ProEToDxf translator
Translates the Pro/ENGINEER drawing files to the Autodesk Drawing eXchange Format (DXF)
format.
The batch file that starts the Pro/ENGINEER translator may have different names depending
on the installation. The Dispatcher Server looks for InvokeProE.bat file in the bin directory to
invoke the translator. Therefore, if the batch file has a different name, you must save the file as
InvokeProE.bat in the bin directory for the Dispatcher Server to invoke the Pro/ENGINEER
translator.
Create a PRO_COMM_MSG_EXE environment variable that points to loadpoint/OS
name/obj/pro_comm_msg.exe.
For example, set PRO_COMM_MSG_EXE to:
C:\ptc\proe2000i2\i486_nt\obj\pro_comm_msg.exe

Enable the translators


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

Enable the ContMgmtPublish translator


The ContMgmtPublish translator is used to render Content Management content to an output file
format defined by a publishing tool, such as PDF or HTML. The translator then stores the output file
in Teamcenter.

Note
You can install this translator using TEM only. This translator is not designed to run in a
standalone mode or run by a user directly.

6-20 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

1. Install the required XSL formatter for this translator, such as Antenna House.

2. (Optional) If you use a DITA open toolkit to publish content, install Java JDK version 1.7 and
modify the Dispatcher_Root\Module\Translators\contmgmtpublish\config\contmgmtpublish_
config.properties file to change the JDK_HOME variable to the JDK installation directory.

Note
• Content Management supports version 2.4.6 of the DITA Open Toolkit (OT)
publishing tools.

• To use an older version of DITA OT, copy the older version of DITA OT to: the
Dispatcher_Root\Module\Translators\contmgmtpublish\lib folder.

• Set the path for DITA_ANT_HOME in the Dispatcher_Root\Module\Translators\


contmgmtpublish\config\contmgmtpublish_config.properties file. The path
must be set to the Ant directory in the DITA OT.

3. To verify the installation, after you set up the ContMgmtPublish translator, publish a topic
revision using Teamcenter Content Management rich client (Tools→Publish Content).

Enable the translator


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

Enable FMSTransfer, ImportObjects, JtToBBoxAndTso, and mmvindexgen


translators
• FMSTransfer service
Used to forward a file from a temporary store and forward volume to its destination volume.
Prerequisites:

o TC_ENABLE_STOREANDFORWARD site preference must be set to true.

o Uploaded files are transferred to their destination according to the set rules and the
configured schedule.

PLM00562 12.2 Installing and Configuring Dispatcher 6-21


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

o The user must have appropriate permissions to upload files.

• ImportObjects service
Executes data_share -f=remote_import for a given items list.
Prerequisites:
Teamcenter and the Classic-Multisite feature must be installed to use this translator.

• JtToBBoxAndTso service
Generates bounding box and TSO files from JT files in Teamcenter.
Prerequisites:

o Teamcenter and the jttobboxandtso utility must be installed to use this service.

o This translator requires the Teamcenter password.


To encrypt a password file, you set a temporary environment variable to the password you
want to encrypt, and then generate an encrypted password file using the -encryptpwf
argument for the install utility.

• mmvindexgen translator
An MMV dataset consists of a spatial hierarchy of a model, which is harvested from JT data
using the Teamcenter Dispatcher mmvindexgen translator. You can use the My Teamcenter
Translation menu to automate the generation of the spatial index on a recurring basis, in order to
capture design changes over the course of the product lifecycle.
Prerequisites:

o When MMV index production is performed on an assembly under which a Spatial Hierarchy
dataset already exists for one or more item revisions, the existing Spatial Hierarchy
dataset is overwritten. To avoid an accidental overwrite of the Spatial Hierarchy dataset,
Siemens PLM Software recommends that you restrict the authorization of performing Spatial
Hierarchy production to select user accounts. The VIS_mmvindexgen_admin_group site
preference is used to give the user group the authority to run the mmvindexgen translator
from the Teamcenter Translation menu.

o This translator requires Perl version 5.0.3 or later.

o (Optional) To define one or more revision rules to generate the Spatial Hierarchy dataset,
open the mmvindexgen.config file from the Dispatcher_RootModule\Translators\
mmvindexgen directory and edit the revision_rules option.
By default, this option does not have any revision rule and generates Spatial Hierarchy in
the unconfigured mode.

Enable the translators


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

6-22 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

4. Run the translator in standalone mode from the command prompt to verify whether it is working
properly.
For more information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher\Translators\translator_name directory and run the appropriate
command for your platform:

Note
For more information, see the Readme file in the Translators\translator_name
directory.

• Windows: translator_name.bat -help

• UNIX: translator_name.sh -help

5. (Optional) To set up dcproxy as the owner of the translated files, make the following change to
the translator_name.bat (Windows) or translator_name.sh (UNIX) file.
NxTransDirect translator example:
"%UGII_BASE_DIR%\ugmanager\run_nxtrans.bat" -u=dcproxy -p=dcproxy
-changeOwnerToCad=false "-pim=yes" %*

If you set up dcproxy as the owner of the translated files, you must create a dispatcher client
access rule.
After installation, you must add a rule to the access rule tree permitting the translation service
proxy user to update attributes of a DispatcherRequest object. If this access rule is not created
correctly, the dispatcher client reports errors.

Enable PcbToFatf, PartUtility, and PdfGenerator, and populateFSC translators


• PcbToFatf translator
Prerequisites:
Verify that the TransExecutable dir is correctly specified for this translator.

• PartUtility service
Runs the NX Part utility and saves NX parts in the current version of NX.
Prerequisites:
NX installed with UGMANAGER and PVTRANS modules.

PLM00562 12.2 Installing and Configuring Dispatcher 6-23


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

• PdfGenerator service
Converts a variety of file formats, such as Microsoft Office documents (.doc, .docx, .xls, .xlsx,
.ppt, .pptx) and others (Postscript, Adobe Photoshop, WordPerfect, Rich Text, Bitmap, GIF,
JPEG, and TIFF), to Adobe PDF (.pdf) and directly stores the .pdf file in Teamcenter.
Prerequisites:

o This service is supported on Windows only.

o Adobe LiveCycle PDF Generator ES (configured as WatchedFolder).

o When the WatchedFolder is shared across the network, users must have complete read/write
permissions to the shared WatchedFolder directory.
The Watched Folder Input Dir and Watched Folder Result Dir must point to the same
location as the Adobe LiveCycle watched folder input and result directories, respectively. You
must also modify the default applications extension to include other file types for generating.
For more information about configuring these directories and setting up application
extensions, see Adobe LiveCycle documentation.

o Do not append %Y/%M/%D in the result folder directory. This can be an absolute or relative
directory path. Include file pattern *.

o (Optional) Open the Dispatcher_Root\Module\Translators\docmgt_translators\config\


pdfgenerator_config.properties file and edit configuration properties.
The configuration properties are set automatically when you use TEM to install and configure
this service.
For more information, see the pdfgenerator_config.properties file.

• populateFSC translator
Supports FSC caching of structured context object (SCO) content at non-database sites. The
translator generates a PLM XML file of the SCO object, parses it for file global unique IDs
(GUIDs), and generates read tickets for all the files referenced in the PLM XML file. You can use
the read tickets to load the FSC cache of a target or a distant FSC of the same database.

Enable the translators


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.

6-24 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

For more information about CHANGE_ME tags, see the .bat file for the translator.

4. Run the translator in standalone mode from the command prompt to verify whether it is working
properly.
For more information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher\Translators\translator_name directory and run the appropriate
command for your platform:

Note
For more information, see the Readme file in the Translators\translator_name
directory.

• Windows: translator_name.bat -help

• UNIX: translator_name.sh -help

5. (Optional) To set up dcproxy as the owner of the translated files, make the following change to
the translator_name.bat (Windows) or translator_name.sh (UNIX) file.
NxTransDirect translator example:
"%UGII_BASE_DIR%\ugmanager\run_nxtrans.bat" -u=dcproxy -p=dcproxy
-changeOwnerToCad=false "-pim=yes" %*

If you set up dcproxy as the owner of the translated files, you must create a dispatcher client
access rule.
After installation, you must add a rule to the access rule tree permitting the translation service
proxy user to update attributes of a DispatcherRequest object. If this access rule is not created
correctly, the dispatcher client reports errors.

Enable QSEARCH_process_queue, QueryScos, and RenderMgtTranslator


translators
• QSEARCH_process_queue service generates spatial index boxes.
Prerequisites:

o Teamcenter and the qsearchprocessqueue utility should be installed to use this service.

o This translator requires the Teamcenter password.


To encrypt a password file, you set a temporary environment variable to the password you
want to encrypt, and then generate an encrypted password file using the -encryptpwf
argument for the install utility.

• QueryScos translator
Generates a list of structure context objects (SCOs) for a given saved query or folder
containing the SCOs. The generated SCOs are used by the RdvContextDBDownload or
RdvContextNONDBDownload translators.
Prerequisites:

PLM00562 12.2 Installing and Configuring Dispatcher 6-25


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

o Start the start_sco_dispatcher utility to invoke the query_scos translator.

o Install the RdvContextDBDownload or RdvContextNONDBDownload translator.

• RenderMgtTranslator service translates files from one input file format to another output file
format and stores the output files in Teamcenter.
Prerequisites:

o Requires PdfGenerator and/or PreviewService.


Use TEM to install and configure either PdfGenerator or PreviewService.
If you use PreviewService, Teamcenter Visualization Convert and Ghostscript 8.53 are
prerequisites. To use Ghostscript for PDF conversions:

■ Modify the PSPath property in the vvcp.cfg file to point to the location where Ghostscript
is installed.

■ Set the AllowOpenApplication property to on to convert a file that is already open in


an application.

For more information, see the vvcp.cfg file.

Note
Verify whether Teamcenter Visualization Convert is installed correctly by
performing a test conversion using the prepare command line utility. You can run
this utility from the VIS_version/VVCP directory.

o You can use any other translator if the translator is defined as a dispatcher service
configuration in Business Modeler IDE and the ServiceToExeMap attributes in the
Dispatcher_Root\Module\conf\translator.xml file are set to the location of the translator
.bat (Windows) or .sh (UNIX) files.

Note
You can use the rendermgt_previewservice.bat
or rendermgt_previewservice.sh file in the
Dispatcher_Root\Module\Translators\previewservice directory as a template for
creating the .bat or .sh file for your custom translator.

Enable the translators

Skip these steps if you use TEM to enable the translators.

1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

6-26 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

4. Run the translator in standalone mode from the command prompt to verify whether it is working
properly.
For more information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher\Translators\translator_name directory and run the appropriate
command for your platform:

Note
For more information, see the Readme file in the Translators\translator_name
directory.

• Windows: translator_name.bat -help

• UNIX: translator_name.sh -help

5. (Optional) To set up dcproxy as the owner of the translated files, make the following change to
the translator_name.bat (Windows) or translator_name.sh (UNIX) file.
NxTransDirect translator example:
"%UGII_BASE_DIR%\ugmanager\run_nxtrans.bat" -u=dcproxy -p=dcproxy
-changeOwnerToCad=false "-pim=yes" %*

If you set up dcproxy as the owner of the translated files, you must create a dispatcher client
access rule.
After installation, you must add a rule to the access rule tree permitting the translation service
proxy user to update attributes of a DispatcherRequest object. If this access rule is not created
correctly, the dispatcher client reports errors.

Enable Simulation Process Management translators


• BatchMesh service
The BatchMesh service translates part (.prt) files to mesh files and directly stores them in
Teamcenter.
The BatchMesh translator is supported only on Windows systems.

• The Simpgen translator is primarily used to create assembly-level simplification geometry.


Prerequisites:

o The Simpgen translator requires Perl 5.0.3 or later.

PLM00562 12.2 Installing and Configuring Dispatcher 6-27


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

o Licenses for Teamcenter and Teamcenter lifecycle visualization mockup (for the JtOptimize
utility). An additional license is required to work with JtSimplification data in the viewer.
For more information, contact your Siemens PLM Software representative.

o OpenGL on the Teamcenter server. OpenGL is an open source environment for developing
2D and 3D graphics applications.
For more information, see the OpenGL website.
The Simpgen translator heavily leverages the graphics hardware. Siemens PLM Software
recommends that you install a high-end graphics card for better performance. When this
translator is run on a UNIX machine, a user with appropriate permissions must locally log
on to the machine to initialize the graphics hardware and grant hardware permission (for
example, using the xhost command) to other users who start the dispatcher remotely.
For more information, see the Dispatcher_Root\Module\Translators\simpgen\Readme.txt
file.

o The clients and Dispatcher Server should point to the common staging directory and both
should have read and write permissions to that directory. Additionally, the common staging
directory should have sufficient disk space to store temporary PLM/XML and JT files created
during the translation process.
The Dispatcher Server allows translations using a Web server (Web mode) or through remote
method invocation (RMI) mode. RMI mode requires a common staging directory.

o When JtSimplification production is performed on an assembly under which a


JtSimplification dataset already exists for one or more item revisions, the existing
JtSimplification dataset is overwritten. To avoid accidental overwrite of the JtSimplification
dataset, Siemens PLM Software recommends that only a select few user accounts are given
the authority to perform JtSimplification production.
VIS_simpgen_admin_group site preference is used to give the user group the authority to
run the Simpgen translator from the Teamcenter Translation menu.
The default value for this site preference is SimpGenAdmin. You can specify the name of a
Teamcenter group as a valid value.

• The SimProcess service supports remote launch for Simulation Process Management.
Prerequisites:

o The tc_launch_sim_process_ts_pl.bat file in the module/SimProcess directory points to


the Perl location. Make sure that the Perl location is correct.

o The clients and Dispatcher Server should point to the common staging directory and both
should have read/write permissions to that directory.

Enable the translators


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

6-28 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

4. Run the translator in standalone mode from the command prompt to verify whether it is working
properly.
For more information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher\Translators\translator_name directory and run the appropriate
command for your platform:

Note
For more information, see the Readme file in the Translators\translator_name
directory.

• Windows: translator_name.bat -help

• UNIX: translator_name.sh -help

5. (Optional) To set up dcproxy as the owner of the translated files, make the following change to
the translator_name.bat (Windows) or translator_name.sh (UNIX) file.
NxTransDirect translator example:
"%UGII_BASE_DIR%\ugmanager\run_nxtrans.bat" -u=dcproxy -p=dcproxy
-changeOwnerToCad=false "-pim=yes" %*

If you set up dcproxy as the owner of the translated files, you must create a dispatcher client
access rule.
After installation, you must add a rule to the access rule tree permitting the translation service
proxy user to update attributes of a DispatcherRequest object. If this access rule is not created
correctly, the dispatcher client reports errors.

Enable the store_and_forward translator


The store_and_forward translator supports the store and forward functionality in batch mode. It
executes the move_volume_files utility with a new -transfersaf argument. The utility queries
the entire database for the extent of user’s files under local volumes and transfers them to their
respective default volumes. The utility also creates and schedules a dispatcher task to delete the
local volume files after the ticket expiry interval.
Default local volumes are temporary local volumes that allow files to be stored locally before they
are automatically transferred to the final destination volume. This functionality is referred to as
store and forward functionality.

PLM00562 12.2 Installing and Configuring Dispatcher 6-29


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Prerequisites
Ensure that the store_and_forward.pl file under
Dispatcher_Root\Module\Translators\store_and_forward has correct values specified for the user
name (-u=) and password file (-pf=) parameters.
If these parameters have values set as "CHANGE_ME", manually edit them, setting them to the
correct values.

Note
The password file specified using the -pf parameter should be a file that is encrypted
using "install -encryptpwf".

Enable the translator


1. Set the TC_Store_and_Forward preference.
You must set this preference to enable store and forward functionality.

2. In the Select Translators panel in TEM, select the StoreAndForward translator.

3. Specify the Bootstrap FSC URIs value.


You must specify this value while enabling this translator using TEM.
This is generally the same as the Fms_bootStrap_Urls preference value.

4. To set the store_and_forward translator as a repeat task, in My Teamcenter, choose


Translation→Translate, select the translation service, and click Next. Select the Repeating
option and click Finish to start the translation.

Note
The Repeating option does not appear by default. You must set the
ETS.Repeating_UI.<ProviderName>.<ServiceName> preference to TRUE to display
the repeating tasks functionality.
To avoid unpredictable behavior, the (time) interval in repeating tasks must be greater
than the translation time.

Enable Teamcenter Substance Compliance services


The Teamcenter Substance Compliance solution requires the following dispatcher services:
• Compliance Results Validation: Invalidates substance compliance results based on the expiry
of exemptions on related objects.

• Supplier Declaration Import: Creates the material and substance information in Teamcenter
based on material substance declaration (MSD) files.

• Supplier Declaration Re-Request: Sends an MSD request again to suppliers, for all qualified
vendor parts.

6-30 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

• Email Polling: Polls email on a dedicated email account based on Teamcenter rules.

• Generate outbound declaration: Generates an outbound declaration file in IPC formats for the
selected object.

• Send reminders for declarations to vendors: Creates reminders for the declarations in Teamcenter
which are about to expire. It also sends reminders to vendors who have not responded to a
declaration request earlier within the stipulated time.

Enable these dispatcher services as follows.

Tip
Skip the following steps if you use TEM to install and configure these services.

1. Open the translator.xml file from the Dispatcher_Root\Module\conf directory.

2. To activate the SubsCmplValidationService service, set the isactive attribute to true.

3. To activate the SubsCmplMSDImportService service, set the isactive attribute to true.

4. To activate the SubsCmplMSDRerequestService service, set the isactive attribute to true.

5. To activate the EmailPollingService service, set the isactive attribute to true.

6. To activate the SubscmplGenerateDeclarationService service, set the isactive attribute to true.

7. To activate the SubscmplDeclarationRemindersService service, set the isactive attribute to


true.

8. Edit the CHANGE_ME tags for all the services you have activated in the
respective service_name.bat (Windows) or service_name.sh (UNIX) files in the
\Module\Translators\service_name directory.
Refer to the respective files.

9. From the command prompt, run the service in standalone mode to verify whether it is working
properly.
To view help about running the translator in a standalone mode, from a command prompt, change
to the Dispatcher_Root\Module\Translators\service_name directory and call service_name.bat
-help.

Enable NX translators
• NxClone service
Calls the NX refile utility to refile NX parts.
NX must be installed with the UGManager module to use this service.

• NxNastran service

PLM00562 12.2 Installing and Configuring Dispatcher 6-31


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Used to launch NX Nastran remotely using Simulation Process Management.


Prerequisites:

o The tc_launch_sim_process_ts_pl.bat file in the module/SimProcess directory points to


the Perl location. Make sure that the Perl location is correct.

o The clients and Dispatcher Server should point to the common staging directory and both
should have read/write permissions to that directory.

o To launch a service remotely, ensure that the service name in the translator.xml file matches
the process name in the Simulation Tools Configuration window in CAE Manager.

• NxTransDirect service

Translates NX files (.prt) to JT (.jt) and other formats and directly stores the JT files in Teamcenter.
Create the JT file synchronously when you save a part.
You can create a customer default that allows you to create the JT file synchronously when you
save a part. It is applicable only when the Save JT Data option is also selected. If this customer
default is not selected, JT file creation occurs as a batch translation in the background, which
reduces the overall save time.
In Teamcenter 11.4 or later, this customer default is not available. Instead, you can set the
NX_ETS_NXTRANSDIRECT_ENABLED preference to False.

Enable the translators

Skip these steps if you use TEM to enable the translators.

1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.

For more information about CHANGE_ME tags, see the .bat file for the translator.

4. Run the translator in standalone mode from the command prompt to verify whether it is working
properly.

For more information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher\Translators\translator_name directory and run the appropriate
command for your platform:

6-32 Installing and Configuring Dispatcher PLM00562 12.2


Enable default translators

Note
For more information, see the Readme file in the Translators\translator_name
directory.

• Windows: translator_name.bat -help

• UNIX: translator_name.sh -help

5. (Optional) To set up dcproxy as the owner of the translated files, make the following change to
the translator_name.bat (Windows) or translator_name.sh (UNIX) file.
NxTransDirect translator example:
"%UGII_BASE_DIR%\ugmanager\run_nxtrans.bat" -u=dcproxy -p=dcproxy
-changeOwnerToCad=false "-pim=yes" %*

If you set up dcproxy as the owner of the translated files, you must create a dispatcher client
access rule.
After installation, you must add a rule to the access rule tree permitting the translation service
proxy user to update attributes of a DispatcherRequest object. If this access rule is not created
correctly, the dispatcher client reports errors.

Enable tc3dpdftrans and tcmfg_update_productviews translators


• The tc3dpdftrans translator creates 3D PDF reports.

• The tcmfg_update_productviews translator updates product views in a batch mode.

Enable the translators


Skip these steps if you use TEM to enable the translators.
1. Open the translator.xml file from the Dispatcher_RootModule\conf directory.

2. Set the isactive attribute to true to activate this translator.

Note
By default, this attribute is set to false.

3. Open the translator.bat (Windows) or translator.sh (UNIX) file from the


Dispatcher_Root\Module\Translators\jttocatia\V5 directory and edit the CHANGE_ME tags.
For more information about CHANGE_ME tags, see the .bat file for the translator.

4. Run the translator in standalone mode from the command prompt to verify whether it is working
properly.
For more information about running the translator in standalone mode, from a command prompt,
change to the Dispatcher\Translators\translator_name directory and run the appropriate
command for your platform:

PLM00562 12.2 Installing and Configuring Dispatcher 6-33


Chapter
Chapter 6: 6: Enable
Enable default
default translators
translators

Note
For more information, see the Readme file in the Translators\translator_name
directory.

• Windows: translator_name.bat -help

• UNIX: translator_name.sh -help

5. (Optional) To set up dcproxy as the owner of the translated files, make the following change to
the translator_name.bat (Windows) or translator_name.sh (UNIX) file.
NxTransDirect translator example:
"%UGII_BASE_DIR%\ugmanager\run_nxtrans.bat" -u=dcproxy -p=dcproxy
-changeOwnerToCad=false "-pim=yes" %*

If you set up dcproxy as the owner of the translated files, you must create a dispatcher client
access rule.
After installation, you must add a rule to the access rule tree permitting the translation service
proxy user to update attributes of a DispatcherRequest object. If this access rule is not created
correctly, the dispatcher client reports errors.

6-34 Installing and Configuring Dispatcher PLM00562 12.2


Chapter 7: Add custom translators to Dispatcher

How to add custom translators to Dispatcher


The following is a typical sequence of tasks for adding custom translators or new translators to
Dispatcher.

Configure the module to include the new translator

• Install the new translator and the license


Install the new translator on a machine or module as per your deployment strategy. Ensure
that the new translator is properly licensed.

• Test the custom translator by performing a translation from the command prompt
Perform a translation from the translator in standalone mode from the command prompt to
verify whether it is working properly.

PLM00562 12.2 Installing and Configuring Dispatcher 7-1


Chapter
Chapter 7: 7: Add custom
Add custom translators
translators to Dispatcher
to Dispatcher

• Update the translator.xml file to include the new translator


Update the translator.xml file for the executable name and the directory and set the isactive
attribute to true.
Configure the Dispatcher client to integrate the new translator

• Use the default filters or create custom filters


You can modify the default validation rules to ensure that the same primary object is not sent
for translation again or modify default filters to exclude specific translators, exclude translation
requests based on priority, and exclude translation requests based on owning user name.
Alternatively, you can create custom filters by using the sample Filter.java file from the
DISPATCHER_ROOT/DispatcherClient/sample/integration/filters directory.

• Extract the data required for the translation from Teamcenter


You can extract the data required for the translation by using the TaskPrep Java class.

• Load the translated data back to Teamcenter


You can load the translated data back to Teamcenter by using the DatabaseOperation Java
class.

• Set preferences to enable the Translate menu in rich client or create dispatcher requests using
ITK APIs
You add Dispatcher preferences for the translation options to appear in the Translation
Selection dialog box in the rich client.
Alternatively, you can create dispatcher requests using ITK APIs. The Dispatcher client provides
server APIs to support customized triggering of translations. You can modify the sample
dispatcher_create_rqst_itk_main.c source code or create a new ITK command line C source
file.

Create custom filters

What are filter classes?


Filters are implemented by subclasses of the RequestFilter class. Filter instances are created by
the FilterFactory1 class utilizing methods of the RequestFilter class. All translation services apply
filtering to the results returned from the query for dispatcher requests.
To create a new filter, create a new subclass of the RequestFilter class providing an implementation
for each of the methods specific to the new filter.
A sample Filter.java file is provided in the DISP_ROOT/DispatcherClient/sample/integration/filters
directory.

1. FilterFactory is a class supplied by Dispatcher. It is a mechanism used by the service classes for creating instances of RequestFilter
subclasses—for example, PriorityFilter.

7-2 Installing and Configuring Dispatcher PLM00562 12.2


Add custom translators to Dispatcher

RequestFilter contains the properties data member. The properties data member is an object that
contains the configuration required and optional properties and values that are established when
the dispatcher client starts.
The RequestFilter contains the following methods:
• getRequiredPropertyNames
This method is used by the FilterFactory class to return an array of property names of required
configuration properties. These properties are those that must be specified by the filter
configuration. If no value is specified for these properties, the FilterFactory class logs an error in
the Extractor service instance log file and no filter instance is created.

public abstract String[] getRequiredPropertyNames();

• getOptionalPropertyNames
This method is used by the FilterFactory class to return an array of property names of optional
configuration properties. These properties are optional.

public abstract String[] getOptionalPropertyNames();

• setProperties
This method is used by the FilterFactory class to allow a specific RequestFilter subclass access
to property values. The subclass implementation must execute the super method.

public void setProperties(Properties p) throws Exception


{
properties = p;
}

• filterRequest
This method is used to filter dispatcher request objects for processing by the dispatcher client. It
is run by the dispatcher client to filter the results of the query for dispatcher request for processing.

public abstract boolean filterRequest( IMANComponent request )


throws Exception;

Develop custom Dispatcher client filters


To customize a dispatcher client filter in a Microsoft Windows environment:

Note
Adapt the procedure for UNIX as required.

1. Create the custom dispatcher client filter Java source file. Use a custom package designation.
A sample Filter.java file is provided in the
DISP_ROOT/DispatcherClient/sample/integration/filters directory.

2. Ensure that the appropriate Java SDK is installed and Java path information is correctly set.

PLM00562 12.2 Installing and Configuring Dispatcher 7-3


Chapter
Chapter 7: 7: Add custom
Add custom translators
translators to Dispatcher
to Dispatcher

3. Compile the Java source file using the following command:


javac –classpath
Add jars created in the classpath of runDispatcher.bat/sh file
myFilter.java

4. Archive the new Java classes. These new classes, along with other customized dispatcher client
classes, are combined into the CAD Manager JAR file or a single site-specific custom JAR file.
jar cf jar-file-name.jar myFile.class myFile2.class …

5. Copy the new JAR file to the DISP_ROOT/DispatcherClient/lib directory.

6. Modify the DISP_ROOT/conf/Service.properties file to specify the new filter and associated
properties.
Add the filter in the FILTERS section of the Service.properties file.

7. Run the dispatcher client and verify the operation of the filter.

Extract data and load data required for translation

What is the extract-transform-load (ETL) model?


The dispatcher client employs the ETL model (Extract-Transform-Load) for data translation. It
provides a framework that supports extraction of data for translation, translation, and loading of
translation results. The dispatcher client is implemented as a standalone SOA application.
• Extraction provides a collection of input data to be submitted as a translation task to the
Dispatcher Server. The nature of the extracted data is dependent upon the input required by the
desired translation.

• After extraction, the dispatcher client submits a translation task to the Dispatcher Server. The
Dispatcher Server then processes the translation tasks.

• After the translation is complete, the dispatcher client loads the translated data in the appropriate
Teamcenter target data model.
The nature of the translation results is dependent on the output generated by the desired
translation. Storage of the results is also dependent on the target data model.

The dispatcher client provides support for translator integrations and related data models with
two Java classes: one for preparation of translator input (TaskPrep class) and one for storage of
translator output (DatabaseOperation class). These two classes provide a structure for translator-
and data model-specific logic implementation. The dispatcher client configuration properties define
the mapping between translators and supporting classes.
These classes provide a structure for translator-specific and data model–specific logic implementation.
The dispatcher client configuration properties define the mapping between translators and supporting
classes.

7-4 Installing and Configuring Dispatcher PLM00562 12.2


Add custom translators to Dispatcher

What is the Dispatcher request object?


The Dispatcher task execution process starts by the creation of a DispatcherRequest object. The
DispatcherRequest object is represented by the DispatcherRequest class.

Dispatcher request object attributes


Attribute Description
Current state Displays the current state of the dispatcher request.
Provider name Displays the name of the provider of the translator.
Service name Displays the name of the dispatcher service to be used.
Priority Specifies a scheduling priority. Set it to low, medium, or high.
Task ID Displays the task identifier assigned during the preparation
process.
Creation date Displays the date and time when the DispatcherRequest object
was created.

Primary objects Specifies one or more primary objects containing the data to
be translated. When translating CAD data, primary objects are
typically datasets.
Secondary objects Specifies one or more supporting objects for the translation.

Note
Secondary objects are optional and dependent on
the requirements of the specific translation. When
translating CAD data, secondary objects are typically
item revisions.

Owning user Displays the name of the user that created the request.

Owning group Displays the name of the group that created the request.

History states Displays various states that make up the history of the dispatcher
request.
History dates Displays timestamps associated with state values.
Type Shows an application the purpose of the dispatcher request.
Mode Represents a user-defined mode of operation.
Argument keys/argument data Specifies one or more strings containing key/value pairs.
Data files keys/data files Specifies one or more strings containing name/value pairs.
Start time Stores the expected start time of the request.
Interval Stores the number of seconds until the dispatcher request is
translated again.
End time Stores the end time of the request.

PLM00562 12.2 Installing and Configuring Dispatcher 7-5


Chapter
Chapter 7: 7: Add custom
Add custom translators
translators to Dispatcher
to Dispatcher

Dispatcher request states


The following information describes the various Dispatcher states associated with the translation
process.

State Description
INITIAL Indicates the initial state of a newly created DispatcherRequest object.
PREPARING Indicates that the data is being extracted from Teamcenter and that a
Dispatcher Server task is being prepared.
SUPERSEDING Supports the situation in which an original request contains a set of
objects that require more than one translation—for example, if the set
contains both CATIA V4 and CATIA V5 parts. This state indicates that
successor dispatcher requests are being created.
SCHEDULING Indicates that the task is being added to the Dispatcher Server
scheduling queue.
TRANSLATING Indicates the task is being processed by the Dispatcher Server.
LOADING Indicates the task results are being loaded into Teamcenter.
COMPLETE Indicates the Dispatcher task has successfully completed.
TERMINAL Indicates the Dispatcher tasks has failed.
DUPLICATE Indicates the primary objects (datasets) specified in the
DispatcherRequest are also specified by one or more
DispatcherRequest objects currently being translated.
DELETE Indicates that the dispatcher object has been marked for deletion.

CANCELLED Indicates that the dispatcher request has been canceled.


SUPERSEDED Indicates a successful end state in which the original dispatcher request
is replaced by one or more newer requests.
NO_TRANS Indicates a successful end state in which the original dispatcher request
contained objects that did not require translation.

Each dispatcher request object has an initial state value, one or more working state values, and one
or more end state values. Each dispatcher service processes DispatcherRequest objects whose
current state matches the initial state of the dispatcher service. When processing by the dispatcher
service completes, it sets the state of the dispatcher request to an end state value.

Dispatcher
request states
Value
Initial INITIAL
In Progress PREPARING, SCHEDULED, TRANSLATING, LOADING, SUPERSEDING
Final COMPLETE, DUPLICATE, DELETE, CANCELLED, SUPERSEDED,
NO_TRANS, TERMINAL

7-6 Installing and Configuring Dispatcher PLM00562 12.2


Add custom translators to Dispatcher

Translation process
1. Based on actions such as checkin and workflow, one or more DispatcherRequest
objects are created. (In Teamcenter, the DispatcherRequest object is represented by the
DispatcherRequest class). The dispatcher requests are added to the DispatcherRequest
database table with a state value of INITIAL.

2. Each dispatcher client queries the DispatcherRequest database table at the


configuration-defined interval. The dispatcher client queries for DispatcherRequest objects
with a state value of INITIAL.

3. The dispatcher client changes the DispatcherRequest state value to PREPARING to prevent
other dispatcher client instances from operating on the same DispatcherRequest object.

4. The dispatcher request is validated to check whether it is a duplicate of another in-process


request. If it is, the DispatcherRequest state value is set to DUPLICATE.

5. The translator-specific task preparation logic is activated to prepare data for translation input and
create a task XML file to facilitate submission of the translation task to the scheduler. The input
and XML files are collected in a task staging location. After task preparation is complete, the
dispatcher client submits the task to the scheduler and sets the DispatcherRequest object state
value to SCHEDULED. If an error occurs during preparation, the DispatcherRequest state
value is set to TERMINAL.

6. When translation begins, the Dispatcher Server notifies the scheduler and the
DispatcherRequest state is set to TRANSLATING.

7. When translation is successfully completed, the Dispatcher Server again notifies the
dispatcher client and the DispatcherRequest state value is set to LOADING. If an error
occurs or the translation task fails, the Dispatcher Server notifies the scheduler and sets the
DispatcherRequest state value to TERMINAL.

8. After the result files are loaded to the task staging location, the result files are mapped to
Teamcenter application data. The dispatcher client then activates the appropriate translator
integration logic to store the translation results in the Teamcenter database containing the
associated Teamcenter application data model. When the results are loaded, the dispatcher
client sets the DispatcherRequest state value to COMPLETE. If an error occurs during loading,
the DispatcherRequest state value is set to TERMINAL.
If the translation fails, the request is updated with a log file in the loader. This is based on
configuration settings.

Create dispatcher requests

Why create dispatcher requests?


You can customize dispatcher request creation by:
• Adding translator preferences to the Teamcenter database and then using the Translate menu
commands for translations.

PLM00562 12.2 Installing and Configuring Dispatcher 7-7


Chapter
Chapter 7: 7: Add custom
Add custom translators
translators to Dispatcher
to Dispatcher

• Using APIs for creating dispatcher requests. You can use these APIs for batch processing of
dispatcher requests or creating a dispatcher request from a workflow.

Create dispatcher requests in Teamcenter rich client


The Dispatcher client provides a single dispatcher request creation menu that is driven
from preferences defined within Teamcenter. This event is activated by selecting the
Translation→Translate menu command in My Teamcenter through one of the specific translator
menu selections.
To add the translator to the Translate menu command, you must add translation preferences
to Teamcenter.
If this menu command does not allow the creation mechanism you need in the rich client, a method is
exposed to create a dispatcher request on the com.teamcenter.rac.ets plug-in within the rich client.
The package, class, and method to create the request are:
Package: external

Class: DispatcherRequestFactory

Method: createDispatcherRequest

Create Dispatcher requests using ITK APIs


The Dispatcher client provides server APIs to support customized triggering of translations. The
dispatcher client framework for creation of dispatcher requests allows customizations in the following
areas:
• Batch translations

• Workflow

You can create dispatcher request objects using the DISPATCHER_create_request API.
These API support the creation of dispatcher request object in a server environment.
You must include the dispatcher_itk.h file to provide the prototype for these Dispatcher API
functions, and you must modify link scripts to link against the libdispatcher shared object.
Ensure that you specify primary and secondary objects as input to this API.
1. Modify the sample dispatcher_create_rqst_itk_main.c source code or create a new ITK
command line C source file.

2. Compile the source module using the sample script provided in the TC_ROOT/sample directory
by entering the following command:
compile –DIPLIB=none dispatcher_create_
rqst_itk_main.c

3. Copy the sample ITK link script provided in the TC_ROOT/sample directory. Edit the copied ITK
link script to add the Dispatcher library, libdispatcher.lib, to the link command.

4. Run the modified ITK link script by entering the following command:

7-8 Installing and Configuring Dispatcher PLM00562 12.2


Add custom translators to Dispatcher

myLinkitk –o dispatcher_create_rqst_itk_main dispatcher_create_rqst_itk_main.obj

5. Test the new ITK executable.

Creating Dispatcher requests using Teamcenter Services


Dispatcher provides a service to allow the creation of a dispatcher request using the service-oriented
architecture within Teamcenter.

Batch translations
Existing non-Dispatcher customer translation processes typically employ a daily process that runs
during off hours to examine the contents of the customers Teamcenter database and create the
necessary visualization data. You can integrate this process with Dispatcher using Dispatcher
Integration Toolkit (ITK) APIs.
For performing batch translations, the following are provided:
• ITK functions for use in custom batch programs.

• Command line ITK executable (with sample source) for use by batch scripts.

Dispatcher provides the DISPATCHER_create_request server ITK API. This ITK API supports the
creation of dispatcher request objects in a server environment.

Workflow translations
No workflow action handlers or triggers are currently provided by Dispatcher. Because workflow is
a customer process, it is intended that on-site customizations of workflow action handlers use the
Dispatcher Integration Toolkit (ITK) API to create dispatcher requests as they are needed.

Integrate new translators in the rich client


The following procedure explains how to integrate new translators in the Teamcenter rich client. It
assumes that appropriate triggers for the translation already exist.

Note
Adapt the procedure for UNIX as required.

1. Confirm that the desired translation is supported by a Dispatcher Server integrated translator.

2. Determine the following input requirements of the translator:


• Data to be translated.

• Datasets containing the data to be translated.

• Named references are required to perform the translation.

PLM00562 12.2 Installing and Configuring Dispatcher 7-9


Chapter
Chapter 7: 7: Add custom
Add custom translators
translators to Dispatcher
to Dispatcher

3. Design the logic of the new TaskPrep subclass prepareTask method to satisfy
translator input, and other Dispatcher requirements. Design the necessary
helper classes. Sample TaskPrep classes and property files are provided in the
DISP_ROOT/DispatcherClient/sample/integration/translator directory.

4. Determine the preferences required by the new TaskPrep subclass and add them to the
Translator name_env.xml file. Keep in mind that some preferences may be required by the
TranslateMenu classes and utilize these preferences before creating new ones.
The Translator-name_env.xml file should be created in the DISP_ROOT/DispatcherClient/install
directory.
You must manually load the preferences into Teamcenter.

5. Determine the output of the translator.

6. Determine the Teamcenter data model under which the result files are stored. Utilize the
Teamcenter standard data model and supported extensions. Be sure the data model is supported
by any downstream tools that are to consume translation results from the Teamcenter database.

7. Determine the DatabaseOperation method implementations that are necessary to load the
translator results in the Teamcenter database. This includes the load method at a minimum.

8. Design the logic of the required DatabaseOperation methods and any necessary helper
classes. Sample DatabaseOperation classes and property files are provided in the
DISP_ROOT/DispatcherClient/sample/integration/translator directory.

9. Determine the preferences required by the new DatabaseOperation subclass and add them to
the Translator-name_env.xml file. Keep in mind that some preferences may be required by the
TranslateMenu classes and utilize these preferences before creating new ones.

10. Extend the dispatcher client DefaultTaskPrep abstract class in a new TaskPrep class in a
package specific to the translator.
For example: your path.translator.provider name.translator name

11. Implement the new DatabaseOperation subclass in the same package with the TaskPrep class.

12. Implement the associated helper classes.

13. Compile the Java source files.


javac –classpath Classpath created by the
runDispatcherClient.bat/sh file myFile.java

14. Create the TSTranslator nameService.properties file to incorporate the new translator
integration classes.
The provider and service attribute values specified by the module translator configuration in the
translator.xml file must be used in constructing the property names (keys).
Edit the Service.properties file to import the new TSTranslator nameService.properties file.

7-10 Installing and Configuring Dispatcher PLM00562 12.2


Add custom translators to Dispatcher

15. Archive the new Java classes and the TSTranslator nameService.properties file. These new
classes along with other customized dispatcher client classes are most simply combined into a
single application or custom JAR file.
Make sure the TSTranslator nameService.properties file is in the root directory.
jar cf jar file name.jar myFile.class
myFile2.class TSTranslator nameService.properties

16. If the JAR file contains only translator integration classes, copy the new JAR file to the
DISP_ROOT/DispatcherClient/lib directory.

17. Implement the new translator site preference XML file and use the preferences_manager
executable to import the file.
preferences_manager -u=infodba -p=infodba -g=dba -mode=import
-scope=SITE -action=override -context=Teamcenter -file=your XML file

18. Modify the ETS_trans_rqst_referenced_dataset_types site preference to add the application


or customized dataset type name of the datasets that may be specified as a primary objects in
the dispatcher request for this translator. Addition of a dataset type to this preference allows
cancellation of a dispatcher request and subsequent deletion of the primary objects while the
translation is in process.

19. Add the Translate menu support for the new translation.

20. Start the dispatcher client.

21. Trigger an on-demand dispatcher request and verify that the new TaskPrep class run by the
dispatcher client processes the dispatcher request correctly. Examine the contents of the
Dispatcher Server file server task directory (or task staging location if configured for shared
staging location). Verify that the XML task file is present and that its contents are correct. Verify
that all the expected translator input files are present.

22. Verify that the translation task is successfully submitted to the Dispatcher Server scheduler.

23. When translation completes, verify the contents of the Dispatcher Server task directory (or task
staging location) to see that all expected result files are present.

24. Verify that the new DatabaseOperation class runs by the dispatcher client processes the
dispatcher request and correctly loads the result files. Confirm that the location and ownership of
the stored results is correct.

25. Confirm that the results can be accessed in the Teamcenter database.

Add customizations during the Dispatcher client startup


To call a custom code during the Dispatcher client startup, do the following:
1. Create a custom class that extends com.teamcenter.ets.ServiceInit and implement the init
method.
Example:

PLM00562 12.2 Installing and Configuring Dispatcher 7-11


Chapter
Chapter 7: 7: Add custom
Add custom translators
translators to Dispatcher
to Dispatcher

{
public void init()
{
//call custom code.
}
}

2. Add the compiled class to the DispatcherClient\lib directory as a jar file.

3. Add the class name to DispatcherClient\conf\Service.properties as follows:

#Custom class to invoke the methods that need to be called during


DispatcherClient startup.
#This class needs to implement the "init" method defined in
com.teamcenter.ets.ServiceInitclass.ServiService.InitClass=
com.xyz.CustomInit

Translation menu integration


The Translation menu
The Translation menu item appears on the menu bar, if you select the Translation for Rich Client
option during installation. The following procedures describe how to create the new menu items in the
Translation menu bar and to start a new dispatcher request using the new menu item.

Create a new menu item


• Open plugin.xml in an Eclipse plugin project. In the menuContribution tag, add the following
location;
<menuContribution
locationURI="menu:com.teamcenter.rac.ets.external.translate?after=additions">
</menuContribution>

Note
To place your new menu item after the Translate... menu item, use after=additions
in the menuContribution tag.
To place your new menu item before the Translate... menu item, use after=bottom
in the menuContribution tag.

Create a dispatcher request using a new menu item


• To create a new dispatcher request from a newly created menu item, use the
createDispatcherRequest method as an exported function from the DispatcherRequestFactory
class. This method allows you to create a dispatcher request easily from within your own plug-in
by just referencing the main Dispatcher plug-in from Eclipse.

7-12 Installing and Configuring Dispatcher PLM00562 12.2


Add custom translators to Dispatcher

/**
* Creates the DispatcherRequest.
*
* This function allows customers who wish to create a DispatcherRequest
* through a menu or other plug-in within Teamcenter.
*
* [R] = required, [O] = optional
*
* @param [R] provider - string representing the name of the translator
* provider
* @param [R] service - string representing the name of the translator
* to use
* @param [R] priority - integer representing the priority used in
* processing the request
* @param [O] primaryObjects - array of components selected within
* Teamcenter
* @param [O] secondaryObjects - array of parent components for the
* primary components
* @param [O] startTime - time to start the request
* @param [O] interval - number of times to repeat request
* @param [O] endTime - time at which to stop repeating tasks
* @param [O] type - string for user to define user specific
type of request
* @param [O] requestArgs - name/value arguments to pass to service
*
* @return true, if create DispatcherRequest
*
* @throws TCException the TC exception
*
* @published
*/

boolean createDispatcherRequest(String provider, String service,


int priority,
TCComponent[] primaryObjects,
TCComponent[] secondaryObjects,
String startTime, int interval, String endTime,
String type, Map<String, String> requestArgs) throws Exception

Customizing Translation Selection dialog box behavior

Why customize the Translation Selection dialog box behavior?


You can customize the Translation Selection dialog box behavior to do the following:
• Validate data.

• Dynamically add translation argument values to the dispatcher request.

You must perform the following steps to customize the Translation Selection dialog box.
• Create a custom plugin.

• Create a custom class.

PLM00562 12.2 Installing and Configuring Dispatcher 7-13


Chapter
Chapter 7: 7: Add custom
Add custom translators
translators to Dispatcher
to Dispatcher

Create a custom plugin


1. Create a new plugin based on the com.teamcenter.rac.ets.translator.singleselection plugin
and extend the requestCustomize point.

2. You must provide the following information in the plugin.xml file.


• providerName=Name of the provider whose behavior needs to be customized

• serviceName=Name of the service whose behavior needs to be customized

• class=Name of the class that implements the customization

Your plugin.xml file looks as follows:

<?xml version="1.0" encoding="UTF-8"?>


<?eclipse version="3.4"?>
<plugin>
<extension point="com.teamcenter.rac.ets.translator.
singleselection.requestCustomize">
<translator class=" com.foo.customization.abctoxyz.
AbcToXyzRequestCustomization"
providerName="SIEMENS" serviceName="abctoxyz">
</translator>
</extension>
</plugin>

You can add multiple translator tags to provide customization classes for different services, and the
same plugin can be used to provide customization classes for different services. However, there can
be only one customization class for one service and provider combination.

Create a custom class


1. Create the com.teamcenter.rac.dispatcher.translator.singleselection.
customization.translator service name.New class nameRequestCustomization class, which
implements com.teamcenter.rac.ets.translator.singleselection.customization.

7-14 Installing and Configuring Dispatcher PLM00562 12.2


Add custom translators to Dispatcher

IRequestCustomizable.

2. This class must implement the following methods:


• validateRequestData

• getValuesForKeys

For more information about the extension point, refer to the requestCustomize.exsd schema located
in the com.teamcenter.rac.ets.translator.singleselection plugin.
For an example on how to extend the requestCustomize extension point, see the
com.teamcenter.rac.dispatcher.customization plugin.

PLM00562 12.2 Installing and Configuring Dispatcher 7-15


Chapter 8: Monitor and administer translation requests

Dispatcher request administration console interface


You can monitor and administer translation requests using the Dispatcher request administration
console. To access the Dispatcher request administration console, in My Teamcenter choose
Translation→Administrator Console - All.

Buttons Description
Refreshes all dispatcher requests.
Refreshes the selected dispatcher request.
Resubmits a dispatcher request for processing.
Deletes the selected dispatcher request.
Launches the properties dialog box for the selected dispatcher request.

Refresh, resubmit, delete, or filter Dispatcher requests


• Refresh dispatcher requests

• Submit a dispatcher request for processing again

• Delete dispatcher requests

• Filter dispatcher requests

PLM00562 12.2 Installing and Configuring Dispatcher 8-1


Chapter
Chapter 8: 8: Monitor
Monitor and administer
and administer translation
translation requests
requests

Refresh dispatcher requests


• In the Dispatcher request administration console, click one of the following:
o Refresh All Requests (SHIFT+F5) button to refresh all dispatcher requests.

o Refresh Request (F5) button to refresh the selected dispatcher request.

Submit a dispatcher request for processing again


1. Select a dispatcher request.

2. Click the Resubmit Request for Processing button .

Note
You can submit dispatcher requests again only in final states.

Delete dispatcher requests


1. Select a dispatcher request.

2. Click the Delete Request button .

3. To delete dispatcher requests which are the in-progress states, press the Shift key and click the
Delete Request button .

Note
The translation fails when you delete dispatcher requests which are in the in-progress
states.

Filter dispatcher requests


1. From the Filter Requests section, select the filters from the available lists.

2. Filter dispatcher requests by selecting options provided in the following lists:


• Provider

• Service

• State

• User

View dispatcher properties


1. Choose a translation request and click the Request Properties button .

2. The Translation Request Properties dialog box appears.

8-2 Installing and Configuring Dispatcher PLM00562 12.2


Monitor and administer translation requests

a. Click the Properties tab to view the properties of the selected dispatcher.

b. Click the Arguments tab to view the dispatcher arguments.

c. Click the Files tab to view the dispatcher log. You can download the dispatcher log to view it.

d. Click History to view a log of the different dispatcher states.

View logs attached to dispatcher requests


1. Choose a dispatcher request and click the Request Properties button .

2. In the Translation Request Properties dialog box, click the Files tab.

3. In the Files pane, select the log and click Export to view the log file locally.

PLM00562 12.2 Installing and Configuring Dispatcher 8-3


Chapter
Chapter 8: 8: Monitor
Monitor and administer
and administer translation
translation requests
requests

Dispatcher request administration console performance tuning


When you perform the Refresh All operation in the Dispatcher request administration console, if
there are more than 5000 requests to retrieve, the SOA query has to make multiple server calls.
This degrades performance.
To avoid this, set the TC_SOA_MAX_PROPERTIES environment variable from 100,000 to a higher
number. For every additional 5000 requests, the environment variable must to be increased by
100,000.

8-4 Installing and Configuring Dispatcher PLM00562 12.2


Chapter 9: Customize the rich client for Dispatcher

Enable translation options in the user interface by adding Dispatcher


preferences
For translation options to appear in the Translation Selection dialog box, you must add Dispatcher
preferences.

This dialog box allows you to select the translation provider and service for a selected data type.
You can view the Translation Selection dialog box by choosing the Translation→Translate menu
option in the My Teamcenter menu.

Note
The translator preferences provided by Dispatcher are imported in Teamcenter during
installation. You only need to add preferences of new translators or providers that you
want to add to Teamcenter.

1. In My Teamcenter, choose Edit→Options.

2. In the Options dialog box, select Filter. This option is located at the bottom left corner of the
Options dialog box.

PLM00562 12.2 Installing and Configuring Dispatcher 9-1


Chapter
Chapter 9: 9: Customize
Customize the client
the rich rich client for Dispatcher
for Dispatcher

3. In the Preferences By Filter dialog box, you can either modify the values of the existing
preferences or add new preferences. To create new Dispatcher preferences, click the Definition
tab and click Create a new preference definition in the Preferences By Filter dialog box.
To modify the values of an existing preference, select the preference and change the values in
the Values box.

Note
Access to preferences and preference hierarchy are specified by protection scope.

You must set the following Dispatcher preferences:

Preference name Description


ETS.PROVIDERS Specifies the company that provides translators.
ETS.TRANSLATORS. Specifies a list of translators for a specific provider.
PROVIDER
ETS.DATASETTYPES. Specifies valid datasets for the selected translators.
PROVIDER.TRANSLATOR
Note
Only the datasets specified in this preference
are valid for translation.

ETS.PRIORITY. Specifies the priority to be assigned to a dispatcher


PROVIDER.TRANSLATOR request when the translator specified in this preference
is used.
ETS.TRANSLATOR_ARGS. Specifies the list of translation arguments to be passed
PROVIDER.TRANSLATOR to the translator.

Note
The order of values in the Values box determines the order in which they appear
in the Translation options dialog box.

4. Restart the Teamcenter server and rich client.

5. Select a dataset for which you defined preferences, and choose Translation→Translate.
The translators defined for the dataset appear.

9-2 Installing and Configuring Dispatcher PLM00562 12.2


Customize the rich client for Dispatcher

Note
If there is more than one translator definition, all the translators appear in a list.
The list with the translator values appears only if you select the cell that contains the
translator service.

Create a Dispatcher request and extract the data required for the
translation using sample preferences
You can use the CreateRequestInRAC.xml and ExtractAndLoad.xml sample preference files
to create a dispatcher request for a custom translator in the rich client and to extract and load
the data required for the translation in the Dispatcher client. These files are available in the
Dispatcher_Root\DispatcherClient\\sample\integration\translators\ppttopdf\ directory. For more
information, see the Readme file in the same directory.

Customizing the Dispatcher request administration console


Why customize the Dispatcher request administration console?
You can customize the Dispatcher request administration console to:
• Filter requests in the Dispatcher request administration console.
For example, this can be done to filter out other site requests or filter out requests owned
by other users.

• Create a new submenu under the Translation menu.


This menu launches the Dispatcher request administration console with predefined filtered results.
For example: Create a submenu called Terminal only to show only terminal requests in the
Dispatcher request administration console.

Filter requests in the Dispatcher request administration console


1. Create a new plugin based on the com.teamcenter.rac.ets plugin and extend the
DispatcherAdminConsoleFilter point.

2. You must provide the following information in the plugin.xml file.


class=com.teamcenter.rac.dispatcher.sampledispaccustomization.
handlers.NonTerminalFilter

PLM00562 12.2 Installing and Configuring Dispatcher 9-3


Chapter
Chapter 9: 9: Customize
Customize the client
the rich rich client for Dispatcher
for Dispatcher

Class is the actual class provided by new plugin and it implements methods defined in the
com.teamcenter.rac.ets.customization.IDispatcherACCustomizable interface.
Your plugin.xml file looks like this:
<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.4"?>
<plugin>
<extension
id="adminconsolenonterminal"
point="com.teamcenter.rac.ets.DispatcherAdminConsoleFilter">
<filter
class="com.teamcenter.rac.dispatcher.sampledispaccustomization.
handlers.NonTerminalFilter">
</filter>
</extension>
</plugin>

There can be only one customization class for one service and provider combination. If there
are multiple customizations, the Dispatcher request administration console ignores all the
customizations and displays all the queried requests to user.

3. Create a class com.teamcenter.rac.dispatcher.sampledispaccustomization.


handlers.NonTerminalFilter which implements
com.teamcenter.rac.ets.customization.IDispatcherACCustomizable.

4. This class must implement the method in IDispatcherACCustomizable.

For more information about the extension point, refer to the


com.teamcenter.rac.ets.DispatcherAdminConsoleFilter.exsd schema in com.teamcenter.rac.ets
plugin.

Create a new submenu under the Translation menu


1. Create a new plugin based on the com.teamcenter.rac.ets plugin.

2. In the new plugin, create a new menu and create a handler class to handle the menu click.

3. Create a class named com.teamcenter.rac.dispatcher.sampledispaccustomization.


handlers.NonTerminalFilter that implements
com.teamcenter.rac.ets.customization.IDispatcherACCustomizable.
This class must implement the method in IDispatcherACCustomizable.

4. In the handler class, implement the execute(ExecutionEvent) method to call the


AdminDialogService.OpenAdminDialog() method and pass an instance of the filter class
created previously.

Note
If you use this method, the Dispatcher request administration console ignores the filter class
defined by extending the extension point. The Dispatcher request administration console
only uses the filter class passed in the OpenAdminDialog() method in such a case.

9-4 Installing and Configuring Dispatcher PLM00562 12.2


Chapter 10: Troubleshooting

Troubleshoot Dispatcher
Checklist to handle errors
• Ensure that the installation and configurations are properly done.

• Follow instructions in the documentation according to the order of dependencies.

Example
To run the ideastojt translator, ensure that the ideastojt translator is installed
according to the I-deas installation guide.

• Check whether all the property files are configured correctly.


When you are not sure of the property values, try to be as close as possible to the default
property values.

• Ensure that all prerequisite software is installed and tested before installing the dispatcher client.
Also ensure the correct versions of the prerequisite software are installed.

• Restart the dispatcher client and rich client after any property changes.

• Ensure that service access rules are added.

• Ensure that you have permissions to write to the staging directory.

• Ensure that you have file storage space to run translation services.

Isolate translation problems


1. To isolate the application that is causing the translation failure, run the translator in different
contexts:
a. Run the translator in a standalone mode from the command line. For information about
running the translator from the command line, see the translator documentation.
It the translator fails, it is a translator issue. See the translator documentation for information
about fixing it.
If the translator works, go to the next step.

b. Perform a translation within the context of Dispatcher Server using the administration client.
If the translation fails, it is a Dispatcher Server issue.

PLM00562 12.2 Installing and Configuring Dispatcher 10-1


Chapter
Chapter 10:10:Troubleshooting
Troubleshooting

If the translation works, go to the next step.

c. Perform a translation within Teamcenter.


If the translation fails, it is a Teamcenter dispatcher client issue.

2. After the issue is identified as a Teamcenter dispatcher client issue, you can further isolate the
problem by setting debug levels to higher values in the log4j.xml file.
More debug information is available in:

• Console in which the dispatcher client started.

• Service logs are available in the Log-Directory/Dispatcher/process/DispatcherClient.log


file.

• Task logs are available in the Log-Directory/Dispatcher/Task-ID/Task-ID_ts.log directory.

3. Delete or back up old logs to ensure that you are not looking at wrong files for debug messages.

4. Create a new query for DispatcherRequest using Query Builder. This is useful to check whether
the DispatcherRequest object is created in the Teamcenter database.

5. Shut down the dispatcher client. Use the on-demand dispatcher client to trigger a translation
request.
a. Start the dispatcher client. Check the console, the DispatcherClient.log file, or task log files
to see whether the dispatcher client was successful in extracting files from Teamcenter and
uploading them to a staging location. Confirm that files are in a staging directory. If extraction
does not occur for the translation request, query DispatcherRequest in the rich client to see
whether a DispatcherRequest object is created.

b. After extraction, the task is submitted to the scheduler. Check whether the task was
successfully submitted to the scheduler and that you get back a translation successful event
from Dispatcher Server. The Dispatcher Server events should appear in the following order:
A. Submitted the task successfully

B. Started translation

C. Completed successfully

Confirm that result files (JT, CGM) are available on the file server staging directory. If
translation fails, you get a translation error event. If translation fails, use input files in the file
server staging directory to translate independent of dispatcher client using Dispatcher Server
administration client or the core standalone translator.
If translation fails, the input files have some problem.

c. Check whether the dispatcher client was successful in downloading result files and attaching
result files back to Teamcenter. If the download is successful and the attachment failed, check
whether file mapping failed (file mapping fails if result files do not map one on one with source
files). This can occur if translators are not configured per dispatcher client requirements.

10-2 Installing and Configuring Dispatcher PLM00562 12.2


Troubleshooting

Setting debug levels


For all Dispatcher services, the LogVolumeLocation property defines the location of the log files.
This property can be found in the following locations:
• Module
DISP_ROOT/Moduel/conf/transmodule.properties

• Scheduler
DISP_ROOT/Scheduler/conf/transscheduler.properties

• Dispatcher client
DISP_ROOT/DispatcherClient/conf/DispatcherClient.properties

You can define the debug level for logs in the Log4j.xml file. This file is located in the
DISP_ROOT/Dispatchert-component/conf directory.
To change the debug level, change the value of the level value property to the debug level you want.
Information about the supported debug levels is as follows.

<!-- Supported Levels of logging are -->

<!-- "OFF" - The OFF Level is intended to turn off logging. -->

<!-- "FATAL" - The FATAL level designates very severe error

events that will presumably lead the application to abort. --

<!-- "ERROR" - The ERROR level designates error events that might still
allow the application to continue running. -->

<!-- "WARN" - The WARN level designates potentially harmful situations. -->

<!-- "INFO" - The INFO level designates informational messages that

highlight the progress of the application at coarse-grained level. -->

<!-- "DEBUG" - The DEBUG Level designates fine-grained informational events


that are most useful to debug an application. -->

<!-- "TRACE" - The TRACE Level designates finer-grained informational events


than the DEBUG and tracks the start and end of method calls. -->

<!-- "${DBGHG}" - The ${DBGHG} Level designates very fine-grained information

than TRACE. Used to debug code which has lots of output. -->

<!-- "ALL" - The ALL Level is intended to turn on all logging. -->

<logger name="Process">

PLM00562 12.2 Installing and Configuring Dispatcher 10-3


Chapter
Chapter 10:10:Troubleshooting
Troubleshooting

<level value="INFO"/>

<appender-ref ref="ProcessAppender"/>

<appender-ref ref="ProcessConsoleAppender"/>

</logger>

<logger name="Task">

<level value="INFO"/>

<appender-ref ref="TaskAppender"/>

<appender-ref ref="TaskConsoleAppender"/

</logger>

Query translation request objects


To check whether a translation request object is created in the database, create a new query in the
Query Builder application as follows:
1. In the Query Builder pane, type DispatcherRequest in the Name box.
This specifies the name for the query.

2. Click the Search Class button , and select DispatcherRequest as the search class.

3. In the Attribute Selection pane, double-click the State attribute to add the State attribute to
the Search Criteria table.

4. In the Search Criteria pane, set the Default Value attribute to *.

5. Click the Create button to create the query definition.

Unable to run Dispatcher components as Windows service due to missing


DLL file
You cannot run Dispatcher components as Windows service if the msvcr71.dll file is missing from
your Windows system directory. To add this file to the Windows system directory:
• Copy the msvcr71.dll file from the Teamcenter-install-kit\install\install\jre\bin directory to your
Windows system directory.
For example, copy msvcr71.dll to C:\Windows\SysWOW64.
OR

• Add the Teamcenter-install-kit\install\install\jre\bin directory to the system path variable.

10-4 Installing and Configuring Dispatcher PLM00562 12.2


Troubleshooting

Optimizing performance of the dispatcher client


The dispatcher client performance may be impacted if you have a large number of dispatcher
requests in the INITIAL state, for example, more than 10000 dispatcher requests. If you observe
performance issues, create a preference named DISPATCHERCLIENT_MAX_TO_QUERY with
protection scope of User and a value of 500. This preference limits the number of dispatcher
requests that dispatcher client queries.
To create this preference, log in as the Dispatcher proxy user.
You can adjust the value of this preference based on the Dispatcher performance.

Dispatcher requests go to terminal state due to large number of files open


On a Linux server, if the number of open dispatcher requests is greater than the number of files the
server can handle, the extra dispatcher requests go to the terminal state.
To fix this, run the ulimit utility and update the nofile argument with the number of files or requests
you want Dispatcher to handle at a time.
Example:
$ ulimit -n 65536

Troubleshoot Translators

NXToPvDirect translations hang


When translations for NxToPvDirect are submitted to the Dispatcher Server, the translator launches,
but hangs and never completes the operation.
When this translator runs in batch mode it must connect and log on to Teamcenter as a validated user.
When the dispatcher module launches the translator, the validated user logging on to Teamcenter
must be the same user as the Module, meaning that the translator must be running as the same user
name as the Module service. There are two solutions for this:
• Run the Module as a user with a valid Teamcenter user. This is the correct solution for this
problem.

• Modify the launch script used by Dispatcher to start the translator to add the user name and
password as a parameter to the UgToPvDirect translator. This is not the best solution because
this exposes the user name and password in a text file. If this approach is chosen, the Dispatcher
batch script must be properly secured to avoid anyone (other than the module and translator)
from being able to read or get access to this file.
UNIX example:
# Using single part option with individual @DB strings
#
if [ $1 = -single_part ]; then
if [ $3 = defaultdef ]; then
export UGII_DEFAULTS_FILE=
else
export UGII_DEFAULTS_FILE=$3

PLM00562 12.2 Installing and Configuring Dispatcher 10-5


Chapter
Chapter 10:10:Troubleshooting
Troubleshooting

fi
export UGII_LOAD_OPTIONS=
$UGII_BASE_DIR/pvtrans/run_ugtopv -single_part
-config=$UGII_CONFIG_FILE -noupdate -pim=yes $4 $5 $6 $7 $8 $9
#
# Copying latest UG release status.
#
elif [ $1 = copyugrelstatus ]; then
. $TC_DATA/tc_profilevars
$TC_ROOT/bin/tc_workflow_postprocess $2 $3 $4 $5 $6 $7 $8 $9
#
# Using text file with @DB Strings
#
else
$UGII_BASE_DIR/pvtrans/run_ugtopv
-config=$UGII_CONFIG_FILE -noupdate
-pim=yes $3 $4 $5 $6 $7 $8 $9
fi
exitvalue=$?
if [[ `uname` = SunOS ]] then
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH_ORG
elif [[ `uname` = HP-UX ]] then
export SHLIB_PATH=$SHLIB_PATH_ORG
elif [[ `uname` = AIX ]] then
export LIBPATH=$LIBPATH_ORG
elif [[ `uname` = IRIX64 ]] then
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH_ORG
export LD_LIBRARYN32_PATH=$LD_LIBRARYN32_PATH_ORG
fi
exit $exitvalue

Windows example:

REM
REM Using text file with @DB Strings
REM
"%UGII_BASE_DIR%\PVTRANS\run_ugtopv.bat"
-config="%UGII_CONFIG_FILE%"
-noupdate "-pim=yes" %3 %4 %5 %6 %7 %8 %9
goto done
REM
REM Using single part option with individual @DB strings
REM
:single_part
set UGII_DEFAULTS_FILE=%3
if %3==defaultdef set UGII_DEFAULTS_FILE=
set UGII_LOAD_OPTIONS=
"%UGII_BASE_DIR%\PVTRANS\run_ugtopv.bat"
-single_part -config="%UGII_CONFIG_FILE%"
-noupdate "-pim=yes" %4 %5 %6 %7 %8 %9
goto done
REM
REM Copying latest UG release status.
REM
:copyugrelstatus

10-6 Installing and Configuring Dispatcher PLM00562 12.2


Troubleshooting

call %TC_DATA%\tc_profilevars
"%TC_ROOT%\bin\tc_workflow_postprocess.exe" %2 %3 %4 %5 %6 %7 %8 %9
goto done

View runtime status of Dispatcher services and Dispatcher client history


The –ping command is provided for all the three Dispatcher services. This command provides
the runtime status of these services.

Note
The ping command is performance intensive; use it only when required.

• Dispatcher scheduler: The runscheduler.bat –ping (Windows) or runscheduler.sh –ping


(UNIX/Linux) ping command provides runtime information on the scheduler and modules
associated with the scheduler.

• Dispatcher module: The runmodule.bat –ping (Windows) or runmodule.sh –ping (UNIX/Linux)


ping command provides runtime information on the module.

• Dispatcher client: The runDispatcherClient.bat –ping (Windows) or runDispatcherClient.sh


–ping (UNIX/Linux) ping command provides runtime information on the Dispatcher client,
scheduler, and the modules associated with the scheduler.

The –history command is provided for the Dispatcher client. It is used to parse the history log and
provide a detailed summary of tasks performed per day. The runDispatcherClient.bat –history
(Windows) or runDispatcherClient.sh –history (UNIX/Linux) command provides information on
the usage of the Dispatcher client.

PLM00562 12.2 Installing and Configuring Dispatcher 10-7


Siemens Industry Software

Headquarters
Europe
Granite Park One
Stephenson House
5800 Granite Parkway
Sir William Siemens Square
Suite 600
Frimley, Camberley
Plano, TX 75024
Surrey, GU16 8QD
USA
+44 (0) 1276 413200
+1 972 987 3000

Asia-Pacific
Americas
Suites 4301-4302, 43/F
Granite Park One
AIA Kowloon Tower, Landmark East
5800 Granite Parkway
100 How Ming Street
Suite 600
Kwun Tong, Kowloon
Plano, TX 75024
Hong Kong
USA
+852 2230 3308
+1 314 264 8499

About Siemens PLM Software

© 2019 Siemens Product Lifecycle Management


Siemens PLM Software, a business unit of the Siemens
Software Inc. Siemens and the Siemens logo are
Industry Automation Division, is a leading global provider
registered trademarks of Siemens AG. D-Cubed,
of product lifecycle management (PLM) software and
Femap, Geolus, GO PLM, I-deas, Insight, JT, NX,
services with 7 million licensed seats and 71,000 customers
Parasolid, Solid Edge, Teamcenter, Tecnomatix and
worldwide. Headquartered in Plano, Texas, Siemens
Velocity Series are trademarks or registered trademarks
PLM Software works collaboratively with companies
of Siemens Product Lifecycle Management Software
to deliver open solutions that help them turn more
Inc. or its subsidiaries in the United States and in other
ideas into successful products. For more information
countries. All other trademarks, registered trademarks
on Siemens PLM Software products and services, visit
or service marks belong to their respective holders.
www.siemens.com/plm.

You might also like