Download as pdf or txt
Download as pdf or txt
You are on page 1of 135

Tecnomatix 2402

Installation Guide on
eMServer
Unpublished work. © 2024 Siemens

This Documentation contains trade secrets or otherwise confidential information owned by Siemens Industry Software Inc. or its affiliates
(collectively, “Siemens”), or its licensors. Access to and use of this Documentation is strictly limited as set forth in Customer’s applicable
agreement(s) with Siemens. This Documentation may not be copied, distributed, or otherwise disclosed by Customer without the
express written permission of Siemens, and may not be used in any way not expressly authorized by Siemens.

This Documentation is for information and instruction purposes. Siemens reserves the right to make changes in specifications and other
information contained in this Documentation without prior notice, and the reader should, in all cases, consult Siemens to determine
whether any changes have been made.

No representation or other affirmation of fact contained in this publication shall be deemed to be a warranty or give rise to any liability of
Siemens whatsoever.

If you have a signed license agreement with Siemens for the product with which this Documentation will be used, your use of this
Documentation is subject to the scope of license and the software protection and security provisions of that agreement. If you do
not have such a signed license agreement, your use is subject to the Siemens Universal Customer Agreement, which may be viewed
at https://www.sw.siemens.com/en-US/sw-terms/base/uca/, as supplemented by the product specific terms which may be viewed at
https://www.sw.siemens.com/en-US/sw-terms/supplements/.

SIEMENS MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS DOCUMENTATION INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT OF INTELLECTUAL PROPERTY.
SIEMENS SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL OR PUNITIVE DAMAGES, LOST DATA OR
PROFITS, EVEN IF SUCH DAMAGES WERE FORESEEABLE, ARISING OUT OF OR RELATED TO THIS DOCUMENTATION OR THE INFORMATION
CONTAINED IN IT, EVEN IF SIEMENS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

TRADEMARKS: The trademarks, logos, and service marks (collectively, "Marks") used herein are the property of Siemens or other parties.
No one is permitted to use these Marks without the prior written consent of Siemens or the owner of the Marks, as applicable. The use
herein of third party Marks is not an attempt to indicate Siemens as a source of a product, but is intended to indicate a product from,
or associated with, a particular third party. A list of Siemens' Marks may be viewed at: https://www.plm.automation.siemens.com/
global/en/legal/trademarks.html. The registered trademark Linux® is used pursuant to a sublicense from LMI, the exclusive licensee of
Linus Torvalds, owner of the mark on a world-wide basis.

About Siemens Digital Industries Software


Siemens Digital Industries Software is a global leader in the growing field of product lifecycle management (PLM), manufacturing
operations management (MOM), and electronic design automation (EDA) software, hardware, and services. Siemens works with
more than 100,000 customers, leading the digitalization of their planning and manufacturing processes. At Siemens Digital Industries
Software, we blur the boundaries between industry domains by integrating the virtual and physical, hardware and software, design and
manufacturing worlds. With the rapid pace of innovation, digitalization is no longer tomorrow’s idea. We take what the future promises
tomorrow and make it real for our customers today. Where today meets tomorrow. Our culture encourages creativity, welcomes fresh
thinking and focuses on growth, so our people, our business, and our customers can achieve their full potential.

Support Center: https://support.sw.siemens.com

Send Feedback on Documentation: https://support.sw.siemens.com/doc_feedback_form

ii Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Contents
Tecnomatix applications installation.................................................... 1-1

Workflow............................................................................................... 2-1
Three-tier installation...................................................................................... 2-1
Setting up Tecnomatix applications in non-English languages....................... 2-1
Compact installation........................................................................................ 2-3
Full client-server installation........................................................................... 2-3

Installing Tecnomatix Applications....................................................... 3-1


Important setup information........................................................................... 3-1
Launching the installation wizard....................................................................3-6
Side-by-side Tecnomatix versions.................................................................... 3-8
Side-by-side installation..................................................................................3-8
Tecnomatix Version Selector........................................................................... 3-9
Performing a Client/Server installation..........................................................3-10
Performing a Tecnomatix server installation.................................................3-21
Performing a Tecnomatix client installation..................................................3-28
Performing a Tecnomatix standalone installation.........................................3-40
Performing a Tecnomatix administration tools installation.......................... 3-50
Launch Tecnomatix applications from the command line............................. 3-57
Installing Release Updates............................................................................. 3-59

Setting up Tecnomatix applications in non-English languages............ 4-1

Install local HTML documentation.........................................................5-1

Performing a Tecnomatix silent installation......................................... 6-1

Installation information for administrators.......................................... 7-1

Setting the eMSAgent and eMServer to automatic login..................... 8-1

Removing the Tecnomatix installation..................................................9-1

Configuring the client and server environment..................................10-1

Preparing the Windows Server machine............................................. 11-1

Tecnomatix 2402 Installation Guide on eMServer iii


Unpublished work. © 2024 Siemens
Setting the client environment........................................................... 12-1

Setting Chinese or Japanese as the operating system language on


Windows 10................................................................................ 13-1

Tecnomatix database prerequisites.................................................... 14-1

Preparing the domain group policy to allow MMC snap-ins............... 15-1

ArtiMinds RPS Installation................................................................... 16-1

iv Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
1. Tecnomatix applications installation
This topic describes the installation and configuration of Tecnomatix applications. It contains the following
sections:

• Workflow, which describes its basic configuration and architecture.


• Installing Tecnomatix Applications, which provides a detailed explanation of how to install the
eMServer and client applications.
• Setting the eMSAgent and eMServer to automatic login, which describes how Client applications can
access the eMServer without having logged in to the eMServer machine.

Note
For information on installation of the Oracle Database Server, refer to the Admistration Guide.

The sections that follow will guide you through the Tecnomatix installation process. If some parts of the
system are already functional, refer only to the sections that describe the required installation procedures.

Note
• When performing installation, you require administration rights. Therefore, when launching the
installation, right-click the installation file and select Run as administrator.
• Perform installation directly from the installation file on the installation DVD by launching Setup.exe.
• Throughout the Tecnomatix installation, before proceeding to a subsequent section of the installation,
you should verify that the component you just installed is working properly. For example, make sure
that the database is functional before proceeding to eMServer installation.
• The default installation folder is <Program Files>\Tecnomatix_<VERSION>.
◦ In a 64bit setup, the setup program creates a folder named eMPower and nests it under the
installation folder. The 64bit setup files are stored in eMPower. If you install a client application on
the same machine, the setup program creates a folder named eMPower32 and also nests it under
the installation folder. The 32bit setup files for the client application are stored in eMPower32.
◦ If you select an installation path that does not end with a Tecnomatix folder, the setup program
automatically creates a folder named Tecnomatix and nests it under the installation folder. For
example, when performing a StandAlone 64bit installation under C:\apps:
◊ The installation folder is C:\apps\Tecnomatix_<VERSION>.
◊ 64bit files are stored under C:\apps\Tecnomatix_<VERSION>\eMPower.
◊ 32bit files are stored under C:\apps\Tecnomatix_<VERSION>\eMPower32.

Tecnomatix 2402 Installation Guide on eMServer 1-1


Unpublished work. © 2024 Siemens
1-2 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
Three-tier installation

2. Workflow
Three-tier installation
In the three-tier installation, the Oracle database is installed on its own hardware platform. The eMServer
is also installed on its own hardware platform and consists of the Oracle client and the eMServer. The
Client applications are then installed on the end-user machines.

Follow the steps below to complete the installation of the eMServer tiers:

Procedure

1. Install and configure the Oracle database (tier 1), as described in the Oracle Server Installation
section in the Tecnomatix Administration documentation, according to the Oracle compatibility
matrix - Tecnomatix database prerequisites .
2. Install the eMServer.
3. Configure the eMServer and perform various administrative tasks, as described in the Schema
Administration section of the Tecnomatix Administration documentation.
4. Install the various client applications to complete the installation of the client tier (tier 3).

The eMServer processes are now up and running, and users can log in to the different client applications
and begin working.

Setting up Tecnomatix applications in non-English languages

• From the Tecnomatix setup DVD, perform the standard (English) installation of Process Simulate or
Process Designer.
• From the setup DVD, open the Add-Ons\Localization folder.
• Run the .msi file for the language in which you wish to operate the Tecnomatix application. If you
installed more than one application, the language change applies to all of them.

Note
◦ For Windows 10, it is necessary to run the setup as an administrator. You can right-click to open a
command prompt using Run as Administrator, and run the .msi from the window that opens.
◦ Make sure that the Beta Use Unicode UTF-8 for worldwide language support checkbox in the
Administrative Language settings is not checked.

Tecnomatix 2402 Installation Guide on eMServer 2-1


Unpublished work. © 2024 Siemens
Note
Tecnomatix applications are available in the following additional languages:
◦ German
◦ Spanish
◦ French (France)
◦ Portuguese (Brazil)
◦ Chinese

2-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Compact installation

◦ Japanese

• From Tecnomatix Doctor, set the language in the Change Language dialog described in the Tecnomatix
Administration documentation.

Compact installation

In the compact installation, the Oracle database is installed on its own hardware platform. The eMServer is
installed on a separate hardware platform, and includes the Oracle client. The client applications are also
installed on this machine.

After you have installed and configured the Oracle database (tier 1), the next step is to install the
components of the eMServer hardware platform (tier 2), as follows:

Procedure

1. Install Oracle client according to the Oracle compatibility matrix - Tecnomatix database
prerequisites.
2. Install the client and server, as described in Installing Tecnomatix Applications.
3. Configure the eMServer and perform various administrative tasks, as described in the Schema
Administration section of the Tecnomatix Administration documentation.

The eMServer processes are now up and running, and users can log in to the different client applications
and begin working.

Full client-server installation

In the full client-server installation, all components are installed on a single hardware platform. This
includes the Oracle database and the client/server applications. After you have installed and configured the
Oracle database, Oracle client and ODP.NET, the install the following components of the configuration:

Procedure

1. Install Oracle according to the Oracle compatibility matrix - Tecnomatix Database Prerequisites.
2. Install the client and server, as described in Installing Tecnomatix Applications.

Tecnomatix 2402 Installation Guide on eMServer 2-3


Unpublished work. © 2024 Siemens
3. Configure the eMServer and perform various administrative tasks, as described in the Schema
Administration section of the Tecnomatix Administration documentation.

The eMServer processes are now up and running, and users can log in to the different client applications
and begin working.

2-4 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Important setup information

3. Installing Tecnomatix Applications


Important setup information

Note
Setup requires that .NET framework 4.8 or above is installed. You can download it from https://
dotnet.microsoft.com/en-us/download/dotnet-framework.

Tecnomatix Supported Operating Systems - (Process Designer, Process Simulate)

Operating System - 64bit / CPU x86-64 Tecnomatix 2301, 2307, 2402


Windows 10 - Enterprise edition Supported
Windows 11 - Enterprise edition Supported
Windows Server 2016 - Standard edition Supported
Windows Server 2019 - Standard edition Supported
Windows Server 2022 - Standard edition Supported

Note
Limited support: The Operating System is no longer used in development and no support is available
from the vendor. Siemens Digital Industries Software will attempt to duplicate on a current supported
version. An Operating System upgrade is required for full support.

Interactive users are not supported in Windows 10.

Tecnomatix 2402 Installation Guide on eMServer 3-1


Unpublished work. © 2024 Siemens
Third-party Applications

When performing an installation, the following third-party applications will be installed automatically,
depending on which Tecnomatix applications are installed:

Third-party Merge Module Included in product


ATL 7.1 All
MFC 7.1 All
Microsoft C Runtime Library 7.1 All
Microsoft C++ Runtime Library 7.1 All
Microsoft Common Dialog Control 6.0 WEB
Microsoft Component Category Manager Library WEB
Microsoft Data Formating Object Library 6.0 Web-Based BOP Manager
Microsoft Tabbed Dialog Control 6.0 Web-Based BOP Manager
Microsoft Visual Basic Virtual Machine-6.0 Web-Based BOP Manager
Visual C++ 8.0 ATL (x86) WinSXS MSM Client
Visual C++ 8.0 ATL (x86_x64) WinSXS MSM All
Visual C++ 8.0 ATL.Policy (x86) WinSXS MSM Client
Visual C++ 8.0 ATL.Policy (x86_x64) WinSXS MSM All
Visual C++ 8.0 CRT (x86) WinSXS MSM Client
Visual C++ 8.0 CRT (x86_x64) WinSXS MSM All
Visual C++ 8.0 CRT.Policy (x86) WinSXS MSM Client
Visual C++ 8.0 CRT.Policy (x86_x64) WinSXS MSM All
Visual C++ 8.0 MFC (x86) WinSXS MSM Client
Visual C++ 8.0 MFC (x86_x64) WinSXS MSM All
Visual C++ 8.0 MFC.Policy (x86) WinSXS MSM Client
Visual C++ 8.0 MFC.Policy (x86_x64) WinSXS MSM All
Visual C++ 9.0 ATL (x86) WinSXS MSM Client
Visual C++ 9.0 ATL (x86_x64) WinSXS MSM All
Visual C++ 9.0 ATL.Policy (x86) WinSXS MSM Client
Visual C++ 9.0 ATL.Policy (x86_x64) WinSXS MSM All

3-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Third-party Merge Module Included in product
Visual C++ 9.0 CRT (x86) WinSXS MSM Client
Visual C++ 9.0 CRT (x86_x64) WinSXS MSM All
Visual C++ 9.0 CRT.Policy (x86) WinSXS MSM Client
Visual C++ 9.0 CRT.Policy (x86_x64) WinSXS MSM All
Visual C++ 9.0 MFC (x86) WinSXS MSM Client
Visual C++ 9.0 MFC (x86_x64) WinSXS MSM All
Visual C++ 9.0 MFC.Policy (x86) WinSXS MSM Client
Visual C++ 9.0 MFC.Policy (x86_x64) WinSXS MSM All
Visual C++ 10.0 ATL (x86) All
Visual C++ 10.0 ATL (x64) All
Visual C++ 10.0 CRT (x86) All
Visual C++ 10.0 CRT (x64) All
Visual C++ 10.0 MFC (x86) All
Visual C++ 10.0 MFC (x64) All
Visual C++ 12.0 OpenMP (x86) All
Visual C++ 12.0 OpenMP (x64) All
Visual C++ 12.0 MFC (x86) All
Visual C++ 12.0 MFC (x64) All
Visual C++ 12.0 MFCLOC (x86) All
Visual C++ 12.0 MFCLOC (x64) All
Visual C++ 12.0 CXXAMP (x86) All
Visual C++ 12.0 CXXAMP (x64) All
Visual C++ 12.0 CRT (x86) All
Visual C++ 12.0 CRT (x64) All

Setup Prerequisites

Tecnomatix 2402 Installation Guide on eMServer 3-3


Unpublished work. © 2024 Siemens
Setup prerequisite Required for
.NET Framework 4.8 Windows 10 \ Windows 11
.NET Framework 4.8.1 Server 2012 R2 \ Server 2016 \ Server
2019
MSXML 6.0 SP1 (x86) All setup types
MSXML 6.0 SP1 (x64) All setup types
Microsoft Visual C++ 2012 Update 4 (V11.0.61030.0) All setup types
Redistributable Package (x64)
Microsoft Visual C++ 2015-2022 (V14.32.31332.0) All setup types
Redistributable Package (x64)
Microsoft Visual C++ 2015-2022 (V14.32.31332.0) All setup types
Redistributable Package (x86)
Microsoft Edge WebView2* Process Simulate Teamcenter Platform

* This setup is being installed during Tecnomatix installation and not as prerequisite.

3-4 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Setup Logs

The system creates the following log files during installation:

Tecnomatix_V<Version>_Install_Summary_<date>-<time>.log – Notes when the installation began and


ended and lists the applications and components installed as well as options selected during setup. For
example, setup type, installation directory, eMServer name. This log file is created under the %TEMP%
directory and copied to the <INSTALL DIR>\Setuplogs folder in the installation directory when setup is
complete.

Tecnomatix_V<Version>_Install_<date>-<time>.log– Lists custom actions executed during setup as well


as possible errors, for example, dll registration errors, copying ems system root files failure, create COM+
Application failure. This file is created under the %TEMP% directory and copied to <INSTALL DIR>\Setuplogs
when setup is completed.

Setup also creates the MSI log file:

• For silent installations, the MSI log name and path are set as an MSI_LOGFILE_VAR parameter to the
setup (e.g., set MSI_LOGFILE_VAR=%TEMP%\Tecno13.1.1_64bit_MSI_Install.log).
• For regular installations, the MSI log file is created under the %TEMP% with a
random name in the MSIXXXXX.LOG format. When setup is complete it creates the
Tecnomatix_V<Version>_Install_<date>-<time>_msi.log shortcut to the MSI log under <INSTALL
DIR>\Setuplogs. In addition, the path to the MSI log file can be found in the
Tecnomatix_V<Version>_Install_Summary.log file.

Tecnomatix 2402 Installation Guide on eMServer 3-5


Unpublished work. © 2024 Siemens
Launching the installation wizard

Launching the installation wizard

Procedure

1.
Insert the Tecnomatix DVD into the DVD drive. The DVD Browser is displayed.

2. Click Install Tecnomatix Products. An Install screen is displayed.

3-6 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
3. Click Install Tecnomatix.
A welcome screen is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-7


Unpublished work. © 2024 Siemens
Side-by-side Tecnomatix versions

4. Proceed with the desired installation, as described in the following sections.


• Performing a Tecnomatix Client/Server Installation
• Performing a Tecnomatix Server Installation
• Performing a Tecnomatix Client Installation
• Performing a Tecnomatix Standalone Installation
• Performing a Tecnomatix Administration Tools Installation
• Performing a Tecnomatix Silent Installation (using a batch file)

Side-by-side Tecnomatix versions

Side-by-side installation

When installing the Tecnomatix suite of applications, you can install new client setup types while retaining
your current ones. This is known as Side-by-Side Installation and is useful if you want to work with different
Tecnomatix versions for multiple customers or to debug your data by running it under different software
versions. One version is always active and this version is launched by default until you change the active
version.

3-8 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Tecnomatix Version Selector

You can install multiple eMServer-based or multiple Process Simulate on Teamcenter versions. For
example, you can install an earlier eMServer-based version (e.g., 12.1, 12.1.3) and then eMServer-based
version 2402 on the same machine. Similarly, you can install Process Simulate on Teamcenter version
12.1.3 and then version 2402 on the same machine.

Note
The Common Folder is a location to be used by all Tecnomatix versions. The Tecnomatix Version
Selector is installed in this location.

Tecnomatix Version Selector

Procedure

1. To access the selector, right-click the Tecnomatix Version Selector icon and select Run as
administrator.

Current active Tecnomatix version is a read-only field and notifies you which version is currently
active.

Note
You can also view the currently active version by running mpmversion from the command prompt.

2. If you wish to change to another version, right-click the Tecnomatix Version Selector icon and select
Run as administrator. The Tecnomatix Version Selector appears.
3. Set Change active Tecnomatix version to to the desired version and click OK.
The system switches to the version you selected. This may take a few minutes, after which the system
displays a success message and offers you the option to view the installation log file.

Tecnomatix 2402 Installation Guide on eMServer 3-9


Unpublished work. © 2024 Siemens
Performing a Client/Server installation

Note
• You can only uninstall the active version. Uninstalling a version that is not currently-active
may result in an unstable system. Therefore, before running the uninstall procedure, use the
Tecnomatix Version Selector to activate the version you wish to uninstall.
• If you remove the older version of two side by side installations (older than 12.1.1),
the remaining (newer) version does not automatically become the active version. Use the
Tecnomatix Version Selector to switch to it.

Performing a Client/Server installation

When performing a Client/Server installation, administration tools (available in Start → Programs →


Tecnomatix → Administration Tools) are installed automatically.

The configuration provided by the Client/Server installation supplies a complete Tecnomatix environment,
containing both Application server and Client components in a single hardware framework. With this
setup, no separate, additional machine is required for client operations.

Before beginning to install Tecnomatix 2402, make sure that the ODP.NET (including ‘Oracle Data Provider
for .NET’) is installed according to the Oracle compatibility matrix - Tecnomatix Database Prerequisites.
When setting Oracle Home immediately before the Tecnomatix installation, it is recommended to restart
your machine before installing Tecnomatix 2402 to ensure that the path variable is updated.

3-10 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Procedure

1. From the Welcome screen, click Next.


The Setup Type dialog box is displayed.

2. Select Install eMServer and Client Applications and click Next.


The Custom Setup dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-11


Unpublished work. © 2024 Siemens
3. Select the client applications you wish to install.
• The Process Designer application. Refer to the Process Designer documentation.
• The Process Simulate installation is the complete client application. Refer to the Process Simulate
documentation.

Note
The Common Folder is a location to be used by all Tecnomatix versions. The Tecnomatix Version
Selector is installed in this location.

3-12 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
4. (Optional) You can click Change in the Custom Setup window if you wish to change the default
installation location.
The Change Current Destination Folder window is displayed.

5. Choose the folder in which you want Tecnomatix to be installed and click OK.
6. Click Next.
The Controllers setup dialog box is displayed. You can select one or more Tecnomatix robot
controllers to install.

Tecnomatix 2402 Installation Guide on eMServer 3-13


Unpublished work. © 2024 Siemens
Note
Check the Use an existing rrs.xml file option if you wish to select and install a previous or already
existing rrs.xml file in <INSTALL DIR>\Robotics\OLP instead of the default file installed by the
Tecnomatix setup.
This option is unselected by default.

7. Click Next.
The Product Excellence Program (PEP) screen displays.

3-14 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Click one of the following
• AGREE—PEP collects information on how you use the application which allows Siemens Digital
Industries Software to improve the product and its functionality. No information is ever exposed to
outside parties.
• DECLINE—No information is collected.

Note

If you decline to participate in the Product Excellence Program, then when running Process
Simulate, clicking

Tecnomatix 2402 Installation Guide on eMServer 3-15


Unpublished work. © 2024 Siemens
opens the Product Excellence Program screen, enabling you to join.
Alternatively, you can change your selection at any time using the Data Privacy menu of the
Tecnomatix Doctor.

When you agree to take part in the Product Excellence Program, you also have access to the
Feedback feature that gives you a direct channel to help make Process Simulate a better tool for your
needs, by allowing you to send feedback directly from Process Simulate. You have the option to add
your email to allow us to be in contact with you, and you can take a web survey.

8. Click Next.
The Choose System Root Location dialog box for the eMServer system root is displayed.

3-16 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
9. Click Next.
If you selected the Process Simulate Teamcenter Platform, the Teamcenter Manufacturing Access
dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-17


Unpublished work. © 2024 Siemens
These parameters are not relevant for an eMServer installation.
10. Click Next.
The Ready to Install dialog box is displayed.

3-18 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
11. Click Install.
The Installing Tecnomatix dialog box displays with a progress bar, enabling you to track the progress
of the installation.

Tecnomatix 2402 Installation Guide on eMServer 3-19


Unpublished work. © 2024 Siemens
When the installation process is complete, the following message is displayed:

3-20 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
12. Click Finish.

Configuring the eMServer for a Client/Server Installation

After you have completed the installation, you must configure the connection between the Oracle
database and the eMServer in order to be able to log in. See the Associating eMServer with a Schema
and Configuring Optional eMServer Settings sections in the Tecnomatix Administration documentation
for more details.

Note
Check if Release Updates are available.

Performing a Tecnomatix server installation

• Click this link for information about Preparing the Windows 2008 Server Machine.
• When performing a Server installation, administration tools (available in Start > Programs > Tecnomatix
> Administration Tools) are installed automatically.

Tecnomatix 2402 Installation Guide on eMServer 3-21


Unpublished work. © 2024 Siemens
Server installations support multi-user environments. Make sure that the Oracle server is installed
according to the Oracle compatibility matrix - Tecnomatix database prerequisites. Also, make sure
that Oracle Home is set accordingly. When setting Oracle Home immediately before the Tecnomatix
installation, it is recommended to restart your machine before installing Tecnomatix to ensure that the
path variable is updated.

Note
The client version must be identical to the server version.

Procedure

1. From the Welcome screen, click Next.


The Setup Type dialogs box is displayed.

2. Click Next.
Select Install eMServer and click Next.
The Custom Setup dialog box is displayed.

3-22 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Note
The Common Folder is a location to be used by all Tecnomatix versions. The Tecnomatix Version
Selector is installed in this location.

3. (Optional) The default location is displayed. If a different location is required, click Change.
The following window is displayed:

Tecnomatix 2402 Installation Guide on eMServer 3-23


Unpublished work. © 2024 Siemens
Choose the folder in which you want Tecnomatix to be installed and click OK.
The Custom Setup dialog box reappears.
4. Click Next.
The Choose System Root Location dialog box for the eMServer system root is displayed:

3-24 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
5. Click Change to specify the destination of the eMServer system root (UNC paths are also accepted,
but make sure that the SystemRoot is a separate folder under the shared one), and click Next.
The Delete Old Items dialog box is displayed.

Check Delete old items if you wish to delete the items that the setup program has detected
remaining from previous Tecnomatix installations. If you do not wish to delete these items, leave
the checkbox clear.

Tecnomatix 2402 Installation Guide on eMServer 3-25


Unpublished work. © 2024 Siemens
6. Click Next.
The Ready to Install dialog box is displayed:

7. Click Install.
The Installing Tecnomatix dialog box displays with a progress bar, enabling you to track the progress
of the installation.

3-26 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
When the installation process is complete, the following message is displayed:

Tecnomatix 2402 Installation Guide on eMServer 3-27


Unpublished work. © 2024 Siemens
8. Click Finish.

Note
Check if Release Updates are available.

Performing a Tecnomatix client installation


When performing a Client installation, administration tools (available in Start → Programs →
Tecnomatix → Administration Tools) are installed automatically.
The AdminConsole runs facing the remote eMServer that you define in the installation.
When performing a Client installation, the fully qualified name of the server should be available on the
client (either via the DNS or by specifying it explicitly in the hosts file).

Procedure

1. From the Welcome screen, click Next.


The Setup Type dialog box is displayed.

3-28 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
2. Select Install Client Applications and click Next.
The Custom Setup dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-29


Unpublished work. © 2024 Siemens
3. Select the client applications you wish to install.
• The Process Designer application. Refer to the Process Designer documentation.
• Process Simulate. This is the complete client application.

Note
The Common Folder is a location to be used by all Tecnomatix versions. The Tecnomatix Version
Selector is installed in this location.

4. The Controllers setup dialog box is displayed. You can select one or more Tecnomatix robot
controllers to install.

3-30 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Note
Check the Use an existing rrs.xml file option if you wish to select and install a previous or already
existing rrs.xml file in <INSTALL DIR>\Robotics\OLP instead of the default file installed by the
Tecnomatix setup. This option is unselected by default.

5. The Product Excellence Program (PEP) screen displays.

Tecnomatix 2402 Installation Guide on eMServer 3-31


Unpublished work. © 2024 Siemens
Click one of the following
• AGREE—PEP collects information on how you use the application which allows Siemens Digital
Industries Software to improve the product and its functionality. No information is ever exposed to
outside parties.
• DECLINE—No information is collected.

Note
If you decline to participate in the Product Excellence Program, then when running Process
Simulate, clicking

opens the Product Excellence Program screen, enabling you to join.

3-32 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Alternatively, you can change your selection at any time using the Data Privacy menu of the
Tecnomatix Doctor.

When you agree to take part in the Product Excellence Program, you also have access to the
Feedback feature that gives you a direct channel to help make Process Simulate a better tool for your
needs, by allowing you to send feedback directly from Process Simulate. You have the option to add
your email to allow us to be in contact with you, and you can take a web survey.

6. (Optional) The default location is displayed. If a different location is required, click Change in the
Custom Setup window.
The following window is displayed:

Tecnomatix 2402 Installation Guide on eMServer 3-33


Unpublished work. © 2024 Siemens
Choose the folder in which you want Tecnomatix to be installed and click OK.
The Custom Setup dialog box reappears.
7. Click Next.
The Choose System Root Location dialog box is displayed.

3-34 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
8. Click Change and navigate to the system root of the eMServer. Click OK and Next.
The eMServer and eMSAgent Names dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-35


Unpublished work. © 2024 Siemens
This dialog box allows you to select an eMServer and the Notification Agent to which your client
application will connect. The system pings the server and the notification agent in order to check that
there is a working connection. Note however, that the installation continues even if the ping fails.
9. In the text box, enter the eMServer and the Notification Agent server name. Ensure that your entry
contains an active server installation.
10. Click Next.
If you selected the Process Simulate Teamcenter Platform, the Teamcenter Manufacturing Access
dialog box is displayed.

3-36 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
These parameters are not relevant for an eMServer installation.
11. Click Next.
The Delete Old Items dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-37


Unpublished work. © 2024 Siemens
Check Delete old items if you wish to delete the items that the setup program has detected
remaining from previous Tecnomatix installations. If you do not wish to delete these items, leave
the checkbox clear.
12. Click Next.
The Ready to Install dialog box is displayed.

13. Click Install.


The Installing Tecnomatix dialog box displays with a progress bar, enabling you to track the progress
of the installation.

3-38 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
When the installation process is complete, the following message is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-39


Unpublished work. © 2024 Siemens
14. Click Finish.

Note
Check if Release Updates are available.

Performing a Tecnomatix standalone installation

The following Process Simulate applications do not require a connection to the eMServer:

• Process Simulate Standalone


• Process Simulate VC Lite

Procedure

1. From the Welcome screen, click Next.


The Setup Type dialog box is displayed.

3-40 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
2. Select Install Client Applications and click Next.
The Custom Setup dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-41


Unpublished work. © 2024 Siemens
3. Select the client applications you wish to install.
• The Process Simulate Standalone installation is an option for users who only need to work in
disconnected mode. Choosing this setup installs just Process Simulate Standalone without Process
Simulate eMServer. All Process Simulate Standalone capabilities are fully supported. Refer to the
Process Simulate Standalone documentation.

• The Process Simulate VC Lite installation is an option for users who only need to perform virtual
commissioning. Refer to the Process Simulate VC Lite documentation. Refer to the Process Simulate
VC Lite documentation.

3-42 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Note
The Common Folder is a location to be used by all Tecnomatix versions. The Tecnomatix Version
Selector is installed in this location.

4. The Controllers setup dialog box is displayed. You can select one or more Tecnomatix robot
controllers to install.

Tecnomatix 2402 Installation Guide on eMServer 3-43


Unpublished work. © 2024 Siemens
Note
Check the Use an existing rrs.xml file option if you wish to select and install a previous or already
existing rrs.xml file in <INSTALL DIR>\Robotics\OLP instead of the default file installed by the
Tecnomatix setup. This option is unselected by default.

5. The Product Excellence Program (PEP) screen displays.

Click one of the following


• AGREE—PEP collects information on how you use the application which allows Siemens Digital
Industries Software to improve the product and its functionality. No information is ever exposed to
outside parties.
• DECLINE—No information is collected.

Note
If you decline to participate in the Product Excellence Program, then when running Process
Simulate, clicking

3-44 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
opens the Product Excellence Program screen, enabling you to join.
Alternatively, you can change your selection at any time using the Data Privacy menu of the
Tecnomatix Doctor.

When you agree to take part in the Product Excellence Program, you also have access to the
Feedback feature that gives you a direct channel to help make Process Simulate a better tool for your
needs, by allowing you to send feedback directly from Process Simulate. You have the option to add
your email to allow us to be in contact with you, and you can take a web survey.

6. (Optional) The default location is displayed. If a different location is required, click Change in the
Custom Setup window.
The following window is displayed:

Tecnomatix 2402 Installation Guide on eMServer 3-45


Unpublished work. © 2024 Siemens
Choose the folder in which you want Tecnomatix to be installed and click OK.
The Custom Setup dialog box reappears.
7. Click Next.
The Choose System Root Location dialog box is displayed.

3-46 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Note
This setting is not relevant for Process Simulate Standalone on Teamcenter.

8. Click Next.
The Ready to Install dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-47


Unpublished work. © 2024 Siemens
9. Click Install.
The Installing Tecnomatix dialog box displays with a progress bar, enabling you to track the progress
of the installation.

3-48 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
When the installation process is complete, the following message is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-49


Unpublished work. © 2024 Siemens
10. Click Finish.

Note
Check if Release Updates are available.

Performing a Tecnomatix administration tools installation

Note
• The AdminConsole runs facing the remote eMServer that you define in the installation.
• When performing an Administration Tools installation, the fully qualified name of the server should be
available on the client machine (either via the DNS or by specifying it explicitly in the hosts file).

Procedure

1. From the Welcome screen, click Next.

3-50 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
The Setup Type dialog box is displayed.

2. Select Install Administration Tools and click Next.


The Custom Setup dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-51


Unpublished work. © 2024 Siemens
Note
The Common Folder is a location to be used by all Tecnomatix versions. The Tecnomatix Version
Selector is installed in this location.

3. (Optional) The default location is displayed. If a different location is required, click Change.
The following window is displayed:

3-52 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Choose the folder in which you want Tecnomatix to be installed and click OK.
The Custom Setup dialog box reappears.
4. Click Next.
The eMServer and eMSAgent Names dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-53


Unpublished work. © 2024 Siemens
This dialog box allows you to select an eMServer and the Notification Agent to which your client
application will connect. The system pings the server and the notification agent in order to check that
there is a working connection. Note however, that the installation continues even if the ping fails.
5. In the text box, enter the eMServer and the Notification Agent server name. Ensure that your entry
contains an active server installation.
6. Click Next.
The Delete Old Items dialog box is displayed.

3-54 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Check Delete old items if you wish to delete the items that the Setup program has detected
remaining from previous Tecnomatix installations. If you do not wish to delete these items, leave
the checkbox clear.
7. Click Next.
The Ready to Install dialog box is displayed.

Tecnomatix 2402 Installation Guide on eMServer 3-55


Unpublished work. © 2024 Siemens
8. Click Install.
The Installing Tecnomatix dialog box displays with a progress bar, enabling you to track the progress
of the installation.

When the installation process is complete, the following message is displayed:

3-56 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
9. Click Finish.

Note
Check if Release Updates are available.

Launch Tecnomatix applications from the command line

You can start Process Simulate Standalone - eMServer Compatible and Process Simulate eMServer-based
applications from the command line, loading specified data, as follows:

• Process Simulate Standalone - eMServer Compatible


Use the following syntax:

tune.exe /c NewAssembler /l offline /file {file}

where {file} is the full .psz file name to load,

Tecnomatix 2402 Installation Guide on eMServer 3-57


Unpublished work. © 2024 Siemens
For example, running:

tune.exe /c NewAssembler /l offline /file D:\ps.psz

Results in:
◦ Process Simulate starting in Standalone mode.
◦ Loading the ps.psz file.
• Process Simulate eMServer-based
Use the following syntax:

tune.exe /c NewAssembler /l ems /user {user} /pass {pass}


/project {project} /study {studyId} /command {command}

where
{user} is the user name (e.g., administrator)
{pass} is the password
{project} is the name of the project. If the project name contains captions, specify those with
quotation marks (e.g., “15” ProjectA ”34”)
{studyId} is the id of the study
{command} is the command name (e.g.,
LayoutManagementCommands.CreateWindow.CreateWindowCmd)
For example, running:

tune.exe /c NewAssembler /l ems /user administrator /pass 1234


/project ProjectName /study 420668 /command LayoutManagementCommands.
CreateWindow.CreateWindowCmd

Results in:
◦ Process Simulate starting
◦ Logged in as administrator using the password 1234.
◦ Opening ProjectName.
◦ Loading study id 420668..
◦ Opening a new Graphic Viewer.

3-58 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Note
Check if Release Updates are available.

Installing Release Updates


Siemens provides release updates for Process Simulate on an ongoing basis, which include fixes and
enhancements. These are available for you to download and install from Support Center Downloads
and also from the Process Simulate user interface and should be installed on top of the installed Process
Simulate version.

For details regarding Release Update content refer to the Release Update Notes with release updates for
Process Simulate.

For Release Update installation instructions refer to Release Update Installation Instructions.

Tecnomatix 2402 Installation Guide on eMServer 3-59


Unpublished work. © 2024 Siemens
Installing Release Updates

3-60 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
4. Setting up Tecnomatix applications in non-
English languages

• From the Tecnomatix setup DVD, perform the standard (English) installation of Process Simulate or
Process Designer.
• From the setup DVD, open the Add-Ons\Localization folder.
• Run the .msi file for the language in which you wish to operate the Tecnomatix application. If you
installed more than one application, the language change applies to all of them.

Note
◦ For Windows 10, it is necessary to run the setup as an administrator. You can right-click to open a
command prompt using Run as Administrator, and run the .msi from the window that opens.
◦ Make sure that the Beta Use Unicode UTF-8 for worldwide language support checkbox in the
Administrative Language settings is not checked.

Tecnomatix 2402 Installation Guide on eMServer 4-1


Unpublished work. © 2024 Siemens
Note
Tecnomatix applications are available in the following additional languages:
◦ German
◦ Spanish
◦ French (France)
◦ Portuguese (Brazil)
◦ Chinese

4-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
◦ Japanese

• From Tecnomatix Doctor, set the language in the Change Language dialog described in the Tecnomatix
Administration documentation.

Tecnomatix 2402 Installation Guide on eMServer 4-3


Unpublished work. © 2024 Siemens
4-4 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
5. Install local HTML documentation

Siemens Digital Industries Software allows you to install HTML documentation locally. After installing the
Siemens Documentation Server, and downloading and installing product documentation packages for
the relevant software(s), you can host HTML documentation for multiple languages and versions on your
local host or intranet.

The first step in this procedure describes how to access the detailed instructions for installing the
documentation server and product documentation packages from the Siemens Support Center. This
document can be viewed in HTML format from the Support Center or downloaded in PDF format.

Note
You should view this document for hardware and software requirements, and for additional information
as required.

After accessing the detailed document (step 1 below), you can follow all its directions to complete the
installation. Alternatively, you can proceed from step 2 below to the end of this procedure. These steps
describe the basic installation procedure, using the default parameters.

Procedure

1. Access the local help installation instructions, as follows:


a. Log on to the .

Tecnomatix 2402 Installation Guide on eMServer 5-1


Unpublished work. © 2024 Siemens
If you do not have an account, click Register Now and fill out the information.
b. Once on Support Center, click Manage Products.

5-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
c. Scroll down and toggle On the Siemens Documentation Installer product.

Tecnomatix 2402 Installation Guide on eMServer 5-3


Unpublished work. © 2024 Siemens
The installer is added to your list of products.

d. Scroll back to the top and click Support Center in the bread crumb, to go back to see the
products you are tracking.

e. Click the Siemens Documentation Installer box.

5-4 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
f. Click Documentation.

If you see a message about selecting a product version, click the X in the upper right to close the
message window.
g. In the drop-down list on the right, select the most recent Siemens Documentation Server
listed.

Tecnomatix 2402 Installation Guide on eMServer 5-5


Unpublished work. © 2024 Siemens
h. Click the installation guide for your operating system.

The HTML version is displayed.

i. To view or download the PDF version, in the upper right, click View Document PDF.

j. Now, using either the HTML or PDF version, follow the instructions to download and install the
documentation server and documentation.
2. Download the Siemens Documentation Server, as follows:
a. Click the Siemens Documentation Installer tile on the Siemens Support Center.

5-6 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
b. Click Downloads.

c. Select Siemens Documentation Server 2.0.

d. Click the Siemens Documentation Server 2.0 tile to download the file.
e. Store the file in the relevant location.
3. Install the Siemens Documentation Server, as follows:

Tecnomatix 2402 Installation Guide on eMServer 5-7


Unpublished work. © 2024 Siemens
Note
Verify Java 8 is installed prior to installing the Siemens Documentation Server and that the
JAVA_HOME system variable points to the installation folder.

a. Navigate to the location where you downloaded Siemens Documentation Server 2.0 and
launch it with administration privileges.
b. When prompted, accept all the default settings.

5-8 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
c. Click Install.
d. From the Windows Start menu, launch the Siemens Documentation Server.

Tecnomatix 2402 Installation Guide on eMServer 5-9


Unpublished work. © 2024 Siemens
5-10 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
The help server opens. Currently, no documentation packages are installed.

4. Download a product documentation package, as follows:


a. Click the product tile for which you want to download the documentation.

b. Click Downloads.

c. Select the version of the product for which to download the documentation.

Tecnomatix 2402 Installation Guide on eMServer 5-11


Unpublished work. © 2024 Siemens
Note
You must download and install the English product documentation package before installing
documentation packages for other languages.

d. Click the relevant tile.

The list of downloads appears.

5-12 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
e. Filter the list as required.

f. Click the documentation file you want to download. For example, docs-tecnomatix-en-US.exe.
g. Store the file in the relevant location.
h. Download additional product documentation packages as required.
5. Install the product documentation package, as follows:

Tecnomatix 2402 Installation Guide on eMServer 5-13


Unpublished work. © 2024 Siemens
a. Navigate to the location in which you stored docs-tecnomatix-en-US.exe.
b. Click the file to launch the installation.

c. If you downloaded additional documentation packages, install them.


6. From the Windows Start menu, launch the Siemens Documentation Server.

5-14 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Tecnomatix 2402 Installation Guide on eMServer 5-15
Unpublished work. © 2024 Siemens
5-16 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
6. Performing a Tecnomatix silent installation
Tecnomatix provides an option for silent installation using the standard MSI silent installation procedures
and parameters. Tecnomatix applications can be installed via the command line, while specifying the
desired products and installation location. Administrators can set the following parameters (or pass them
to the installation via the command line) to activate/deactivate some of the setup behavior and streamline
the installation process. The parameters listed below can be modified according to the values in the table:

Parameter Name Purpose Example value


ADDLOCAL List of setup features to be installed ( see
ADDLOCAL value table for details )
CREATEDESKTOPICONS Create program shortcuts on the desktop, "TRUE"
must be one of two: TRUE, FALSE
CREATESTARTMENUICONS Create program shortcuts on the start menu, "TRUE"
must be one of two: TRUE, FALSE
EMSAGENTNAME The machine name or the IP number where "il-hr-ems"
the eMSagent is installed on.
EMSSERVERNAME The machine name or the IP number of the "il-hr-ems"
eMServer.
EMSSYSTEMROOT The location of the eMServer file system root. "\machine\share\sys_root"
That location can be either a fully qualified
directory name or a UNC path; it must not
include a trailing backslash.
ENABLECOPYSYSTEMROOT Enable\Disable the copy of the files to the "FALSE"
eMServer system root, must be one of two:
TRUE (default), FALSE
ENABLEPIP Participate in the Product Excellence Program, "TRUE"
must be one of two: TRUE, FALSE
EXISTING_RRS_XML_FILE Path to a previous or already existing rrs.xml "C:\TEMP\rrs.xml"
file that will be installed under <INSTALL
DIR>\Robotics\OLP instead of the default one.
INSTALLDIR The fully qualified path to a target folder on "C:\Program
the hard drive. By default, the INSTALLDIR Files\Tecnomatix_16.0.1"
path is set to resolved based on the
[ProgramFilesFolder]Tecnomatix_<VERSION>
REBOOT Surpresses cetain prompts for a reboot of the Surpress
system. Must have one of the following values
(see REBOOT table for details): Force, Surpress,
ReallySurpress

Tecnomatix 2402 Installation Guide on eMServer 6-1


Unpublished work. © 2024 Siemens
Parameter Name Purpose Example value
SETUPTYPE The setup configuration, must be one of the "Client"
following values: Client, Server, Standalone,
WEBAPPS, Administation
SILENTMODE Enable silent installation, must be one of two: "TRUE"
TRUE, FALSE
SYMLINK_VAR The fully qualified path to the Tecnomatix "C:\Program
common folder on the hard drive. Note: Files\TecnomatixShared"
This property is needed only when installing
Tecnomatix as Side by Side.
TC_SERVER_LOGIN_METHOD Set Teamcenter login method (relevant "URL"
when installing Process Simulate Teamcenter
Platform > Process Simulate Teamcenter
Platform), must be one of two: URL, TCCS
* TC_SERVER_URL or TC_SERVER_TCCS_ENV
can updated according to the value of
TC_SERVER_LOGIN_METHOD
TC_SERVER_TCCS_ENV TCCS Environment
TC_SERVER_URL Teamcenter Web Server URL http://
LOCALHOST:7001/tc
TECNOREG_LOG_LEVEL Log level of files registration errors, must be "Info"
one of two: Error, Info (the default value is
Error, choosing Info may slow the installation
process)
HELP_DIRECTORY_LOCATION Help directory location, must be one of two: "HelpLocalDocServer"
HelpDocWeb, HelpLocalDocServer
LOCAL_DOC_SERVER_NAME Server name, needed in case "MyDocServerName"
HELP_DIRECTORY_LOCATION was set to
HelpLocalDocServer
LOCAL_DOC_SERVER_PORT Server port, needed in case "5000"
HELP_DIRECTORY_LOCATION was set to
HelpLocalDocServer

After you have already installed some Tecnomatix applications, you can use the silent mode installation to
add further Tecnomatix products to your setup. You must provide all the necessary parameters for the new
products as well as all the parameters of the existing products in order to retain the current setup.

All parameters submitted using the Installation Wizard are given as command line parameters according to
the rules specified in the table below:

Notes:

6-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
• For silent installations, you must add the SILENTMODE parameter with the value of TRUE; it is not
sufficient to specify /q to the mesiexec.
• All of the parameter's values must be enclosed in double quotes (").
• The parameter's names and the SETUPTYPE, SILENTMODE values are case sensitive.
• When modifying a setup in silent mode, you can only add product(s). You cannot remove product(s). If
you want to remove (or add and remove) product(s), run to the regular installation program and select
Modify.
• When modifying a setup in silent mode, you cannot change the setup type, for example, to change the
setup type from Client to Client-Server.

The Reboot parameter contains the following options:

REBOOT value Description


Force Always prompt for a restart at the end of the installation. The UI always prompts the
user with an option to restart at the end. If there is no user interface, and this is
not a multiple-package installation, the system automatically restarts at the end of the
installation. If this is a multiple-package installation, there is no automatic restart of the
system and the installer returns ERROR_SUCCESS_REBOOT_REQUIRED.
Suppress Suppress prompts for a restart at the end of the installation. The installer still prompts
the user with an option to restart during the installation whenever it encounters the
ForceReboot action. If there is no user interface, the system automatically restarts at
each ForceReboot. Restarts at the end of the installation (for example, caused by an
attempt to install a file in use) are suppressed.
ReallySuppress Suppress all restarts and restart prompts initiated by ForceReboot during the installation.
Suppress all restarts and restart prompts at the end of the installation. Both the restart
prompt and the restart itself are suppressed. For example, restarts at the end of the
installation, caused by an attempt to install a file in use, are suppressed.

Tecnomatix Silent Install

The content of the ADDLOCAL variable should be derived from the following table:

Product MSI Parameters


Process Shared with all N_PD_64
Designer Shared Client products
Process with All N_CLIENT_64 Shared with all
Simulate N_BASE_64 Localization_64 Process Simulate
English_64 * eMServer

Tecnomatix 2402 Installation Guide on eMServer 6-3


Unpublished work. © 2024 Siemens
Product MSI Parameters
eMServer
Platform
Process PS_64
Simulate
Process PS_DIS_EMSERVER_64
Simulate
Standalone
Process Platform PS_VCLITE_SA_64
Simulate VC N_PS_64
Lite
ABB_RAPID,ABB_RAPID_VOLVO,CLOOS_CAROLA
COMAU_PDL_VOLVO,DENSO_PACSCRIPT,DUERR_
Tecnomatix FANUC_F100,FANUC_RJ,FANUC_RJ_JAPAN,IGM_
Robot KAWASAKI_CKE,KUKA_KRC,KUKA_KRC_BMW,KU
Controllers* MITSUBISHI_MELFA,NACHI_SLIM,NC_CODE,NC_C
NC_CODE_RIVETING,PANASONIC_CSR,REIS_ROB
TRALLFA_ROBTALK,UNIVERSAL_URSCRIPT,YASKA
Process
Simulate
Teamcenter
Platform
Process PS_ON_TC_64
Simulate
Process PS_DIS_TC_64
Simulate
Shared with all
Standalone
Process Simulate
Process Teamcenter PS_ON_TC_VCLITE_SA_64
Simulate VC Platform
Lite on N_PS_ON_TC_64
Teamcenter
ABB_RAPID,ABB_RAPID_VOLVO,CLOOS_CAROLA
COMAU_PDL_VOLVO,DENSO_PACSCRIPT,DUERR_
Tecnomatix FANUC_F100,FANUC_RJ,FANUC_RJ_JAPAN,IGM_
Robot KAWASAKI_CKE,KUKA_KRC,KUKA_KRC_BMW,KU
Controllers* MITSUBISHI_MELFA,NACHI_SLIM,NC_CODE,NC_C
NC_CODE_RIVETING,PANASONIC_CSR,REIS_ROB
TRALLFA_ROBTALK,UNIVERSAL_URSCRIPT,YASKA
Server Shared with Server
Administration and Administration tools
Tools products N_SERVER_64

6-4 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Product MSI Parameters
EMPLANNER_Server_64
N_AdminTools_64
Process
Reports Server AdministrationTools_64

Web-Based EMREPORTS
BOP Manager Shared with all WEB products
eBopServer
N_WEB
eBopServer_64

eBopServer_64_Only**

*To install all available Tecnomatix robot controllers in the setup, Controllers can be used instead of
specifying each controller.

Note: All features should be comma-separated without spaces.

Value of ADDLOCAL can be set to a specific list of controllers you wish to install or set to Controllers
that will install ALL controllers available in the setup. In the silent install scripts supplied in the DVD the
CONTROLLERS_VAR variable first hold parameters related to the controllers then it is concatenated to the
ADDLOCAL one.

Example of silent installation code for default client applications 64bit:

@echo off
set DVD_LOC=[DVD_LOC]
set INSTALLDIR_VAR=C:\Program Files
set SETUPTYPE_VAR=Client
set EMSSYSTEMROOT_VAR=c:\temp\System_root
set EMSSERVERNAME_VAR=[EMSSERVERNAME]
set EMSAGENTNAME_VAR=[EMSAGENTNAME]
set CREATEDESKTOPICONS_VAR=TRUE
set CREATESTARTMENUICONS_VAR=TRUE
set
ADDLOCAL_VAR=N_BASE_64,N_CLIENT_64,N_PD_64,N_PS_64,N_PS_ON_TC_64,PS_64,PS_ON
_TC_64,Localization_64,English_64
set MSI_LOGFILE_VAR=%TEMP%\Tecno2209_64bit_MSI_Install.log
set ENABLEPIP_VAR=TRUE
rem Value of HELP_DIRECTORY_LOCATION_VAR should be set to one of the
following: HelpDocWeb, HelpLocalFile or HelpLocalDocServer
rem If it was set to HelpLocalDocServer you also need to set
LOCAL_DOC_SERVER_NAME_VAR and LOCAL_DOC_SERVER_PORT_VAR
rem set HELP_DIRECTORY_LOCATION_VAR=HelpDocWeb
rem set LOCAL_DOC_SERVER_NAME_VAR=[MyDocServerName]
rem set LOCAL_DOC_SERVER_PORT_VAR=8282
rem Value of TC_SERVER_LOGIN_METHOD_VAR should be URL or TCCS and
TC_SERVER_URL_VAR or TC_SERVER_TCCS_ENV_VAR should be set accordingly

Tecnomatix 2402 Installation Guide on eMServer 6-5


Unpublished work. © 2024 Siemens
rem set TC_SERVER_LOGIN_METHOD_VAR=URL
rem set TC_SERVER_URL_VAR=[TC_SERVER_URL]
rem set TC_SERVER_TCCS_ENV_VAR=[TC_SERVER_TCCS_ENV]
rem Value of CONTROLLERS_VAR can be set to a specific list of controllers
you wish to install or set to Controllers that will install ALL controllers
available in the setup
rem set CONTROLLERS_VAR=Controllers
rem set
CONTROLLERS_VAR=ABB_RAPID,ABB_RAPID_VOLVO,CLOOS_CAROLA,COMAU_PDL,COMAU_PDL_V
OLVO,DENSO_PACSCRIPT,DUERR_ECOTALK,EPSON_SPEL,FANUC_F100,FANUC_RJ,FANUC_RJ_J
APAN,IGM_INS,KAWASAKI_AS,KUKA_KRC,KUKA_KRC_BMW,KUKA_KRC_VOLVO,MITSUBISHI_MEL
FA,NACHI_SLIM,NC_CODE,NC_CODE_BMW,NC_CODE_EMBRAER,NC_CODE_RIVETING,PANASONIC
_CSR,REIS_ROBSTAR,STAUBLI_VAL,TRALLFA_ROBTALK,UNIVERSAL_URSCRIPT,YASKAWA_INF
ORM
rem set EXISTING_RRS_XML_FILE_VAR=[PATH_TO_RRS_XML]
echo =========================================================
echo ==================== Confirmation =======================
echo == Installation location:
echo %DVD_LOC%
echo == Setup type: %SETUPTYPE_VAR%
echo == Setup destination: %INSTALLDIR_VAR%
echo == EMS system root: %EMSSYSTEMROOT_VAR%
echo == eMServer name: %EMSSERVERNAME_VAR%
echo == Notification agent name: %EMSAGENTNAME_VAR%
echo == Teamcenter Server login method: %TC_SERVER_LOGIN_METHOD_VAR%
echo == Teamcenter Web Server URL: %TC_SERVER_URL_VAR%
echo == TCCS Environment: %TC_SERVER_TCCS_ENV_VAR%
echo == MSI log file path: %MSI_LOGFILE_VAR%
echo == Participate in the Product Improvement Program: %ENABLEPIP_VAR%
echo =========================================================
pause Press any key to begin installation
echo Installing Tecnomatix 2402x64 Client only...
"%DVD_LOC%\Setup\64bit\Setup.exe" /s /v"/qn INSTALLDIR=\"%INSTALLDIR_VAR%\"
SILENTMODE=\"TRUE\" HELP_DIRECTORY_LOCATION=\"%HELP_DIRECTORY_LOCATION_VAR%
\"
LOCAL_DOC_SERVER_NAME=\"%LOCAL_DOC_SERVER_NAME_VAR%\"
LOCAL_DOC_SERVER_PORT=\"%LOCAL_DOC_SERVER_PORT_VAR%\"
SETUPTYPE=\"%SETUPTYPE_VAR%\" EMSSYSTEMROOT=\"%EMSSYSTEMROOT_VAR%\"
EMSSERVERNAME=\"%EMSSERVERNAME_VAR%\" EMSAGENTNAME=\"%EMSAGENTNAME_VAR%\"
CREATESTARTMENUICONS=\"%CREATESTARTMENUICONS_VAR%\"
CREATEDESKTOPICONS=\"%CREATEDESKTOPICONS_VAR%\"
TC_SERVER_LOGIN_METHOD=\"%TC_SERVER_LOGIN_METHOD_VAR%\"
TC_SERVER_TCCS_ENV=\"%TC_SERVER_TCCS_ENV_VAR%\"
TC_SERVER_URL=\"%TC_SERVER_URL_VAR%\" ENABLEPIP=\"%ENABLEPIP_VAR%\"
EXISTING_RRS_XML_FILE=\"%EXISTING_RRS_XML_FILE_VAR%\"
ADDLOCAL=\"%ADDLOCAL_VAR% ,%CONTROLLERS_VAR%\" /l* %MSI_LOGFILE_VAR%"
IF %ERRORLEVEL% NEQ 0 ( echo Failed installing Tecnomatix 2402x64 Client
only, check the log files from more details)
ELSE ( echo Finished installing Tecnomatix 2402x64 Client only)
pause

Note
The installation DVD contains additional examples for silent installation at Setup\SilentInstall.

6-6 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
7. Installation information for administrators
Overview
The Tecnomatix installation program uses native msi (Basic MSI project) compiled with InstallShield 2020
R3 to achieve a robust installation program and maximum transparency to the installation process.

During the installation, the setup executes several custom actions according to the setup type and
hardware/software configuration of the target machines. These custom actions are listed in the tables
below with brief descriptions of their purpose and values in the installation.

You can assign additional parameters (see below) to the installation to block some of the setup default
behavior.

During the setup, the installer invokes the following additional applications (installed with the Tecnomatix
application files):

• PackageAdmin.exe - creates the eMServer COM+ application


• RegSvr64.exe and RegSvr.exe - register some of the setup COM objects
• eMSAgent.exe - installs the DCOM eMSAgent application
• regtlib.exe - registers some type libraries
• tecnoreg.exe - launches RegSvr64.exe and regtlib.exe to register files
• installtools.dll - this is an internal c# dll and allows running several install actions, for example delete
folder
• pkzip.exe - extracts zip files

Custom Actions in Tecnomatix Setup

Custom Action name Description


BackupFilesRegistry Backup files and registry before installing the setup
BackupTomcatFiles Backup Tomcat configuration files
Block32MSIOn64Machine_If64Installed Block 32bit MSI on 64bit machine if 64bit Server configuration
was not installed
Block64MSIOn64Machine_If32Installed Block 64bit MSI on 64bit machine if 32bit was installed
BlockModify Block Modify of Server \ Administration Tools only installation
BlockSilentInstallOnExisting Block installing setup on an existing one in silent mode

Tecnomatix 2402 Installation Guide on eMServer 7-1


Unpublished work. © 2024 Siemens
Custom Action name Description
BlockUninstallIfREDeltaInstalled Block Tecnomatix uninstall in case RobotExpert delta setup is
installed
BlockUpgrade_IfHybridInstalled Not in use (Block upgrade if hybrid configuration is installed)
Change_ConfigFile Update the eMS_Config.cfg file with path to installation
directory
Change_export_xml Update the server.xml file for the Web Applications
CheckCadtranslators_installed Not in use
CheckCleanMachine Check for old Tecnomatix folders and registry keys already
exists on the machine
CheckCondition Check if setup installed on supported OS and if previous
versions of Tecnomatix already installed
CheckEnvBeforeSetup Check for setup prerequisite before installing the setup
CheckCPU Not in use
CheckCrossPaltform Check special hybrid configuration and OS
CheckEMSsystemRoot Check if the selected eMServer System Root exists
CheckInstalledProducts Check the Installed features when running on maintenance
mode
CheckInstalledSetupType Check the Installed SetupType when running on maintenance
mode
CheckInstallProducts Check for products that will be installed according to the
CustomSetup dialog
CheckInstallProductsSilent Check for products that will be installed on silent install
CheckLocalization Not in use
CheckMajorVersion Not in use
CheckProgramRunning Check if Tecnomatix applications currently running before
installing setup as side by side
CheckServerCondition Show message about the network COM+ access when installing
on Server 2003
CheckTreeRequirements Check for setup requirements according to the features selected
by the user
CheckUpgradeParameters Not in use (On major upgrade check for installed SETUPTYPE,
EMSSERVERNAME, EMSAGENTNAME, EMSSYSTEMROOT and
INSTALLDIR properties and if German localization is installed)

7-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Custom Action name Description
CheckVersionUpgrade Not in use
Clean_AC Currently not in use
Clear_RunAs_MSI VB script action that solve %USER_PROFILE% issue
CopyLocalizationFiles Update [INSTALLDIR] folder with German localization files if
German is the default language
CopyLogFile Copy the install and Install_Summary logs from %TEMP%
directory to …\eMPower\SetupLogs folder
CreateDirectoriesAdminConsole Creates empty directories
CreateDirectoriesClient Creates empty directories
CreateLogFile Create the Install \ UnInstall log file
CreateLogFileMaintenance Create the Maintenance log file
CreateLogFileRemove Not in use
CreateShortcut2MSILogFile Create shortcut to MSI log file under %TEMP%
CS_DeleteOldItems Delete existing folders
CS_ReturnLongestFilePath Not in use
DeleteRegistry Delete existing registry keys
DisplayReadyToInstall Set the text displayed in the ReadyToInstall dialog and
Tecnomatix Install_Summary.log
eMPOwerCopySystemRoot Copy eMServer System Root files to the directory chosen in the
setup wizard
ExecuteClientRegistration Execute Client Registration using the EmsClient.inf
ExecuteEmsClientInf Update the EmsClient.inf file without execute
ExitSetup Update the setup log in case the user choose to exit the setup
ExtractHelpFiles Not in use (Extract help files that installed as zip format)
FeatureTreeAdminTools Set features that will be installed \ not installed when choosing
the AdminTools setup type
FeatureTreeClient Set features that will be installed \ not installed when choosing
the Client setup type
FeatureTreeClient_Silent Set features that will be installed \ not installed when choosing
the Client setup type on silent install
FeatureTreeSA Set features that will be installed \ not installed when choosing
the Client Server setup type

Tecnomatix 2402 Installation Guide on eMServer 7-3


Unpublished work. © 2024 Siemens
Custom Action name Description
FeatureTreeSA_Silent Set features that will be installed \ not installed when choosing
the Client Server setup type on silent install
FeatureTreeServer Set features that will be installed \ not installed when choosing
the Server setup type
FeatureTreeST Not in use
FeatureTreeWEB Set features that will be installed \ not installed when choosing
the Web setup type
FileBrowse Browse for rrs.xml file
FinishSetup Run post setup operations
FinishUninstall Remove folders and registry keys remains after Uninstall
FirstUIAfter Enable Tomcat installation in case the Standalone was selected
and it include the WEB
GetEnvVar_ENABLE_TX_PSD_TC Currently not in use
Get_UserInfo VB script action that get user name and domain info
HandleModifyFromCommandLine Action to support modify setup from command line
Install_Tomcat Update Tomcat files when installing Web Applications
InstallControllers Install Robot Controllers
MTSPackage_Create Create the eM-Server COM+ Application using the
PackageAdmin.exe
MTSPackage_Remove Remove the eM-Server COM+ Application using the
PackageAdmin.exe
OpenControllersFolder Not in use ( For RE )
RegEmsAgent Register the eMSAgent.exe files
RegisterFiles Register the files with the TecnoReg.exe tool
RemovePrograms Automatically remove OLP controls on uninstall
RunUninstall Execute files un-registration done by install script
Set_APACHE_TOMCAT Set APACHE_TOMCAT property
Set_Install_SYMLINK_PATH Set the SYMLINK property by checking if it ends with
TecnomatixShared
Set_REINSTALL_for_TCM_ACCESS Handle setup modify when including TCM Access
SetCnfgFolder Set the CnfgFolder value on the registry

7-4 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Custom Action name Description
SetComponentsState Set special components \ features state
SetCreateDesktopIcons Check If setup should create desktop shortcuts
SetCustomSetup Set features displayed in the Custom setup and Controllers
setup dialogs
SeteMSClientParameters Check connection and set the eMServer and eMS Notification
Agent parameters
SetEnvironment Not in use
SetHybridConfiguration Not in use
SetInstalldir Set the INSTALLDIR property by checking if it ends with
Tecnomatix_[TECNOMATIX_VERSION]
SetINSTALLDIR32bit Set the INSTALLDIR property to
[ProgramFilesFolder]Tecnomatix\eMPower when running the
32bit MSI
SetINSTALLDIR64bit Set the INSTALLDIR property to
[ProgramFiles64Folder]Tecnomatix\eMPower when running the
64bit MSI
SetINSTALLDIRShort Set the INSTALLDIR property as short path
SetIS_MAJOR_UPGRADE_32 Not in use (On major upgrade reset the
IS_MAJOR_UPGRADE_32 property when installing the 64bit
setup)
SetIS_MAJOR_UPGRADE_64 Not in use (On major upgrade reset the
IS_MAJOR_UPGRADE_64 property when installing the 32bit
setup)
SetJavaHome Check if JAVA is installed and set JavaHome
SetMode_ENABLE_TX_PSD_TC_MODE Not in use
SetMSIPLATFORM64bit Set the MSIPLATFORM property to 64 when running the 64bit
MSI
SetPSonTCParameters Set parameters needed for supporting TCM
SetShowDialogs Set MSI properties according to Setup Type
SetSideBySide Set Tecnomatix registry structure in case of Side by Side
SetSoftwareAnalytics Set SetSoftwareAnalytics (Product Improvement Program)
according to user selection
SetSpaceBall Check if setup should install the SpaceBall integration
SetSYMLINK Setup value of SYMLINK property used for Side by Side

Tecnomatix 2402 Installation Guide on eMServer 7-5


Unpublished work. © 2024 Siemens
Custom Action name Description
SetSYMLINKVal Setup value of SYMLINK property used for Side by Side on silent
install
SetTECNOMATIX_SHARED_ID32bit Set Tecnomatix shared folder default path for 32 bit
SetTECNOMATIX_SHARED_ID64bit Set Tecnomatix shared folder default path for 64 bit
SetTecnomatixRoot Set the TECNOMATIXROOT_ID folder property to the parent of
INSTALLDIR
SetTecnomatixSymlinkFolder Used for Side by Side
SetTecnomatixSymlinkFolderUninstall Used for Side by Side
SetVar_ENABLE_TX_PSD_TC_MODE Currently not in use
SetVar_ENABLE_TX_SUPPORT_TCM_AC Currently not in use
CESS
SetVar_RUN_EMSERVER Currently not in use
SetVar_RUN_TECNOREG Currently not in use
SetVar_SIDEBYSIDE_MODE Currently not in use
SetVar_SKIP_EMSERVER_MODE Currently not in use
SetVar_SUPPORT_TCM_ACCESS Currently not in use
ShowErrorPlatform Block unsupported configurations
ShowLog Open the install \ Uninstall log when setup finished
ShowMessageFor64 Not in use
ShowMessageForUninstall Not in use ( Display message for manual steps need to complete
the uninstall after uninstall has finished )
TxVersionSelectorSwitchShortcuts Used for Side by Side
UnRegEmsAgent Not in use
UnRegisterFiles Unregister the files with the TecnoReg.exe tool
UpdateRegistryForLocalization Not in use
VerifyRRSXML Verify path to selected rrs.xml file is valid
VerifyVersionB4Maintenance Check the version being maintained is installed and active

Folders and Registry Keys Affected by Tecnomatix Installations


The following table lists the folders and registry keys affected by Tecnomatix installations.

7-6 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Folders * Example
[CommonAppDataFolder]\eM-Plant C:\ProgramData\Tecnomatix\Process
[CommonAppDataFolder] Designer\2402.0
\Tecnomatix\<APPLICATION>\<VERSION>
[CommonFilesFolder\Apache-Tomcat C:\Program Files\Common Files\Apache-Tomcat
[CommonFilesFolder]\Tecnomatix C:\Program Files\Common Files\Tecnomatix
[FontsFolder] C:\WINDOWS\Fonts
[SystemFolder] C:\Windows\System32
[INSTALLDIR]\Tecnomatix_<VERSION> C:\Program Files\Tecnomatix_2402
[SYMLINK]\TecnomatixShared ** C:\Program Files\TecnomatixShared

Registry *
HKEY_CLASSES_ROOT
HKEY_CLASSES_ROOT\AppID
HKEY_CLASSES_ROOT\CLSID
HKEY_CLASSES_ROOT\Interface
HKEY_CLASSES_ROOT\Record
HKEY_CLASSES_ROOT\TypeLib
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft
HKEY_LOCAL_MACHINE\SOFTWARE\Tecnomatix
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Tecnomatix
HKEY_LOCAL_MACHINE\SOFTWARE\TecnomatixRoot **
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Tecnomatix
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\TecnomatixRoot **

* All these items may change depending on the installation type and OS

** Relevant when installing Tecnomatix as Side by Side.

Tecnomatix 2402 Installation Guide on eMServer 7-7


Unpublished work. © 2024 Siemens
7-8 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
8. Setting the eMSAgent and eMServer to
automatic login

After you have completed the eMServer installation and configured the eMServer connections using the
eMServer Administration Tool, the eMServer services are running. The users can then log in to their client
applications and begin working.

An administrator generally logs in to the eMServer in order to perform specific administrative tasks using
the eMServer Administration functionality described in the Administrative and Management Tools section
(such as changing schemas and converting customizations). Since it is not necessary for users to access
eMServer administration functionality, there are various situations where the administrator may want to
have the eMServer available for users, but without logging in as an administrator, such as:

• To get the eMServer up and running quickly (for example, after an electrical power failure).
• To secure his or her workstation from access by others.

The following section describes how to connect to the application server without logging in. This consists
of:

• Defining access and launch permissions from the eMSAgent Properties window.
• Defining the users who are permitted to log on to the eMServer from the eMServer Properties window.

Tecnomatix 2402 Installation Guide on eMServer 8-1


Unpublished work. © 2024 Siemens
To access the eMServer without logging in:

Procedure

1. From your Windows Start menu, select Run→dcomcnfg.


The Component Services window is displayed.

2. Expand the Component Services\Computers\My Computer\DCOM Config.


3. From the Applications list, select eMSAgent and click Properties.The eMSAgent Properties window
is displayed (as shown below).
4. Select the Security tab, as follows:

8-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
5. Select the Customize option for Access Permissions and click Edit.
The Access Permission window is displayed.

Tecnomatix 2402 Installation Guide on eMServer 8-3


Unpublished work. © 2024 Siemens
6. Click Add.
The Select Users, Computers, or Groups window is displayed.

7. In the Names area enter the object name to select.


8. Click Check Names to verify that the name you typed is valid, then click OK to close the window.
9. In the Access Permissions window select Everyone or select a predefined group of users and click
the Allow checkbox for the selected item to allow access.

8-4 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
10. Click OK to close the Access Permission window.
11. In the eMSAgent Properties window, select the Customize option for Launch and Activation
Permissions and click Edit.
The Launch Permission window is displayed.

12. Click Add. The Select Users, Computers, or Groups window is displayed.
13. In the Names area enter the object name to select.
14. Click Check Names to verify the name typed is valid, then click OK to close the window.
15. Select the user or group whose access you wish to update and click the Allow checkbox to allow
launch for your selection.
16. Click OK to close the Launch Permission window.
17. Click Apply followed by OK to close the eMS Agent Properties window.
18. From your Windows Start menu, select Control Panel→Administrative Tools→Component Services
(or from the Start menu, select Run→dcomcnfg).
The Component Services window is displayed.

Tecnomatix 2402 Installation Guide on eMServer 8-5


Unpublished work. © 2024 Siemens
19. Right-click the eMServer package. From the popup menu, select Properties. The eMServer
Properties window is displayed, showing the General tab.
20. Uncheck the Disable changes checkbox in the Advanced tab, as displayed below:

8-6 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
21. Select the Identity tab, as follows:

Tecnomatix 2402 Installation Guide on eMServer 8-7


Unpublished work. © 2024 Siemens
22. In the Account area, select This user.
23. In the relevant user and password fields, enter the details of the user to be permitted to log on to the
eMServer.
24. Click OK.

8-8 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
9. Removing the Tecnomatix installation
Tecnomatix installations can be removed by performing one of the procedures described below.

To remove the Tecnomatix installation using the Control Panel:

Procedure

1. Access the Control Panel and select Programs and Features.


2. Select Tecnomatix from the list of currently installed programs.
3. Click Change or Remove.
If you click Remove, the following message is displayed.

4. Click Yes to complete the removal.

To remove the Tecnomatix installation using the Start Menu:

Procedure

1. Open the Start menu.


2. Select All Programs → Tecnomatix → Uninstall → Uninstall Tecnomatix <version>.

Note
• In general Tecnomatix uninstall should remove all items (files, folders, registry settings, environment
variables, etc.) created/updated when installing the setup. However, in some circumstances items
will not be removed, for example, if a text file is opened by an application, folders are opened in
Explorer or command line, changes in permissions, install was performed by one user while uninstall
by another, etc. Therefore, this section is included in case Tecnomatix was not successful and some
manual steps are required.

Tecnomatix 2402 Installation Guide on eMServer 9-1


Unpublished work. © 2024 Siemens
• Manual removal of files, folders, etc. can only be done after uninstalling the program as described
above. It complements the uninstallation procedure (if necessary), but does not replace it.

a. Remove the following folders and their contents:

Tecnomatix install dir [INSTALLDIR]\Tecnomatix_<VERSION>\eMPower


[INSTALLDIR]\Tecnomatix_<VERSION>\eMPower32 ( If client was installed )
[CommonAppDataFolder] C:\ProgramData\Tecnomatix\eM-Plant
C:\ProgramData\Tecnomatix\eM-Engineer
C:\ProgramData\Tecnomatix\eM-Human
C:\ProgramData\Tecnomatix\eM-Weld
C:\ProgramData\Tecnomatix\Process Designer
C:\ProgramData\Tecnomatix\Process Simulate
C:\ProgramData\Tecnomatix\Process Simulate on Teamcenter
C:\ProgramData\Tecnomatix\Process Simulate VC Lite
C:\ProgramData\Tecnomatix\Process Simulate VC Lite on Teamcenter
CommonFiles64Folder C:Program Files\Common Files\Apache-Tomcat
C:Program Files\Common Files\Tecnomatix

b. Remove the following registry entries:

HKEY_LOCAL_MACHINE [HKEY_LOCAL_MACHINE\SOFTWARE\Tecnomatix\eM-Planner]
[HKEY_LOCAL_MACHINE\SOFTWARE\Tecnomatix\eMPower]
* [HKEY_LOCAL_MACHINE\SOFTWARE\Tecnomatix\TUNE]
[HKEY_LOCAL_MACHINE\SOFTWARE\Tecnomatix\eBopBrowser]
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Tecnomatix]
HKEY_CURRENT_USER [HKEY_CURRENT_USER\SOFTWARE\Tecnomatix\eM-Planner]
[HKEY_CURRENT_USER\SOFTWARE\Tecnomatix\TUNE]

* Assuming there is no other Tecnomatix application that uses this key

To complete removal of all Tecnomatix installations that were installed Side by Side, you should also
remove the following and their content (note that this procedure is needed only in case all Tecnomatix
versions were uninstalled):

a. Make sure the following folder and all its content is removed:

Tecnomatix Shared Folder [TECNOMATIX_SHARED_FOLDER] (e.g. C:\Program Files\TecnomatixShared)

b. Make sure the following was removed from the registry:

9-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
HKEY_LOCAL_MACHINE [HKEY_LOCAL_MACHINE\SOFTWARE\TecnomatixRoot]
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\TecnomatixRoot]

c. Make sure the following was removed from the PATH environment variable:

PATH [TECNOMATIX_SHARED_FOLDER]\TecnomatixCurrent\eMPower\SIMBAPro;
environment [TECNOMATIX_SHARED_FOLDER]\TecnomatixCurrent\eMPower (e.g. C:\Program
variable Files\TecnomatixShared\TecnomatixCurrent\eMPower\SIMBAPro;C:\Program
Files\TecnomatixShared\TecnomatixCurrent\eMPower)

Tecnomatix 2402 Installation Guide on eMServer 9-3


Unpublished work. © 2024 Siemens
9-4 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
10. Configuring the client and server
environment

In order to ensure that the client and server environments are compatible, check that the User Locale
settings (from the Regional settings) on the client machine are the same as the System Locale settings
(from the Regional settings) on the server (eMSAgent) machine.

Tecnomatix 2402 Installation Guide on eMServer 10-1


Unpublished work. © 2024 Siemens
10-2 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
11. Preparing the Windows Server machine

Windows Server 2008 - Limited support - until version 16.1

Windows 2008 server requires proactive activity to allow clients to connect to COM+ service. Therefore, in
order to have an eMServer up and running you need to use the following steps to allow network COM+
access:

Procedure

1. Start Server Manager.


2. Select Roles in the tree on the left side.
3. Select the Application Server role and click Add Role Services on the right side.
4. Select COM+ Network access and follow the installation instructions.

Tecnomatix 2402 Installation Guide on eMServer 11-1


Unpublished work. © 2024 Siemens
Windows Server 2012

Windows Server 2012 requires proactive activity to allow clients to connect to COM+ service. Therefore, in
order to have an eMServer up and running, you need to use the following steps to allow network COM+
access:

Procedure

1. Start Server Manager.

11-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
2. Select Manage\Add Roles and Features in the menu on the top.
3. Navigate Add Roles and Features wizard to Server Roles page.
4. Check Application Server role.

Tecnomatix 2402 Installation Guide on eMServer 11-3


Unpublished work. © 2024 Siemens
5. Navigate to Application Server\Role Services page.
6. Check COM+ Network Access role service.

11-4 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
7. Follow the installation instructions.

Windows Server 2016, Window Server 2019, Window Server 2022

Windows Server 2016, Windows Server 2019 and Window Server 2022 require proactive activity to allow
clients to connect to COM+ service. Therefore, in order to have an eMServer up and running, you need to
use the following steps to allow network COM+ access:

Procedure

1. Start Registry Editor.


2. Change registry key RemoteAccessEnabled in HKLM\SOFTWARE\Microsoft\COM3 from 0 to 1.

Tecnomatix 2402 Installation Guide on eMServer 11-5


Unpublished work. © 2024 Siemens
3. Start Windows Firewall.
4. Select Allow an app or feature through Windows Firewall.
5. Check COM+ Network Access and the relevant scope Domain, Private or Public.

11-6 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
Tecnomatix 2402 Installation Guide on eMServer 11-7
Unpublished work. © 2024 Siemens
11-8 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
12. Setting the client environment

It is important to correctly adjust the settings of the Region and Language dialog box of the Windows
Control Panel.

You should determine the desired language to use for non-Unicode programs. Use the following steps to
ensure that your environment is properly set:

Procedure

1. Verify that the desired language is set in the section Current language for non-Unicode programs
of the Administrative tab of the Region and Language dialog box. If this is not the case, use the
Change system locale button of the Administrative tab to set the desired language.
2. Verify that the entry in the Format section of the Formats tab of the Region and Language dialog
box is the same as the desired language. If not, set the desired language in the Format section.
3. In the Administrative tab of the Region and Language dialog box click Copy settings to open the
Welcome screen and new user accounts settings dialog box.
4. In the Region and Language dialog box check the Welcome screen and system account and New
user accounts options.
5. Click OK button to implement Welcome screen and new user accounts settings.
6. Reboot your machine (this is necessary after applying Copy settings ).

Tecnomatix 2402 Installation Guide on eMServer 12-1


Unpublished work. © 2024 Siemens
12-2 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
13. Setting Chinese or Japanese as the
operating system language on Windows 10

For Windows 10 users of Tecnomatix applications in Chinese or Japanese, it is necessary to do the


following:

Procedure

1. Use the Region and Language setting in the Control Panel to set the Format language to Chinese -
Simplified or Japanese.

2. From the Administrative tab, use the Change system locale option to set the language to Chinese -
Simplified or Japanese, if not already set.

Tecnomatix 2402 Installation Guide on eMServer 13-1


Unpublished work. © 2024 Siemens
Make sure that the Beta Use Unicode UTF-8 for worldwide language support checkbox in the
Administrative Language settings is not checked.

13-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
14. Tecnomatix database prerequisites
Tecnomatix Database Compatibility Matrix

Tecnomatix version Oracle 19.0.0 EE/SE


2301, 2307, 2402 Supported 1,2
1 ODP.NET (including ‘Oracle Data Provider for .NET) should be installed (see the ODP.NET
registration in GAC topic in the Tecnomatix Administration Guide)

2 Pluggable databases are certified

Tecnomatix 2402 Installation Guide on eMServer 14-1


Unpublished work. © 2024 Siemens
14-2 Tecnomatix 2402 Installation Guide on eMServer
Unpublished work. © 2024 Siemens
15. Preparing the domain group policy to
allow MMC snap-ins
Domain Group Policy should allow running MMC snap-ins. If this policy denies access to these snap-ins,
users may receive the following error when running the Tecnomatix AdminConsole: 'The snap-in below,
referenced in this document, has been restricted by policy. Contact your administrator for details.' You can
add the following settings to your Active Directory to grant MMC snap-in access:

• Allow access to AdminConsole.msc in Active Directory.


• Create a custom ADM template in Active Directory containing AdminConsole extension snap-ins, that
explicitly allows them to run, overriding any restrictive group policy.

Tecnomatix_Console_Unlock.adm

CLASS User
CATEGORY "Windows Components"
CATEGORY "Microsoft Management Console"
CATEGORY "Custom Settings"
POLICY "Microsoft Folder Snap-in"
KEYNAME "Software\Policies\Microsoft\MMC\
{C96401CC-0E17-11D3-885B-00C04F72C717}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
END POLICY
POLICY "Tecnomatix AdminConsole - Main"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE333-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
ENDPOLICY
POLICY "Tecnomatix AdminConsole - Archive Project"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE331-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
END POLICY
POLICY "Tecnomatix AdminConsole - Business Modeler"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE323-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"

Tecnomatix 2402 Installation Guide on eMServer 15-1


Unpublished work. © 2024 Siemens
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
END POLICY
POLICY "Tecnomatix AdminConsole - Common Actions"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE32B-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME"Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
END POLICY
POLICY "Tecnomatix AdminConsole - Data Analysis"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE32F-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
END POLICY
POLICY "Tecnomatix AdminConsole - eMServer Manager"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE327-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUE OFFNUMERIC 1
END POLICY
POLICY "Tecnomatix AdminConsole - Project Actions"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE32D-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
END POLICY
POLICY "Tecnomatix AdminConsole - Schema Manager"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE329-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
POLICY "Tecnomatix AdminConsole - User Administration"
KEYNAME "Software\Policies\Microsoft\MMC\
{F58FE325-371F-11DA-92C7-0020E0797C4D}"
EXPLAIN "Permits or prohibits use of this snap-in"
VALUENAME "Restrict_Run"
VALUEON NUMERIC 0
VALUEOFF NUMERIC 1
END POLICY
END CATEGORY
END CATEGORY
END CATEGORY

15-2 Tecnomatix 2402 Installation Guide on eMServer


Unpublished work. © 2024 Siemens
16. ArtiMinds RPS Installation

To install ArtiMinds Robot Programming Suite, click ArtiMinds-RPS-PS-<version_number>-


Windows64.exe on the Tecnomatix DVD.

Note
An additional license is required for using ArtiMinds.

Download CAD models for ArtiMinds from https://www.artiminds.com/9557e47a2490/RPS/ArtiMinds-


RPS-PS-Models-<version_number>.zip and extract them to the RPS installation directory (for example,
C:\Program Files\ArtiMinds\RPS-PS), overwriting existing files. After opening the ArtiMinds Robot
Configurator, the relevant CAD models are displayed.

Tecnomatix 2402 Installation Guide on eMServer 16-1


Unpublished work. © 2024 Siemens

You might also like