Teamcenter 13.1 Window Client Installation Guide
Teamcenter 13.1 Window Client Installation Guide
Installation on
Windows
PLM00012 - 13.1
Contents
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
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.
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:
For example:
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.
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.
Microsoft Windows • • •
(desktop platforms)
SUSE 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:
1 Teamcenter client communication system (TCCS) is installed with the rich client. This column refers to the stand-alone
TCCS application.
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.
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.
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:
For example:
Install the required software for the Teamcenter web tier you use:
Some web application servers require special configuration for use with Teamcenter.
Web browser
• Deployment Center
• 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.
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.
http://domain/en-US/product/282219420/doc/PL20200604175134771.xid1899404/html/
xid1899405
Replace domain with the source from which you access online help:
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.
For more information about using Teamcenter with NX, see the installation guides distributed with
NX.
• Lifecycle Visualization
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.
Teamcenter architectures
Four-tier architecture
• 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
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.
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
• 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:
• 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
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:
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 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.
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:
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.)
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.
Deployment Center
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.
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.
For more information about any panel in TEM, click the help button .
The Web Application Manager is a tool that builds Teamcenter Java EE web applications.
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.
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.
• 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.
Install a four-tier rich client that connects to the Teamcenter web tier using HTTP protocol or Teamcenter
client communication system (TCCS).
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.
In the Teamcenter 13.1 software kit, right-click the tem.bat program icon and choose Run as
administrator.
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.
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.)
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.
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.
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.
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.
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.
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
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.
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.
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:
Each criterion must contain at least one header name/header value pair or at least a single form
action.
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.
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.
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.
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.
Type Specifies the file type. Choose JKS or PLCS12. The default
file type is JKS.
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
Replace domain with the source from which you access online help:
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.
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 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.
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.
In the Teamcenter 13.1 software kit, right-click the tem.bat program icon and choose Run as
administrator.
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.
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.)
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.
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.
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
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.
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.
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:
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.
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 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.
In the Teamcenter 13.1 software kit, right-click the tem.bat program icon and choose Run as
administrator.
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.
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 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.
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.
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
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.
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
Value Description
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.
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.
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:
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.
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.
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).
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:
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:
6. Click the language you want to see in the user interface in the Language Preference dialog box.
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.
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:
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:
Alternatively, on Windows systems, you can customize the properties for the Teamcenter rich client
desktop shortcut icon to specify a desired language:
2. Choose Properties.
A properties dialog box is displayed.
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
becomes:
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.
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.
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.
3. Add the following line to the file to set the UseDefaultSwingFonts property.
UseDefaultSwingFonts=true
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.
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.
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:
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).
Note:
To enable online help for the rich client, you must first install the required online help software.
Add features
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.
4. In the Old Configuration panel, select the configuration you want to modify.
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.
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.
4. In the Old Configuration panel, select the configuration you want to modify, 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.
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.
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.
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.
<call %TC_DATA%\tc_profilevars>
3. Add the following statements after this line to set GM Overlay environment variables:
If you installed additional features for Teamcenter Automotive Edition–GM Overlay, configure these
features as necessary.
set QPL_USER=qpl-user Replace qpl-user with the site QPL user name;
the default is qpl.
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.
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:
• 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.
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.
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.
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.
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.
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.
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.
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.
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.
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" />
</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"
/>
</features>
</config>
<updateManager />
</root>
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.
Teamcenter Client for Microsoft Office requires the following software on your client host:
• Microsoft Visual Studio Tools for Office (VSTO) for 64-bit Windows.
• 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.
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:
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
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.
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 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.
a. In the Forward Proxy Settings dialog box, enter information about the TCCS forward proxy.
Value Description
Use web browser settings Specifies that you want to use proxy settings from
your web browser.
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.
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.
Value Description
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.
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:
Each criterion must contain at least one header name/header value pair or at least a single
form action.
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.
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.
Value Description
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
Value Description
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.
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.
Value Description
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.
12. In the Setup Type dialog box, select whether to enable Security Services with Client for Office.
Value Description
SSO Server Host Specifies the server host for 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.
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).
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.
In the Teamcenter 13.1software kit, right-click the tem.bat program icon and choose Run as
administrator.
For information about any panel in TEM, click the help button .
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.
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.
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.
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.
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.
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.
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.
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.
1. Open the Add or Remove Programs dialog box in the Windows Control Panel.
Note:
Selecting this item uninstalls Teamcenter Extensions for Microsoft Office and
Teamcenter Plugin for Microsoft Project.
1. Log on to the operating system with the Teamcenter user account you created for installing and
maintaining the Teamcenter installation.
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.
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.
• To remove Microsoft Office interfaces from the configuration, perform the following steps:
b. In the Old Configuration panel, select the configuration you want to modify.
d. In the Features panel, clear the check boxes for the Microsoft Office interface features you
want to remove:
e. Proceed through the remaining panels in TEM, entering required information as needed.
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.
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
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.
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.
Patching Client for Office requires uninstalling the client and reinstalling it using the updated version of
Teamcenter Environment Manager (TEM).
Tc13.1.0_patch_number_wntx64.zip
Tc13.1.0_patch_number_install.zip
a. Copy the TEM patch kit ZIP file to the TC_ROOT\install directory on your Teamcenter client
host.
c. Expand the TEM patch kit ZIP file, overwriting existing files:
unzip –o Tc13.1.0_patch_number_install.zip
Note:
If errors occur while expanding the file, do one of the following tasks:
• 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.
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.
Teamcenter Extensions for Microsoft Office requires the following software on your client host:
• 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.
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.
The Microsoft Office installer may prompt you to insert the Microsoft Office CD-ROM to apply the
changes.
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
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.
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.
1. Install the prerequisite software on the client host. Teamcenter Environment Manager (TEM)
does not install the prerequisite software.
Alternatively, you can install Extensions for Office from a compact distribution.1
3. Start TEM:
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.
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.
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 requires uninstalling the software and reinstalling it using a patched
installation program.
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
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.
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 requires uninstalling the software and reinstalling it using the updated
version of Teamcenter Environment Manager (TEM).
Tc13.1.0_patch_number_wntx64.zip
Tc13.1.0_patch_number_install.zip
a. Copy the TEM patch kit ZIP file to the TC_ROOT\install directory on your Teamcenter client
host.
c. Expand the TEM patch kit ZIP file, overwriting existing files:
unzip –o Tc13.1.0_patch_number_install.zip
Note:
If errors occur while expanding the file, do one of the following tasks:
• 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.
An FCC also supports Lifecycle Visualization file streaming, which downloads portions of JT files over the
network as they are needed.
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.
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.
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.
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.
For more information about any panel in TEM, click the help button .
5. In the Old Configuration panel, select the configuration you want to modify.
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.
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
11. In the Reverse Proxy Settings panel, accept the default values.
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.
• 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.
Value Description
Use Internet Explorer Certificate Store Specifies you want to use certificates stored in
(Recommended) Microsoft Internet Explorer.
Value Description
Configure Certificate Store Manually Specifies you want to manually configure 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.
Configure key store Contains options for configuring the keystore for
Teamcenter.
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.
2. Locate the software kits for Teamcenter 13.1 and Teamcenter 13. Both are needed to install TCCS.
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.
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.
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.
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.
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.
Value Description
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
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.
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:
Each criterion must contain at least one header name/header value pair or at least a single
form action.
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.
Value Description
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.
Value Description
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.
Configure Certificate Store Manually Specifies you want to manually configure 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.
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.
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.
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.
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.
TC_ROOT\install\tem_init.bat
set TC_JRE_HOME=jre_location
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.
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:
FCC does not start Incorrect Internet Explorer Ensure that installing on demand is enabled:
browser setting
Tools→Internet Options→Advanced→
Install on Demand
Tools→Internet Options→Security→
Custom Level→Scripting of Java Applets
Visual C++ libraries are Open a Teamcenter command prompt and enter
missing on the client host. the following command:
fccstat.exe -status
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
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
-ORBListenEndpoints iiop://
localhost:intial-port/portspan=port—range
-ORBListenEndpoints iop://
localhost:3003/portspan=200
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.
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.
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.
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.
1. Open the Add or Remove Programs dialog box in the Windows Control Panel.
Note:
Selecting this item uninstalls Teamcenter Extensions for Microsoft Office and
Teamcenter Plugin for Microsoft Project.
1. Log on to the operating system with the Teamcenter user account you created for installing and
maintaining the Teamcenter installation.
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.
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.
• To remove Microsoft Office interfaces from the configuration, perform the following steps:
b. In the Old Configuration panel, select the configuration you want to modify.
d. In the Features panel, clear the check boxes for the Microsoft Office interface features you
want to remove:
e. Proceed through the remaining panels in TEM, entering required information as needed.
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.
fccstat -stop
After stopping the FCC process, the fccstat command reports that the FCC is offline.
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.
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