TeamcenterKnowledge

Getting started with Teamcenter utilities

Setting up a Teamcenter command-line environment

All server-side Teamcenter command-line utilities must be run within a Teamcenter environment. A Teamcenter environment has many operating system environment variables configured with information about the license server, database connection, password file locations, and so on. Setting the Teamcenter environment variables To create a Teamcenter environment, you must set two environment variables and then run a script to set the rest. Set the value of TC_ROOT to the directory where the Teamcenter software is located. Copy set TC_ROOT=C:\apps\tc\tcroot Set the value of TC_DATA to the directory where the information about the Teamcenter database's is located. Copy set TC_DATA=C:\apps\tc\tcdata Run the tc_profilevars script. Copy call %TC_DATA%\tc_profilevars Your command-line is now ready to run utilities. Example To check the Teamcenter database version in Windows, use the 'ask_version' argument of the install command. Copy set TC_ROOT=C:\apps\tc\tcroot set TC_DATA=C:\apps\tc\tcdata call %TC_DATA%\tc_profilevars install -ask_version Example To check the Teamcenter database version in Linux, use the 'ask_version' argument of the install command. Copy TC_ROOT=/apps/tc/tcroot; export TC_ROOT TC_DATA=/apps/tc/tcdata; export TC_DATA . $TC_DATA/tc_profilevars install -ask_version The TC_ROOT directory The TC_ROOT environment variable points to a directory where Teamcenter software is located. Although this software connects to a Teamcenter database, there is no specific database information in this directory. There can be many TC_ROOT directories throughout your site, each one serving a different purpose. Each time you install Teamcenter software, that will be the TC_ROOT directory for the software that runs from that directory. For example, if you have 3 different volume servers, the value of TC_ROOT for each of those FSC processes will be different. The TC_DATA directory The TC_DATA environment variable points to a directory which contains the information needed to connect Teamcenter software to a single Teamcenter database. For each Teamcenter database, there must be only one TC_DATA directory. This directory is shared and then mounted by each machine with a TC_ROOT directory. Caution While it is technically possible to avoid network sharing and make copies of a Teamcenter database's TC_DATA directory, it is not a best practice. However, if you do make copies, you must track all copies and ensure that they all stay in perfect synchronization with the original. Any discrepancy may lead to data corruption. The tc_profilevars script This script sets the environment variables required to connect to a specific Teamcenter database, and It is located in the TC_DATA directory. It sets environment variables which tell the Teamcenter software what kind of RDBMS it is connecting to, where to find it, and its credentials, as well as where to find the licensing servers, a local copy of the POM schema, the FSC configuration, and so on. To run it properly, you must set two environment variables first. TC_ROOT Represents the Teamcenter software used to connect to a Teamcenter database. TC_DATA Represents the Teamcenter database the software connects to. Provided script on Windows systems On Windows-based Teamcenter servers, a Command Prompt script is available which sets up the environment for you. You will find this in the Windows Start menu in the Teamcenter folder.

Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/utilities_reference/ang1737253682625/xid364275.html · retrieved Fri Jul 31 2026 00:00:00 GMT+0000 (Coordinated Universal Time)