Академический Документы
Профессиональный Документы
Культура Документы
Teamcenter 11.2
Teamcenter Rapid
Start Installation for
Windows
PLM00501 • 11.2
Contents
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Figures
Tables
Teamcenter clients
Teamcenter Rapid Start provides a rich client and a thin client suited to various uses and network
configurations.
• Rich client
The rich client is a platform-independent client implementation (Java application) for users who
interact with Teamcenter frequently. It is extendable to run standard Teamcenter and customized
applications.
The rich client application is deployed on each user workstation using Teamcenter Environment
Manager. The rich client is supported in both the two-tier architecture and four-tier architecture.
• Thin client
The thin client provides access to Teamcenter through a standard commercial web browser, such
as Microsoft Internet Explorer or Mozilla Firefox. The user interface provides a streamlined
browser-based view of product information stored in a Teamcenter database.
The thin client is supported only in the four-tier architecture.
Four-tier architecture
The four-tier architecture model comprises the following tiers:
• Client tier
The client tier comprises the Teamcenter rich client, thin client, and other clients such as
Teamcenter Client for Microsoft Office.
Note
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 4.0.1. (Teamcenter Integration for NX/NX Integration 3 is not supported.)
• 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.
Note
Teamcenter provides server managers based on Microsoft .NET platforms. Install the
appropriate server manager for the web tier you use.
• 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.
If you are setting up multiple web tier environments with separate domains, you must configure:
• A minimum of one server manager for each web tier deployment.
The JMX HTTP adapter allows you to view the status of the server pool and dynamically alter the pool
configuration values (the values are not persistent). Access this functionality from the following URL:
http://host-name:jmx-port
Replace host-name with the name of the host running the server manager. Replace jmx-port with the
number of the port running the JMX HTTP adapter.
The first time you log on to the adapter, use manager for both the user name and the password. You
can change the user name and password to unique values using the adapter.
Teamcenter File Management System (FMS) manages the rich client access to volumes:
• The FMS client cache (FCC) process runs on the rich client host.
• The FMS server cache (FSC) process runs on each server hosting a volume and each server
hosting a pool of Teamcenter servers (TcServer).
Note
If you install File Management System, the FMS server cache (FSC) and the server manager
must run on the same host server, with the same user ID.
Four-tier deployment (enterprise and web tiers on separate hosts with HTTP server)
Four-tier deployment (multiple enterprise tier hosts and web tier hosts)
Two-tier architecture
• Client tier
Note
• 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
The following table describes the Teamcenter Rapid Start server installation components.
The following table describes the Teamcenter Rapid Start client installation components.
• A supported Java EE web application server (if you use the Java EE web tier)
• Microsoft Internet Information Services (IIS) (if you use the .NET web tier)1
For information about supported versions of operating systems, databases, and web application
servers, see the hardware and software certifications page on GTAC.
Quick installation
The quick installation option installs the most commonly used components and is an efficient way to
get Teamcenter Rapid Start up and running. If you want to install custom options after performing the
quick installation, you can run the installation program again to add the options.
The quick server installation performs the following tasks:
• Installs the following templates: Teamcenter Foundation and Dispatcher (Translation Services).
• Installs a thin client for accessing Teamcenter Rapid Start through a web browser (Internet
Explorer), if Internet Information Server (IIS) is installed.
• Connects to the database server and configures a new database or connects to an existing
database, if applicable.
• Creates a default volume (directory to store and manage data files) and a Windows Service
to manage volume access.
1. You need not install IIS if you do not use the thin client.
• Configures Dispatcher.
Custom installation
The custom server installation allows you to select individual options for your installation.
CAD applications
If you use NX, you must install it on individual workstations prior to installing the Teamcenter Rapid
Start client. The client installation detects NX and installs the appropriate CAD manager components.
If you plan to use supported integrations other than NX, they are available as separate installation
packages and are not included in the Teamcenter Rapid Start client installation.
Quick installation
The quick client installation option installs the most commonly used client components and performs
the following tasks:
• Installs the Teamcenter Rapid Start rich client application.
Custom installation
The custom client installation allows you to select individual options in addition to the typical
installation.
https://support.industrysoftware.automation.siemens.com/docs/teamcenter/
When deployed on your local intranet, the PLM Documentation Server can host online help for multiple
languages and multiple Siemens PLM Software products. It provides a fast, powerful, server-based
search engine and significantly improved overall performance over previous Teamcenter help.
and you can add localized Teamcenter help and also help for other Siemens PLM Software products
you use.
After you install Teamcenter documentation, you can configure online help access for Teamcenter
clients during Teamcenter installation or after installation. Teamcenter clients can then access help on
the PLM Documentation Server through the client Help menus.
Note
• The Teamcenter PDF help collection and the Teamcenter developer references are not
accessible though Teamcenter client Help menus.
If you use Teamcenter documentation in multiple languages, you can install all languages on the
same PLM Documentation Server. The PLM Documentation Server displays the appropriate
language according to each user's web browser language settings.
Before you install Teamcenter help, make sure your host meets PLM Documentation Server
requirements.
The following documentation deliverables are provided by Teamcenter but are not installed in the
PLM Documentation Server:
• Teamcenter Client for Microsoft Office
The Teamcenter Client for Microsoft Office contains its own online help, which is displayed in
Microsoft Office.
2. Select a language for the installation user interface, and then click OK.
3. Proceed to the Destination Folder dialog box. Accept the default destination folder (C:\Program
Files\Siemens\PLM Documentation Server\), or click Change to enter a different folder.
4. Proceed to the Ready to Install the Program dialog box. Accept the default port for the PLM
Documentation Server (8181), or click Change Port to specify a different port.
6. In the InstallShield Wizard Completed dialog box, click Finish to exit the wizard.
Note
For additional information about installing the PLM Documentation Server, including advanced
installation options, see the splmdocserver_install.pdf document in the wntx64 (Windows
systems) or unix (UNIX/Linux systems) directory under the splmdocserver directory in the
documentation distribution image.
The PLM Documentation Server starts automatically when installation is complete and whenever
you restart Windows. If necessary, you can stop or start the Siemens PLM Documentation Server
service in the Services dialog box in the Windows Control Panel.
Note
You must install the Siemens PLM Documentation Server before you install online help.
UNIX/Linux systems:
Launch the tchelp.bin program.
2. Select a language for the installation user interface, and then click OK.
The wizard displays the Introduction dialog box.
• Custom installs the Teamcenter online help library and allows you to add the following
help features:
o Teamcenter PDF help collection
o Teamcenter developer references.2
Note
You can also add help features later using the maintenance options provided by the
Teamcenter documentation installer.
2. Developer references include the C++ API Reference, the Integration Toolkit (ITK) Function Reference, and the Services Reference.
4. If you chose the Custom option, select the additional features you want to install.
5. Proceed to the Pre-Installation Summary dialog box. If you are satisfied with your selections,
click Install to begin installing Teamcenter documentation.
The Teamcenter documentation installer installs Teamcenter help into the PLM Documentation
Server and updates the online help search database.
6. When installation is complete, the Teamcenter documentation installer displays the Online
Help Locations dialog box.
Record the Teamcenter Online Help URL. You use this URL to configure online help access for
Teamcenter clients.
If you install additional help features, bookmark the URLs for those help collections and provide
them to users in your Teamcenter network.
Online help URLs are based on the host and port of the PLM Documentation Server and the
Teamcenter version or SP level.
Note
Help URLs are valid only for help features that are installed.
7. Click Next to proceed to the Install Complete dialog box. Then, click Done to exit the installer.
You can add help features after installation by launching the Teamcenter documentation installer in
maintenance mode.
1. In the Add or Remove Programs dialog box in the Windows Control Panel, right-click Siemens
Teamcenter version Documentation and choose Uninstall/Change.
2. Select the Add Features or Remove Features option in the Teamcenter documentation installer.
4. In the PLM Document Server URL box, type the Teamcenter online help URL.
When you create the rich client distribution instance, type values for the following context
parameters.
Note
You must install the Siemens PLM Documentation Server before you install online help. The
Siemens PLM Documentation Server installer is provided only in the English documentation
distribution image. It is not provided in localized documentation distribution images.
The Teamcenter online help library and the Teamcenter PDF help collection are localized for
all supported locales. The Teamcenter developer references are available in English only.
The PLM Documentation Server displays localized Teamcenter help according to the language
settings in your web browser.
When you open a Teamcenter help collection, the PLM Documentation Server detects your web
browser's language settings. For example, if your browser is configured to display in German, the
PLM Documentation Server determines whether the German version of the current collection is
installed, and if so, it displays the German version of the content. If the German version is not
installed, the PLM Documentation Server displays the default (English) help collection.
If you have multiple languages configured in your web browser, the PLM Documentation Server
chooses the first available help collection it finds from the list of preferred languages in the web
browser settings.
For information about configuring language settings in your web browser, see your web browser
documentation.
Preinstallation tasks
• On the local host, create an operating system account with administrative privileges for installing
Teamcenter Rapid Start.
This user should be a member of the Administrators group.
• Obtain the Teamcenter Rapid Start license file, copy it onto the corporate server host, and
configure the file with the name of the corporate server host.
Record the location of the license file for use during corporate server installation.
• Make sure you have the following information from the database administrator:
o Name of the host on which the database server runs.
o If you must use an existing database user, obtain the database user name and password.
• Make sure the server host is connected to the network during Rapid Start installation. During the
installation, TEM creates a default volume in the given share directory, and the share directory is
accessed using a UNC path.
• Set the JRE64_HOME environment variable to the location of a supported 64-bit Java JRE. After
installation is complete, TEM no longer requires this variable.
TEM verifies the JRE version during launch and cancels installation if a certified JRE is not
available on the host.
Note
Alternatively, you can specify the Java JRE location by one of the following methods:
o Set the JRE_HOME environment variable to the location of a supported 64-bit Java
JRE.
o When you launch TEM type the following command in a command prompt using the
-jre argument to specify the location of a supported 64-bit Java JRE:
tem -jre JRE-path
For example:
tem -jre c:\apps\jre1.7
Expand both ZIP files for your platform to a common directory to assemble the full software
distribution before you begin installation.
In addition, download the rich client over-the-web distribution image (Tcversion_otw.zip) from the
GTAC download page.
Note
• Contents of Teamcenter distribution images are described in the server installation guides
for Windows and UNIX/Linux.
When performing an English installation of Teamcenter Rapid Start, all existing databases
must have Latin1 collation.
1. Log on to the workstation with the operating system user account you created for installing
Teamcenter Rapid Start.
2. Start Teamcenter Environment Manager (TEM) to begin installing Teamcenter Rapid Start:
a. Browse to the root directory of the Teamcenter installation media.
Do not use the Windows Run as option to run the Teamcenter Rapid Start setup
program as a user with administrator privileges. To successfully install and configure
Teamcenter Rapid Start, you must log on as a user with administrator privileges.
c. In the Installer Language dialog box, select a language and click OK.
Your language selection applies only to the TEM session, not the Teamcenter installation.
5. In the Product Selection panel, select Teamcenter Corporate Server and Teamcenter Rich
Client 2-Tier.
If you want to add Teamcenter Rapid Start features not automatically included in the quick
preconfigured installation, select the Include additional features check box. If you select
additional features, TEM may display additional panels not described in this procedure.
6. In the Teamcenter Corporate Server and Teamcenter Rich Client 2-Tier panel, enter the
following values:
a. Type the OS User Password for the operating system user account you created for installing
Teamcenter Rapid Start.
b. Select Database Type according to your database vendor (Oracle, Microsoft SQL Server, or
IBM DB2).
c. Enter database access credentials and configuration values for the Teamcenter Rapid Start
database. For more information about these values, click the help button .
d. In the Character Encoding Type box, make sure the selected character set is correct for
your database server. Teamcenter clients use this character set to access the database.
Caution
To prevent data corruption, this character encoding set must match the encoding
set used by the Teamcenter database.
e. Enter the Installation Directory where you want to install Teamcenter Rapid Start.
The Installation Directory must not already exist on your system. TEM creates the directory
during installation.
The directory must also be in a location excluded from real-time virus scanning.
7. In the Select Translators panel, select the Dispatcher Server translators you want to install.
8. If you selected additional features, proceed through any remaining panels, entering the required
information for the features you selected.
If an error occurs during installation, follow the instructions in the error message displayed
by TEM or see the available troubleshooting solutions.
Related topics
• Non-English locale environment settings
c. In the Installer Language dialog box, select a language and click OK.
Your language selection applies only to the TEM session, not the Teamcenter installation.
Note
For information about any TEM panel, click the help button .
4. Proceed to the Install/Upgrade Options panel. This panel contains the following options:
• Install
Installs a new Teamcenter configuration using a fully configurable installation process.
• Upgrade
5. In the Media Locations panel, enter paths to any Teamcenter patches or service packs you want
to apply during installation. This step is optional.
6. In the Configuration panel, type a unique ID and description for the new Teamcenter Rapid
Start configuration.
The configuration ID identifies your Teamcenter Rapid Start configuration when you maintain,
upgrade, uninstall, or add features to the configuration. Installation log files are also named
based on the ID you enter.
8. Proceed to the Features panel. This panel shows the corporate server features preselected
by the Corporate Server solution:
FMS Server Cache
NX Part Family Classification Integration
9. Select the Flex License Server (under Server Enhancements) and any other additional
features you want to install.
If you select additional features, TEM displays additional panels during installation that are not
described in this procedure.
For help with any panel in TEM, click the help button .
You can also add features to the corporate server later using TEM in maintenance mode.
10. In the Installation Directory box, enter the path to a new directory where you want to install
Teamcenter.
The Installation Directory value is the Teamcenter application root directory (TC_ROOT).
Do not set the TC_ROOT environment variable in the system environment. TEM sets this
variable as required in Teamcenter configuration files. Setting this variable in the operating
system can cause conflicts if you install multiple Teamcenter configurations.
• The directory must not already exist on your system. (TEM creates the directory during
installation.)
11. In the Flex License Server panel, enter a path for the licensing server in the Install UGS
Licensing to box.
In the Use License File box, enter the path to your Teamcenter license file.
Make sure the License Server Installer Location box contains the path to the installer for
the licensing server.
Note
This panel appears only if you include the Flex License Server feature in your
configuration.
12. In the File System Cache (FSC) panel, type a unique identifier and port for the FMS server
cache in the FSC ID and Port boxes.
A Teamcenter network must have at least one master FSC. If you want to designate the current
FSC as an FSC master, select the Enable configuration master check box. Otherwise, type the
URL to the parent FSC in the FSC Parent URL box.
For advanced FSC configuration options, click Advanced.
13. In the Operating System User panel, type the password for the operating system account
under which you install Teamcenter Rapid Start.
14. In the Foundation panel, select how you want to create or designate the Rapid Start database
and Rapid Start data directory (TC_DATA).
1. Real-time virus scanning prevents Teamcenter from updating the persistent object manager (POM) schema during installation, causing
installation errors.
15. Enter the required values for your Rapid Start database according to your selection in the
Foundation panel.
• Create and populate database, create new data directory:
a. Proceed to the Foundation Database panel.
b. Select the appropriate database server vendor (IBM DB2, Oracle, or MS SQL Server).
c. Enter the required values for the database server, the database user, and the database
administrator account.
b. Select the appropriate database server vendor (IBM DB2, Oracle, or MS SQL Server).
c. Enter the required values for the database server and the database user.
b. Select the appropriate database server vendor (IBM DB2, Oracle, or MS SQL Server).
c. Enter the required values for the database server and the database user.
Note
For more information about database configuration values, click the help button .
For Oracle and Microsoft SQL Server databases, the directory you specify in the Database
Path box must exist and you must have write permission to the directory.
16. In the Data Directory box, enter a location for the Rapid Start data directory.
The Rapid Start data directory is called the TC_DATA directory. TEM stores this location as the
TC_DATA variable in Teamcenter configuration files. TEM creates shared data subdirectories
and files in this location. Each data directory is associated with a single database user within
a database instance.
Do not set TC_DATA as a system environment variable. Setting this variable in the operating
system can cause conflicts if you install more than one configuration.
17. In the Share Name box, type a name for the Rapid Start share directory, or accept the default
value. TEM creates a default volume in the given share directory.
Siemens PLM Software recommends not defining the volume location under the
Teamcenter application root directory. Doing so leads to complications when upgrading
to a later version of Teamcenter.
Value Description
Transient Volume Directories Specifies transient volume locations for Windows
hosts, UNIX/Linux hosts, or both.
A transient volume is an operating system directory
controlled by Rapid Start and used to store
temporary data for transport of reports, PLM XML
data, and other nonvolume data between the
enterprise tier and client tier in a deployed four-tier
architecture. All four-tier clients that access the
corporate server you are installing use this transient
volume.
Caution
Value Description
20. If you want to configure Teamcenter online help, click Advanced in the Foundation Settings
panel and perform the following steps:
a. Click the Online Help tab.
c. In the PLM Document Server URL box, type the Teamcenter online help URL.
21. Proceed to the Flex License Client panel. Enter settings for the Teamcenter Rapid Start
license server.
22. Proceed to the Password Security panel. In the Administrative Password Directory box,
enter the directory in which to place Rapid Start password files. TEM locks access to this
directory to all users except the user performing Teamcenter installation.
23. Proceed through any remaining panels, entering the required information for the features you
selected.
24. Proceed to the Confirmation panel. Verify the information you entered.
If you want to change any values, click Back to return to the panels you want to change.
Otherwise, click Start to begin installing the Rapid Start corporate server.
Note
If an error occurs during installation, follow the instructions in the error message displayed
by TEM or see the available Troubleshooting.
4. In the Roles pane, under Web Server (IIS), locate the Role Services table.
5. In the Role Services table, verify that all of the following required role services are installed on
your host:
Web Server
Common HTTP Features
Static Content
Default Document
Directory Browsing
HTTP Errors
HTTP Redirection
Application Development
ASP.NET version
.NET Extensibility
ASP
CGI
ISAPI Extensions
ISAPI Filters
Server Side Includes
Security
Basic Authentication
Windows Authentication
Digest Authentication
Client Certificate Mapping Authentication
IIS Client Certificate Mapping Authentication
URL Authorization
Request Filtering
IP and Domain Restrictions
Performance
Static Content Compression
Dynamic Content Compression
Management Tools
IIS Management Console
IIS 6 Management Compatibility
IIS 6 Metabase Compatibility
IIS 6 WMI Compatibilty
IIS 6 Scripting Tools
IIS 6 Management Console
If any of these services are not installed, click Add Role Services to launch the Add
Role Services wizard and install the required role services.
Caution
Installing XpresReview
If you use XpresReview with Teamcenter Rapid Start, install XpresReview on your host:
1. Browse to the additional_applications\tcrs\XpresReview directory in the Teamcenter software
distribution image.
The XpresReview installer installs XpresReview and associates .pcf files with the XpresReview
application.
XpresReview is an electronic design review solution that allows you to share documents in a
collaborative environment. Using XpresReview, you can create and export a review package as a
.pcf or .zip file.
Note
In Teamcenter Rapid Start 10.1 and earlier versions, XpresReview was available as an
installable feature in TEM. If you used XpresReview with an earlier version than Teamcenter
Rapid Start 11.2, the XpresReview review package functionality remains after upgrade.
Modify a configuration
Add Teamcenter Rapid Start features to an existing configuration, or remove them from a
configuration:
1. Launch Teamcenter Environment Manager. In the Windows start menu, click
Programs→Teamcenter 11.2, 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 select Run
as administrator.
4. In the Old Configuration panel, select the configuration you want to modify.
Note
Options in the Feature Maintenance panel vary depending on the features in your
configuration.
6. In the Features panel, select features to add to the configuration, or deselect features you
want to remove.
Note
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. For more information, see How to remove a template in
the latest version of the Business Modeler IDE Best Practices Guide at the Teamcenter
documentation site on GTAC.
7. Proceed through the remaining panels in TEM, entering the required information for the features
you selected.
8. When TEM displays the Confirmation panel, click Start to begin installation.
2. Copy the necessary ICD files from the Teamcenter software distribution image.The Teamcenter
Rapid Start ICD files are in the tcrs_icd directory.
This populates the list of solutions available to install.
Note
If your network includes client hosts running on an IPv6 network, the Java EE web tier must
be deployed in an application server that supports an IPv6 URL as an external endpoint and
uses IPv4 addresses to support all communication with the Teamcenter enterprise tier, such as
communication with the Java EE server manager.
A typical environment for the Java EE web tier is a dual-stack machine that supports both
IPv4 and IPv6 addresses in which the application server accepts HTTP requests from either
IPv4 or IPv6.
Teamcenter enterprise tier server components that communicate with other server components
in the same network are assumed to be on an IPv4 network and are not supported on IPv6.
Teamcenter IPv6 support is limited to clients or integrations that use Teamcenter client
communication system (TCCS) and Teamcenter components that communicate with clients
on IPv6-enabled networks.
Related topics
• Web Application Deployment
• Install a supported third-party Java EE application server and the Java Runtime Environment
(JRE) on the web tier host.1
• If you use Security Services with the rich client or thin client, install Security Services.
2. In the Teamcenter software distribution image, browse to the Web_tier directory and double-click
the INSTALL_TCWEB.EXE program icon.
7-Zip displays a self-extractor dialog box.
3. In the Unzip To Folder box, type the path to WEB_ROOT, and then click Unzip.
After 7-Zip extracts the installation files, click Close to close the WinZip self-extractor dialog box.
1. For information about supported application servers and Java versions, see the hardware and software certifications page on GTAC.
4. To launch the Web Application Manager, browse to the WEB_ROOT directory and double-click
the insweb.bat program icon.
• The two-tier rich client is installed only through Teamcenter Environment Manager (TEM).
Over-the-Web installation is supported only for the four-tier rich client.
• If your network includes client hosts running on an IPv6 network, the Java EE web tier
must be deployed in an application server that supports an IPv6 URL as an external
endpoint and uses IPv4 addresses to support all communication with the Teamcenter
enterprise tier, such as communication with the Java EE server manager.
A typical environment for the Java EE web tier is a dual-stack machine that supports
both IPv4 and IPv6 addresses in which the application server accepts HTTP requests
from either IPv4 or IPv6.
Teamcenter enterprise tier server components that communicate with other server
components in the same network are assumed to be on an IPv4 network and are not
supported on IPv6. Teamcenter IPv6 support is limited to clients or integrations that use
Teamcenter client communication system (TCCS) and Teamcenter components that
communicate with clients on IPv6-enabled networks.
c. Browse to the tcrs_icd directory of the Teamcenter 11.2 over-the-web software distribution.
Select the tcrs_icd directory, and then click Open.
In the Copy ICD Files, click OK to load ICD files.
Note
The Web Application Manager displays a Progress dialog box while it copies ICD files.
When ICD files are copied, a list of ICD files follows the Copying ICD files... notice. If
no files are listed, Web Application Manager did not find files to copy in the directory you
entered.
If the ICD files are not copied successfully, repeat these steps ensuring that you include
the tcrs_icd directory in the path. Not including the tcrs_icd directory is the most common
reason ICD files are not copied.
5. In the Name box, type the name of this application, for example, Teamcenter OTW Distribution
Server.
6. In the Staging Location box, type the path to the location where you want the distribution server
software and administration files to reside.
Typically, you install the distribution server software in a directory under the WEB_ROOT
directory, the directory in which you installed the Web Application Manager on your hard drive.
Note
• This directory must be empty. The Web Application Manager creates the directory
if it does not exist.
• Note the staging location path of this distribution server for later use.
7. Optionally, in the Description box, type a brief description of this distribution server.
8. Click the Add button adjacent to the Disk Locations for Install Images box.
The Web Application Manager displays the Add Disk Location dialog box.
9. In the Disk Location To Add box, type the path to the icd directory in the thin client over-the-web
software distribution image and click OK.
The Web Application Manager displays the Add Web Application dialog box with the path you
entered displayed in the Disk Locations for Install Images box.
If Distribution Server is not in the Solution Type list, the required ICD files were not
copied correctly. To copy the ICD files, repeat steps a through c.
Parameter Value
RMI Port Specifies the port number used by the rich client distribution server,
a remote method invocation (RMI) registry server.
The default value, 12099, is in a range that is typically available.
Note
14. When the Progress dialog box indicates that installation is complete, click OK.
The Web Application Manager displays the Teamcenter Web Application Manager dialog
box with the distribution server software you installed listed as an application in the Web
Applications box.
15. Either click Exit to exit the Web Application Manager or click Add to begin installing the rich
client distribution server instance.
For each unique rich client configuration, you must create a distribution server instance.
Before you build a rich client distribution instance, ensure that the following software is installed
and configured:
• Teamcenter Rapid Start server
If you use Security Services with the rich client, make sure Security Services is installed and
configured.
Make sure the Web Application Manager has access to the following software images:
• Complete rich client over-the-web software distribution image
Note
The rich client over-the-web software distribution image includes files for all supported
Windows, UNIX, and Linux platforms. The Web Application Manager requires access to all
of these to build the Over-the-Web Installer.
If you include Lifecycle Visualization in your rich client distribution instance, and you use
downloaded software images instead of a DVD:
1. Download the version_Vis_ALL.zip file.
Replace version with the current Teamcenter version level.
3. When building your rich client distribution instance, enter the location of this directory
in the context parameter in the Web Application Manager.
Obtain values for the required rich client parameters. You must provide these values when building
the rich client distribution instance.
Note
• Whether your network uses IPv6 (128-bit) or IPv4 (32-bit) addresses, use host names
in URLs wherever possible so the domain name system (DNS) can determine which
IP address to use.
If you must use IP addresses and your network uses IPv6 addresses, enclose the literal
IPv6 address in square brackets, for example:
http://[2001:db8:ffff:1:101:12ff:de13:1322]:9043/tc
Parameter Description
RMI Port Port number used by the rich client distribution server. This
value was determined when the distribution server was
installed. The default is 12099.
WindowsLocation Location on the client host where you want the
Over-the-Web Installer to download rich client files on
Microsoft Windows systems by default.
The drive must exist on the client hosts prior to rich
client installation, and users must have write permission
to it. For example, if the installation location is
F:\Teamcenter\rich_client, every Windows client host
must have an F drive, and users must have permissions to
create Teamcenter\rich_client.
UnixLocation Location on the client host where you want the
Over-the-Web Installer to download rich client files on
UNIX systems by default.
The mount must exist on the client hosts prior to rich client
installation, and users must have write permission to it.
WebBrowserUnixLocation Location of a web browser on Linux client systems. This
location must be available for Linux client hosts.
RichClientHelpWebServer URL specifying the path to the Teamcenter online help
installed on the PLM Documentation Server. Set this value
to:
http://host:port/tdoc/tc/version
host and port are the host name and port of the PLM
Documentation Server. version is the Teamcenter version
or SP level.
RichClientHelpLocation Set to /help.
This is the subpath to the Teamcenter online help.
Parameter Description
HTTPUseGZip Indicates whether the rich client prefers responses
from the Java EE server in a compressed (gzipped)
form. Compressing responses reduces the bandwidth
requirement significantly, and should be considered,
especially in lower bandwidth network environment.
When set to true, the server may send responses without
compression depending on the server configuration.
When set to false, the server never compresses responses
for this rich client.
ParentFSCAddressTable List of addresses (host name and port) of the FMS file
server caches (FSC) to act as the parents of the installed
FMS file client cache.
HTTPServerTable List of web tier application servers; the first server in the
list is the default server for logon. Requires the following
information for each server:
URI
URL of the web tier SOAP endpoint. The value
depends on where the web tier application is deployed.
Typically it has the form:
http://host-name:port/tc/webclient
Name
Display name of the URL for the rich client graphical
user interface.
SSOAppID
Provides the Teamcenter application ID and sets the
TC_SSO_APP_ID environment variable for Security
Services.
The value you provide in this context parameter is
used only when Security Services is enabled and
either multiple Teamcenter sites are served by a single
identity provider or the Security Services service is
configured to use an ID other than TC.
When the multiple sites have different sets of users
authorized to use the application for each installation,
or different identifications in each installation, this value
identifies which installation is authenticated.
Parameter Description
JREWindows64Location Specifies the path to the Java Runtime Environment (JRE)
on the client host during installation of the rich client
through the Over-the-Web Installer on 64-bit versions of
Windows.
By default, the Over-the-Web Installer uses the value of the
JRE64_HOME environment variable on the target client
host. Change the value of this context parameter if you
want to specify a different path.
JREUNIXLocation Specifies the path to the Java Runtime Environment (JRE)
on the client host during installation of the rich client
through the Over-the-Web Installer on Linux systems.
By default, the Over-the-Web Installer uses the value of the
JRE_HOME environment variable on the target client host.
Change the value of this context parameter if you want
to specify a different path.
Depending on the solutions you include in your rich client distribution instance, you may need to
provide values for the additional parameters shown in the following tables.
Install the rich client instance on the same host and in the same directory as the distribution server.
1. Expand the rich client over-the-web software distribution image (Teamcenter-version_otw.zip) to
a drive on your local host.2
2. If you use Teamcenter lifecycle visualization, make sure the Lifecycle Visualization software
distribution is available from your host. The Over-the-Web Installerrequires this to install Lifecycle
Visualization viewers.
c. Browse to the tcrs_icd directory of the Teamcenter 11.2 over-the-web software distribution
image. Select the tcrs_icd directory, and then click Open.
In the Copy ICD Files, click OK to load ICD files.
2. If you expanded the over-the-web software distribution image when you installed the rich client distribution server, skip this step.
3. If you copied solution ICD files when you installed the rich client distribution server, skip this step.
Note
The Web Application Manager displays a Progress dialog box while it copies ICD files.
When ICD files are copied, a list of ICD files follows the Copying ICD files... notice. If
no files are listed, Web Application Manager did not find files to copy in the directory you
entered.
If the ICD files are not copied successfully, repeat these steps ensuring that you include
the tcrs_icd directory in the path. Not including the tcrs_icd directory is the most common
reason ICD files are not copied.
7. In the Staging Location box, enter the path to the directory where you want to install the rich
client image files for downloading to clients.
Typically, you would install the rich client distribution instance files in a directory under the
Web_tier directory, the directory in which you installed the Web Application Manager on your
hard drive.
Note
• This directory must be empty. The Web Application Manager creates the directory
if it does not exist.
• Note the staging location path of this distribution server instance for later use.
b. In the Add Disk Location dialog box, enter the locations of the following software
distributions. For each location, enter the path in the Disk Location to Add box, and then
click Apply.
• Teamcenter 11.2 over-the-web software distribution image.
Note
To modify a location or remove a location from the Disk Locations for Install Images list,
click Modify or Remove.
Over-the-Web Installer
Microsoft Visual C++ 2005/2008/2010/2012 Redistributables
Teamcenter client communication system
Rich Client 4-Tier
11. If you want to include additional solutions in the distribution instance, click Solutions and select
the solutions you want installed with the rich client.
12. When you are satisfied with your selections in the Add Web Application dialog box, click OK.
The Web Application Manager displays the Modify Required Context Parameters dialog box.
• The path specified in the WindowsLocation context parameter must not contain
any of the following special characters:
#~!@$%^&*()_+=
If the WindowsLocation contains any of these characters, the Over-the-Web Installer
fails to install the rich client.
• The required parameters must have values specified. If a required parameter has no
significance for your deployment (for example, a UNIX location in an environment of
all Windows systems), retain the default value.
• For descriptions of rich client required parameters, see Rich client distribution instance
requirements. The rich client required parameters vary, depending on the solutions
you install with the rich client.
The Web Application Manager displays the Modify Required Table dialog boxes for the
HTTPServerTable and the ParentFSCAddressTable.
14. For each table, type the values for each parameter. To add another row to the table, click Add
Row.
Note
Whether your network uses IPv6 (128-bit) or IPv4 (32-bit) addresses, use host names
in URLs wherever possible so the domain name system (DNS) can determine which
IP address to use.
If you must use IP addresses and your network uses IPv6 addresses, enclose the literal
IPv6 address in square brackets, for example:
http://[2001:db8:ffff:1:101:12ff:de13:1322]:9043/tc
Table Description
HTTPServerTable Type a list of web tier application servers; the first server in
the list is the default server for logon. Requires the following
information for each server:
URI
URL of the web-tier SOAP endpoint. The value depends
on where the web tier application is deployed. Typically
it has the form:
http://host-name:port/tc/webclient
Name
Display name of the URL for the rich client user interface.
Note
Note
If you use Teamcenter client communication system (TCCS), you do not need to supply
values
• Extracts the rich client image files into the webapp_root directory under the staging location
directory (named in step 7).
• Creates the manifest file (ds_manifest.mf) in the staging location directory (named in step 7).
The manifest file records and maintains information about the rich client image files, including
a list of the files and a version for each file. The Over-the-Web Installer consults the manifest
file to determine which files to download.
16. When the Progress dialog box indicates that installation is complete, click OK.
The Web Application Manager displays the Teamcenter Web Application Manager dialog box.
To make the rich client distribution instance available to client hosts, deploy the distribution instance
on a supported web application server.
2. In the Modify Web Application dialog box, click Modify Context Parameters.
3. In the Modify Context Parameters dialog box, enter values for TCCS context parameters, and
then click OK to continue.
5. In the Modify Tables dialog box, select the TcCSEnvironmentTable table, and then click Modify.
6. In the Modify Table dialog box, click Add Row. Enter values for the TCCS environment and
then click OK to continue.
Value Description
Name Specifies the name of a the TCCS environment. This
name is displayed in the TCCS logon dialog after
configuration is complete.
Value Description
URI Specifies the URI to the TCCS environment. This is the
endpoint URI for the web tier deployment, for example,
http://host:port/tc.
Tag Specifies a string identifier for the TCCS environment.
When installing a rich client, you can optionally provide
a Client Tag Filter value to filter the list of environments
displayed in the rich client to those environments that
match the filter.
For example, if the Client Tag Filter value is 9*, all
TCCS environments with Tag values beginning with 9
are available to the client host. Environments with Tag
values beginning with 10 are not available.
Note
Note
Whether your network uses IPv6 (128-bit) or IPv4 (32-bit) addresses, use host names in
URIs and URLs wherever possible so the domain name system (DNS) can determine
which IP address to use.
If you must use IP addresses and your network uses IPv6 addresses, enclose the literal
IPv6 address in square brackets, for example:
http://[2001:db8:ffff:1:101:12ff:de13:1322]:9043/tc
7. In the Modify Web Application dialog windows, click OK to apply your changes.
8. Exit the Web Application Manager and redeploy the rich client distribution instance.
2. In the Web Applications box, select the web application that contains the rich client distribution
instance and click Modify.
The Web Application Manager displays the Modify Web Application dialog box.
Web Application Manager displays the Modify Context Parameters dialog box.
4. Type values for the Security Services context parameters, and then click OK.
5. Exit the Web Application Manager and redeploy the rich client distribution instance.
Related topics
Configure reverse proxy settings for the rich client distribution instance
If you must connect to a Teamcenter environment through a reverse proxy server (such as WebSEAL
or SiteMinder), you may need to configure TCCS reverse proxy settings for SiteMinder or WebSEAL
by performing the following steps:
1. In the Web Application Manager, select your four-tier rich client application in the Web
Applications list, and then click Modify.
5. In the Add Row to Table dialog box, in the Criteria String box, type the appropriate value.
• SiteMinder:
checkHeaders,false
Note
This setting configures TCCS to detect form-based challenges originating from the
reverse proxy. This setting also applies to other reverse proxy servers that do not send
specific header information in the 200 form-based challenge.
• WebSEAL:
server,webseal,:/pkmslogin.form
Click OK and close dialog boxes until you return to the Modify Web Application dialog box.
6. Generate a deployable file and deploy the rich client distribution instance.
• images directory
Contains all images used by the web pages.
• installed.html file
Contains the English version of the HTML page displayed with installation completes successfully.
• installfailed.html file
Contains the English version of the HTML page displayed when installation fails.
• installing.html file
Contains the English version of the HTML page for launching the Over-the-Web Installer.
• launcherror.html file
Contains the English version of the HTML page displayed to the user when the Over-the-Web
Installer cannot install the rich client due to one of the following problems:
o The connection to the web is not available or the user has not provided permissions to install.
o The required Java Plug-in is not available and cannot be installed automatically.
• otw.html file
Contains the logic for detecting the web browser and Java Plug-in required for installing the rich
client over the web.
• localized directory
Contains subdirectories for each supported locale other than English (French, German, Italian,
Japanese, Korean, Russian, S_Chinese, Spanish, and T_Chinese). The subdirectories contain
localized versions of the installing.html and error.html files. To use a localized version of the
installation, deploy the localized installing.html and error.html files rather than the English
versions.
Note
2. Find the following two lines and in each replace change_me_server with the name
of the server host:
<param name="server_name" value="change_me_server>
server_name="change_me_server"
When editing the preceding information, do not delete the quotation marks.
For each distribution server instance you create, deploy these files in a web server. If you are creating
multiple rich client distribution instances, consider creating a unique directory in the web server
documentation root for each instance and copy all the files in the webapp_root\otwweb folder there.
For detailed deployment information, see the documentation provided by the web server vendor.
The following examples use the name of the instance for the web component directory name:
To enable users to install the rich client over the web, publish the following information:
• URL where the web components are located.
• The location in which the rich client will be installed on user workstations. Users must have
write permissions for this location.
• For rich client instances that include support for Teamcenter lifecycle visualization or NX, the
locations in which users must install Teamcenter lifecycle visualization and NX.
1. Go to the staging location directory you created for the distribution server.
This is the directory containing the distribution server application and administration utilities.
2. Ensure that the Java runtime environment (JRE) bin folder is in the Windows path. This is
the path to your JRE installation, for example:
JRE-HOME\bin
3. Browse to the webapp_root subdirectory and double-click the start_rmi.bat program file.
The start_rmi.bat program file starts the Java remote method invocation (RMI) registry.
When the distribution server is running, rich client can be installed over the web.
Replace host-name with the name of the computer where the distribution server is running. Replace
port-number with the port number.
The stop_server program prints the results of the remote shutdown. If the results include Java
exceptions, errors occurred. Usually exceptions occur when no distribution server is running on the
specified host.
To stop the RMI registry, use the operating system facilities.
The operating system facilities stop the RMI registry server.
To allow automatic updating of a rich client when users start a Teamcenter session, do not
change the name of the distribution instance.
2. Replace the existing dist_server.jar file with the new JAR file.
The dist_server.jar is in the in the webapp_root subdirectory of the staging location for the
distribution server.
3. Enter the path to the tcrs_icd directory in the Rich Client Over-the-Web distribution image and
click OK.
The Web Application Manager displays a Progress dialog box and copies the ICD files.
5. In the Web Applications list, select the distribution server instance you want to add components
to and click Modify.
The Web Application Manager displays the Modify Web Application dialog box.
7. Ensure the paths to the installation images of components you want to add are listed in the Disk
Locations for Install Images box.
For example, if you intend to add the embedded viewer to the rich client, enter the paths to the
Teamcenter lifecycle visualization installation images for each operating system.
Note
For each instance, the Over-the-Web Installer requires access to the installation images
files for all operating systems.
10. Provide the information for the required parameters and click OK.
Note
• The required rich client parameters vary, depending on the applications you are
installing with the rich client instance.
• The required parameters must have values specified. If a required parameter has no
significance for your deployment (for example, a UNIX location in an environment of
all Windows systems), retain the default value.
The Web Application Manager begins installation of the solutions and displays a Progress
dialog box.
11. When installation is complete, click OK to close the Progress dialog box.
The Web Application Manager displays the Modify Web Application dialog box.
12. If the solution you added has optional parameters you want to modify, click Modify Context
Parameters.
The Web Application Manager displays the Modify Context Parameters dialog box.
Note
13. Type the values for the optional parameters and click OK.
Note
For descriptions of the optional parameters, see Rich client optional parameter values.
The Web Application Manager displays the Modify Web Application dialog box.
15. If you changed a context parameter value, notify users that they must uninstall the rich client
and reinstall from the same instance.
Make sure you include a space before WEB_ROOT when you type these commands.
Note
12099 is the default value of the RMI Port context parameter for the distribution server.
This value should match the value you specified during distribution server installation.
Note
Make sure you include a space following -cp as shown in the key value.
b. In the Services list, right-click the OTWRMI service and choose Start.
c. In the Services list, right-click the OTWDistServer service and choose Start.
Note
The distribution server services start automatically when you restart Windows.
If you want to remove the distribution server services, perform the following steps:
1. In the Services dialog box in the Windows Control Panel, stop the OTWRMI and OTWDistServer
services.
Data Description
TreeCache cluster name1 Name for a cluster of components accessing a shared global
server pool. This name must be unique for this database and
corporate server.
You must supply this same name for the TreeCache cluster
name when configuring the web tier application.
JMX HTTP Adaptor port Number of the port running a Java Management Extension
(JMX) HTTP adaptor.
Server host name Logical host name of the server manager host. If the server
manager host has multiple IP addresses, the server host name
allows you to control which IP address is used when connecting
to Teamcenter servers.
If your server manager host has only one IP address, you do
not need to provide a value for this box. If the server host has
multiple IP addresses and you want the server manager to use
a specific address when connecting to Teamcenter servers,
you must provide the address or the logical host name of the
server manager host.
The value you enter is written to the SERVER_HOST parameter
in the serverPool.properties file.
Communication protocol The communication protocol mode between TreeCache peers,
either TCP or multicast mode.
The web tier application must use this same mode.
Multicast configuration If you are using multicast mode, ensure that the network on
which the server manager and web tier run are configured to
allow multicast communication.
1. For more information about configuring JBoss Cache TreeCache and setting TreeCache parameters, see www.jboss.org/jbosscache.
The TreeCache implementation also uses the JGroups toolkit. For more information about JGroups, see www.jgroups.org/.
Data Description
TCP configuration If you are using TCP, the following information is required:
• The TCP port at which this TreeCache cluster member
attempts to provide the TreeCache service. If the port is in
use, the application fails to start and issues an error about
having no port to bind to. Select an available port and retry.
This port can vary from the port specified for the web tier
application.
If you use multiple TreeCaches on the same host (for
example, a server manager and a web tier application),
the TreeCaches must use different local service ports.
Depending on the network configuration, specifying the
same local service port for each component may cause
problems when they are on different machines.
Data Description
Note
For server pool sizing recommendations, see the Teamcenter Deployment Guide available
on GTAC.
If you create a new Teamcenter configuration, launch TEM from the Teamcenter software
distribution image. If you want to add the Java EE server manager to an existing configuration,
launch TEM in maintenance mode.
2. Proceed to the Features panel. Under Server Enhancements, select Java EE based Server
Manager.
3. Proceed to the TcServer Character Encoding Settings panel. Make sure the values reflect the
character set you use for Teamcenter. If you are not sure, accept the default settings.
For information about the values in this panel, click the help button .
4. In the Multiplexing Proxy panel, accept the default values or type new values for the Teamcenter
multiplexing proxy (MUX).
Value Description
Port Specifies the TCP/IP port on which the MUX listens
for web tier requests. This is the Jetty server
connector port.
TECS Admin Port Specifies the port used by the Teamcenter Enterprise
Communication System (TECS).
Note
The MUX listens on a single port for incoming requests from the web tier, forwarding
those requests to an appropriate Teamcenter server using operating system named-pipe
communication protocol, and then streaming the response back to web tier. The MUX runs
as an application within the Teamcenter Enterprise Communication System (TECS). The
TECS container is based on the Teamcenter client communication system (TCCS)
container used in the client tier.
5. Proceed to the Communication Configuration panel and enter the required values:
a. In the Pool ID and JMX RMI Port boxes, type a name and port for the server pool.
b. In the Assignment Service Port box, type a port number for the server manager assignment
service.
c. In the Server Host box, type the logical host name of the server manager host. This value
allows you to control which IP address is used when connecting to Teamcenter servers.
• Command Line
Specifies you want to run the server manager manually from a command line.
Enter remaining values as needed in the Server Manager for Java EE panel. For more
7. Proceed through remaining panels to the Confirmation panel. Click Start to begin installing the
Teamcenter server with the Java EE-based server manager.
9. After you install the Java EE server manager, install the Teamcenter Management Console using
the appropriate steps for Windows platforms.
You can install multiple Java EE server manager services on the same host. Each server manager
service has its own configuration directory:
TC_ROOT\pool_manager\confs\config-name
Replace config-name with the name of the server manager configuration.
The server manager configuration directory contains configuration files, log files, and server manager
scripts. These include the following.
File/Directory Description
mgrstart Script that launches the Java EE server manager in console mode.
mgrstop Script that stops the Java EE server manager when started from a
command line.
If you run the Java EE server manager as a Windows service, stop
the service using the Windows services manager.
Note
You can also stop the server manager using the Teamcenter
Management Console.
mgr.output If you run the Java EE server manager as a Windows service, this
file contains all output from the Java EE server manager.
This file is not used if you run the server manager from the command
line.
logs Directory that contains all Java EE server manager log files.
If you run the Java EE server manager as a Windows service, the server manager starts automatically.
Verify that your Teamcenter Rapid Start server environment is running and is properly configured
before you install a Teamcenter Rapid Start client.
Set the JRE64_HOME environment variable on the client host to the location of a supported 64-bit
Java JRE.
Teamcenter Environment Manager (TEM) verifies the JRE version during launch and cancels
installation if a certified JRE is not available on the host. After installation is complete, TEM no
longer requires this variable.
Note
Alternatively, you can specify the Java JRE location by one of the following methods:
• Set the JRE_HOME environment variable to the location of a supported 64-bit Java JRE.
• When you launch TEM type the following command in a command prompt using the -jre
argument to specify the location of a supported 64-bit Java JRE:
tem -jre JRE-path
For example:
tem -jre c:\apps\jre1.7
Do not use the Windows Run as option to run the Teamcenter Rapid Start setup
program as a user with administrator privileges. To successfully install and configure
Teamcenter Rapid Start, you must log on as a user with administrator privileges.
c. In the Installer Language dialog box, select a language and click OK.
Your language selection applies only to the TEM session, not the Teamcenter installation.
If you want to add Teamcenter Rapid Start features not automatically included in the quick
preconfigured installation, select the Include additional features check box. If you select
additional features, TEM may display additional panels not described in this procedure.
Proceed to the Teamcenter Rich Client 4-Tier panel. Enter the required information to
install a four-tier rich client that connects to an existing Teamcenter Rapid Start middle tier
and corporate server.
Value Description
4 Tier Server URI Specifies the URI to the rich client middle tier. Type a
URI of the following form:
http://host:port/tc
FCC Parent Specifies the URI to the FMS server cache (FSC) used
by the local FMS client cache (FCC) in your four-tier rich
client configuration. Type a URI of the following form:
http://host:port
Installation Directory Specifies the directory in which you want to install
Teamcenter. Enter a directory that does not exist. TEM
creates the directory you specify.
Proceed to the Teamcenter Rich Client 2-Tier panel. Enter the required information to install
a two-tier rich client that connects to an existing Teamcenter Rapid Start corporate server.
Value Description
Host name Type the host name of the corporate server.
Data directory Type the UNC path to data directory (TC_DATA) for the
corporate server.
Value Description
FCC Parent Specifies the URI to the FMS server cache (FSC) used
by the local FMS client cache (FCC) in your four-tier rich
client configuration. Type a URI of the following form:
http://host:port
Installation Directory Specifies the directory in which you want to install
Teamcenter. Enter a directory that does not exist. TEM
creates the directory you specify.
6. If you selected additional features, proceed through any remaining panels, entering the required
information for the features you selected.
If an error occurs during installation, follow the instructions in the error message displayed
by TEM or see the available troubleshooting solutions.
Related topics
• File Management System
On Windows 7 systems, the Windows User Access Control (UAC) or Least-privileged User
Account (LUA), if enabled, may interfere with configuration of some rich client features.
1. Install the prerequisite software on the client host. Teamcenter Environment Manager (TEM) does
not install the prerequisite software.
Note
2. Set the JRE64_HOME system environment variable to the path to a supported 64-bit Java JRE,
for example, C:\Program Files\Java\jre7x64.
7. In the Media Locations panel, enter paths to any Teamcenter patches or service packs you want
to apply during installation. This step is optional.
8. In the Configuration panel, type an ID and a description for the new Teamcenter configuration.
Note
The configuration ID identifies your configuration when you perform maintenance tasks in
TEM. Also, installation log files reference your configuration by this ID.
10. 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.)
11. 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.
For information about a feature, point to the feature in the list to display a description.
Note
• If you select additional features, TEM displays additional panels during installation
that are not described in this procedure.
• If you install the rich client from a compact distribution and you select features not
included in the compact distribution media, TEM prompts you for the location of the full
distribution media.
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).
1. A compact distribution package is much smaller than a full Teamcenter software image and may contain a selected subset of features.
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.
Note
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
Name Specifies a name for the TCCS environment.
TC_DATA Enter the path to the data directory (TC_DATA) where
you want Teamcenter Environment Manager to create
shared data subdirectories and files.2
Tag (Optional) Specifies a tag for the environment that
can be used to filter the list of TCCS environments
during rich client logon.
In the Client Tag Filter panel during rich client
installation, you can optionally provide a pattern to
filter the list of environments displayed in the rich
client to those environments that match the pattern.
Example
2. This can be the network path to the TC_DATA directory on your corporate server.
Value Description
SSO Login URL Specifies the logon URL to the Security Services
environment.
Note
• Four-tier deployment
Value Description
Name Specifies a name for the TCCS environment.
URL Specifies the URL to the rich client middle tier. Type a
URL of the following form: http://host:port/tc.
Tag (Optional) Specifies a tag for the environment that
can be used to filter the list of TCCS environments
during rich client logon.
In the Client Tag Filter panel during rich client
installation, you can optionally provide a pattern to
filter the list of environments displayed in the rich
client to those environments that match the pattern.
Example
Value Description
SSO Login URL Specifies the logon URL to the Security Services
environment.
Note
A single TCCS configuration can contain multiple environments. For example, you may want
to install some TCCS environments with Security Services (SSO), some without SSO, or some
environments on only certain servers. If you configure multiple environments, a selection list of
environments is displayed during rich client logon.
For advanced TCCS settings, click Advanced.
17. In the Rich Client Settings panel, specify online help settings.
If you want to configure online help for the rich client, select the Enable Online Help check
box, and then type the online help URL in the Web server URL box.
Note
This step assumes you installed Teamcenter online help before installing the rich client.
If not, you can install online help and configure online help access after installation is
complete.
If you want to specify Security Services settings or other advanced rich client settings, click
Advanced.
18. Proceed to the Confirmation panel and review your selections. Click Start to install the rich
client, or click Back to change your selections.
When installation is complete, close TEM.
The installation 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
On Windows 7 systems, the Windows User Access Control (UAC) or Least-privileged User
Account (LUA), if enabled, may interfere with configuration of some rich client features.
1. Install the prerequisite software on the client host. Teamcenter Environment Manager (TEM) does
not install the prerequisite software.
Note
2. Set the JRE64_HOME system environment variable to the path to a supported 64-bit Java JRE,
for example, C:\Program Files\Java\jre7x64.
7. In the Media Locations panel, enter paths to any Teamcenter patches or service packs you want
to apply during installation. This step is optional.
8. In the Configuration panel, type an ID and a description for the new Teamcenter configuration.
Note
The configuration ID identifies your configuration when you perform maintenance tasks in
TEM. Also, installation log files reference your configuration by this ID.
10. 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.)
3. A compact distribution package is much smaller than a full Teamcenter software image and may contain a selected subset of features.
11. The Teamcenter Rich Client 4-tier feature is selected by default. Select any additional features
you want to include in your rich client configuration.
For information about a feature, point to the feature in the list to display a description.
Note
• If you select additional features, TEM displays additional panels during installation
that are not described in this procedure.
• If you install the rich client from a compact distribution and you select features not
included in the compact distribution media, TEM prompts you for the location of the full
distribution media.
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.
Note
14. 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
Whether your network uses IPv6 (128-bit) or IPv4 (32-bit) addresses, use host names in
URIs wherever possible so the domain name system (DNS) can determine which IP
address to use.
If you must use IP addresses and your network uses IPv6 addresses, enclose the literal
IPv6 address in square brackets, for example:
http://[2001:db8:ffff:1:101:12ff:de13:1322]:9043/tc
15. In the Rich Client Settings panel, specify online help settings.
If you want to configure online help for the rich client, select the Enable Online Help check
box, and then type the online help URL in the Web server URL box.
Note
This step assumes you installed Teamcenter online help before installing the rich client.
If not, you can install online help and configure online help access after installation is
complete.
If you want to specify Security Services settings or other advanced rich client settings, click
Advanced.
16. Proceed to the Confirmation panel and review your selections. Click Start to install the rich
client, or click Back to change your selections.
When installation is complete, close TEM.
The installation 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
On Windows 7 systems, the Windows User Access Control (UAC) or Least-privileged User
Account (LUA), if enabled, may interfere with configuration of some rich client features.
1. Install the prerequisite software on the client host. Teamcenter Environment Manager (TEM) does
not install the prerequisite software.
Note
2. Set the JRE64_HOME system environment variable to the path to a supported 64-bit Java JRE,
for example, C:\Program Files\Java\jre7x64.
4. A compact distribution package is much smaller than a full Teamcenter software image and may contain a selected subset of features.
7. In the Media Locations panel, enter paths to any Teamcenter patches or service packs you want
to apply during installation. This step is optional.
8. In the Configuration panel, type an ID and a description for the new Teamcenter configuration.
Note
The configuration ID identifies your configuration when you perform maintenance tasks in
TEM. Also, installation log files reference your configuration by this ID.
10. 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.)
11. The Teamcenter Rich Client 2-tier feature is selected by default. Select any additional features
you want to include in your rich client configuration.
For information about a feature, point to the feature in the list to display a description.
Note
• If you select additional features, TEM displays additional panels during installation
that are not described in this procedure.
• If you install the rich client from a compact distribution and you select features not
included in the compact distribution media, TEM prompts you for the location of the full
distribution media.
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.
Note
14. In the TcServer Character Encoding Settings panel, make sure the values reflect the character
set you use for Teamcenter. If you are not sure, accept the default settings.
15. In the 2-tier server settings panel, define how you will access the Teamcenter corporate server.
a. Make sure the Connection Port box reflects the port used by your Teamcenter corporate
server.
B. Enter the path to the data directory (TC_DATA) where you want Teamcenter Environment
Manager to create shared data subdirectories and files.5
D. Click OK.
E. If you want to add access to additional databases, repeat the previous four steps to
add access information for each database.
To remove a database from the list, select the row and click Remove. To edit values for a
database connection, select the row and click Edit.
If you connect to multiple databases, assign connection priority by selecting rows and
clicking Up or Down.
16. In the Rich Client Settings panel, specify online help settings.
If you want to configure online help for the rich client, select the Enable Online Help check
box, and then type the online help URL in the Web server URL box.
Note
This step assumes you installed Teamcenter online help before installing the rich client.
If not, you can install online help and configure online help access after installation is
complete.
If you want to specify Security Services settings or other advanced rich client settings, click
Advanced.
17. Proceed to the Confirmation panel and review your selections. Click Start to install the rich
client, or click Back to change your selections.
When installation is complete, close TEM.
The installation 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
5. This can be the network path to the TC_DATA directory on your corporate server.
http://host/path/otwweb/otw.html
Obtain the URL from your Teamcenter administrator.
The Over-the-Web Installer installs the rich client.
Note
Whether your network uses IPv6 (128-bit) or IPv4 (32-bit) addresses, use host names
in URLs wherever possible so the domain name system (DNS) can determine which
IP address to use.
This step is required to activate the FMS_HOME environment variable set by the Over-the-Web
Installer.
3. If the rich client includes Teamcenter Automotive Edition–GM Overlay, you must complete
additional required configuration steps.
The Over-the-Web Installer places the Teamcenter rich client icon on your desktop. To start
the rich client, double-click the icon.
Each time you start the rich client, the startup process checks for updates and downloads them to
your workstation. After checking and downloading changed and new components, it starts the rich
client application using the updated components.
Note
The four-tier rich client requires the Microsoft Visual C++ 2008 redistributable libraries. If these
libraries are not present on the client host, the Over-the-Web Installer automatically installs
the libraries. You must then restart your system, and then restart the Over-the-Web Installer
to complete rich client installation.
4. To verify the installation completed successfully, start Microsoft Project and verify the Teamcenter
Integration button or tab is displayed.
Upgrade Business Modeler IDE template project and code to Teamcenter Rapid Start . . . . . . . 6-6
• Before upgrading, ensure that all Teamcenter user sessions are terminated.
• Ensure that you have write permission on the default volume of the administrative user (infodba).
• All customizations done outside the database (for example, portal properties) must be moved
forward manually. All customizations done within the database are carried over by reusing
the same database.
• Before upgrading the client, be sure that the server you plan to connect to has been upgraded to
Teamcenter Rapid Start 11.2.
• If you have custom templates (custom objects), migrate them to the compatible versions.
• The following Teamcenter Express features are replaced by Teamcenter Rapid Start features:
o Sync mapping
Replaced by the attribute exchange feature in Client for Office.
o Self-Paced Training
Replaced by the Teamcenter Help Collection.
2. If you are upgrading from Teamcenter Express 5.3.x to Teamcenter Rapid Start 11.2, upgrade
the Solid Edge Embedded Client (SEEC) template as follows:
a. Download the required Solid Edge Embedded Client template from GTAC.
Note the download location as you will need it later in this procedure.
The following table shows the paths for upgrading the Solid Edge Embedded Client (SEEC)
template.
b. In the Teamcenter Rapid Start version you are upgrading from (that is, your current
installation), open the Teamcenter Environment Manager.
3. In the Teamcenter Rapid Start 11.2 software distribution image, double-click the
UpgradetoTcRSUtility.bat file. To modify the configuration files, confirm the path of the
TC_ROOT directory for your installed version (for example, Teamcenter Express 5.3.x or
Teamcenter Express 9.1.x).
4. In the Teamcenter Rapid Start 11.2 software distribution image, double-click the tem.bat file.
8. In the Old Application Root panel, browse to the path of the application directory of the previous
installation and click Next.
9. In the Old Configuration panel, select the installation you want to upgrade and click Next.
10. In the Configuration panel, enter a unique ID and description for this software configuration.
The default ID and description values are copied from the configuration being upgraded.
Note
Record the description and ID you enter for this configuration. When uninstalling this
configuration or performing other maintenance tasks, you must select this configuration
from a list. In addition, installation log file names use this ID.
11. In the New Application Root panel, enter the installation directory for the new installation.
Verify that the status for all features is valid. If there are any warning messages, you must
resolve them before continuing.
If TEM displays a warning message regarding a feature's XML file, click the feature and use the
Browse button to locate the XML file. Note that the feature's XML file may reside in a location
different from the corresponding Business Modeler IDE project location.
Note
If the custom template directory is on a shared network drive, make sure that you have
write permission to the shared path.
When upgrading to Teamcenter Rapid Start 11.2, you must first download the AutoCAD and
SEECOverlay templates from GTAC and then browse to them on the New Application Root
panel.
12. In the Operating System User panel, enter the operating system user name and password
for the user installing Rapid Start.
13. In the Flex License Server panel, enter a path for the licensing server in the Install UGS
Licensing to box.
In the Use License File box, enter the path to your Teamcenter license file.
Make sure the License Server Installer Location box contains the path to the installer for
the licensing server.
14. In the Teamcenter Administrative User panel, enter the Teamcenter user name and password.
15. In the Upgrade Information panel, enter the paths to the old TC_DATA and new TC_DATA
directories. Then, enter the user name and password for the Teamcenter database.
16. In the Upgrade Database Features panel, verify that the features you want to upgrade are
displayed. If all of the features are not displayed, click Browse to locate them.
17. In the the Upgrade Options panel, select one of the following:
• Stop database upgrade at first error
The upgrade stops when it encounters an error.
Siemens PLM Software recommends that you select this option only if you are
upgrading a test environment.
19. In the .NET Server Manager panel enter the required values or accept the default values shown.
If TEM displays an error message prompting you to change the pool port number, enter a
different port number.
20. In the .NET Web Tier panel, enter the required values.
21. In the Rich Client Settings panel, specify whether you want to install the help files locally, and
provide the URL to the Teamcenter online help.
22. In the Business Modeler IDE Client panel, select the Business Modeler IDE templates you want
to install. To install additional templates, click Browse and locate the desired templates.
23. In the the License Level for Teamcenter Visualization (Embedded) panel select the
appropriate licensing option.
24. Start the Teamcenter Express FSC service from your previous version before you continue.
25. In the Pre-Upgrade Diagnostics panel, specify a directory for storing the diagnostic log files,
and then click Run.
After the pre-upgrade diagnostics complete, click Review to see the results of the diagnostics.
Perform and recommended steps before you continue.
If problems occur during upgrade, TEM displays a message that includes the path to the
log file that describes the problem.
27. If the upgrade is successful, TEM displays the Upgrade Features: Successful panel.
Close TEM .
To upgrade additional databases using the same application root directory, run TEM from
the new, upgraded installation.
3. In the Teamcenter Rapid Start software distribution image, double-click the tem.bat file.
8. In the Old Application Root panel, browse to the path of the application directory of the previous
installation and click Next.
9. In the Old Configuration panel, select the installation you want to upgrade and click Next.
10. In the Configuration panel, enter a unique ID and description for this software configuration.
The default ID and description values are copied from the configuration being upgraded.
Note
Record the description and ID you enter for this configuration. When uninstalling this
configuration or performing other maintenance tasks, you must select this configuration
from a list. In addition, installation log file names use this ID.
11. In the New Application Root panel, enter the new installation directory.
12. If you are performing a two-tier client installation, type the host name of the server and the path
to the TC_DATA directory.
13. In the Rich Client Settings panel, specify whether you want to install the help files locally, and
provide the URL to the Teamcenter online help.
14. In the Teamcenter Visualization (Embedded) for Rich Client panel, click Next.
15. In the License Level for Teamcenter Visualization (Embedded) panel, select the license level.
16. If NX is installed on your host, verify the path to the installation directory and click Next.
If problems occur during upgrade, TEM displays a message that includes the path to the
log file that describes the problem.
18. If the upgrade is successful, TEM displays the Upgrade Features: Successful panel.
Close TEM .
Note
To upgrade additional databases using the same application root directory, run Teamcenter
Environment Manager from the new, upgraded installation.
1. Use the new version of Teamcenter Rapid Start to install a test system that represents your
existing customer production system, with no customizations. Include only Siemens PLM
Software-supplied features. You can add customizations in later steps.
For example, if the production system has only the foundation (corporate server) template and
customizations in the database, install the test system with only the foundation template of
the new version installed.
2. Install the Business Modeler IDE and dependent templates from the new version.
3. Import the customer template project created in the previous version into the new version of
Business Modeler IDE. To import a project, choose File→Import→Import Business Modeler
IDE Project wizard.
Importing the project upgrades the older customer template project elements into the new
version. Business Modeler IDE validates and loads the migrated customer template project. Any
loading or upgrade errors are displayed in the Console view.
After upgrade, open the Navigator view and check for any error or warning messages in the .log
file in the output\upgrade folder.
Note
If no migration is automatically initiated when the template project is imported, you must
manually initiate the migration.
4. Fix all errors displayed in the Business Modeler IDE Console view. After you fix the errors,
right-click the project and choose Reload Data Model to validate the custom data model. If any
errors occur after reloading the data model, redo this step until all errors are fixed.
5. Upgrade localizations.
a. After upgrading the older custom template to the newer data model, migrate the text for
properties and relations to the newer language framework using the Property Name and
Relation Name Migration Wizard.
b. Create a default set of localization files for the upgraded template project using the Default
Localization Creation Wizard.
Note
These steps migrate legacy display names from the text server into the Business
Modeler IDE. If you do not perform these steps, those properties assume the internal
names in the rich client and thin client.
6. In the Business Modeler IDE, view and evaluate the latest configurations added by each
dependent template in the new version. This allows you to determine the impact to your
configurations before you upgrade the system.
7. Some Teamcenter Rapid Start preferences are obsolete and are migrated to Business Modeler
IDE template elements. A list of preferences migrated to Business Modeler IDE elements is
provided in the Business Modeler IDE Guide.
8. Refactor create operations if they do not conform to the Teamcenter Rapid Start framework.
9. Configure your template to get the desired result in your system when your template is deployed
to the database.
10. Save changes in the customer template project along with the configurations made in the
previous version.
a. Regenerate the custom C++, Java, and .NET code to pick up the latest updates available
in the new version.
b. Compile and link the custom code with libraries of the new version installed in step a.
Caution
If you have any server code customizations from previous versions, you must
regenerate the code and rebuild your libraries.
12. Package the custom template project for testing by choosing New→Other→Package Template
Extensions.
Caution
Some customizations depend on specific data in the database and cannot be used on
other databases until you create all the required data in the new database.
For example, any customization that involves the Organization module and has
customizations to display types is specific to a database. That template only works with a
database that has the same Organization structure for which the display type is set up.
For another example, if you create a custom Change Management object, it must be
configured with a workflow process template, which it gets from the database. The
template works in any database that also has the same process template.
Moving to Teamcenter
If you obtain a Teamcenter license file, you can convert a Teamcenter Rapid Start installation
to Teamcenter.
1. Launch Teamcenter Environment Manager in maintenance mode. In the Windows start menu,
click Programs→Teamcenter 11.2, 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 Rapid Start installation. Right-click the tem.bat program icon and select
Run as administrator.
3. In the Teamcenter Administrative User panel, enter the password for the Teamcenter Rapid
Start administrative user account.
The value in the User box is read-only during this step.
Caution
The password must not be empty nor contain any whitespace characters such as space,
tab, newline, carriage return, form feed, or vertical tab.
In addition, the password must not contain any of the following characters:
!@$%=&'":;.<>(){}
4. In the Configuration panel, if you want to enable all Teamcenter menus and applications for
the features installed in your configuration, select the Enable all the menus and applications
hidden by Teamcenter Rapid Start check box.
5. In the Confirmation panel, review your selections and click Start to convert your Teamcenter
Rapid Start configuration to Teamcenter.
• 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 distribution image 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
distribution image. 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.
2. Start Teamcenter Environment Manager (tem.bat) from the Teamcenter software distribution
image.
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 , or install using a
full Teamcenter software distribution image.
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 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
Siemens PLM Software recommends using 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.
Element Description
feature Specifies one feature of a Teamcenter module. The code attribute
identifies the feature. To define whether Teamcenter Environment
Manager installs the feature, set the selected attribute to either true
or false.
data Lists all Teamcenter Environment Manager Java classes and values
defining aspects of installation, such as the path to the installation
directory for Teamcenter application files. For additional information,
see the comments in the configuration file. The comments describe
the class and valid values.
<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>
1. Log on to the Teamcenter corporate server host and browse to the root directory of the
Teamcenter software distribution image.
3. Proceed to the Install/Upgrade Options panel, select the Create custom distribution check
box, and then click Install.
4. In the Custom Distribution Options panel, select Create compact deployable media. Enter
the path in which to create the compact distribution and a file name for the package, for example,
C:\tc.zip.
The specified path must be to an existing directory and the file name must end in .zip.
Caution
If you create a silent installation 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 distribution image.
program-name.log
program-name.syslog
program-name.out
Of these files, the system log (.syslog) files usually contain the most relevant error data. If an
auxiliary program completes successfully, the syslog file is deleted automatically unless you set the
TC_KEEP_SYSTEM_LOG environment variable to any value prior to starting the installation.
If any problems are encountered during the installation, the Teamcenter Rapid Start setup program
stops and reports the name of the log file to be inspected.
The Teamcenter Rapid Start setup program reports the names of the log file and directory at the end
of the installation process. Following a successful installation, the system administrator can delete all
files under these directories.
To work around this issue for the duration of Rapid Start installation, perform the following steps to
temporarily change the Windows local group policy:
1. Click Start→Run, and then enter gpedit.msc.
2. In the Local Group Policy Editor, expand the Computer Configuration tree to the User Rights
Assignment item:
Computer Configuration→Windows Settings→Security Settings→Local
Policies→User Rights Assignment
a. Double-click Access this computer from the network. Add Everyone to the list of users
and groups granted access, and then click OK.
b. Double-click Deny access to this computer from the network. Remove Guest and
Everyone from the list of users and groups denied access, and then click OK.
These settings should allow you to complete Rapid Start installation. After Rapid Start installation is
complete, you may restore the previous local group policy settings.
If you do not want to change policies, change the logon credentials for the installation administrative
user before you proceed with Rapid Start installation.
Note
2. In the Maintenance panel, select Configuration Manager and then click Next.
3. In the Configuration Maintenance panel, select Remove configuration (uninstall) and then
click Next.
4. In the Old Configuration panel, ensure that the Teamcenter installation that you want to uninstall
is selected and then click Next.
6. On servers only, in the Uninstall Teamcenter Foundation panel, you can select whether
or not you want to delete the TC_DATA directory, the database, and the volume during the
uninstallation. To delete them, select Advanced Uninstall Options, and then select REMOVE
database, TC_DATA and volume. Click Next.
The Teamcenter Visualization (Embedded) for Rich Client panel appears.
8. In the Confirmation panel, verify that the features you want removed are listed and then select
Start.
Solution Features
Corporate Server FMS Server Cache
NX Part Family Classification Integration
Rich Client 2-tier Teamcenter Rich Client 2-tier
Rich Client 4-tier Teamcenter Rich Client 4-tier
Rich Client (2-tier and 4-tier) Teamcenter Rich Client (2-tier and 4-tier)
Business Modeler IDE Business Modeler IDE Standalone
• Some features are disabled because they require other features. To enable a feature,
select its prerequisite features. For information about feature prerequisites, see the
feature description.
• Some features cannot be installed in the same configuration, so selecting one disables
the other.
Flex License Server Installs the license server for Teamcenter Rapid Start.
Business Modeler IDE Standalone Installs only the Business Modeler IDE client without requiring a connection to
a Teamcenter server.
Business Modeler IDE 2-tier Installs the two-tier Business Modeler IDE client. This client connects to
the Teamcenter server using IIOP.
Business Modeler IDE 4-tier Installs the four-tier Business Modeler IDE client. This client connects to a
Teamcenter server in a four-tier environment using HTTP.
Teamcenter Rich Client (2-tier and 4-tier) Installs a rich client that uses the communication infrastructure introduced in
Teamcenter 11.2.
This rich client is configurable for both two-tier and four-tier deployments. It
connects to the Teamcenter server (in a two-tier environment) or web tier
(in a four-tier environment) using Teamcenter client communication system
(TCCS). This differs from the existing two-tier rich client that connects directly
to the Teamcenter server using IIOP protocol, and the existing four-tier rich
client that connects directly to the Teamcenter web tier using HTTP protocol.
The newer TCCS-based rich client architecture provides the ability to stream
responses from the Teamcenter server (tcserver) to the client, an advantage
over the previous two- and four-tier architectures that required server
responses be completely prepared before sending.
Note
Teamcenter Rich Client 4-tier Installs a four-tier rich client that connects directly to the Teamcenter web tier
using HTTP protocol.
Note
For a smaller site, you can install the server manager and Teamcenter servers
on the same host as the web tier application. For deployment options for
larger sites, you can install the server manager on a separate host.
Full Text Search Engine Installs Autonomy Intelligent Data Operating Layer (IDOL) server, the default
full-text search engine, and configures searching for the local database.
IDOL works with the IDOL server, DiSH server and File System Fetch as three
services installed. The IDOL installer does not support the silent install option.
Teamcenter Management Console Installs Teamcenter Management Console, an SSL-secured console for
managing and monitoring server-side components such as the Java EE
server manager and Java EE web tier. The console's tabbed interface
resembles a web application server console. Teamcenter administrators
can use the console to access multiple Teamcenter management features
from a single page.
Teamcenter Security Services Configures Security Services for Teamcenter. These services eliminate
prompts for logon credentials when users switch Teamcenter products within
a user session.
Prerequisite:
Required information:
Installing the Action Manager service is required to enable the rich client
Subscription Monitor application.
Subscription Manager Service Monitors the database event queue for the creation of subscription event
objects.
Note
Note
For information about using Teamcenter Integration for NX, see Teamcenter
Integration for NX in the NX help collection.
NX Foundation Installs default data types and loads template NX data to support , the
Teamcenter integration with Siemens PLM Software NX provided through
NX Remote Manager.
NX Rich Client Integration Installs Teamcenter Integration for NX for the rich client. This feature requires
Teamcenter Rich Client 2-tier or Teamcenter Rich Client 4-tier.
Related topics
• Managing variability of your entire product suite
Solution Description
Over-the-Web Installer Installs the program that installs the rich client over the web.
This solution is required.
Microsoft Visual C++ Installs the Microsoft Visual C++ libraries required for the rich
2005/2008/2010/2012 client and for the FMS client cache (FCC).
Redistributables
Teamcenter client Installs Teamcenter client communication system (TCCS).
communication system
TCCS contains the FMS client cache (FCC), which uploads files
from a Teamcenter client workstation to a Teamcenter volume
and also downloads requested files from the volume to a client
workstation. An FCC provides the following advantages:
• Improved file transfer performance
• File streaming
To configure Teamcenter online help after Teamcenter installation, or to change online help access for
Teamcenter Rapid Start clients, perform the following procedures where appropriate.
• Four-tier rich client installed through TEM
To configure online help for a Teamcenter rich client you installed using TEM (not using the
Over-the-Web Installer), set the following preferences.
Preference Value
WEB_core_help_server http://host:port/tdoc/tc/version/help/
host and port are the host name and port of the PLM
Documentation Server. version is the Teamcenter
version or SP level. For example:
http://myhost:8181/tdoc/tc/11.2/help/
WEB_help_server http://host:port/tdoc/tc/version/help/
#filename:thin_client_dhtml:getting_started
host and port are the host name and port of the PLM
Documentation Server. version is the Teamcenter
version or SP level.
This preference specifies the location of the thin
client online help. The part of this value preceding
the hash symbol (#) should match the value of the
WEB_core_help_server preference.
Next, in the Rich Client Settings panel, select the Enable Online Help check box, and then
type the online help URL in the Web server URL box.
Note
Alternatively, you can configure online help for a two-tier rich client by setting the following
values in the site_specific.properties file for on the rich client host.
Property Value
portalHelpWebServer http://
host and port are the host name and port of the PLM Documentation
Server. version is the Teamcenter version or SP level. For example:
myhost:8181/tdoc/tc/11.2/help/
The Full Text Search option installs the Teamcenter Rapid Start full text search engine. The full text
search engine enables users to retrieve objects from the Teamcenter Rapid Start database based on
search criteria. It allows users to specify searches on metadata values, as well as full text retrieval
searches on both metadata and common forms of text data.
This option is available when you perform a custom installation. You can also use Teamcenter
Environment Manager to add this feature after the installation in complete. Before you install or
configure the full text search engine, you must install Teamcenter Rapid Start.
1. Launch Teamcenter Environment Manager in maintenance mode. In the Windows start menu,
click Programs→Teamcenter 11.2, 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 Rapid Start installation. Right-click the tem.bat program icon and select
Run as administrator.
4. In the Old Configuration panel, select the installation to which you want to add the full text
search feature.
6. In the Features panel, under Server Enhancements, select the Full Text Search Engine
feature.
Note
If TEM cannot find one of the software media locations specified during the initial
installation or in a previous patch, TEM may display the Media Verification panel, in
which to can verify or update the locations of Teamcenter Rapid Start software distribution
images.
7. In the Teamcenter Administrative User panel, enter the password for the Teamcenter Rapid
Start administrative user account.
The value in the User box is read-only during this step.
Caution
The password must not be empty nor contain any whitespace characters such as space,
tab, newline, carriage return, form feed, or vertical tab.
In addition, the password must not contain any of the following characters:
!@$%=&'":;.<>(){}
8. In the Full Text Search panel, enter settings for the full text search feature:
Box Description
DISH Service Configuration
ACI Port Specifies the number of the port on which Autonomy
Content Infrastructure (ACI) sends action commands to
the Autonomy server (Suir).
The default value is 20000.
Service Port Specifies the service port number.
The default value is 20002.
IDOL Service Configuration
ACI Port Specifies the number of the port on which Autonomy
Content Infrastructure (ACI) sends action commands to
the Autonomy server (Suir).
The default value is 9000.
Service Port Specifies the service port number.
The default value is 9002.
Index Port Specifies the number of the port on which the search
engine is to perform indexing.
The default value is 9001.
File System Fetch Service Configuration
ACI Port Specifies the number of the port on which Autonomy
Content Infrastructure (ACI) sends action commands to
the Autonomy server (Suir).
The default value is 7000.
Service Port Specifies the service port number.
The default value is 10223.
9. In the Confirmation panel, review your selections and click Start to convert your Teamcenter
Rapid Start configuration to Teamcenter.
Headquarters
Europe
Granite Park One
Stephenson House
5800 Granite Parkway
Sir William Siemens Square
Suite 600
Frimley, Camberley
Plano, TX 75024
Surrey, GU16 8QD
USA
+44 (0) 1276 413200
+1 972 987 3000
Asia-Pacific
Americas
Suites 4301-4302, 43/F
Granite Park One
AIA Kowloon Tower, Landmark East
5800 Granite Parkway
100 How Ming Street
Suite 600
Kwun Tong, Kowloon
Plano, TX 75024
Hong Kong
USA
+852 2230 3308
+1 314 264 8499