0% found this document useful (0 votes)
5K views102 pages

Teamcenter 13.1 Window Client Installation Guide

This document belongs to Siemens Co.LTD. How to install Teamcenter Step by step

Uploaded by

Phuoc Ho
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)
5K views102 pages

Teamcenter 13.1 Window Client Installation Guide

This document belongs to Siemens Co.LTD. How to install Teamcenter Step by step

Uploaded by

Phuoc Ho
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/ 102

Teamcenter Client

Installation on
Windows
PLM00012 - 13.1
Contents

Getting started with Teamcenter client installation


Where to start ─────────────────────────────────────── 1-1
System Requirements ─────────────────────────────────── 1-1
Choose an online help source ────────────────────────────── 1-5
Install dependent Teamcenter integrations ───────────────────── 1-6
Teamcenter client concepts ─────────────────────────────── 1-7
Teamcenter architectures ─────────────────────────────────── 1-7
Teamcenter components ─────────────────────────────────── 1-10
Teamcenter installation tools ──────────────────────────────── 1-13

Installing the rich client


Choose a rich client configuration type ─────────────────────── 2-1
Installing the rich client using TEM ────────────────────────── 2-1
Install the four-tier rich client ───────────────────────────────── 2-1
Install the two-tier rich client ───────────────────────────────── 2-9
Install the rich client (two-tier and four-tier) ─────────────────────── 2-15
Install the rich client lite edition ─────────────────────────────── 2-21
Configure rich client features ───────────────────────────── 2-22
Configuring client display language ──────────────────────────── 2-22
Configure online help access ──────────────────────────────── 2-25
Add features ────────────────────────────────────────── 2-26
Add, remove, or modify databases ───────────────────────────── 2-27
Migrate Teamcenter to a different JRE ─────────────────────────── 2-27
Configure Teamcenter Automotive Edition–GM Overlay ──────────────── 2-29
Customize port for Teamcenter Integration for NX ─────────────────── 2-30

Creating a custom distribution


Overview of custom distributions ─────────────────────────── 3-1
Create a silent distribution ─────────────────────────────── 3-1
Create a silent installation configuration file ──────────────────────── 3-1
Install the rich client silently ────────────────────────────────── 3-2
Modify the silent installation configuration file ────────────────────── 3-2
Create a compact distribution ───────────────────────────── 3-8

Installing Microsoft Office interfaces


Compare Microsoft Office interfaces ───────────────────────── 4-1
Installing Teamcenter Client for Microsoft Office ───────────────── 4-2
Before you install Client for Office ────────────────────────────── 4-2
Install Client for Office using the stand-alone installation wizard ──────────── 4-3
Install Client for Office using TEM ────────────────────────────── 4-10
Requiring add-ins to be signed by a trusted publisher ────────────────── 4-11
Process of opening a Microsoft Office dataset from Teamcenter ─────────── 4-12

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2


© 2021 Siemens
Contents

Uninstall Microsoft Office interfaces ──────────────────────────── 4-13


Patching Client for Office ─────────────────────────────────── 4-14
Installing Teamcenter Extensions for Microsoft Office ───────────── 4-17
Before you install Extensions for Office ────────────────────────── 4-17
Install Extensions for Office using the stand-alone installation wizard ──────── 4-18
Install Extensions for Office using TEM ─────────────────────────── 4-19
Patching Extensions for Office ──────────────────────────────── 4-20

Installing TCCS
What is TCCS? ──────────────────────────────────────── 5-1
Preparing to install TCCS ───────────────────────────────── 5-1
Enable TCCS using TEM ────────────────────────────────── 5-2
Install TCCS ───────────────────────────────────────── 5-5

Troubleshooting A-1

Uninstalling Teamcenter
Uninstall the rich client using TEM ────────────────────────── B-1
Uninstall Microsoft Office interfaces ───────────────────────── B-1
Choose the appropriate uninstallation method ────────────────────── B-1
Uninstall Microsoft Office interfaces using Windows Control Panel ────────── B-2
Uninstall Microsoft Office interfaces using TEM ────────────────────── B-2
Uninstall TCCS ─────────────────────────────────────── B-3

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 3


© 2021 Siemens
4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1
© 2021 Siemens
1. Getting started with Teamcenter client
installation
Where to start
What software should I download?

From the download page on Support Center, download the Teamcenter 13 and 13.1 software kits for
Windows:

Tc13.0.0.0_wntx64.zip
Tc13.1.0.0_wntx64.zip

If a patch to Teamcenter 13.1 is available, for example, Teamcenter 13.1.0.1, you can alternatively
substitute that kit for the Teamcenter 13.1 kit. Patch kit files are named
Tc13.1.0_patch_number_wntx64.zip.

Expand the software kits to separate directories that are accessible to your Teamcenter host.

Can I place the software in a remote location?

You can place the Teamcenter kits on a non-local drive, with the following consideration.

Teamcenter cannot be installed from UNC paths, for example, \\mediaserver\tcmedia. If the
software kits are located on a remote host, map a drive to each software location using the net use
command.
Open an administrator command prompt and type the net use command:

net use drive-letter: UNC-path

For example:

net use z: \\mediaserver\tcmedia

System Requirements
For versions of system software and hardware certified for running Teamcenter on your platform, see
the Hardware and Software Certifications knowledge base article on Support Center:

https://support.sw.siemens.com

Some software requirements differ for non-English locales. When viewing certified versions, make sure
you note any exceptions for your locale.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-1


© 2021 Siemens
1. Getting started with Teamcenter client installation

Hardware requirements for a Teamcenter deployment vary depending on considerations such as


whether your deployment contains:

• A single host or multiple hosts

• Rich client, Active Workspace, or both

• Additional components such as Dispatcher Server on separate hosts

The Teamcenter Server Hardware Overview available on Support Center contains hardware
recommendations based on these and other variables.

Platforms

Determine from the following table which Teamcenter 13.1 servers and clients are supported on your
operating system. Bullet characters (•) denote supported servers and clients.

Platform support for Teamcenter servers and clients

Operating system Corporate Web Rich Business Modeler IDE TCCS1


server tier client client

Microsoft Windows • • •
(desktop platforms)

Microsoft Windows Server • • •

SUSE Linux • • • • •

Red Hat Linux • • • • •

CentOS Linux • • • • •

Microsoft Windows

• On Windows platforms, disable Windows User Account Control (UAC) before you install
Teamcenter. This option is available in the Control Panel→User Accounts dialog box.
Windows UAC can interfere with Teamcenter installation programs. Siemens Digital Industries
Software recommends turning off UAC for administrative users only.
For more information, see Microsoft Windows documentation.

• Disable the Windows TCP scaling feature. Open a command prompt and enter the following
command:

netsh interface tcp set global autotuninglevel=disabled

1 Teamcenter client communication system (TCCS) is installed with the rich client. This column refers to the stand-alone
TCCS application.

1-2 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
System Requirements

Siemens Digital Industries Software recommends setting this parameter before installing
Teamcenter because most client network infrastructures use one or more switches or routers. By
default, Windows enables TCP window scaling, but some routers do not support this feature.
This can cause installation failures that are difficult to diagnose and correct.
For more information, see Microsoft Windows documentation.

• If you use a nonnative language operating system version of Windows, you must install and
enable the Multilingual User Interface (MUI) pack to ensure the language font is displayed
properly.

1. Download and install the MUI pack for Windows from Microsoft.

2. Open the Regional and Language Options dialog box in the Windows Control Panel.

3. In the Languages tab, set the required language for the menus and dialogs.

4. In the Advanced tab and the Regional Options tab, set the required language.

If you use Teamcenter Client for Microsoft Office on a non-English version of Windows, install
the Multilingual User Interface (MUI) Pack for your version of Microsoft Office. This is required
because .NET add-ins require English support.

Database

Teamcenter requires a relational database management system (RDBMS) for storing Teamcenter data.
Before you install Teamcenter, you must install an Oracle database server or a Microsoft SQL Server
database server.

If your database server is not a supported version, upgrade your database server to a supported version
before you install Teamcenter.

Choose a database management system that suits the platforms of your Teamcenter servers and clients,
and make sure your Teamcenter corporate server host has access to the database server.

If you use Oracle, set system parameters to recommended values to ensure adequate database
performance.

If you use Microsoft SQL Server, keep in mind that Teamcenter servers and two-tier rich clients on Linux
hosts cannot connect to Microsoft SQL Server database servers.

Java Runtime Environment

Teamcenter Environment Manager (TEM) requires a supported 64-bit Java Runtime Environment (JRE). If
a certified JRE is not available on the host, TEM cancels installation.

Before you launch TEM to install Teamcenter:

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-3


© 2021 Siemens
1. Getting started with Teamcenter client installation

1. Download and install a certified 64-bit JRE.

For certified JRE versions, see the Hardware and Software Certifications knowledge base article on
Support Center.

2. Set the JRE_HOME environment variable to the location of the supported JRE. After installation is
complete, TEM no longer requires this variable.

Alternatively, you can launch TEM in a command prompt and specify the JRE location using the -jre
argument:

tem -jre JRE-path

For example:

tem -jre c:\apps\jre1.8

Web tier support

Install the required software for the Teamcenter web tier you use:

• Java EE web tier

Java Runtime Environment (JRE)


Install a supported JRE on the host where you build Teamcenter web applications.
Java EE application server
Install a supported application server on the host where you deploy Teamcenter web
applications.

• .NET web tier

Microsoft Internet Information Server (IIS)


Install IIS on your Teamcenter corporate server host and add the required role services.
Microsoft .NET framework
Install the .NET framework on all Teamcenter hosts.

Some web application servers require special configuration for use with Teamcenter.

Web browser

A web browser is required if you use the following:

• Teamcenter online help


• Active Workspace

1-4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Choose an online help source

• Deployment Center

For these products, Teamcenter supports the following web browsers:

• Windows systems: Microsoft Internet Explorer, Mozilla Firefox, and Google Chrome
• Linux systems: Mozilla Firefox and Google Chrome

For supported browser versions, see the Hardware and Software Certifications knowledge base article
on Support Center.

Microsoft Office interface support

Teamcenter Microsoft Office interfaces require additional prerequisite software.

Choose an online help source


You can access Teamcenter online help from two sources.

Online help Support Center Siemens Documentation Server


source:

Access Internet access Local network access


required

Benefits • Eliminates the need to install and • Local access to help for all products and
maintain documentation on user versions you use, in multiple languages.
desktops or intranet.
• No Internet access required.
• Provides secure access through a
generated API key specific to your
site.

• Requires no log on.

Software to Secure Documentation Proxy 1. Siemens Documentation Server


install To enable access for multiple hosts in
your network, configure multiuser
mode.
2. Product documentation

To configure client access to online help:

1. Choose how you want to access online help.

2. Download and install the appropriate software from Support Center.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-5


© 2021 Siemens
1. Getting started with Teamcenter client installation

3. Supply the appropriate online help URL to the rich client:

http://domain/en-US/product/282219420/doc/PL20200604175134771.xid1899404/html/
xid1899405

Replace domain with the source from which you access online help:

• Support Center: docs.sw.siemens.com

• Siemens Documentation Server: doc-server-host:doc-server-port

Install dependent Teamcenter integrations


If you use Teamcenter integrations to other Siemens Digital Industries Software products or third-party
software, install those products before you install Teamcenter.

Some software products require separate licenses from Siemens Digital Industries Software. Purchase
the required licenses and install them into the Siemens Common Licensing Server as described in the
server installation guides for Windows and Linux.

If you use any of the following integrations with the rich client, make sure you install these applications
in locations specified by the Teamcenter administrator.

• NX integrations
Installing NX is not a prerequisite for installing or using Teamcenter, but if you intend to integrate NX
with Teamcenter, install the following software before you install Teamcenter:

• NX
Install NX locally on every workstation according to the installation guide distributed with NX. This
is required for NX integrations to function in a rich client environment.

• Teamcenter Integration for NX or NX Integration


Teamcenter Integration for NX and NX Integration provide the same NX user interface and are both
installed with NX, but neither can be used until Teamcenter is configured.
If you include the NX Foundation feature on your Teamcenter corporate server, you must install
the NX Rich Client Integration feature on all servers and all two-tier rich clients in your
environment.
When you upgrade to a new version of NX, uninstall the NX Rich Client Integration feature, then
reinstall it, specifying the path to the new NX installation in the NX Install Location box in the
Teamcenter installation tool (TEM or Deployment Center).

For more information about using Teamcenter with NX, see the installation guides distributed with
NX.

• Lifecycle Visualization

1-6 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Teamcenter architectures

Obtain the Lifecycle Visualization software kit and install a supported version of Lifecycle Visualization
on your workstation.
For installation information, see the installation guide distributed with Lifecycle Visualization.

• SCM Integration – ClearCase


Obtain the IBM Rational ClearCase client software kit and install a supported version on your
workstation.

Teamcenter client concepts

Teamcenter architectures

Teamcenter can be deployed in either of following logical server-client models.

Four-tier architecture

The four-tier architecture model comprises the following tiers:

• Client tier
The client tier comprises the Teamcenter rich client, and other clients such as Teamcenter Client for
Microsoft Office.
The rich client can be deployed with additional functionality, such as Lifecycle Visualization,
Teamcenter Client for Microsoft Office, and Teamcenter Integration for NX or NX Integration.

• Web tier
The Teamcenter web tier is a web application that facilitates communication between the client tier
and enterprise tier. Teamcenter provides a Java EE web tier that runs in a Java Enterprise Edition (Java
EE) application server such as Oracle WebLogic, and a .NET web tier that runs in Microsoft Internet
Information Server (IIS).2
For information about supported application servers, the Hardware and Software Certifications
knowledge base article on Support Center.

• Enterprise tier
The enterprise tier comprises a configurable pool of Teamcenter C++ server processes and a server
manager. The enterprise tier retrieves data from and stores data in the database.
A server manager manages a pool of Teamcenter server processes. You must install a server manager
whenever you deploy the web tier.

• Resource tier
The resource tier comprises a database server, database, volumes, and file servers.

Four-tier architecture

2 The .NET web tier is not available on Linux platforms.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-7


© 2021 Siemens
1. Getting started with Teamcenter client installation

You can design deployments that host the web tier, resource tier, and enterprise tiers on the same
computer or on separate computers:

• Smaller sites can run the pool of servers and the server manager on the same host as the web tier.

• Larger sites can distribute the pool of server processes across multiple hosts and optionally include an
HTTP server to serve static files or multiple HTTP servers to support load balancing.
For a multihost configuration, the server pool consists of multiple subpools, one or more for each
host. Each subpool is managed by one server manager process. The web tier balances the load across
the server pools.

1-8 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Teamcenter architectures

To ensure communication between the web tier and the server manager, you must coordinate the
values you specify for each component. For some values, you must provide the identical value when
configuring the web tier application.

For more information about four-tier rich client architecture, see the appropriate Teamcenter server
installation manual (for Windows or Linux).

Two-tier architecture

The two-tier architectural model comprises the following tiers:

• Client tier
The client tier comprises the Teamcenter rich clients.
In a deployment of the two-tier architecture, the Teamcenter server runs on the client workstation.
Some Teamcenter client features, such as Teamcenter Integration for NX, Lifecycle Visualization, and
Teamcenter Client for Microsoft Office, require the web tier, a component of the four-tier
architecture. To enable these features for a two-tier rich client, you can connect the two-tier rich client
to a deployment of the web tier on a Windows host or on a Linux host.

• Resource tier
The resource tier comprises a database server, database, volumes, and file servers.

Two-tier architecture

In the two-tier model, you deploy the Teamcenter rich client, which includes the local server, and the
optional applications that integrate with the rich client on the client workstation. Typically, the database
server, volumes, and file servers are installed on one or more separate hosts.

Teamcenter File Management System (FMS) manages the rich client access to volumes:

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-9


© 2021 Siemens
1. Getting started with Teamcenter client installation

• The FMS server cache (FSC) process run on the server hosting the volume.

• The FMS client cache (FCC) process runs on the rich client host.

Two-tier deployment

Teamcenter components

Teamcenter servers and clients

Corporate server

A Teamcenter corporate server performs the vital operations of the Teamcenter environment, including
communication with the Teamcenter database. A corporate server primarily consists of the following:

• Teamcenter shared executables.


This installation directory is referred to as the Teamcenter application root directory, or TC_ROOT. The
TC_ROOT environment variable in Teamcenter configuration files points to this location.
A Teamcenter application root directory can be NFS/CIFS-mounted to more than one application
client.

• Teamcenter shared data subdirectories and files.


This installation directory is referred to as the Teamcenter data directory, or TC_DATA. The TC_DATA
environment variable in Teamcenter configuration files contains this location. Each data directory is

1-10 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Teamcenter servers and clients

associated with a single database instance, but multiple data directories can point to a single
database instance.
The data directory is exported with full write access and mounted via NFS/CIFS by other Teamcenter
nodes.

• Teamcenter volume and File Management System (FMS).


To install volumes on multiple hosts for the same database, install a server that points to the database
and install FMS on any system that services a volume.

• Teamcenter server manager, which starts and stops Teamcenter servers, informing a server assigner
of its actions so that the assigner can assign available servers to user sessions.

A Teamcenter environment requires one corporate server configuration. Additional servers are optional,
but can help balance network loads and facilitate heterogeneous networks (networks with hosts
running different operating systems).

Corporate server installation is described in the Teamcenter server installation guides for Windows and
Linux.

Rich client

The rich client is a platform-independent client Java application for users who interact with Teamcenter
frequently. It is extendable to run standard Teamcenter and customized applications.

The rich client is deployed on each user workstation using Teamcenter Environment Manager or
Deployment Center. The rich client is supported in both the two-tier architecture and four-tier
architecture.

If your Teamcenter database is on Microsoft SQL Server, be aware that Teamcenter servers and two-tier
rich clients on Linux hosts cannot connect to Microsoft SQL Server database servers.

Active Workspace

Active Workspace is a web client that features a simplified interface highly configurable to an industry,
group, role, or individual user. It provides a broad set of Teamcenter functionality with enhanced search
capability and mobile device support.

Installation and configuration of Active Workspace is described in the Active Workspace help, not in the
Teamcenter help.

Additional clients

Teamcenter provides additional clients for specialized use within other applications. This includes
integrations like Teamcenter Client for Microsoft Office and Teamcenter Extensions for Microsoft Office.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-11


© 2021 Siemens
1. Getting started with Teamcenter client installation

File Management System (FMS)

File Management System (FMS) is a file storage, caching, distribution, and access system. FMS provides
global, secure, high-performance and scalable file management. Use FMS to centralize data storage
volumes on reliable backup file servers, while keeping data close to users in shared data caches. This
enables centralized storage and wide distribution of file assets to the needed locations within a single
standard file management system. FMS provides WAN acceleration to effectively move large files across
WAN assets.

Teamcenter client installation programs installs FMS executables and an FMS client cache (FCC) on
client hosts and sets the FMS_HOME environment variable in the user environment.

FMS downloads files to client hosts from Teamcenter volumes and uploads files from client hosts to
Teamcenter volumes. FMS_HOME points to the location of the FMS executables on the client host. All
Teamcenter clients installed on a host use the FMS executables defined in FMS_HOME.

If other users on a client host want to use the same installed client environment, they must manually set
FMS_HOME in their user environments. Using the same installed environment shares only the binaries
and run-time content; the file cache contents remain private to the user.

Lifecycle Visualization

For enterprise-wide product visualization capability, you can install Teamcenter lifecycle visualization
and add a Lifecycle Visualization viewer to your Teamcenter configuration.

Siemens Digital Industries Software provides two Lifecycle Visualization viewers for use with
Teamcenter:

• Lifecycle Visualization embedded viewer


The Lifecycle Visualization embedded viewer is embedded in the rich client user interface. The
embedded viewer provides full 2D visualization capabilities and 3D viewing and is available to all
Teamcenter users.
The embedded viewer is installed on user workstations as part of a rich client configuration. The
license level is configured during installation.

• Lifecycle Visualization stand-alone application viewer


The Lifecycle Visualization stand-alone application viewer is launched from the Teamcenter rich client
user interface. Users can also run it as a stand-alone application. The suite includes the embedded
viewer and Teamcenter lifecycle visualization mockup.
The stand-alone application viewer is individually installed on each client workstation using the
Teamcenter lifecycle visualization software kits.

Lifecycle Visualization uses Teamcenter client communication system (TCCS).

If your Teamcenter configuration includes a rich client and a Lifecycle Visualization viewer, Lifecycle
Visualization uses Teamcenter volumes and FMS, including the FMS server cache (FSC) and FMS client
cache (FCC). (FCC is a component of TCCS.)

1-12 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Teamcenter installation tools

When installed as a stand-alone application, Lifecycle Visualization can use Teamcenter volumes and
FMS if you install TCCS on the client host.

If you use NX or Teamcenter lifecycle visualization, you can install the FCC and use it to upload files to
and download files from the Teamcenter volume.

Installation of TCCS is described in the appropriate Teamcenter client installation guides for Windows
and Linux.

For information about installing Lifecycle Visualization, see the Teamcenter lifecycle visualization
Installation Guide in the Lifecycle Visualization online help library.

Lifecycle Visualization features provided with Teamcenter are installed through TEM and Deployment
Center. You can also patch Lifecycle Visualization using TEM.

You can configure both Lifecycle Visualization viewers for use with a rich client. If you configure both
products, you must install the embedded viewer in a separate directory from the stand-alone application
viewer. The embedded viewer and the stand-alone application viewer require separate license files.

For more information about software requirements for Lifecycle Visualization, see the Hardware and
Software Certifications knowledge base article on Support Center.

Teamcenter installation tools

Deployment Center

Deployment Center is a centralized web application for deploying software to Teamcenter


environments. Using Deployment Center, you can create and manage multiple environments from a
single, location. This simplifies the processes of installing and updating software and can automate
deployment.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-13


© 2021 Siemens
1. Getting started with Teamcenter client installation

Note:
Most topics in this guide describe installation using Teamcenter Environment Manager and Web
Application Manager. For information about how to use Deployment Center, see the Deployment
Center Guide.

Teamcenter Environment Manager

Teamcenter Environment Manager (TEM) is a tool that installs Teamcenter clients.

1-14 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Teamcenter installation tools

Teamcenter Environment Manager

TEM also performs maintenance operations, such as upgrading servers, applying minor releases, and
installing patches.

During installation, upgrade, and maintenance, you can select features to add to a Teamcenter
configuration in the Features panel in TEM. For a description of any feature, point to the feature in the
list.

You launch TEM using the tem.bat command.

For more information about any panel in TEM, click the help button .

Web Application Manager

The Web Application Manager is a tool that builds Teamcenter Java EE web applications.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 1-15


© 2021 Siemens
1. Getting started with Teamcenter client installation

You launch the Web Application Manager by entering the insweb command. The Web Application
Manager allows you to create web applications that contain different sets of Teamcenter solutions. This
enables you to create web applications for different groups of users in your network. Your web
applications can access the same Teamcenter corporate server, but provide different subsets of
Teamcenter functionality. The Web Application Manager creates separate staging locations and separate
deployable files3 for each web application. Some Teamcenter solutions require other solutions and some
solutions may not be combined with other solutions in the same web application. Use of the Web
Application Manager is described in the server installation guides for Windows and Linux.

3 A deployable file is a web archive (WAR) file.

1-16 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
2. Installing the rich client
Choose a rich client configuration type
Teamcenter provides four rich client configurations:

• Teamcenter Rich Client Four-Tier


Installs a four-tier rich client that connects to the Teamcenter web tier using HTTP protocol or
Teamcenter client communication system (TCCS).

• Teamcenter Rich Client Two-Tier


Installs a two-tier rich client that communicates with the Teamcenter corporate server using TCCS. It
supports most Teamcenter features and does not require a web tier.

• Teamcenter Rich Client (Two-Tier and Four-Tier)


Installs a rich client that supports multiple two-tier and four-tier connections using TCCS.
If configured for two-tier operation, this rich client connects to a Teamcenter corporate server. If
configured for four-tier operation, it connects to a Teamcenter web tier.

• Teamcenter Rich Client (Lite Edition)


Installs a rich client with limited applications and menu commands.

Note:
IIOP protocol is no longer supported in Teamcenter. The Teamcenter two-tier rich client uses TCCS
(Teamcenter client communication system) instead of IIOP (Internet Inter-ORB Protocol) to
communicate with the corporate server. Existing IIOP-based two-tier rich clients are automatically
converted to TCCS-based during upgrade.

Before you install the rich client:

• Make sure your client host meets the system hardware and software requirements.

• Obtain your Teamcenter user name and password from the Teamcenter administrator for logging on
to the rich client.

Installing the rich client using TEM

Install the four-tier rich client

Install a four-tier rich client that connects to the Teamcenter web tier using HTTP protocol or Teamcenter
client communication system (TCCS).

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-1


© 2021 Siemens
2. Installing the rich client

Note:
The Windows User Access Control (UAC) feature, if enabled, may interfere with configuration of
some rich client features.

1. Install the prerequisite software on the client host using an account with administrative
privileges. Teamcenter Environment Manager (TEM) does not install the prerequisite software.

2. Specify the path to a supported Java Runtime Environment (JRE) by setting the JRE64_HOME
environment variable on your host.

3. Start Teamcenter Environment Manager (TEM).

In the Teamcenter 13.1 software kit, right-click the tem.bat program icon and choose Run as
administrator.

4. In the Welcome to Teamcenter panel, select Teamcenter.

5. In the Install/Upgrade Options panel, click Install.

6. In the Media Locations panel, enter the path to the Teamcenter 13 software kit in the Original
Media Location box.

Optionally, add paths to any Teamcenter patches you want to apply during installation.

7. In the Configuration panel, type an ID and a description for the new Teamcenter configuration.

The configuration ID identifies your configuration when you perform maintenance tasks in TEM.
Installation log files also reference your configuration by this ID.

8. In the Solutions panel, select Rich Client 4-tier.

9. Proceed to the Features panel. In the Installation Directory box, enter the path and directory in
which you want to install the rich client. The directory must not exist. (TEM creates the directory.)

10. The Teamcenter Rich Client 4-tier feature is selected by default.

Select any additional features you want to include in your rich client configuration. If you select
additional features, TEM displays additional panels during installation that are not described in this
procedure.

11. In the File Client Cache (FCC) panel, specify file caching and communication selections.

2-2 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the four-tier rich client

a. Choose whether to use a new or existing FMS client cache (FCC). If you want to create a new
FCC using the same settings as an existing FCC on your host, select the Merge values from
an existing FMS_HOME check box.

b. Choose the communication protocol. By default, the four-tier rich client uses HTTP to
communicate with the corporate server. If you want to use TCCS instead of HTTP, click
Advanced, and then select the Use Configurations and Environments check box.

12. In the FCC Parents panel, enter access information for the FMS server cache (FSC).

a. Double-click the Host box, and then type the host name of the FSC.

b. Double-click the Port box, and then type the port used by the FSC. The default value is 4544.

c. In the Protocol box, select the appropriate protocol used by the FSC.

If you want to add access to additional FSCs, click Add to add a row to the table, and then enter
access information for the parent FSC. To remove a host from the list, select the row and click
Remove.

If you use multiple FSCs, assign a connection priority to each using values in the Priority column.

You can configure File Management System further after installation.

13. If you chose TCCS instead of HTTP in step 11, skip this step and proceed to step 14.

In the 4-tier server configurations panel, specify communication settings for the four-tier rich
client. In the URI column, enter the URI for the Teamcenter web tier server. In the Connection
Name column, enter a name for the rich client connection.

If you use HTTP instead of TCCS for client-server communication, skip to step 21.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use the
literal addresses, so the domain name system (DNS) can determine which IP address should
be used.

14. Proceed to the Configuration Selection for Client Communication System panel.

If you are a TCCS administrator, select Shared if you want this configuration to be used by multiple
users, or select Private if this configuration is for your use only. By default, the shared
configuration is used by the system for all users connecting using TCCS.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-3


© 2021 Siemens
2. Installing the rich client

Select whether to create a shared or private TCCS configuration. If you are not a TCCS
administrator, you can only create a Private configuration for your use only. A TCCS administrator
can create both shared and private configurations.

15. In the Forward Proxy Settings panel, enter information about the TCCS forward proxy.

Value Description

Do not use forward Specifies that you do not want to use a forward proxy.
proxy

Use web browser Specifies that you want to use proxy settings from your web browser.
settings

Detect settings from Specifies that you want to use proxy settings from your local network.
network

Retrieve settings from Specifies that you want to obtain settings from a proxy
URL autoconfiguration (PAC) file.

Proxy URL Specifies the URL to the PAC file from which you want to obtain proxy
settings.

Configure settings Specifies that you want to enter proxy settings manually.
manually

All Protocols Host Specifies a name of a valid proxy to use for all protocols. In the
accompanying Port box, type the port used by the proxy host.

HTTP Proxy Host Specifies the host of a forward proxy server for the HTTP protocol. In
the accompanying Port box, type the port used by the proxy host.

HTTPS Proxy Host Specifies the host of a forward proxy server for the HTTPS protocol. In
the accompanying Port box, type the port used by the proxy host.

Exceptions Specifies a semicolon-delimited list of host names and IP addresses to


exempt. This box is optional.
This list can be used to send requests for local endpoints directly to
the destination server without going through a forward proxy that is
used for endpoints outside the company intranet. For example, this
could allow direct access to a Teamcenter web tier hosted within the
company while going through a forward proxy to access a
Teamcenter web tier hosted by a business partner.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use the
literal addresses, so the domain name system (DNS) can determine which IP address should
be used.

2-4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the four-tier rich client

16. Proceed to the Environment Settings for Client Communication System panel.

To add an environment to the table of TCCS environments, click Add, and then type the required
values to configure the TCCS environment.

Value Description

Name Specifies a name for the TCCS environment.

URI Specifies the URL to the rich client middle tier. Type a URL of the following form:
http://host:port/tc.

Tag (Optional) Specifies a tag for the environment that can be used to filter the list of
TCCS environments during rich client logon.
In the Client Tag Filter panel during rich client installation, you can optionally
provide a pattern to filter the list of environments displayed in the rich client to
those environments that match the pattern.

Example:
You create 10 environments, three on Server1 with Security Services, three
on Server1 without Security Services, and four on Server2.
Tag the environments SSO, no SSO, and Server2, respectively.

SSO Specifies a Security Services (SSO) application ID. Type an application ID if you
App ID want to add a Security Services environment to your TCCS environment.

SSO Specifies the logon URL to the Security Services environment.


Login
URL Note:
You must set up the Security Services environment before you configure
TCCS.
For example, in the SSO App ID box, type the value of the
SSO_APPLICATION_ID context parameter from the web tier installation. In
the SSO Login URL box, type the value of the SSO_LOGIN_SERVICE_URL
context parameter.

A single TCCS configuration can contain multiple environments. For example, you may want to
install some TCCS environments with Security Services (SSO), some without SSO, or some
environments on only certain servers. If you configure multiple environments, a selection list of
environments is displayed during rich client logon.

For advanced TCCS settings, click Advanced.

17. Proceed to the Reverse Proxy Settings panel.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-5


© 2021 Siemens
2. Installing the rich client

Teamcenter uses reverse proxy settings to detect a logon web page from a reverse proxy server
through which Teamcenter services are accessed.

The criteria table lists the reverse proxy criteria currently defined. Each row of the table is a criteria
XML element defined in the specified format. By default, the table is blank and no criteria are
defined. A criterion string is of the following form:

Header_Name1, Header_Value1, Header_Name2, Header_Value2,…:Form_Action

Each criterion must contain at least one header name/header value pair or at least a single form
action.

To add a criterion to the table, perform the following steps:

a. Click Add.

Note:
You can also click Remove to remove an existing criterion from the table or Edit to edit
an existing criterion.

b. In the Criteria Details table, add HTTP header names and values for criterion you want to add.

c. In the Form Action box, specify a form action.

d. Click OK to add the criterion or Cancel to abandon your changes.

Note:
• Criteria definitions are written to the reverseproxy_cfg.xml file.

• If you must connect to a Teamcenter environment through a reverse proxy server (such as
WebSEAL or SiteMinder), you may need to configure reverse proxy settings for TCCS.

• If you use SiteMinder, you must configure TCCS to detect form-based challenges
originating from the reverse proxy by selecting the Check Headers check box.
This setting also applies to other reverse proxy servers that do not send specific header
information in the 200 form-based challenge.

• If you use WebSEAL and you deploy the TCCS configuration, add the following criterion
to the table.

2-6 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the four-tier rich client

Header name Header value Form action

server webseal /pkmslogin.form

This is required because the settings in the deployed reverseproxy_cfg.xml override


the default WebSEAL configuration.
If you do not deploy the TCCS configuration, TCCS uses the default WebSEAL
configuration, so this manual configuration is not required.

18. Proceed to the Kerberos Support panel.

If you use Kerberos, enter Kerberos authentication settings.

Value Description

Support Kerberos Specifies you want to use Kerberos authentication for Teamcenter
authentication logon.

Use this Krb5 file Specifies you want to use a custom Kerberos configuration file. If
you select this option, enter the path to the custom Kerberos
configuration file.

Use default Specifies you want to use the default Kerberos configuration file
settings on the host.
On Windows hosts, the default location is C:\Windows.

Kerberos is a network authentication protocol that uses a system of tickets to allow nodes
communicating over nonsecure networks to securely verify identities of each side. Using a client-
server model, it provides mutual authentication: the user and the server verify each other's
identities.

When configuring TCCS to use Kerberos authentication, a krb5.ini file should not be specified in
the TCCS configuration. Even if specified, the file is not used for Kerberos configuration.

19. In the Secure socket layer (SSL) settings panel, enter SSL settings.

Value Description

Use Internet Explorer Certificate Specifies you want to use certificates stored in Microsoft
Store (Recommended) Internet Explorer.
This option is available only on Windows hosts.

Disable SSL Specifies you want to disable SSL authentication.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-7


© 2021 Siemens
2. Installing the rich client

Value Description

Configure Certificate Store Specifies you want to manually configure the certificate
Manually store for Teamcenter.

Configure trust store Contains options for manually configuring the certificate
store for Teamcenter.

Use trust store Specifies you want to use a trust store. If you select this
option, enter the path to file that contains the trust store
you want to use.

Accept untrusted Specifies you want to accept untrusted certificates.


certificates

Configure key store Specifies you want to configure a keystore for


Teamcenter.
If you select the Use key store check box, enter keystore
configuration values.

File Specifies the path to the keystore file.

Type Specifies the file type. Choose JKS or PLCS12. The default
file type is JKS.

Further configuration of SSL for Teamcenter is described in Security Services Installation/


Customization.

20. Proceed to the Client Tag Filter panel.

If multiple TCCS environments exist in your system, you can optionally limit the TCCS environments
available to the rich client by specifying a pattern in the Client Tag Filter box. This pattern is used
to filter the list of TCCS environments, which are each identified by a unique Tag value. Wildcard
characters (*) are allowed in the Client Tag Filter box.

For example, if the Client Tag Filter value is set to 13.* in the rich client, all TCCS environments
with Tag values beginning with 13. are available to the rich client. Environments with Tag values
beginning with 12 are not available.

21. In the Rich Client Settings panel, specify online help settings.

If you want to enable online help for the rich client, select the Enable Online Help check box,
and then type the online help URL in the Documentation server URL box:

https://domain/en-US/product/282219420/doc/PL20200604175134771.xid1899404/html/
xid1899405

2-8 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the two-tier rich client

Replace domain with the source from which you access online help:

• Support Center: docs.sw.siemens.com

• Siemens Documentation Server: doc-server-host:doc-server-port

If you do not want to enable online help during rich client installation, you can configure online
help access after installation is complete.

To enable online help for the rich client, you must install the required software for your selected
online help source, the Secure Documentation Proxy (for Support Center access) or the Siemens
Documentation Server (for local network access).

22. If you want to specify Security Services settings or other advanced rich client settings, click
Advanced in the Rich Client Settings panel.

23. Proceed to the Confirmation panel and review your selections. Click Start to install the rich client,
or click Back to change your selections.

When installation is complete, close TEM.

TEM places the Teamcenter rich client icon on your desktop. To start the rich client, either double-
click the desktop icon or press the following shortcut keys:

Control+Shift+F

Note:
• After installation, you can find the rich client in the list of installed programs in the Windows
control panel. The program name is displayed as Teamcenter 13 (x64) (TC_ROOT).
You can install multiple rich clients on a host. Each client is identified by its TC_ROOT location in
the Windows program list.

• If you upgrade your JRE after you install the rich client, you must configure Teamcenter to use
the new JRE.

• If your rich client configuration includes Teamcenter Automotive Edition–GM Overlay, you must
complete additional required configuration steps.

Install the two-tier rich client

Install a Teamcenter two-tier rich client that communicates with the Teamcenter corporate server using
Teamcenter client communication system (TCCS). This configuration supports most Teamcenter features
and does not require a web tier.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-9


© 2021 Siemens
2. Installing the rich client

Note:
IIOP protocol is no longer supported in Teamcenter. The Teamcenter two-tier rich client uses TCCS
(Teamcenter client communication system) instead of IIOP (Internet Inter-ORB Protocol) to
communicate with the corporate server. Existing IIOP-based two-tier rich clients are automatically
converted to TCCS-based during upgrade.

Note:
The Windows User Access Control (UAC) feature, if enabled, may interfere with configuration of
some rich client features.

1. Install the prerequisite software on the client host using an account with administrative
privileges. Teamcenter Environment Manager (TEM) does not install the prerequisite software.

2. Specify the path to a supported Java Runtime Environment (JRE) by setting the JRE64_HOME
environment variable on your host.

3. Start Teamcenter Environment Manager (TEM).

In the Teamcenter 13.1 software kit, right-click the tem.bat program icon and choose Run as
administrator.

4. In the Welcome to Teamcenter panel, select Teamcenter.

5. In the Install/Upgrade Options panel, click Install.

6. In the Media Locations panel, enter the path to the Teamcenter 13 software kit in the Original
Media Location box.

Optionally, add paths to any Teamcenter patches you want to apply during installation.

7. In the Configuration panel, type an ID and a description for the new Teamcenter configuration.

The configuration ID identifies your configuration when you perform maintenance tasks in TEM.
Installation log files also reference your configuration by this ID.

8. In the Solutions panel, select Rich Client 2-tier.

9. Proceed to the Features panel. In the Installation Directory box, enter the path and directory in
which you want to install the rich client. The directory must not exist. (TEM creates the directory.)

10. The Teamcenter Rich Client 2-tier feature is selected by default.

2-10 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the two-tier rich client

Select any additional features you want to include in your rich client configuration. If you select
additional features, TEM displays additional panels during installation that are not described in this
procedure.

Make sure you select the features included in your corporate server configuration, including
custom features. This ensures all associated run-time server components and rich client plugins are
available in the rich client. For example, if your corporate server contains the NX Foundation
feature, you must select the NX Rich Client Integration feature in your two-tier rich client. If you
do not select all required client features, TEM prompts you later in the installation process to return
to the Features panel and select them.

11. Proceed to the Key Manager Configuration panel. If you use Key Manager, select the Enable Key
Manager check box and enter the required values. Otherwise, leave the check box cleared.

12. In the File Client Cache (FCC) panel, choose whether to use a new or existing FMS client cache
(FCC).

If you want to create a new FCC using the same settings as an existing FCC on your host, select the
Merge values from an existing FMS_HOME check box.

13. In the FCC Parents panel, enter access information for the FMS server cache (FSC).

a. Double-click the Host box, and then type the host name of the FSC.

b. Double-click the Port box, and then type the port used by the FSC. The default value is 4544.

c. In the Protocol box, select the appropriate protocol used by the FSC.

If you want to add access to additional FSCs, click Add to add a row to the table, and then enter
access information for the parent FSC. To remove a host from the list, select the row and click
Remove.

If you use multiple FSCs, assign a connection priority to each using values in the Priority column.

You can configure File Management System further after installation.

14. Proceed to the Configuration Selection for Client Communication System panel.

If you are a TCCS administrator, select Shared if you want this configuration to be used by multiple
users, or select Private if this configuration is for your use only. By default, the shared
configuration is used by the system for all users connecting using TCCS.

Select whether to create a shared or private TCCS configuration. If you are not a TCCS
administrator, you can only create a Private configuration for your use only. A TCCS administrator
can create both shared and private configurations.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-11


© 2021 Siemens
2. Installing the rich client

15. Proceed to the Environment Settings for Client Communication System panel.

To add an environment to the table of TCCS environments, click Add. TEM displays the Edit
Environment Setting dialog box.

Value Description

Name Specifies a name for the TCCS environment.

TC_DATA Enter the path to the data directory (TC_DATA) where you want Teamcenter
Environment Manager to create shared data subdirectories and files.1

Tag (Optional) Specifies a tag for the environment that can be used to filter the
list of TCCS environments during rich client logon.
In the Client Tag Filter panel during rich client installation, you can
optionally provide a pattern to filter the list of environments displayed in the
rich client to those environments that match the pattern.

Example:
You create 10 environments, three on Server1 with Security Services,
three on Server1 without Security Services, and four on Server2.
Tag the environments SSO, no SSO, and Server2, respectively.

1 This can be the network path to the TC_DATA directory on your corporate server.

2-12 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the two-tier rich client

Value Description

SSO App ID Specifies a Security Services (SSO) application ID. Type an application ID if
you want to add a Security Services environment to your TCCS environment.

SSO Login Specifies the logon URL to the Security Services environment.
URL
Note:
You must set up the Security Services environment before you
configure TCCS.
For example, in the SSO App ID box, type the value of the
SSO_APPLICATION_ID context parameter from the web tier
installation. In the SSO Login URL box, type the value of the
SSO_LOGIN_SERVICE_URL context parameter.

TcServer Specifies the canonical name of the character encoding set Teamcenter
Character clients use to access the database.
Encoding
Canonical Caution:
Name
To prevent data corruption, this character encoding set must match the
encoding set used by the Teamcenter database.

Single Specifies whether to force all client sessions for the given user to use the
Server same tcserver process. If set to true, all client sessions use the same
tcserver. Setting it to false allows clients to control sharing of tcserver
processes.

A single TCCS configuration can contain multiple environments. For example, you may want to
install some TCCS environments with Security Services (SSO), some without SSO, or some
environments on only certain servers. If you configure multiple environments, a selection list of
environments is displayed during rich client logon.

For advanced TCCS settings, click Advanced.

16. Proceed to the Client Tag Filter panel.

If multiple TCCS environments exist in your system, you can optionally limit the TCCS environments
available to the rich client by specifying a pattern in the Client Tag Filter box. This pattern is used
to filter the list of TCCS environments, which are each identified by a unique Tag value. Wildcard
characters (*) are allowed in the Client Tag Filter box.

For example, if the Client Tag Filter value is set to 13.* in the rich client, all TCCS environments
with Tag values beginning with 13. are available to the rich client. Environments with Tag values
beginning with 12 are not available.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-13


© 2021 Siemens
2. Installing the rich client

17. In the Rich Client Settings panel, specify online help settings.

If you want to enable online help for the rich client, select the Enable Online Help check box,
and then type the online help URL in the Documentation server URL box:

https://domain/en-US/product/282219420/doc/PL20200604175134771.xid1899404/html/
xid1899405

Replace domain with the source from which you access online help:

• Support Center: docs.sw.siemens.com

• Siemens Documentation Server: doc-server-host:doc-server-port

If you do not want to enable online help during rich client installation, you can configure online
help access after installation is complete.

To enable online help for the rich client, you must install the required software for your selected
online help source, the Secure Documentation Proxy (for Support Center access) or the Siemens
Documentation Server (for local network access).

18. If you want to specify Security Services settings or other advanced rich client settings, click
Advanced in the Rich Client Settings panel.

19. Proceed to the Confirmation panel and review your selections. Click Start to install the rich client,
or click Back to change your selections.

When installation is complete, close TEM.

TEM places the Teamcenter rich client icon on your desktop. To start the rich client, either double-
click the desktop icon or press the following shortcut keys:

Control+Shift+F

Note:
• After installation, you can find the rich client in the list of installed programs in the Windows
control panel. The program name is displayed as Teamcenter 13 (x64) (TC_ROOT).
You can install multiple rich clients on a host. Each client is identified by its TC_ROOT location in
the Windows program list.

• If you upgrade your JRE after you install the rich client, you must configure Teamcenter to use
the new JRE.

2-14 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the rich client (two-tier and four-tier)

• If your rich client configuration includes Teamcenter Automotive Edition–GM Overlay, you must
complete additional required configuration steps.

Install the rich client (two-tier and four-tier)

Install a Teamcenter rich client that is configurable for two-tier or four-tier operation. This rich client
supports multiple connections using Teamcenter client communication system (TCCS). In two-tier
connections, this client connects to the Teamcenter server. In four-tier connections, it connects to the
Teamcenter rich client web tier.

Note:
The Windows User Access Control (UAC) feature, if enabled, may interfere with configuration of
some rich client features.

1. Install the prerequisite software on the client host using an account with administrative
privileges. Teamcenter Environment Manager (TEM) does not install the prerequisite software.

2. Specify the path to a supported Java Runtime Environment (JRE) by setting the JRE64_HOME
environment variable on your host.

3. Start Teamcenter Environment Manager (TEM).

In the Teamcenter 13.1 software kit, right-click the tem.bat program icon and choose Run as
administrator.

4. In the Welcome to Teamcenter panel, select Teamcenter.

5. In the Install/Upgrade Options panel, click Install.

6. In the Media Locations panel, enter the path to the Teamcenter 13 software kit in the Original
Media Location box.

Optionally, add paths to any Teamcenter patches you want to apply during installation.

7. In the Configuration panel, type an ID and a description for the new Teamcenter configuration.

The configuration ID identifies your configuration when you perform maintenance tasks in TEM.
Installation log files also reference your configuration by this ID.

8. In the Solutions panel, select Rich Client (2-tier and 4-tier).

9. Proceed to the Features panel. In the Installation Directory box, enter the path and directory in
which you want to install the rich client. The directory must not exist. (TEM creates the directory.)

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-15


© 2021 Siemens
2. Installing the rich client

10. The Teamcenter Rich Client (2-tier and 4-tier) feature is selected by default.

Select any additional features you want to include in your rich client configuration. If you select
additional features, TEM displays additional panels during installation that are not described in this
procedure.

If you are configuring the rich client for two-tier operation, make sure you select the same features
included in your corporate server configuration, including custom features. This ensures all
associated run-time server components and rich client plugins are available in the rich client.

11. Proceed to the Key Manager Configuration panel. If you use Key Manager, select the Enable Key
Manager check box and enter the required values. Otherwise, leave the check box cleared.

12. In the File Client Cache (FCC) panel, specify file caching and communication selections.

a. Choose whether to use a new or existing FMS client cache (FCC). If you want to create a new
FCC using the same settings as an existing FCC on your host, select the Merge values from
an existing FMS_HOME check box.

b. Choose the communication protocol. By default, the four-tier rich client uses HTTP to
communicate with the corporate server. If you want to use TCCS instead of HTTP, click
Advanced, and then select the Use Configurations and Environments check box.

13. In the FCC Parents panel, enter access information for the FMS server cache (FSC).

a. Double-click the Host box, and then type the host name of the FSC.

b. Double-click the Port box, and then type the port used by the FSC. The default value is 4544.

c. In the Protocol box, select the appropriate protocol used by the FSC.

If you want to add access to additional FSCs, click Add to add a row to the table, and then enter
access information for the parent FSC. To remove a host from the list, select the row and click
Remove.

If you use multiple FSCs, assign a connection priority to each using values in the Priority column.

You can configure File Management System further after installation.

14. Proceed to the Configuration Selection for Client Communication System panel.

If you are a TCCS administrator, select Shared if you want this configuration to be used by multiple
users, or select Private if this configuration is for your use only. By default, the shared
configuration is used by the system for all users connecting using TCCS.

2-16 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the rich client (two-tier and four-tier)

Select whether to create a shared or private TCCS configuration. If you are not a TCCS
administrator, you can only create a Private configuration for your use only. A TCCS administrator
can create both shared and private configurations.

15. Proceed to the Environment Settings for Client Communication System panel.

To add an environment to the table of TCCS environments, click Add. TEM displays the Edit
Environment Setting dialog box.

Select 2-tier settings or 4-tier settings, and then enter the required values for the selected
deployment type.

Two-tier deployment

Value Description

Name Specifies a name for the TCCS environment.

TC_DATA Enter the path to the data directory (TC_DATA) where you want Teamcenter
Environment Manager to create shared data subdirectories and files.2

Tag (Optional) Specifies a tag for the environment that can be used to filter the
list of TCCS environments during rich client logon.
In the Client Tag Filter panel during rich client installation, you can
optionally provide a pattern to filter the list of environments displayed in the
rich client to those environments that match the pattern.

2 This can be the network path to the TC_DATA directory on your corporate server.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-17


© 2021 Siemens
2. Installing the rich client

Value Description

Example:
You create 10 environments, three on Server1 with Security Services,
three on Server1 without Security Services, and four on Server2.
Tag the environments SSO, no SSO, and Server2, respectively.

SSO App ID Specifies a Security Services (SSO) application ID. Type an application ID if
you want to add a Security Services environment to your TCCS environment.

SSO Login Specifies the logon URL to the Security Services environment.
URL
Note:
You must set up the Security Services environment before you
configure TCCS.
For example, in the SSO App ID box, type the value of the
SSO_APPLICATION_ID context parameter from the web tier
installation. In the SSO Login URL box, type the value of the
SSO_LOGIN_SERVICE_URL context parameter.

TcServer Specifies the canonical name of the character encoding set Teamcenter
Character clients use to access the database.
Encoding
Canonical Caution:
Name
To prevent data corruption, this character encoding set must match the
encoding set used by the Teamcenter database.

Single Specifies whether to force all client sessions for the given user to use the
Server same tcserver process. If set to true, all client sessions use the same
tcserver. Setting it to false allows clients to control sharing of tcserver
processes.

Four-tier deployment

2-18 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the rich client (two-tier and four-tier)

Value Description

Name Specifies a name for the TCCS environment.

URL Specifies the URL to the rich client middle tier. Type a URL of the following form:
http://host:port/tc.

Tag (Optional) Specifies a tag for the environment that can be used to filter the list of
TCCS environments during rich client logon.
In the Client Tag Filter panel during rich client installation, you can optionally
provide a pattern to filter the list of environments displayed in the rich client to
those environments that match the pattern.

Example:
You create 10 environments, three on Server1 with Security Services, three
on Server1 without Security Services, and four on Server2.
Tag the environments SSO, no SSO, and Server2, respectively.

SSO Specifies a Security Services (SSO) application ID. Type an application ID if you
App ID want to add a Security Services environment to your TCCS environment.

SSO Specifies the logon URL to the Security Services environment.


Login
URL Note:
You must set up the Security Services environment before you configure
TCCS.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-19


© 2021 Siemens
2. Installing the rich client

Value Description

For example, in the SSO App ID box, type the value of the
SSO_APPLICATION_ID context parameter from the web tier installation. In
the SSO Login URL box, type the value of the SSO_LOGIN_SERVICE_URL
context parameter.

A single TCCS configuration can contain multiple environments. For example, you may want to
install some TCCS environments with Security Services (SSO), some without SSO, or some
environments on only certain servers. If you configure multiple environments, a selection list of
environments is displayed during rich client logon.

For advanced TCCS settings, click Advanced.

16. Proceed to the Client Tag Filter panel.

If multiple TCCS environments exist in your system, you can optionally limit the TCCS environments
available to the rich client by specifying a pattern in the Client Tag Filter box. This pattern is used
to filter the list of TCCS environments, which are each identified by a unique Tag value. Wildcard
characters (*) are allowed in the Client Tag Filter box.

For example, if the Client Tag Filter value is set to 13.* in the rich client, all TCCS environments
with Tag values beginning with 13. are available to the rich client. Environments with Tag values
beginning with 12 are not available.

17. In the Rich Client Settings panel, specify online help settings.

If you want to enable online help for the rich client, select the Enable Online Help check box,
and then type the online help URL in the Documentation server URL box:

https://domain/en-US/product/282219420/doc/PL20200604175134771.xid1899404/html/
xid1899405

Replace domain with the source from which you access online help:

• Support Center: docs.sw.siemens.com

• Siemens Documentation Server: doc-server-host:doc-server-port

If you do not want to enable online help during rich client installation, you can configure online
help access after installation is complete.

2-20 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install the rich client lite edition

To enable online help for the rich client, you must install the required software for your selected
online help source, the Secure Documentation Proxy (for Support Center access) or the Siemens
Documentation Server (for local network access).

18. If you want to specify Security Services settings or other advanced rich client settings, click
Advanced in the Rich Client Settings panel.

19. Proceed to the Confirmation panel and review your selections. Click Start to install the rich client,
or click Back to change your selections.

When installation is complete, close TEM.

TEM places the Teamcenter rich client icon on your desktop. To start the rich client, either double-
click the desktop icon or press the following shortcut keys:

Control+Shift+F

Note:
• After installation, you can find the rich client in the list of installed programs in the Windows
control panel. The program name is displayed as Teamcenter 13 (x64) (TC_ROOT).
You can install multiple rich clients on a host. Each client is identified by its TC_ROOT location in
the Windows program list.

• If you upgrade your JRE after you install the rich client, you must configure Teamcenter to use
the new JRE.

• If your rich client configuration includes Teamcenter Automotive Edition–GM Overlay, you must
complete additional required configuration steps.

Install the rich client lite edition

The rich client lite edition contains limited applications and menu commands.

1. Start TEM and create a new Teamcenter configuration in the same manner as if you were installing
a full Teamcenter rich client.

2. Proceed to the Features panel. Under Base Install, select Teamcenter Rich Client (Lite Edition).

3. Proceed through the remaining panels in TEM to complete the installation.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-21


© 2021 Siemens
2. Installing the rich client

Configure rich client features

Configuring client display language

Choose a display language

The default language displayed is the one specified by your operating system locale settings. You can
choose to override the default display language if required.

At each logon, you can choose between multiple languages, depending on your company's policy and
installation. There are two ways you can specify the language:

• Specify the language in the URL. For example:

• To specify French, type http://myhost:7001/tc/webclient?lang=fr in the URL.

• To specify Russian, type http://myhost:7001/tc/webclient?lang=ru in the URL.

When specifying a language in the URL, use standard W3C locale identifiers.
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use the literal
addresses, so the domain name system (DNS) can determine which IP address should be used.

• Specify the language in your browser preferences. For example, in Microsoft Internet Explorer,
perform the following steps:

1. Choose Tools → Internet options....

2. Click Languages in the Internet Options dialog box.

3. Click Add in the Language Preference dialog box.

4. Click any language in the Add Language dialog box.

5. Click OK in the Add Language dialog box.

6. Click the language you want to see in the user interface in the Language Preference dialog box.

7. Click the Move Up button.


The language you move to the top of the list in the Language Preference dialog box is the
language you see in the user interface.

8. Click OK in the Language Preference dialog box.

9. Click OK in the Internet Options dialog box.

2-22 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Choose a display language for the rich client

10. Log on and view the user interface in the language you chose.
An error message is displayed if the specified language is unavailable.

Your ability to set the language for the client depends on the character set encoding of the Teamcenter
server host and also the character set encoding of the Teamcenter database.

To prevent mixed-language display after you change the client display language, clear your web browser
cache. This prevents the interface from displaying in mixed languages.

Choose a display language for the rich client

By default, the rich client is displayed in the language specified by the operating system. If you want to
override the default language, you can choose the display language for the rich client.

Your ability to set the language for the rich client depends on the character set encoding of the
Teamcenter server host and also the character set encoding of the Teamcenter database.

If you want to override the default language to launch the rich client in a desired language, add the -nl
argument to the rich client launch command:

TC_ROOT\portal.bat -nl locale-code

Replace TC_ROOT with the Teamcenter home directory, and replace locale-code with the .

For example, to launch the rich client Italian user interface, enter the following from a command
prompt:

D:\tc\rac\portal.bat -nl it_IT

Alternatively, on Windows systems, you can customize the properties for the Teamcenter rich client
desktop shortcut icon to specify a desired language:

1. On your desktop, right-click the Teamcenter rich client shortcut icon .

2. Choose Properties.
A properties dialog box is displayed.

3. Click the Shortcut tab.

4. In the Target box, add an -nl argument to specify the desired language.
The -nl argument accepts a single string as value. The string must be one of the supported locale
codes.
For example, to run the rich client Italian user interface:

D:\tc\rac\portal.bat

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-23


© 2021 Siemens
2. Installing the rich client

becomes:

D:\tc\rac\portal.bat —nl it_IT

Note:
To prevent mixed-language display the next time you run the rich client after you change the -nl
argument value, or after you change your operating system locale, delete the Teamcenter
directory under your user directory (C:\Documents and Settings\user-name\Teamcenter).

If you find that Asian multibyte characters do not display correctly when you start the rich client, set
your system font to a font that supports Asian multibyte characters. For example, on Windows systems
other than Windows 10, the Arial Unicode MS font can be set to Message Box to correct this problem.

Similarly, if you find that Asian multibyte characters do not display correctly when you start the rich
client using the native language (-nl) option, restart your system in the appropriate locale and set your
system font to a font that supports Asian multibyte characters.

Caution:
If you use the Lifecycle Visualization embedded viewer, do not use the -nl argument when you
launch the rich client.
For the embedded viewer to work properly, the operating system locale and the rich client runtime
locale must match. The -nl argument overrides the Java locale and can cause incorrect behavior in
the embedded viewer.

Choose the default language for the Teamcenter server process

Teamcenter server (TcServer) processes and other Teamcenter processes, and Teamcenter command-
line utilities, start in the language specified in the TC_language_default environment variable. To make
these display in a different preferred locale, set the TC_language_default environment variable to a
supported locale code.

Teamcenter allows users to select a locale on their client hosts, regardless of the locale used by the
Teamcenter server pool manager. Requested locales must be installed on the Teamcenter server (which
may not be true for customized locales) and the server system be configured to accept the locale
encoding.

Add multibyte character support in an English rich client

1. In the rich client \rac\plugins\configuration_config-name directory, create the


customer.properties file, if it does not already exist.

Do not save the customer.properties file in Unicode or UTF-8 format. The customer.properties
file must be in the default format (for example, ANSI) to be read successfully by the rich client.

2-24 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Configure online help access

2. Open the customer.properties in a plain text editor.

3. Add the following line to the file to set the UseDefaultSwingFonts property.

UseDefaultSwingFonts=true

4. Save the file and exit the text editor.

5. Change to the rac\registry directory.

6. Run the genregxml.bat utility to register the change.

When you run Teamcenter in a multibyte environment, make sure the TC_XML_ENCODING
environment variable is set to UTF-8 and the UGII_UTF8_MODE environment variable is set to 1.

Configure online help access

To enable online help for the rich client, you must first install the required online help software.

To configure the rich client to access online help, set the online help URL in the client configuration:

1. Launch TEM in maintenance mode and proceed to the Feature Maintenance panel.

2. Under the appropriate rich client type,3 select Modify settings.

3. In the Rich Client Settings panel, select the Enable Online Help check box, and then type the
appropriate online help URL in the Documentation server URL box:

https://domain/en-US/product/282219420/doc/PL20200604175134771.xid1899404/html/
xid1899405

Replace domain with the source from which you access online help:

• Support Center: docs.sw.siemens.com

• Siemens Documentation Server: doc-server-host:doc-server-port

4. Proceed through the remaining panels to complete the configuration update.

After you complete these steps, online help is available from the Help→Help Library menu option (or
control-F1) in the rich client.

3 The rich client type may be Teamcenter Rich Client 2-tier, Teamcenter Rich Client 4-tier, or Teamcenter Rich Client
(2-tier and 4-tier).

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-25


© 2021 Siemens
2. Installing the rich client

Note:
To enable online help for the rich client, you must first install the required online help software.

Add features

Add Teamcenter features to an existing configuration, or remove them from a configuration:

1. Launch Teamcenter Environment Manager. In the Windows start menu, click


Programs→Teamcenter 13, and then right-click Environment Manager and choose Run as
administrator.

Note:
Alternatively, you can run the tem.bat file in the install directory in the application root
directory for the Teamcenter installation. Right-click the tem.bat program icon and select
Run as administrator.

2. In the Maintenance panel, choose Configuration Manager.

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


configuration.

4. In the Old Configuration panel, select the configuration you want to modify.

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


Options in the Feature Maintenance panel vary depending on the features in your configuration.

6. In the Features panel, select features to add to the configuration, or deselect features you want to
remove.
If you remove a feature that added data model objects to the Teamcenter database, the data model
is not removed when you remove the feature. Relations and objects created using the removed
feature persist in the database.
If no instances of the feature's data model objects were created in the database, you can attempt
to remove the template.

7. Proceed through the remaining panels in TEM, entering the required information for the features
you selected.
For information about each panel, click the help button .

8. When TEM displays the Confirmation panel, click Start to begin installation.

2-26 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Add, remove, or modify databases

Add, remove, or modify databases

1. Start Teamcenter Environment Manager (TEM). From the Start menu, choose All
Programs→Teamcenter 13→Environment Manager, then right-click and choose Run as
administrator.
Alternatively, you can run the tem.bat file in the install directory in the application root directory
for the Teamcenter installation.

Note:
If you create a desktop shortcut to TEM, make sure the working directory (or Start in
location) for the shortcut is TC_ROOT\install. If the working directory for the shortcut is
incorrect, TEM displays errors during installation or updating of a configuration.

2. In the Maintenance panel, select Configuration Manager and then click Next.

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


configuration, then click Next.

4. In the Old Configuration panel, select the configuration you want to modify, and then click Next.

5. In the Feature Maintenance panel, select 2-tier server configurations→Modify 2-tier


Teamcenter server settings, and then click Next.

6. In the 2-tier Teamcenter server settings panel, update the two-tier server settings:

• To add databases, click Add, and then enter the database access information as during a two-
tier rich client installation.

• To remove databases, select the appropriate row in the 2-tier Servers table, and then click
Remove.

• To edit database settings, select the appropriate row in the 2-tier Servers table, and then click
Edit. Enter database access information.

To set additional advanced options, click Advanced.

7. In the Confirmation panel, review your selections. If you want to change any settings, click Back to
return to previous panels. Otherwise, click Start to begin updates.
When updates are complete, exit TEM.

Migrate Teamcenter to a different JRE

The Java Runtime Environment (JRE) used by Teamcenter and Teamcenter Environment Manager (TEM)
is set by TEM during Teamcenter installation. If you upgrade or install a new JRE, you must migrate
Teamcenter to the new JRE using TEM.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-27


© 2021 Siemens
2. Installing the rich client

Caution:
Do not remove your previous JRE until after you complete migrating Teamcenter to the new JRE. If
you removed your old JRE before performing this procedure, problems or error messages may
occur, and TEM fails to start.

To change the JRE used by Teamcenter and TEM, perform the following steps.

1. If you changed the password for the Teamcenter administrative user after you installed the FMS
server cache (FSC) service, update the logon credentials for the FSC service to specify the current
password.

2. Start Teamcenter Environment Manager (TEM). From the Start menu, choose All
Programs→Teamcenter 13→Environment Manager, then right-click and choose Run as
administrator.

Alternatively, you can run the tem.bat file in the install directory in the application root directory
for the Teamcenter installation.

3. In the Maintenance panel, select Migrate Teamcenter to another JRE and then click Next.

4. The Migrate Teamcenter to another JRE panel lists Teamcenter services that depend on the JRE
and must be shut down before the migration can begin.

After you make sure these services are shut down, select All features from the above list have
been shut down, and then click Next.

5. In the JRE Location panel, enter the path to the JRE you want Teamcenter to use.

Depending on the features in your configuration, TEM may prompt you for the operating system
user password.

Caution:
Make sure you specify a 64-bit JRE.

6. In the Confirmation panel, click Start to migrate Teamcenter to the specified JRE.

If you encounter problems migrating Teamcenter to the new JRE, see the available troubleshooting
solutions.

2-28 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Set environment variables for GM Overlay

Configure Teamcenter Automotive Edition–GM Overlay

Set environment variables for GM Overlay

1. Open the startup file (TC_ROOT\iiopservers\start_database-name.bat).

2. Locate the following line in the file:

<call %TC_DATA%\tc_profilevars>

3. Add the following statements after this line to set GM Overlay environment variables:

Environment variables Comment


set UG_VERSION=nx-version Set only if you use a version of NX earlier
than NX 4. Do not set if you use NX 4 or
later.
Replace nx-version with the NX version
number, for example, 30.
set GMPDL_EXT_DIR=%GMPDL_BASE_DIR%\bin\win Specifies the path to the GMPDL fc_main
and read_flag utilities.
set GMIMAN_FC_ADDL_LIBS= Replace pdl-libs-path with the path to PDL
pdl-libs-path libs, for example, %GMPDL_BASE_DIR%\lib
\win.

If you installed additional features for Teamcenter Automotive Edition–GM Overlay, configure these
features as necessary.

Configure Design Context for GM Overlay

1. Set the following environment variables in the %IMAN_SBS%\repository\jobs\start_tc_server.bat


file before starting the server broker service:

Environment variables Comment

set QPL_USER=qpl-user Replace qpl-user with the site QPL user name;
the default is qpl.

set UGII_QPL=qpl-server-host-name: Replace qpl-server-host-name with the name of


qpl—server-port the QPL server host; the default is
your.qpl.server.com. Replace qpl-server-port
with the port number of the QPL server; the
default is 14730.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 2-29


© 2021 Siemens
2. Installing the rich client

Environment variables Comment

set QPL_DB_CONNECT= Replace {QPL_USER}; the default is


%{QPL_USER}%:pwd@oracleSID %TC_DB_CONNECT%.

set TNS_ADMIN=tnsadmin.ora-dir Replace tnsadmin.ora-dir with the path to the


directory containing the Oracle tnsadmin.ora
file; the default is %TC_DATA%.

2. Install a central QPL server on your.qpl.server.com.


Installing the QPL server is described in the server installation guides for Windows and Linux.

3. Populate QPL builds for CORP_Vehicle Revisions.

4. Verify the QPL builds. A fine tuning may be necessary as the spacemap accuracy and range may
have an impact on the results of Design Context filters.

Note:
Edit the start_ugmanager.bat file in your client directory to set GMPDM_PORTAL=1.

Customize port for Teamcenter Integration for NX

If you installed Teamcenter Integration for NX for use with the Teamcenter rich client and want to
customize the Teamcenter Integration for NX port number, enter the following line in the etc\services
file:

ugmgr 9998/tcp #TC ugmanager port

Modifying this file requires administrative privileges.

2-30 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
3. Creating a custom distribution
Overview of custom distributions
Teamcenter supports the following custom distributions to simplify installation of Teamcenter on
multiple hosts.

• Silent distribution
A silent distribution is an XML-based configuration file you can use to install Teamcenter silently
(without user interaction) on another host. Silent installation suppresses most installation prompts
and requires minimal user interaction. As an alternative to installing and configuring Teamcenter on
individual hosts in your network, silent installation provides an efficient way to deploy Teamcenter on
multiple hosts in your network.
The silent installation configuration file records the selections and values you enter during a
Teamcenter installation and enables TEM to perform these steps noninteractively on other hosts. You
can modify a silent configuration file to change certain Teamcenter settings before installation.
Silent distributions are supported for Teamcenter servers, two-tier rich clients, and four-tier rich
clients.

• Compact distribution
A compact distribution is an installable package with a selected subset of Teamcenter client features.
It is much smaller than a full Teamcenter software kit and is more easily distributed to multiple hosts
in an organization.
A compact distribution is an alternative to installing Teamcenter from a full Teamcenter software kit.
A compact deployable package can contain a selected subset of Teamcenter features rather than the
entire set of features in the release. This reduces network loads and simplifies large-scale Teamcenter
deployments by providing an installation package that is smaller and more easily distributed to an
organization. For example, a two-tier rich client installation can be packaged in a deployable media as
small as 580 MB, where a full Teamcenter distribution can require up to 5 GB. A four-tier rich client
compact distribution can be as small as 283 MB, and a Client for Office compact distribution can be
only 93 MB.
Compact distributions are supported for Teamcenter two-tier and four-tier rich clients.

Create a silent distribution

Create a silent installation configuration file

1. Log on to the Teamcenter corporate server host and browse to the root directory of the
Teamcenter software kit.

2. Start Teamcenter Environment Manager (tem.bat) from the Teamcenter software kit. Right-click
the tem.bat program icon and choose Run as administrator.

3. In the Welcome to Teamcenter panel, select Teamcenter.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 3-1


© 2021 Siemens
3. Creating a custom distribution

4. In the Install/Upgrade Options panel, select the Create custom distribution check box, and
then click Install.

5. In the Custom Distribution Options panel, select Create silent configuration file, and then
specify the path to the silent installation file, for example, C:\silent.xml. The specified path must
be to an existing directory and the file name must end in .xml.

6. Proceed through the remaining panels to complete the Teamcenter installation.

Teamcenter Environment Manager creates the silent installation file you specified in step 5. This
file records your settings and selections during the installation. You can use this file to silently
install Teamcenter on another host with the same settings.

Caution:
If you install a rich client silently using a compact distribution and your silent configuration file
requires features not included in the compact distribution, the silent installation fails. To avoid
this, make sure your silent configuration requires only features in the compact distribution, or
install using a full Teamcenter software kit.

Install the rich client silently

Your Teamcenter administrator can create a silent distribution of the rich client, which allows you to
install the client without user interaction. This provides a means to install the rich client efficiently on
multiple hosts in your network.

To launch a silent installation, type the following command:

tem.bat -s file-name.xml

Replace file-name with the name of the silent installation configuration file.

After installation is complete, you can view a log of the installation in the installxxx.log file under the
install directory in the Teamcenter application installation directory.

The rich client can be uninstalled only through the TEM interface. Silent uninstallation is not supported.

Modify the silent installation configuration file

The silent installation configuration file is XML-based. After creating the file and establishing the file
structure using Teamcenter Environment Manager, you can change the installation by manually
modifying the values of the XML elements described in the following table.

3-2 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Modify the silent installation configuration file

Caution:
Use an XML editor to ensure well-formed XML code. Do not change the XML structure of the file. If
XML file structure is incorrect, or the XML code is not well-formed, installation fails.

Element Description

features Lists all the Teamcenter modules and features to be installed. These are
selected on the Features panel of Teamcenter Environment Manager.

feature Specifies one feature of a Teamcenter module. The code attribute


identifies the feature. To define whether Teamcenter Environment
Manager installs the feature, set the selected attribute to either true or
false.

data Lists all Teamcenter Environment Manager Java classes and values
defining aspects of installation, such as the path to the installation
directory for Teamcenter application files. For additional information, see
the comments in the configuration file. The comments describe the class
and valid values.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 3-3


© 2021 Siemens
3. Creating a custom distribution

Sample silent installation configuration file

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


<root>
<tem engine="2008.0.0" />
<settings>
<installDir value="C:\\Program Files\\Siemens\\Teamcenter13.1" />
<sourceDir value="D:\\kits\\tc13.1\\win64" />
<application value="tceng" />
<silentMaintenance value="false" />
<installingUser value="osuser" />
<installLanguage value="ENGLISH" />
<aboutFullVersion value="13.1" />
<version value="12000.1.0.20181207" />
</settings>
<sourceLocations>
<coreLocations>
<directory value="D:/kits/tc13.1/win64" />
</coreLocations>
<browsedLocations />
</sourceLocations>
<config name="My Configuration 1" id="config1">
<mode type="install" clone="false">
<checkpoints>
<checkpoint value="featureProperties">
<point value="vcruntimes:vc2005,latest" />
<point value="minMSSQL2005Version:10.50" />
<point value="coreTemplate:foundation_template.xml" />
<point value="feature_id:datamodel,rtserver" />
<point value="vcruntimes:latest" />
<point value="template_file:foundation_template.xml" />
<point value="minDB2Version:9.7.4" />
<point value="minOracleVersion:11.2.0.1" />
<point value="template_name:foundation" />
<point value="typeAnalysis:true" />
</checkpoint>
</checkpoints>
</mode>
<comments />
<data>
<adminUser guid="2E53CFC3AC75665E50FF0F207D1D013B">
<password value="holrvg6fpj40nGt7ZlCM2Q" encrypt="true" />
<user value="infodba" />
</adminUser>
<director guid="661AA2A766CA975D998EBE61455F3EA3">
<saveStateOnFail value="true" />
<status value="0" />
<script>
<temBase />
<copyFeature name="Microsoft Visual C++ Runtimes"
feature="A0CF69C3A0BC61770EB81BD22667EA52" />
<copyFeature name="Business Modeler IDE"
feature="A9CECD82127A11DB9804B622A1EF5492" />
<copyFeature name="VC 2008 Redistributables"
feature="DPBL8RC6MUS0LCPS10NIPGR85RI7HPHQ" />
<copyFeature name="Teamcenter File Services"
feature="BC76F9D1AB7C93A848D0FE3602F59097" />
<copyFeature name="Flex License Server"

3-4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Modify the silent installation configuration file

feature="D1D683A8B2CE1EB821B97CD2EE5D7627" />
<copyFeature name="VC 2005 Redistributables"
feature="UDR4NG0DEZ1TN9XHKG7Z8AFDPVVTZXL2" />
<copyFeature name="VC 2013 Redistributables"
feature="NJCMQH3ZMYTPPPGA8BS4Q1C7OV6IXVXU" />
<copyFeature name="VC 2010 Redistributables"
feature="R08U30BA5KZYSNDFKMGXKKHWEYOOVD7V" />
<copyFeature name="VC 2012 Redistributables"
feature="Z9ICW073V9QXU4H5F8BK6CXG6KFYWBQZ" />
<copyFeature name="Business Modeler Templates"
feature="A909338A1CB411DB8AF6B622A1EF5492" />
<copyFeature name="Digital Dashboard"
feature="A9CECD82127A11DB9804B622A1EF5599" />
<copyFeature name="FMS Server Cache"
feature="90C2A1C96F6A61FAB397AF88ABE4AAC1" />
<copyFeature name="Teamcenter Foundation"
feature="8C061DD51E13E0CB9DC4687B1A3348BE" />
<copyFeature name="NX Part Family Classification Integration"
feature="B176F6B6E9E91D9804EFB0D2
010FD613" />
<copyFeature name="Server Manager" feature="BF0E78AFE4280DCB08594EA2F3671BE8" />
.
.
.
<unpack name="Microsoft Visual C++ Runtimes"
feature="A0CF69C3A0BC61770EB81BD22667EA52" />
<unpack name="FMS Server Cache" feature="90C2A1C96F6A61FAB397AF88ABE4AAC1" />
<unpack name="Teamcenter Foundation"
feature="8C061DD51E13E0CB9DC4687B1A3348BE" />
<unpack name="NX Part Family Classification Integration"
feature="B176F6B6E9E91D9804EFB0D2010FD
613" />
<preInstall name="Microsoft Visual C++ Runtimes"
feature="A0CF69C3A0BC61770EB81BD22667EA52" />
<preInstall name="FMS Server Cache" feature="90C2A1C96F6A61FAB397AF88ABE4AAC1" />
<preInstall name="Teamcenter Foundation"
feature="8C061DD51E13E0CB9DC4687B1A3348BE" />
<preInstall name="NX Part Family Classification Integration"
feature="B176F6B6E9E91D9804EFB0D20
10FD613" />
<install name="Microsoft Visual C++ Runtimes"
feature="A0CF69C3A0BC61770EB81BD22667EA52" />
<install name="FMS Server Cache" feature="90C2A1C96F6A61FAB397AF88ABE4AAC1" />
<install name="Teamcenter Foundation"
feature="8C061DD51E13E0CB9DC4687B1A3348BE" />

<install name="NX Part Family Classification Integration"


feature="B176F6B6E9E91D9804EFB0D2010F
D613" />
<postInstall name="Microsoft Visual C++ Runtimes"
feature="A0CF69C3A0BC61770EB81BD22667EA52" />
<postInstall name="FMS Server Cache"
feature="90C2A1C96F6A61FAB397AF88ABE4AAC1" />
<postInstall name="Teamcenter Foundation"
feature="8C061DD51E13E0CB9DC4687B1A3348BE" />
<postInstall name="NX Part Family Classification Integration"
feature="B176F6B6E9E91D9804EFB0D2
010FD613" />

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 3-5


© 2021 Siemens
3. Creating a custom distribution

<featureInstalled name="Microsoft Visual C++ Runtimes"


feature="A0CF69C3A0BC61770EB81BD22667EA5
2" />
<featureInstalled name="FMS Server Cache"
feature="90C2A1C96F6A61FAB397AF88ABE4AAC1" />
<featureInstalled name="Teamcenter Foundation"
feature="8C061DD51E13E0CB9DC4687B1A3348BE" />
<featureInstalled name="NX Part Family Classification Integration"
feature="B176F6B6E9E91D9804E
FB0D2010FD613" />
</script>
</director>
<FSCService guid="F2FCBCEC03DFF7F9D1E3A11EC9B64BD2">
<fscReadCacheDir value="$HOME\\FSCCache" />
<fscWriteCacheDir value="$HOME\\FSCCache" />
<addToBootstrap value="true" />
<fscReadCacheSize value="10" />
<serverID value="FSC_tchost_osuser" />
<log value="" />
<fscWriteCacheSize value="10" />
</FSCService>
<FSCMasterSettings guid="EBC3422F77C6BF18FE0E3A821EFE1134">
<masterModel value="Simple Model" />
</FSCMasterSettings>
<FscSiteImport guid="630BECF927EC742A748A97486D5868DA">
<remoteSites value="" />
</FscSiteImport>
<tcdata guid="4500621E2BE24BF0DD6ABF31EBA01088">
<serverHostLocation value="tchost" />
<path value="C:\\Program Files\\Siemens\\tcdata" />
<create value="true" />
<shareName value="" />
<dsmKeyPath value="" />
</tcdata>
<FSCServiceFCCDefaults guid="7311DC5E94724BED0DD7419FCDE055CF">
<writeCacheSize value="1000" />
<readCacheSize value="1000" />
<cacheDirUnix value="/tmp/$USER/FCCCache" />
<partialReadCacheSize value="3000" />
<cacheDirWin value="$HOME\\FCCCache" />
</FSCServiceFCCDefaults>
<FccSite guid="35EE6A66B85467D5EDE5B3D91871EACE">
<siteListString value="" />
</FccSite>
<FSCServiceConnections guid="E4BDA0B521CB10A49F0CE123C9F326F1">
<connections value="http,4544,;" />
</FSCServiceConnections>
<OSUser guid="CA769D31FD7E122E5E509A0BBBD7E809">
<password value="+rfq6mTJVSuqaYJixkwntg" encrypt="true" />
<user value="DOMAIN\\osuser" />
</OSUser>
<flexClient guid="7221ECFBC9555CDF997FC3F575022761">
<nX5String value="28000@flexhost" />
<port value="27000" />
<nX4String value="27000@flexhost" />
<nX5Port value="28000" />
<host value="flexhost" />
<nX5Host value="flexhost" />
<nX5CheckBox value="true" />
<envServerString value="28000@flexhost" />

3-6 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Modify the silent installation configuration file

</flexClient>
<signatureCertificate guid="RRK3WTCSY4020QSZO90QFJWMISFAC2AX">
<replaceCerts value="false" />
<certificates value="" />
</signatureCertificate>
<foundationSettings guid="LHBY67ZYMYHSKED26FHDNDHFJTZD84I7">
<templatesToBeInstalled value="" />
<genClientCache value="generate all" />
<genServCache value="" />
<productionEnvironment value="true" />
<requestMetaCacheRebuild value="true" />
<enableGenServCache value="true" />
<quickClone value="false" />
</foundationSettings>
<transientVolume guid="983980098FF188A8C4BF08E8168A32A8">
<windowsVolume value="C:\\Temp\\transientVolume_tcdbuser" />
<unixVolume value="/tmp/transientVolume_tcdbuser" />
</transientVolume>

<TcOracleSystem guid="1EF0859AC04962CBFA41C4C8C84499A1">
<password value="WsRDrEfD0/4vnLO0/mj2wA" encrypt="true" />
<user value="system" />
<tablespaces
value="tcdbuser_IDATA:90;tcdbuser_ILOG:5;tcdbuser_INDX:5;tcdbuser_TEMP:5;tcdbuser_MM
V:5" />
<tablespacePath value="/db/oradata/tc/tcdbuser" />
</TcOracleSystem>
<security guid="ZUG63OE2YRNFD1VY13KCEZM52XFJP45D">
<adminDirectory value="$TC_ROOT\\security" />
</security>
<volume guid="1F16971107DE44C0C7827F800EE4AEF8">
<port value="4544" />
<fscModel value="Simple Model" />
<location value="C:\\Program Files\\Siemens\\volume" />
<name value="volume" />
<hostName value="tchost" />
<fscId value="FSC_tchost_osuser" />
</volume>
<TcOracleEngine guid="F4F7C0852B27D6E56B8C64BE77FFA14C">
<port value="1521" />
<createUser value="true" />
<host value="dbhost" />
<flush value="false" />
<populate value="true" />
<service value="tc" />
<uTF8Enabled value="true" />
<password value="AdxT7Jmz2/WbYF6O/eqX9g" encrypt="true" />
<user value="tcdbuser" />
<create value="true" />
</TcOracleEngine>
</data>
<features>
<add feature="A0CF69C3A0BC61770EB81BD22667EA52" name="Microsoft Visual C++
Runtimes" />
<add feature="90C2A1C96F6A61FAB397AF88ABE4AAC1" name="FMS Server Cache" />
<add feature="8C061DD51E13E0CB9DC4687B1A3348BE" name="Teamcenter Foundation" />
<add feature="B176F6B6E9E91D9804EFB0D2010FD613" name="NX Part Family
Classification Integration"

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 3-7


© 2021 Siemens
3. Creating a custom distribution

/>
</features>
</config>
<updateManager />
</root>

Create a compact distribution


Creating a compact distribution is supported only in Teamcenter major releases. It is not supported in
minor releases, so the Create compact deployable media check box is disabled in Teamcenter
Environment Manager (TEM).

3-8 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
4. Installing Microsoft Office interfaces
Compare Microsoft Office interfaces
Teamcenter provides two interfaces to Microsoft Office. Choose the interface that best suits your use of
Teamcenter and Microsoft Office.

• Teamcenter Client for Microsoft Office


Teamcenter Client for Microsoft Office allows you to manage Teamcenter workspace objects in real
time. Client for Office gives you access to Teamcenter objects directly through Microsoft Office Word,
Excel, PowerPoint, Project, and Outlook. From Outlook, you can save email content or attachments or
both and register them in the Teamcenter database. A custom Teamcenter ribbon is added to these
Microsoft Office applications.
Client for Office enables you to import objects from Microsoft Excel into Teamcenter. It also enables
you to import and export objects between live Word and Teamcenter applications.
Client for Office can be installed with the Teamcenter four-tier rich client or separately as an add-in to
Microsoft Office. Client for Office is independent of the Teamcenter rich client. You can work in Client
for Office while a Teamcenter client is running, or you can work solely through Client for Office
without running a Teamcenter client.

• Teamcenter Extensions for Microsoft Office


Teamcenter Extensions for Microsoft Office provides easy access to Teamcenter through Microsoft
Office Live features in Microsoft Word. Extensions for Office allows you to edit properties of
workspace objects and apply those changes to the Teamcenter database.
Extensions for Office is available for the two-tier and four-tier Teamcenter rich client.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-1


© 2021 Siemens
4. Installing Microsoft Office interfaces

Installing Teamcenter Client for Microsoft Office

Before you install Client for Office

Choose an installer

Client for Office can be installed alone or as part of a Teamcenter four-tier rich client configuration.
Siemens Digital Industries Software provides the following ways to install Client for Office.

Standalone installation wizard Installs Client for Office on a single host through a step-by-step
interface. This wizard does not install the Teamcenter rich client.

Teamcenter Environment Installs Client for Office alone or as part of a four-tier rich client
Manager (TEM) configuration.
TEM does not install the Teamcenter plugin for Microsoft Project.
If you need the plugin for Microsoft Project, you must use the
standalone installation wizard.

In Teamcenter patch releases, patch the standalone installation wizard or TEM, and then install the
patched version of Client for Office.

Install required software

Teamcenter Client for Microsoft Office requires the following software on your client host:

Install Microsoft Office


Install a supported 64-bit edition of Microsoft Office. For certified versions, see the Hardware and
Software Certifications knowledge base article on Support Center.
Client for Office installs Teamcenter plugins for Microsoft Word, Excel, PowerPoint, Project, and
Outlook. (The plugin for Microsoft Project is installable only through the standalone installation
wizard.)

Install Microsoft Windows Components


If you install Client for Office using TEM, install the required 64-bit Microsoft Windows components
before you install Client for Office. The stand-alone Client for Office installation wizard installs
these if they are not present, but may interrupt the installation for system restarts. Installing these
components requires administrative privileges.
Uninstall any 32-bit versions of these components, then download and install the 64-bit versions
from Microsoft Corporation:

• Microsoft .NET Framework.

• Microsoft Visual Studio Tools for Office (VSTO) for 64-bit Windows.

4-2 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install Client for Office using the stand-alone installation wizard

• Microsoft Office Language Pack for English for 64-bit Windows. This is required if you use a non-
English version of Windows because .NET add-ins require English support.

For certified versions of these libraries, see the Hardware and Software Certifications knowledge
base article on Support Center.

Gather required information

You may need to provide the following information during installation of Client for Office. Obtain these
values from your Teamcenter administrator if you do not have them:

Teamcenter server information • Host name


• Port
• Teamcenter application name

FMS server cache (FSC) information • Host name


• Port
• Protocol

Security Services information • Application ID


(Required only if you use Security • Application name
Services with Client for Office.) • Server host name
• Server port

Install Client for Office using the stand-alone installation wizard

1. Uninstall any existing Client for Office software using the Windows Control Panel.

2. From the download page on Support Center, download the Teamcenter 13 and 13.1 software kits
for Windows:

Tc13.0.0.0_wntx64.zip
Tc13.1.0.0_wntx64.zip

Expand the software kits to separate local directories.

3. In the Teamcenter 13.1 kit, locate the additional_applications\OfficeClient directory. Copy the
contents of this directory to the corresponding directory in the Teamcenter 13 kit
(additional_applications\OfficeClient), overwriting existing files.

This updates the Client for Office installer from Teamcenter 13 to 13.1.

4. In the additional_applications\OfficeClient directory in the updated Teamcenter 13 kit, double-


click the setup.exe program icon to launch the Client for Office installation wizard.

5. If the prerequisite Microsoft libraries are not present on the client host, the installation wizard
installs them. If this installation requires a restart, the wizard resumes after restart.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-3


© 2021 Siemens
4. Installing Microsoft Office interfaces

6. Proceed to the Setup Type dialog box. Specify whether to install Client for Office for one user or all
users on the client host.

The option to install for all users is available only to administrative users.

7. In the Choose Destination Location dialog box, enter the location in which to install Client for
Office.

Note:
If the wizard prompts for a JRE path, enter the path to the required Java Runtime
Environment (JRE) on your system.

8. In the Select Features dialog box, select the features you want to include in your installation.

The list of available plugins depends on the Microsoft Office applications installed on your host
(Word, Excel, PowerPoint, Project, and Outlook).

If you use Requirements Manager and want to manage requirements in Microsoft Office, select the
Word Applications→Requirements Management Integration feature.

Client for Office requires Teamcenter client communication system (TCCS). If the rich client or TCCS
are not already present on your system, the Teamcenter client communication system (TCCS)
feature is selected by default.

9. In the Teamcenter FCC Parent settings dialog box, specify the FMS server caches (FSCs) used by
the FMS client cache (FCC). Click Add to add an FSC.

10. In the Advanced Configuration dialog box, select the Advanced Configuration check box if you
want to specify settings for forward proxy, reverse proxy, Kerberos authentication, or other TCCS
settings.

If you do not select Advanced Configuration, skip to step 11.

If you select Advanced Configuration, perform the following steps.

a. In the Forward Proxy Settings dialog box, enter information about the TCCS forward proxy.

Value Description

No proxy Specifies that you do not want to use a forward


proxy.

Use web browser settings Specifies that you want to use proxy settings from
your web browser.

4-4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install Client for Office using the stand-alone installation wizard

Value Description

Detect settings from network Specifies that you want to use proxy settings from
your local network.

Use a proxy auto-configuration file Specifies that you want to obtain settings from a
proxy autoconfiguration (PAC) file.

Proxy URL Specifies the URL to the PAC file from which you
want to obtain proxy settings.

Note:
If your network uses IPv6 (128-bit) addresses,
use the hostname in URIs and do not use the
literal addresses, so the domain name system
(DNS) can determine which IP address should
be used.
You can configure TCCS environments further
after installation.

Manually configure proxy settings Specifies that you want to enter proxy settings
manually.

All Protocols Proxy Host Specifies a name of a valid proxy to use for all
protocols. In the accompanying Port box, type the
port used by the proxy host.

HTTP Proxy Host Specifies the host of a forward proxy server for the
HTTP protocol. In the accompanying Port box, type
the port used by the proxy host.

HTTPS Proxy Host Specifies the host of a forward proxy server for the
HTTPS protocol. In the accompanying Port box, type
the port used by the proxy host.

Exception List Specifies a semicolon-delimited list of host names


and IP addresses to exempt. This box is optional.
This list can be used to send requests for local
endpoints directly to the destination server without
going through a forward proxy that is used for
endpoints outside the company intranet. For
example, this could allow direct access to a
Teamcenter web tier hosted within the company
while going through a forward proxy to access a
Teamcenter web tier hosted by a business partner.

b. In the TCCS Environments Information dialog box, type information about defined TCCS
environments. Click Add to add a row to the table, and then type the required values.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-5


© 2021 Siemens
4. Installing Microsoft Office interfaces

Value Description

Name Specifies the name of the TCCS environment.

URL Specifies the URL to the TCCS environment.

Filter Text Specifies a string identifier for the TCCS environment.


When installing a rich client, you can optionally provide a
Client Tag Filter value to filter the list of environments
displayed in the rich client to those environments that
match the filter value.

SSO URL Specifies the URL to the Security Services application you
use with TCCS.

SSO App ID Specifies the ID of the Security Services application you use
with TCCS.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use
the literal addresses, so the domain name system (DNS) can determine which IP address
should be used.
You can configure TCCS environments further after installation.

c. In the Reverse Proxy dialog box, specify whether to enable TCCS reverse proxy support.
Select the Enable Reverse Proxy check box if any URL accessed by TCCS is a reverse proxy
server that requires a logon.

If you select No, skip to step e.

d. Proceed to the TCCS Reverse Proxy Settings dialog box.

Teamcenter uses reverse proxy settings to detect a logon web page from a reverse proxy
server through which Teamcenter services are accessed.

The criteria table lists the reverse proxy criteria currently defined. Each row of the table is a
criteria XML element defined in the specified format. By default, the table is blank and no
criteria are defined. A criterion string is of the following form:

Header_Name1, Header_Value1, Header_Name2, Header_Value2,…:Form_Action

Each criterion must contain at least one header name/header value pair or at least a single
form action.

To add a criterion to the table, perform the following steps:

4-6 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install Client for Office using the stand-alone installation wizard

A. Click Add.

Note:
You can also click Remove to remove an existing criterion from the table or Edit to
edit an existing criterion.

B. Type the header names and values for criterion you want to add. In the Form Action
box, specify a form action.

C. Click OK to add the criterion or Cancel to abandon your changes.

Note:
• If you must connect to a Teamcenter environment through a reverse proxy server
(such as WebSEAL or SiteMinder), you may need to configure reverse proxy settings
for TCCS.

• If you use SiteMinder, you must configure TCCS to detect form-based challenges
originating from the reverse proxy by selecting the Check Headers check box.
This setting also applies to other reverse proxy servers that do not send specific
header information in the 200 form-based challenge.

• Criteria definitions are written to the reverseproxy_cfg.xml file.

e. Proceed to the Kerberos authentication support dialog box.

If you use Kerberos, enter Kerberos authentication settings.

Value Description

Support Kerberos authentication Specifies you want to use Kerberos authentication


for Teamcenter logon.

Use this Krb5 file Specifies you want to use a custom Kerberos
configuration file. If you select this option, enter the
path to the custom Kerberos configuration file.

Use Krb5 file from default Specifies you want to use the default Kerberos
location configuration file on the host.
On Windows hosts, the default location is
C:\Windows.

Always prompt for user ID Specifies you want to always prompt for a Kerberos
user name.
If you want to enable zero sign-on functionality on
Windows hosts, clear this check box. Zero sign-on

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-7


© 2021 Siemens
4. Installing Microsoft Office interfaces

Value Description

allows Windows users to launch a Teamcenter client


without being prompted to log on to Teamcenter.

Note:
Zero sign-on functionality requires you
configure Security Services in applet-free
mode in the Security Services panel.
For more information about Security Services
installation, see Security Services Installation/
Customization.

Note:
Kerberos is a network authentication protocol that uses a system of tickets to allow
nodes communicating over nonsecure networks to securely verify identities of each
side. Using a client-server model, it provides mutual authentication: the user and the
server verify each other's identities.
When configuring TCCS to use Kerberos authentication, a krb5.ini file should not be
specified in the TCCS configuration. Even if specified, the file is not used for Kerberos
configuration.

f. Proceed to the Secure Socket Layer (SSL) Settings dialog box. Enter smart card
authentication settings.

Value Description

Use Internet Explorer Certificate Specifies you want to use certificates stored in
Store (Recommended) Microsoft Internet Explorer.
This option is available only on Windows hosts.

Disable SSL Specifies you want to disable SSL authentication.

Configure Certificate Store Specifies you want to manually configure the


Manually certificate store for Teamcenter.

Use trust store Specifies you want to use a truststore. If you select
this option, enter the path to the File that contains
the truststore you want to use.

Accept untrusted certificates Specifies you want to accept untrusted certificates.

Configure key store If you want to configure a keystore, select this


check box.

4-8 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install Client for Office using the stand-alone installation wizard

Value Description

If you choose this option, enter the path to the


keystore. Also, specify the file type. The default file
type is JKS.

g. Skip to step 13 to continue installation.

11. In the Teamcenter Server Information dialog box, click Add, and then enter the following values
for the Teamcenter server:

• Connection Name
• Protocol (HTTP or HTTPS)
• Teamcenter Host
• Port Number
• Application Name

If you want to add additional servers, click Add. To remove a server from the list, select the server
in the list and click Remove. To edit settings for a server, select the server and click Edit.

Click Up or Down to assign server priority.

12. In the Setup Type dialog box, select whether to enable Security Services with Client for Office.

If you select Yes, enter server settings for Security Services.

Value Description

Application ID Specifies the application ID of your Teamcenter


installation as configured in the Security Services
installation.

Protocol Specifies the protocol used to access the Security Services


application (HTTP or HTTPS).

SSO Server Host Specifies the server host for the Security Services
application.

Port Number Specifies the port used by the Security Services


application.

Application Name Specifies the application name of the Security Services


application.

13. In the Start Copying Files dialog box, review your selections. Click Back to change your selections
or click Next to install Client for Office.

14. When installation is complete, close the installation wizard.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-9


© 2021 Siemens
4. Installing Microsoft Office interfaces

15. If your host is running Windows 10, restart the system to enable the FMS_HOME environment
variable required by Teamcenter client communication system (TCCS).

You can perform advanced TCCS configuration after installation is complete.

Install Client for Office using TEM

This procedure describes installing Client for Office as part of a new Teamcenter environment. If you
install Client for Office into an existing Teamcenter environment, launch TEM in maintenance mode as
you would to add features, proceed to the Features panel, and then proceed to step 7 here.

1. Install the prerequisite software on the client host. Teamcenter Environment Manager (TEM)
does not install the prerequisite software.

2. Start Teamcenter Environment Manager (TEM).

In the Teamcenter 13.1software kit, right-click the tem.bat program icon and choose Run as
administrator.

3. In the Welcome to Teamcenter panel, select Teamcenter.

For information about any panel in TEM, click the help button .

4. In the Install/Upgrade Options panel, click Install.

5. In the Media Locations panel, enter the path to the Teamcenter 13 software kit in the Original
Media Location box. You can also optionally add paths to any Teamcenter patches you want to
apply during installation.

6. In the Configuration panel, type an ID and a description for the new Teamcenter configuration.

Proceed to the Features panel.

7. In the Features panel, select the Teamcenter Client for Microsoft Office feature (under
Extensions→Enterprise Knowledge Foundation).

You may optionally include additional features in your Teamcenter configuration. If you select
additional features, TEM displays panels during installation that are not described in this procedure.

Note:
TEM does not install the Teamcenter plugin for Microsoft Project. If you need the plugin for
Microsoft Project, you must use the standalone installation wizard. TEM installs
Teamcenter plugins for Microsoft Word, Excel, PowerPoint, and Outlook.

4-10 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Requiring add-ins to be signed by a trusted publisher

8. In the File Client Cache (FCC) panel, choose whether to use a new or existing FMS client cache
(FCC).

If you want to create a new FCC using the same settings as an existing FCC on your host, select the
Merge values from an existing FMS_HOME check box.

If you want to specify settings for forward proxy, reverse proxy, Kerberos authentication, or other
TCCS settings, click Advanced.

9. In the FCC Parents panel, enter information about the FMS server cache (FSC).

10. Proceed to the 4-tier server configurations panel. In the URI column, enter the URI for the
Teamcenter web tier server. In the Connection Name column, enter a name for the rich client
connection.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use the
literal addresses, so the domain name system (DNS) can determine which IP address should
be used.

11. In the Office Client Requirement panel, TEM reports whether the required software is detected
on your system. If not, the installation cannot continue.

If you are logged on as an administrative user on the client host, you can also choose whether to
install Client for Office for the current user or for all users on the client host. This option is under
Administrator Option.

12. In the Office Client Configuration panel, if you use Security Services with Client for Office, select
the Install Teamcenter Single Sign-on support for Office Client check box, and then enter
connection information for the Security Services application.

13. Proceed to the Confirmation panel and review your selections. Click Start to install Client for
Office, or click Back to change your selections.

Requiring add-ins to be signed by a trusted publisher

Microsoft Office provides a setting that enables you to make it compulsory that all add-ins be signed by
a trusted publisher. By default, the publisher of an add-in does not have to be on the Trusted Publishers
list for an add-in to run. From the Microsoft Office application’s Trust Center, a user can enable the
Require that application add-ins are signed by a trusted publisher setting. When this setting is
enabled, add-ins that are signed by a publisher that is on the Trusted Publishers list run as expected.
Add-ins that are signed, but not on the Trusted Publishers list are disabled.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-11


© 2021 Siemens
4. Installing Microsoft Office interfaces

Designate a Publisher as a Trusted Publisher

To designate a publisher as a trusted publisher, add the publisher’s certificate to the Trusted Publishers
list. In this context, the publisher’s certificate is the digital certificate that Siemens Digital Industries
Software used to digitally sign its add-ins. Obtain a copy of the public key certificate from Siemens, and
import it into the Trusted Publishers list.

Process of opening a Microsoft Office dataset from Teamcenter

When you open a Microsoft Office dataset from the Teamcenter rich client, the Teamcenter Application
Launcher passes certain information to Client for Office. This information preserves the Teamcenter
context of the dataset.

In the process of opening the dataset:

1. The Application Launcher sends an Office Application Integration (.oai) file to the Microsoft Office
application for the dataset’s file type.

2. The Office application starts, and the Client for Office add-in is loaded.

Warning:
By default, Microsoft Office allows add-ins to run without notification and does not check for
digital signatures. You can change this behavior by choosing higher security settings in the
Office Trust Center. Client for Office supports all add-in security settings.
Higher security settings (for example, Require Application Add-ins to be signed by Trusted
Publisher) can add a significant amount of time in starting the application and loading the
add-in. This process can take 30 seconds or longer, depending on your settings.

3. The add-in parses the .oai file to obtain the Teamcenter context information about the dataset.

4. The .oai file closes, and the dataset is downloaded from Teamcenter and opens in the Office
application.
Normally, the .oai file appears only briefly before the dataset opens. Under slower network
conditions, however, the .oai file may remain open longer.

Caution:
If the .oai file remains open for more than 10 seconds, an installation or configuration issue
may be indicated.
If you have questions about this issue, consult your Teamcenter administrator.

4-12 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Choose the appropriate uninstallation method

Uninstall Microsoft Office interfaces

Choose the appropriate uninstallation method

Uninstall Teamcenter Microsoft Office interfaces using the method that reflects how you installed the
interfaces.

Method Description

Windows Control Panel If you installed Microsoft Office interfaces using stand-alone
installation wizards, uninstall them using the Add or Remove
Programs dialog box in the Windows Control Panel.

Teamcenter Environment Manager If you installed Microsoft Office interfaces using TEM,
(TEM) uninstall them using TEM.

Uninstall Microsoft Office interfaces using Windows Control Panel

1. Open the Add or Remove Programs dialog box in the Windows Control Panel.

2. Select the programs you want to remove and click Change/Remove:

Teamcenter Client for Office


Teamcenter Applications for Microsoft Office

Note:
Selecting this item uninstalls Teamcenter Extensions for Microsoft Office and
Teamcenter Plugin for Microsoft Project.

Uninstall Microsoft Office interfaces using TEM

1. Log on to the operating system with the Teamcenter user account you created for installing and
maintaining the Teamcenter installation.

2. Start Teamcenter Environment Manager (TEM):

Start→Programs→Teamcenter 13→Environment Manager

3. In the Maintenance panel, select Configuration Manager.

4. If you installed Microsoft Office interfaces as part of a Teamcenter rich client configuration, you
can remove the Teamcenter configuration or just remove Microsoft Office interfaces from the rich
client configuration.

• To remove the Teamcenter configuration, perform the following steps:

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-13


© 2021 Siemens
4. Installing Microsoft Office interfaces

a. In the Configuration Maintenance panel, select Remove configuration (uninstall), and


then click Next.

b. In the Old Configuration panel, select the configuration you want to remove, and then
click Next.

c. In the Uninstall panel, select Yes to confirm that you want to uninstall the configuration.
Click Next.

d. In the Uninstall Teamcenter panel, select the Advanced Uninstall Options check box if
you want to view additional uninstall options. Otherwise, click Next.

e. In the Confirmation panel, click Start to begin the uninstallation.

• To remove Microsoft Office interfaces from the configuration, perform the following steps:

a. In the Configuration Maintenance panel, select Perform maintenance on an existing


configuration, then click Next.

b. In the Old Configuration panel, select the configuration you want to modify.

c. In the Feature Maintenance panel, choose Add/Remove Features.

d. In the Features panel, clear the check boxes for the Microsoft Office interface features you
want to remove:

Extensions→Enterprise Knowledge Foundation→Teamcenter Client for Microsoft


Office

Extensions→Systems Engineering and Requirements Management→Teamcenter


Extensions for Microsoft Office

e. Proceed through the remaining panels in TEM, entering required information as needed.

f. In the Confirmation panel, click Start to begin uninstalling features.

Patching Client for Office

Patch Client for Office using the stand-alone installation wizard

Patching Client for Office requires uninstalling the client and reinstalling it using a patched installation
program.

1. Uninstall any existing Client for Office software using the Windows Control Panel.

4-14 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Patch Client for Office using TEM

2. From the download page on Support Center, download the Teamcenter 13 software kit and the
patch kit you want to apply:

Tc13.0.0.0_wntx64.zip
Tc13.1.0_patch_patch-number_wntx64.zip

Expand the software kits to separate local directories.

3. In the Teamcenter patch kit, locate the additional_applications\OfficeClient directory. Copy the
contents of this directory to the corresponding directory in the Teamcenter 13 kit
(additional_applications\OfficeClient), overwriting existing files.

This patches the Client for Office installer from Teamcenter 13 to the selected patch level.

4. In the additional_applications\OfficeClient directory in the patched Teamcenter 13 kit, double-


click the setup.exe program icon to launch the Client for Office installation wizard.

5. If the prerequisite Microsoft libraries are not present on the client host, the installation wizard
installs them. If this installation requires a restart, the wizard resumes after restart.

Perform the remaining installation steps as if you were installing from a release software kit.

Patch Client for Office using TEM

Patching Client for Office requires uninstalling the client and reinstalling it using the updated version of
Teamcenter Environment Manager (TEM).

1. Download or locate the following software kits:

• Teamcenter patch kit:

Tc13.1.0_patch_number_wntx64.zip

• Teamcenter Environment Manager (TEM) patch kit:

Tc13.1.0_patch_number_install.zip

2. Update Teamcenter Environment Manager (TEM):

a. Copy the TEM patch kit ZIP file to the TC_ROOT\install directory on your Teamcenter client
host.

b. Open a command prompt and change to the TC_ROOT\install directory.

c. Expand the TEM patch kit ZIP file, overwriting existing files:

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-15


© 2021 Siemens
4. Installing Microsoft Office interfaces

unzip –o Tc13.1.0_patch_number_install.zip

Note:
If errors occur while expanding the file, do one of the following tasks:

• Add the path to your TC_ROOT\install\install directory to your PATH environment


variable and enter the unzip command again.

• Enter the unzip command with the full path to your TC_ROOT\install directory, for
example:

TC_ROOT\install\install\unzip –o
Tc13.1.0_patch_number_install.zip

3. Launch TEM in maintenance mode and remove the Teamcenter Client for Microsoft Office
feature from the configuration.

4. Launch TEM in maintenance mode again and add the Teamcenter Client for Microsoft Office
feature to the configuration.

Perform the remaining steps as for an installation from a release software kit.

4-16 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Before you install Extensions for Office

Installing Teamcenter Extensions for Microsoft Office

Before you install Extensions for Office

Choose an installer

Extensions for Office can be installed alone or as part of a Teamcenter rich client configuration (two-tier
or four-tier). Siemens Digital Industries Software provides the following ways to install Extensions for
Office.

Stand-alone installation wizard Installs Extensions for Office on a single host through a step-by-
step interface. This wizard does not install the Teamcenter rich
client.

Teamcenter Environment Installs Extensions for Office alone or as part of a two- or four-tier
Manager (TEM) rich client configuration.

In Teamcenter patch releases, patch the standalone installation wizard or TEM and then install the
patched version of Extensions for Office.

Note:
• You must have administrative privileges to install Extensions for Office, but you do not need any
special permissions to use the Extensions for Office after installation.

• Extensions for Office does not include the Teamcenter plugin for Microsoft Project. The plugin
for Microsoft Project is available in Teamcenter Client for Microsoft Office.

Install required software

Teamcenter Extensions for Microsoft Office requires the following software on your client host:

Install Microsoft Office Word


Install Microsoft Office Excel (Professional, Professional Plus, or Enterprise edition), 64-bit version.
For certified versions, see the Hardware and Software Certifications knowledge base article on
Support Center.

Install Microsoft Libraries


If you install Extensions for Office using TEM, install the required 64-bit Microsoft libraries before
you install Extensions for Office. The stand-alone Extensions for Office installation wizard installs
these libraries if they are not present, but may interrupt the installation for system restarts.
Installing these libraries requires administrative privileges.
Uninstall any 32-bit versions of these libraries before installing the 64-bit versions. Download these
libraries from Microsoft Corporation and then install:

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-17


© 2021 Siemens
4. Installing Microsoft Office interfaces

• Microsoft .NET Framework.

• Microsoft Office Primary Interop Assemblies (PIAs) for Office.

• Microsoft Office Language Pack for English for 64-bit Windows. (Required if you use a non-
English version of Windows because .NET add-ins require English support.)

For certified versions of these libraries, see the Hardware and Software Certifications knowledge
base article on Support Center.

Enable .NET framework programmability support for Microsoft Office applications

1. In the Windows Control Panel, open the Add or Remove Programs dialog box.

2. In the list of installed programs, locate the Microsoft Office application. Select the program name
in the list, and then click Change.

3. In the maintenance mode options dialog box, select Add or Remove Features, and then click
Continue to display the installation options.

4. In the Installation Options dialog box, expand the features tree under Microsoft Excel.

5. To the left of .NET Programmability Support, click the down arrow, and then choose Run from
my computer.

Note:
The .NET Programmability Support option is available if you have installed Microsoft .NET
Framework.

6. Click Continue to apply the changes.

The Microsoft Office installer may prompt you to insert the Microsoft Office CD-ROM to apply the
changes.

Install Extensions for Office using the stand-alone installation wizard

1. Uninstall any previous versions of Extensions for Office using the program list in the Windows
Control Panel.

2. From the download page on Support Center, download the Teamcenter 13 and 13.1 software kits
for Windows:

Tc13.0.0.0_wntx64.zip
Tc13.1.0.0_wntx64.zip

4-18 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install Extensions for Office using TEM

Expand the software kits to separate local directories.

3. In the Teamcenter 13.1 kit, locate the additional_applications\tc_ext4mso directory. Copy the
contents of this directory to the corresponding directory in the Teamcenter 13 kit
(additional_applications\tc_ext4mso), overwriting existing files.

This updates the Extensions for Office installer from Teamcenter 13 to 13.1.

4. In the additional_applications\tc_ext4mso directory in the updated Teamcenter 13 kit, double-


click the tc_ext4mso.exe program icon to launch the Extensions for Office installation wizard.

5. If the prerequisite Microsoft libraries are not present on the client host, the installation wizard
installs them. If this installation requires a restart, the wizard resumes after restart.

6. Proceed to the Select Features dialog box. Select the Teamcenter Extensions for Microsoft
Office feature.

7. Proceed through the remaining dialog boxes in the wizard to complete installation.

Some additional configuration in Microsoft Office is required to enable Teamcenter Extensions for
Microsoft Office.

Install Extensions for Office using TEM

1. Install the prerequisite software on the client host. Teamcenter Environment Manager (TEM)
does not install the prerequisite software.

2. Locate the Teamcenter 13.1 software kit.

Alternatively, you can install Extensions for Office from a compact distribution.1

3. Start TEM:

a. Browse to the root directory of the Teamcenter software kit.

b. Double-click the tem.bat program icon.

4. In the Welcome to Teamcenter panel, select Teamcenter.

For information about any panel in TEM, click the help button .

1 A compact distribution is a Teamcenter software installation package created by your Teamcenter administrator that
contains a selected subset of Teamcenter features. This package is smaller than a full Teamcenter software kit and is
more easily distributed. However, if you attempt to install a feature not included in the compact distribution, TEM
prompts for the location of a full Teamcenter software kit.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-19


© 2021 Siemens
4. Installing Microsoft Office interfaces

5. In the Install/Upgrade Options panel, click Install.

6. In the Media Locations panel, enter the path to the Teamcenter 13 software kit in the Original
Media Location box. You can also optionally add paths to any Teamcenter patches you want to
apply during installation.

7. In the Configuration panel, enter an ID and a description for the new Teamcenter configuration.

Proceed to the Features panel.

8. In the Features panel, select the Teamcenter Extensions for Microsoft Office feature (under
Extensions→Systems Engineering and Requirements Management).

Note:
You may include additional features in your Teamcenter configuration. If you select
additional features, TEM displays additional panels during installation that are not described
in this procedure.

9. In the Teamcenter Extensions for Microsoft Office, TEM reports whether all the prerequisite
libraries and settings are present on your system. Review any instructions in this panel and click
Next to continue.

10. Proceed to the Confirmation panel and review your selections. Click Start to install Extensions for
Office, or click Back to change your selections.

Patching Extensions for Office

Patching Extensions for Office using the stand-alone installation wizard

Patching Extensions for Office requires uninstalling the software and reinstalling it using a patched
installation program.

1. Close all rich client instances on the host.

2. Close all Microsoft Excel instances on the host.

3. Uninstall the existing Extensions for Office software from your system.

4. Log on as a user with administrative privileges on the Extensions for Office host.

5. From the download page on Support Center, download the Teamcenter 13 software kit and the
patch kit you want to apply:

Tc13.0.0.0_wntx64.zip
Tc13.1.0_patch_patch-number_wntx64.zip

4-20 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Patching Extensions for Office using TEM

Expand the software kits to separate local directories.

6. In the Teamcenter patch kit, locate the additional_applications\tc_ext4mso directory. Copy the
contents of this directory to the corresponding directory in the Teamcenter 13 kit
(additional_applications\tc_ext4mso), overwriting existing files.

This patches the Extensions for Office installer from Teamcenter 13 to the selected patch level.

7. If the patch kit contains an office_ext.zip file in its tc directory, expand this office_ext.zip into the
tc directory of the Teamcenter release software kit, overwriting existing files if prompted.

This updates Extensions for Office run-time files.

8. Launch the patched Extensions for Office stand-alone installation wizard (tc_ext4mso.exe) from
the release software location.

Do not run the installation wizard from the patch kit location.

Perform the remaining steps as for an installation from a release software kit.

Patching Extensions for Office using TEM

Patching Extensions for Office requires uninstalling the software and reinstalling it using the updated
version of Teamcenter Environment Manager (TEM).

1. Download or locate the following software kits:

• Teamcenter patch kit:

Tc13.1.0_patch_number_wntx64.zip

• Teamcenter Environment Manager (TEM) patch kit:

Tc13.1.0_patch_number_install.zip

2. Update Teamcenter Environment Manager (TEM):

a. Copy the TEM patch kit ZIP file to the TC_ROOT\install directory on your Teamcenter client
host.

b. Open a command prompt and change to the TC_ROOT\install directory.

c. Expand the TEM patch kit ZIP file, overwriting existing files:

unzip –o Tc13.1.0_patch_number_install.zip

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 4-21


© 2021 Siemens
4. Installing Microsoft Office interfaces

Note:
If errors occur while expanding the file, do one of the following tasks:

• Add the path to your TC_ROOT\install\install directory to your PATH environment


variable and enter the unzip command again.

• Enter the unzip command with the full path to your TC_ROOT\install directory, for
example:

TC_ROOT\install\install\unzip –o
Tc13.1.0_patch_number_install.zip

3. Launch TEM in maintenance mode and remove the Teamcenter Extensions for Microsoft Office
feature from the configuration.

4. Launch TEM in maintenance mode again and add the Teamcenter Extensions for Microsoft
Office feature to the configuration.

Perform the remaining steps as for an installation from a release software kit.

4-22 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
5. Installing TCCS
What is TCCS?
Teamcenter client communication system (TCCS) manages communication and file transfers between
Teamcenter clients and servers. TCCS contains the File Management System client cache (FCC), which
uploads files from your workstation to a Teamcenter volume and also downloads requested files from
the volume to your workstation.

An FCC also supports Lifecycle Visualization file streaming, which downloads portions of JT files over the
network as they are needed.

Siemens Digital Industries Software provides three ways to install TCCS.

Stand-alone installation wizard Provides a step-by-step interface that installs TCCS on a single
host. This wizard does not install a Teamcenter client.
If you do not use the rich client or Client for Office, and you use
NX or Lifecycle Visualization, you can optionally install TCCS on
your workstation using the stand-alone installation wizard.

Teamcenter Environment TCCS is installed when you install the rich client, but to use TCCS,
Manager (TEM) you must enable and configure it during rich client installation, or
after rich client installation, using TEM in maintenance mode.

You can also configure TCCS and (FMS) further after installation.

Note:
The FCC requires an FMS server cache (FSC) to which to connect. Your Teamcenter administrator
must provide you connection information for the FSC.
Each FCC requires a parent FSC to provide it with FMS configuration information upon startup. In
small deployments, the parent file server cache also provides the client cache with access to files.

Preparing to install TCCS


Make sure the minimum required version of Java is installed on your client host. TCCS installation or
configuration may fail if the required Java version is not present. For information about minimum
required versions of Java, see the Hardware and Software Certifications knowledge base article on
Support Center.

To configure TCCS, you must know the host, port, and protocol of the parent FMS server cache (FSC)
that your local FCC connects to. Before you install TCCS, obtain these values from your Teamcenter
administrator.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 5-1


© 2021 Siemens
5. Installing TCCS

In addition, if you use a forward or reverse proxy with TCCS, or if you want to specify connection
information for TCCS environments you want to connect to, you also must obtain these values from your
Teamcenter administrator:

• TCCS environment
Obtain the names and URLs of the TCCS environments your client host connects to. If you use Security
Services with TCCS, obtain the ID and URL of the Security Services application also.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use the
literal addresses, so the domain name system (DNS) can determine which IP address should be
used.

• Forward proxy information


If you use a forward proxy, obtain connection information for the forward proxy.

• Reverse proxy information


If you use a reverse proxy such as WebSEAL or SiteMinder, obtain connection information for the
reverse proxy.

Enable TCCS using TEM


1. Install a rich client.

2. Launch Teamcenter Environment Manager (TEM) in maintenance mode. In the Windows start
menu, choose Programs→Teamcenter 13, and then right-click Environment Manager and
choose Run as administrator.

Note:
You can also run the tem.bat file in the install directory in the application root directory for
the Teamcenter installation. Right-click the tem.bat program icon and choose Run as
administrator.

3. In the Maintenance panel, choose Configuration Manager.

For more information about any panel in TEM, click the help button .

4. In the Configuration Maintenance panel, select Perform maintenance on an existing


configuration.

5. In the Old Configuration panel, select the configuration you want to modify.

5-2 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Enable TCCS using TEM

6. In the Feature Maintenance panel, under Client Communication System, select Use
Configurations and Environments.

7. In the Client Communication System Switch panel, select the Use Configurations and
Environments check box.

8. In the Configuration Selection for Client Communication System panel, select Private (non-
existing, modifiable).

9. In the Forward Proxy Settings panel, specify whether to use a forward proxy.

If you do not use a forward proxy, select Do not use forward proxy.

10. In the Environment Settings for Client Communication System panel, click Add, and then type
the required information to create the TCCS environment.

Value Description

Name Specifies the name of a the TCCS environment. This name is displayed in
the TCCS logon dialog after configuration is complete.

URI Specifies the URI to the TCCS environment. This is the endpoint URI for
the web tier deployment, for example, http://host:port/tc.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname
in URIs and do not use the literal addresses, so the domain name
system (DNS) can determine which IP address should be used.

Tag Specifies a string identifier for the TCCS environment.


When installing a rich client, you can optionally provide a Client Tag
Filter value to filter the list of environments displayed in the rich client
to those environments that match the filter.
For example, if the Client Tag Filter value is 9*, all TCCS environments
with Tag values beginning with 9 are available to the client host.
Environments with Tag values beginning with 10 are not available.

SSO App ID Specifies the ID of the Security Services application you use with TCCS.

SSO Login URL Specifies the URL to the Security Services application you use with TCCS.
If you use Security Services in applet-free mode, include /tccs at the end
of the URL, for example:

http://host:port/app-name/tccs

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 5-3


© 2021 Siemens
5. Installing TCCS

11. In the Reverse Proxy Settings panel, accept the default values.

12. Proceed to the Kerberos Authentication Settings panel.

If you use Kerberos authentication, enter Kerberos authentication settings.

Value Description

Support Kerberos authentication Specifies you want to use Kerberos authentication for
Teamcenter logon.

Use Krb5 file from default Specifies you want to use the default Kerberos
location configuration file on the host.
On Windows hosts, the default location is C:\Windows.

Use this Krb5 file Specifies you want to use a custom Kerberos
configuration file. If you select this option, enter the
path to the custom Kerberos configuration file.

Always prompt for user ID Specifies you want to always prompt for a Kerberos user
name.
If you want to enable zero sign-on functionality on
Windows hosts, clear this check box. Zero sign-on
allows Windows users to launch a Teamcenter client
without being prompted to log on to Teamcenter.

Note:
• Zero sign-on functionality requires you configure Security Services in applet-free mode.

• You can configure Kerberos authentication in Teamcenter using Security Services in


applet-free mode.

• When configuring TCCS to use Kerberos authentication, a krb5.ini file should not be
specified in the TCCS configuration. Even if specified, the file is not used for Kerberos
configuration.

13. Proceed to the Secure Socket Later (SSL) Settings panel.

If you use SSL, specify SSL settings.

Value Description

Use Internet Explorer Certificate Store Specifies you want to use certificates stored in
(Recommended) Microsoft Internet Explorer.

5-4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install TCCS

Value Description

This option is available only on Windows hosts.

Disable SSL Specifies you want to disable SSL authentication.

Configure Certificate Store Manually Specifies you want to manually configure the
certificate store for Teamcenter.

Configure trust store Contains options for manually configuring the


certificate store for Teamcenter.

Use trust store Specifies you want to use a trust store. If you select
this option, enter the path to file that contains the
trust store you want to use.

Accept untrusted certificates Specifies you want to accept untrusted certificates.

Configure key store Contains options for configuring the keystore for
Teamcenter.

Use key store Specifies you want to use a keystore.


If you select this option, enter the path to the
keystore. Also, specify the file type. The default file
type is JKS.

Additional configuration of SSL for Teamcenter is described in Security Services Installation/


Customization.

14. In the Client Tag Filter panel, accept the default value or type a different value.

The Client Tag Filter specifies a pattern to apply when filtering TCCS environments. Wildcard
characters (*) are allowed.

The Client Tag Filter pattern is compared to the Tag parameters on defined TCCS environments.
Environments that do not fit the pattern are not available to the rich client. For example, if the rich
client Client Tag Filter value is 9.*, all TCCS environments with Tag values beginning with 9. are
available to the rich client. Environments with Tag values beginning with 10 are not available.

15. In the Confirmation panel, review the settings you entered and click Start to apply the
configuration changes.

Install TCCS
1. Make sure the Microsoft Visual C++ redistributable for Visual Studio is installed on the TCCS host.

Install the corresponding redistributable to the certified version of Microsoft Visual Studio stated in
the Hardware and Software Certifications knowledge base article on Support Center.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 5-5


© 2021 Siemens
5. Installing TCCS

2. Locate the software kits for Teamcenter 13.1 and Teamcenter 13. Both are needed to install TCCS.

3. On the Teamcenter 13.1 software kit, change to the additional_applications\tccs_install


directory.

4. In the tccs_install folder, double-click the tccsinst.exe file to launch the TCCS installation program.

5. Proceed to the License Agreement dialog box. Read the terms of the license agreement, and then
select the option to accept the terms of the agreement.

6. If the installation program cannot locate a supported Java Runtime Environment (JRE) on your host,
the program prompts you for the location to a valid JRE.

For certified versions of the JRE for Teamcenter, see the Hardware and Software Certifications
knowledge base article on Support Center.

7. Proceed to the Choose Install Folder dialog box. Enter the location in which you want to install
TCCS.

8. In the FCC Settings dialog box, type information about the FMS server caches (FSCs) your host
connects to.

Value Description

Protocol Specifies the communication protocol of the parent FSC. The default
value is HTTP.

Host Specifies the host name of the parent FSC.

Port Specifies the number of the port used by the parent FSC.

Path Specifies the path to the FSC on the parent FSC host.

The FCC can connect to multiple FSCs. To add an additional FSC, click Add and type the values for
the FSC. To remove an FSC from the list, select the row in the table and click Remove.

If you use multiple FSCs, specify a connection priority for each in the Priority column.

9. Proceed to the Setup Type dialog box.

If you want to specify settings for forward or reverse proxies for the TCCS environment, select the
Advanced Configuration check box.

10. If you selected the Advanced Configuration check box in step 9, enter advanced configuration
settings. Otherwise, skip this step and proceed to step 12.

5-6 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install TCCS

a. In the Configuration Selection dialog box, specify whether to create a shared or private TCCS
configuration.

If both the shared and the private TCCS configurations exist, the private configuration takes
precedence. If both shared and private TCCS configurations exist, modifying the shared
configuration may have no effect on clients because the private configuration takes
precedence. Shared configurations may be edited only by administrators.

You can configure TCCS environments further after installation is complete.

b. In the Forward Proxy Settings dialog box, enter information about the TCCS forward proxy.

Value Description

Do not use forward proxy Specifies that you do not want to use a forward
proxy.

Use web browser settings Specifies that you want to use proxy settings from
your web browser.

Detect settings from network Specifies that you want to use proxy settings from
your local network.

Retrieve settings from URL Specifies that you want to obtain settings from a
proxy autoconfiguration (PAC) file.

Proxy URL Specifies the URL to the PAC file from which you
want to obtain proxy settings.

Configure settings manually Specifies that you want to enter proxy settings
manually.

All Protocols Host Specifies a name of a valid proxy to use for all
protocols. In the accompanying Port box, type the
port used by the proxy host.

HTTP Proxy Host Specifies the host of a forward proxy server for the
HTTP protocol. In the accompanying Port box, type
the port used by the proxy host.

HTTPS Proxy Host Specifies the host of a forward proxy server for the
HTTPS protocol. In the accompanying Port box, type
the port used by the proxy host.

Exceptions Specifies a semicolon-delimited list of host names


and IP addresses to exempt. This box is optional.
This list can be used to send requests for local
endpoints directly to the destination server without
going through a forward proxy that is used for
endpoints outside the company intranet. For
example, this could allow direct access to a

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 5-7


© 2021 Siemens
5. Installing TCCS

Value Description

Teamcenter web tier hosted within the company


while going through a forward proxy to access a
Teamcenter web tier hosted by a business partner.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use
the literal addresses, so the domain name system (DNS) can determine which IP address
should be used.

c. In the Environment Settings dialog box, type information about defined TCCS environments.
Click Add to add a row to the table, and then type the required values.

Value Description

Name Specifies the name of a the TCCS environment.

URI Specifies the URI to the TCCS environment.

Tag Specifies a pattern to apply when filtering the list of


available TCCS environments.
When you create TCCS environments, you can use this value
to tag a TCCS environment with a string identifier. When
installing a rich client, you can optionally provide a Client
Tag Filter value to filter the list of environments displayed
in the rich client to those environments that match the
filter.
For example, if the client Client Tag Filter value is 9*, all
TCCS environments with Tag values beginning with 9 are
available to the client host. Environments with Tag values
beginning with 10 are not available.

SSO Login URL Specifies the URL to the Security Services application you
use with TCCS.

SSO APP ID Specifies the ID of the Security Services application you use
with TCCS.

Note:
If your network uses IPv6 (128-bit) addresses, use the hostname in URIs and do not use
the literal addresses, so the domain name system (DNS) can determine which IP address
should be used.
You can configure TCCS environments further after installation is complete.

5-8 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install TCCS

d. Proceed to the Reverse Proxy Settings dialog box.

Teamcenter uses reverse proxy settings to detect a logon web page from a reverse proxy
server through which Teamcenter services are accessed.1

The criteria table lists the reverse proxy criteria currently defined. Each row of the table is a
criteria XML element defined in the specified format. By default, the table is blank and no
criteria are defined. A criterion string is of the following form:

Header_Name1, Header_Value1, Header_Name2, Header_Value2,…:Form_Action

Each criterion must contain at least one header name/header value pair or at least a single
form action.

To add a criterion to the table, perform the following steps:

A. Click Add.

You can click Remove to remove an existing criterion from the table, or click Edit to edit
an existing criterion.

B. In the Criteria Details table, add HTTP header names and values for criterion you want
to add.

C. In the Form Action box, specify a form action.

D. Click OK to add the criterion or Cancel to abandon your changes.

E. Configure your reverse proxy server if necessary.

e. Proceed to the Kerberos Support dialog box.

If you use Kerberos, enter Kerberos authentication settings.

Value Description

Support Kerberos authentication Specifies you want to use Kerberos authentication


for Teamcenter logon.

Use this Krb5 file Specifies you want to use a custom Kerberos
configuration file. If you select this option, enter the
path to the custom Kerberos configuration file.

Use default settings Specifies you want to use the default Kerberos
configuration file on the host.

1 The installer writes criteria definitions to the reverseproxy_cfg.xml file.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 5-9


© 2021 Siemens
5. Installing TCCS

Value Description

On Windows hosts, the default location is


C:\Windows.

Note:
Kerberos is a network authentication protocol that uses a system of tickets to allow
nodes communicating over nonsecure networks to securely verify identities of each
side. Using a client-server model, it provides mutual authentication: the user and the
server verify each other's identities.
When configuring TCCS to use Kerberos authentication, a krb5.ini file should not be
specified in the TCCS configuration. Even if specified, the file is not used for Kerberos
configuration.

11. In the Secure socket layer (SSL) settings dialog box, enter SSL settings.

Value Description

Use Internet Explorer Certificate Store Specifies you want to use certificates stored in
(Recommended) Microsoft Internet Explorer.
This option is available only on Windows hosts.

Disable SSL Specifies you want to disable SSL authentication.

Configure Certificate Store Manually Specifies you want to manually configure the
certificate store for Teamcenter.

Configure trust store Contains options for manually configuring the


certificate store for Teamcenter.

Use trust store Specifies you want to use a trust store. If you select
this option, enter the path to file that contains the
trust store you want to use.

Accept untrusted certificate Specifies you want to accept untrusted certificates.

Configure key store Specifies you want to configure a keystore for


Teamcenter.
If you select the Configure key store check box, enter
keystore configuration values.
The File and Type boxes are hidden if Configure key
store is not selected.

File Specifies the path to the keystore file.

Type Specifies the file type. Choose JKS or PLCS12. The


default file type is JKS.

5-10 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Install TCCS

Further configuration of SSL for Teamcenter is described in Security Services Installation/


Customization.

12. In the Pre-Installation Summary dialog box, review your selections. If you want to change any
selections, click Previous. Otherwise, click Install to begin installing TCCS.

13. When installation is complete, click Done to close the installation wizard.

14. If you install TCCS on a Windows 10 host, restart the system to enable the FMS_HOME
environment variable.

Configure a reverse proxy server

If you must connect to a Teamcenter environment through a reverse proxy server (such as WebSEAL or
SiteMinder), you may need to configure reverse proxy settings for TCCS.

• If you use SiteMinder, you must configure TCCS to detect form-based challenges originating from the
reverse proxy by selecting the Check Headers check box.
This setting also applies to other reverse proxy servers that do not send specific header information in
the 200 form-based challenge.

• If you use WebSEAL and you deploy the TCCS configuration, add the following criterion to the table.

Header name Header value Form action

server webseal /pkmslogin.form

This is required because the settings in the deployed reverseproxy_cfg.xml override the default
WebSEAL configuration.
If you do not deploy the TCCS configuration, TCCS uses the default WebSEAL configuration, so this
manual configuration is not required.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 5-11


© 2021 Siemens
5. Installing TCCS

5-12 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
A. Troubleshooting
The following table describes solutions to possible problems you may encounter during rich client
installation.

Problem Possible cause Solution

TEM does not JRE path is not set in the Set the JRE_HOME or JRE64_HOME environment
start, reports JRE system environment. variable to specify the path to the required Java
not found. Runtime Environment (JRE).

JRE path is set incorrectly in Make sure the path specified in the JRE_HOME or
the system environment. JRE64_HOME environment variable is correct.

The specified JRE has been If you installed a new Java Runtime Environment
removed from the system. (JRE) and removed the previous JRE after you
installed Teamcenter, TEM cannot find the JRE,
even if JRE_HOME or JRE64_HOME is set correctly.
To resolve this problem, perform the following
steps.

1. Open the following file in a plain text editor:

TC_ROOT\install\tem_init.bat

2. Locate the following line in the file:

set TC_JRE_HOME=jre_location

3. Replace jre_location with the path to the new


JRE.

4. Save and close the file.

5. Migrate Teamcenter to the new JRE.

To avoid this problem in the future, do not remove


your previous JRE until after you complete
migrating Teamcenter to the new JRE.

TEM reports the The installation drive Change the Installation Directory to a path with
installation path specified in the Installation no spaces, or to a path on a drive that supports 8.3
must not contain Directory does not support file names.
spaces. short file names (8.3
convention). TEM requires
this capability.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 A-1


© 2021 Siemens
A. Troubleshooting

Problem Possible cause Solution

Tip:
To determine whether support for the 8.3 file
name convention is enabled for a given
drive, type the following command in a
command prompt:

fsutil 8dot3name query


drive-letter

FCC does not start Incorrect Internet Explorer Ensure that installing on demand is enabled:
browser setting
Tools→Internet Options→Advanced→
Install on Demand

Ensure that scripting of Java applets is enabled:

Tools→Internet Options→Security→
Custom Level→Scripting of Java Applets

Incorrect browser setting Ensure that Enable Java is enabled (checked).


Ensure that Enable JavaScript for Navigator is
enabled (checked).

Visual C++ libraries are Open a Teamcenter command prompt and enter
missing on the client host. the following command:

fccstat.exe -status

If the utility returns the following message:

The program can't start because


MSVCR120.dll is missing from your
computer.
Try reinstalling the program to
fix this
problem.

Install the Microsoft Visual C++ Redistributable for


Visual Studio on the client host.

Errors when FMS_HOME environment Uninstall the rich client, then reinstall the rich
uploading or variable does not point to client.
downloading files the location of the File

A-2 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Problem Possible cause Solution

Management System (FMS)


client executables Caution:

Incomplete installation of Always uninstall a rich client using this


FMS client cache procedure before installing a new rich client.
executables

Incompatible configurations If two rich clients are installed on the workstation,


of FMS report the errors to the Teamcenter administrator.
When two rich clients are installed on the same
workstation, FMS uses the FMS_HOME value set
during the first installation. The configuration of
the file client cache (FCC) to a file server cache
(FSC) must support both deployments, especially if
the second deployment is to a different database.

Teamcenter Online help is not Configure online help access for the rich client.
displays an error configured correctly for the
message when rich client.
you attempt to
access
Teamcenter online
help

Logon to two-tier The port the rich client Restrict the TcServer process to a specified range
rich client fails assigned to the TcServer of ports:
process is already in use by
some other process, 1. Open the TC_ROOT\iiopservers
resulting in an error similar \start_TcServer1.bat file.
to the following:
2. Locate the TcServer launch statement, which
Login was resembles the following example:
unsuccessful:
Problems encountered
logging %TC_ROOT%\bin\tcserver.exe
into TCServer:TCData -ORBInitRef
Cause: Unable to
bind server ImplRepoService=corbaloc:iiop:localho
running on st:1572
localhost:1572 /ImplRepoService id=TcServer1
useImR -ORBUseIMR 1
-ORBDottedDecimalAddresses 1

3. Add the following text to this statement:

-ORBListenEndpoints iiop://
localhost:intial-port/portspan=port—range

Replace initial-port with the starting port for


the search, and port-range with the number

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 A-3


© 2021 Siemens
A. Troubleshooting

Problem Possible cause Solution

of ports to search beyond the initial port. For


example, if you want the rich client to search
ports 3003 through 3203, add the following
text:

-ORBListenEndpoints iop://
localhost:3003/portspan=200

4. Save the changes, and then launch the rich


client.

Relogon to a four- If the Teamcenter enterprise Possible resolutions include disabling the firewall
tier rich client is tier runs on a Windows and configuring the firewall not to suppress TCP
slow. server host with a firewall connection reset (RST) packets in response to
that silently ignores TCP connection attempts to closed ports. A workaround
SYN messages to ports that for the rich client is to turn off SOA shared sessions
are not open, there can be a (set shareSession=false in the
significant delay (20-40 site_specific.propertes file).
seconds) in Teamcenter
request processing in
certain cases. In particular, a
delay is likely if a user logs
off and then logs back on
within a short time period or
if a user's Teamcenter server
has timed out and the client
reconnects. Trend Micro
Personal Firewall and the
stealth mode of Windows
Firewall are known to
exhibit this behavior.

A-4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
B. Uninstalling Teamcenter
Uninstall the rich client using TEM
If you installed the rich client (two-tier or four-tier) using Teamcenter Environment Manager (TEM),
uninstall it using TEM.

If you installed the rich client silently, you may only uninstall it through the TEM interface. Silent
uninstallation is not supported.

1. Log on to the operating system using the user account under which you installed Teamcenter.

2. Start Teamcenter Environment Manager (TEM):

Start→Programs→Teamcenter 13→Environment Manager

You can also run the tem.bat file in the install directory in the application root directory for the
Teamcenter installation.

3. In the Configuration Maintenance panel, select Remove Configuration (uninstall), then click
Next.

4. In the Old Configuration panel, select the configuration you want to remove, then click Next.

5. In the Uninstall panel, select Yes to confirm that you want to uninstall the configuration. Click
Next.

6. In the Uninstall Teamcenter panel, select the Advanced Uninstall Options check box if you want
to view additional uninstall options. Otherwise, click Next.

7. In the Confirmation panel, click Start to begin the uninstallation.

Uninstall Microsoft Office interfaces

Choose the appropriate uninstallation method

Uninstall Teamcenter Microsoft Office interfaces using the method that reflects how you installed the
interfaces.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 B-1


© 2021 Siemens
B. Uninstalling Teamcenter

Method Description

Windows Control Panel If you installed Microsoft Office interfaces using stand-alone
installation wizards, uninstall them using the Add or Remove
Programs dialog box in the Windows Control Panel.

Teamcenter Environment Manager If you installed Microsoft Office interfaces using TEM,
(TEM) uninstall them using TEM.

Uninstall Microsoft Office interfaces using Windows Control Panel

1. Open the Add or Remove Programs dialog box in the Windows Control Panel.

2. Select the programs you want to remove and click Change/Remove:

Teamcenter Client for Office


Teamcenter Applications for Microsoft Office

Note:
Selecting this item uninstalls Teamcenter Extensions for Microsoft Office and
Teamcenter Plugin for Microsoft Project.

Uninstall Microsoft Office interfaces using TEM

1. Log on to the operating system with the Teamcenter user account you created for installing and
maintaining the Teamcenter installation.

2. Start Teamcenter Environment Manager (TEM):

Start→Programs→Teamcenter 13→Environment Manager

3. In the Maintenance panel, select Configuration Manager.

4. If you installed Microsoft Office interfaces as part of a Teamcenter rich client configuration, you
can remove the Teamcenter configuration or just remove Microsoft Office interfaces from the rich
client configuration.

• To remove the Teamcenter configuration, perform the following steps:

a. In the Configuration Maintenance panel, select Remove configuration (uninstall), and


then click Next.

b. In the Old Configuration panel, select the configuration you want to remove, and then
click Next.

B-2 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Uninstall TCCS

c. In the Uninstall panel, select Yes to confirm that you want to uninstall the configuration.
Click Next.

d. In the Uninstall Teamcenter panel, select the Advanced Uninstall Options check box if
you want to view additional uninstall options. Otherwise, click Next.

e. In the Confirmation panel, click Start to begin the uninstallation.

• To remove Microsoft Office interfaces from the configuration, perform the following steps:

a. In the Configuration Maintenance panel, select Perform maintenance on an existing


configuration, then click Next.

b. In the Old Configuration panel, select the configuration you want to modify.

c. In the Feature Maintenance panel, choose Add/Remove Features.

d. In the Features panel, clear the check boxes for the Microsoft Office interface features you
want to remove:

Extensions→Enterprise Knowledge Foundation→Teamcenter Client for Microsoft


Office

Extensions→Systems Engineering and Requirements Management→Teamcenter


Extensions for Microsoft Office

e. Proceed through the remaining panels in TEM, entering required information as needed.

f. In the Confirmation panel, click Start to begin uninstalling features.

Uninstall TCCS
If you installed Teamcenter client communication system (TCCS) as part of an installation of the rich
client or Teamcenter Microsoft Office interfaces, uninstalling those clients automatically uninstalls TCCS
from your system.

If you installed TCCS using the stand-alone installation wizard, perform the following steps to uninstall
TCCS.

1. Stop the FMS client cache (FCC) process:

a. Open a command prompt.

b. Change to the \tccs\bin directory in the TCCS installation directory.


The default TCCS installation directory is C:\Program Files\Siemens\Teamcenterversion\tccs.

Teamcenter Client Installation on Windows, Teamcenter 13.1 PLM00012 13.1 B-3


© 2021 Siemens
B. Uninstalling Teamcenter

c. Type the following command:

fccstat -stop

After stopping the FCC process, the fccstat command reports that the FCC is offline.

d. Close the command prompt.

2. Uninstall TCCS:

a. In the Windows Control Panel, open the Add or Remove Programs dialog box.

b. In the list of installed programs, select and remove Teamcenter client communication
system.

c. Restart the system to unset the FMS_HOME environment variable.

B-4 PLM00012 13.1 Teamcenter Client Installation on Windows, Teamcenter 13.1


© 2021 Siemens
Siemens Digital Industries 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 Digital Industries Software


Siemens Digital Industries Software is a leading global provider of product life cycle management
(PLM) software and services with 7 million licensed seats and 71,000 customers worldwide.
Headquartered in Plano, Texas, Siemens Digital Industries Software works collaboratively with
companies to deliver open solutions that help them turn more ideas into successful products. For
more information on Siemens Digital Industries Software products and services, visit
www.siemens.com/plm.
This software and related documentation are proprietary and confidential to Siemens.
© 2021 Siemens. A list of relevant Siemens trademarks is available. Other trademarks belong to
their respective owners.

You might also like