SIEMENSSIEMENSSIEMENS

Teamcenter 12.3 lifecycle visualization

ClearanceDB Administration Guide

PLM00196

Contents

Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

ClearanceDB overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Version compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Supported locales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 ClearanceDB system components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Steps to install, configure, and run ClearanceDB analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 ClearanceDB issue management process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 ClearanceDB managed workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Perl and SQL script reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 Other resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12

Installing ClearanceDB components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Install ClearanceDB components on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Install a ClearanceDB patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Upgrade an existing database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Upgrade to Oracle 11gR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Configuring ClearanceDB Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

ClearanceDB Server overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Create the ClearanceDB database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 Tune the database memory parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Creating the ClearanceDB tablespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11

Creating user accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Creating user accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 Create Oracle users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Update Oracle user accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 Understanding roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 Create ClearanceDB auxillary users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7

Creating the ClearanceDB Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Setting up the work area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Create the ClearanceDB Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Global configuration options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Configure the global DBC file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19 Configure the global .vvi file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20

Configuring and running ClearanceDB Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

PLM00196 ClearanceDB Administration 3

Contents

ClearanceDB Proxy overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1 Install the Oracle Instant Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Configure the default ClearanceDB Proxy settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Encrypt the Oracle user password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4 Create a ClearanceDB Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5 Configure a ClearanceDB Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5 Run a ClearanceDB Proxy as a Windows service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7 Start a ClearanceDB Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9 Ping a ClearanceDB Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9 Ping the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10 List products in the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10 Stop a ClearanceDB Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11

Setting up products for analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Setting up products for analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Configuring the ClearanceDB default product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Understanding the ClearanceDB default product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Create the ClearanceDB default product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Create a new ClearanceDB product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4 Configuring the ALL product for issue inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7

Set up the ALL product for issue inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7 Define groups for the ALL product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7 Example configuration file for the ALL product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8

Deploying the issue inheritance mechanism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8 Enable the issue inheritance mechanism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8 Disable the issue inheritance mechanism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9 Modifying the issue inheritance mechanism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

Using the product-specific configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9 ClearanceDB product configuration attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

Overview of ClearanceDB product attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11 ClearanceDB product attributes reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12 Merging product attributes with the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-25 Example configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-25

Specifying rules and conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26 Specifying rules and conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26 ClearanceDB rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26 ClearanceDB conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-28 Merging rules and conditions with the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-31 Examples of rules and conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-31

Defining clearance zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-50 Defining clearance zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-50 Understanding clearance zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-51 Merging zones with the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-51 Example zones file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-52

Performing analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

Accuracy of clearance calculations