Solid Edge Embedded Client Readme File

Legal Notices

© 2008 Siemens Product Lifecycle Management Software Inc. All rights reserved. Siemens and the Siemens logo are registered trademarks of Siemens AG. Solid Edge and Velocity Series are trademarks or registered trademarks of Siemens Product Lifecycle Management Software Inc. or its subsidiaries in the United States and in other countries. All other logos, trademarks, registered trademarks or service marks used herein are the property of their respective holders.


Version Information

Product:  Solid Edge Embedded Client
Number:  TCG26110
Version:  100.00.00.133
Date:       07-Aug-2008


Description

Solid Edge Embedded Client is the transparent integration between Solid Edge, the revolutionary computer-aided design (CAD) system, and Teamcenter, the recognized standard in cPDM. This unique approach to a managed design environment reduces the designer's workload by enabling existing Solid Edge functionality to be Teamcenter-aware.

For more information about our software and services, visit our home page at http://www.solidedge.com


Solid Edge Embedded Client System Requirements and Information

Operating System Requirements and Information

These operating system requirements are specific to the Solid Edge Embedded Client (SEEC). Review the operating system requirements for Solid Edge and Teamcenter for additional product-specific details.

This release of Solid Edge Embedded Client has been certified to run on the following:

  • Vista Business® or Vista Enterprise® operating system (32-bit or 64-bit)
  • Windows XP Professional® operating system (32-bit or 64-bit)
  • Internet Explorer 6.0 or higher Note: SEEC ST has been certified to run on 64-bit Windows XP or Window Vista as a 32-bit application only.

    This release of Solid Edge Embedded Client DOES NOT support the following:

  • Windows 2000 Professional® operating system

    Software Compatibility

    Solid Edge Embedded Client ST requires:

  • Solid Edge ST, 32-bit
  • SEEC Client
  • SEEC Administrator ST

    Minimum:

  • Teamcenter Express V2.2.4 or V3; Teamcenter Engineering 2005SR1/2007 MP3a
  • Teamcenter Express V4; Teamcenter 2007.1 MP2

    Recommended:

  • Teamcenter Express V2.2.4 or V3; Teamcenter Engineering 2005SR1/2007 MP6
  • Teamcenter Express V4; Teamcenter 2007.1 MP3

    Note: Teamcenter Express V2.2.4 is an update to V2.2.

    Note: For ease of documentation, Teamcenter Engineering 2005SR1 and Teamcenter Engineering 2007 will be referred to as TcE 2005SR1/2007.

    Locations for Teamcenter Express V2 or V3 and Teamcenter Engineering 2005SR1/2007 updates:

    Teamcenter Version Location Filename
    Teamcenter Express 2.2.4 http://ftp.ugs.com/teamcenter_engineering/irm/windows/Teamcenter_Express/ Select TcX_V2.2.4_update.exe
    TcE 2005SR1/2007 MP3 http://ftp.ugs.com/teamcenter_engineering/irm/windows/Teamcenter_Engineering_2007/ Search for “TcEng2005_SR1_2007_MP3”.
    TcE 2005SR1/2007 MP3a http://ftp.ugs.com/special.php?dir=/teamcenter_engineering/patch Search for “TcEng2005_SR1_2007_MP3a”.
    TcE 2005SR1/2007 MP4 http://ftp.ugs.com/teamcenter_engineering/irm/windows/Teamcenter_Engineering_2007/ Search for “TcEng2005_SR1_2007_MP4”.
    TcE 2005SR1/2007 MP5 http://ftp.ugs.com/teamcenter_engineering/irm/windows/Teamcenter_Engineering_2007/ Search for “TcEng2005_SR1_2007_MP5”.
    TcE 2005SR1/2007 MP6 http://ftp.ugs.com/teamcenter_engineering/irm/windows/Teamcenter_Engineering_2007/ Search for “TcEng2005_SR1_2007_MP6”.

    Locations for Teamcenter Express V4 and Teamcenter 2007.1 (unified architecture):

    Teamcenter Version Location Filename
    Teamcenter Express V4 http://download.ugs.com/download.php/teamcenter_engineering/nt/Teamcenter_Express/ Search for "TcExpress4.0".
    Teamcenter 2007.1 MP2 http://download.ugs.com/download.php/teamcenter/nt/Teamcenter2007 Search for “Tc2007.1.2”.
    Teamcenter 2007.1 MP3 http://download.ugs.com/download.php/teamcenter/nt/Teamcenter2007 Search for “Tc2007.1.3”.

    This release of Solid Edge Embedded Client DOES NOT support the following:

  • Teamcenter Engineering V9.1.3.x or Teamcenter Express V1.x

    Hardware Requirements

    For Solid Edge with SEEC:

  • Must meet the minimum requirements of Solid Edge and Teamcenter.

    For bulk data migration using Add to Teamcenter:

    Recommended System Configuration:

  • 64-bit (x64) processor
  • Windows XP Professional Service Pack 2
  • At least 4 GB RAM
  • True Color (32-bit) or 16 million colors (24-bit)
  • Screen resolution set to 1280 x 1024
  • Disk space: The unmanaged data will be copied to the local drive (SEEC cache). The amount of free space must be greater than the amount of unmanaged data to be imported into Teamcenter.

    Minimum System Configuration:

  • 32-bit (x86) or 64-bit (x64) processor
  • Windows XP Professional Service Pack 2
  • At least 1GB RAM
  • 65K colors
  • Minimum Resolution: 1024x768
  • Disk space: The unmanaged data will be copied to the local drive (SEEC cache). The amount of free space must be greater than the amount of unmanaged data to be imported into Teamcenter.

    What's New in Solid Edge Embedded Client

    Solid Edge with Synchronous Technology with Solid Edge Embedded Client (SEEC) continues its implementation of Teamcenter's Service-Oriented Architecture (SOA) and File Management System (FMS) and demonstrates the ever increasing value of the Solid Edge product. This implementation can be used  with Teamcenter's 4-Tier deployment or it can be configured to be used with a Teamcenter 2-Tier deployment.

    In a 4-Tier deployment, only the client application executes on the users' workstation; the Enterprise tier, database, volume, and other resource tier components are executed on the server giving improved performance for customers working in a high-latency WAN environment.

    In a 2-Tier deployment, the Teamcenter Enterprise tier executes on the users' workstation with the client application and is the recommended deployment option for customers working in a low-latency or LAN environment. The implementation of Teamcenter's SOA provides separation between Solid Edge/SEEC and the Teamcenter server process, providing the maximum in available memory for the Solid Edge/SEEC application. This deployment option adds scalability because each client workstation is responsible for the Teamcenter server process and this process then communicates with the Resource tier. Note, the Solid Edge Embedded Client setup configures SEEC for a 4-Tier deployment. If a 2-Tier deployment is required, it is configured after the application is installed. For more details on 2-tier, refer to the Configuring Solid Edge Embedded Client for 2-Tier Deployment section of this readme file.)

    Note: A single Teamcenter environment can support both Solid Edge/SEEC 4-Tier and 2-Tier deployments. Then, your decision on which deployment option is best is based on the Clients connectivity to the Data Center.

    Note: The synchronization of the Solid Edge Assembly occurrence properties with Teamcenter will default to FALSE. If this functionality was TRUE in Solid Edge V20 or is set to TRUE following the installation of SEEC Administrator, the value will not be changed. See the Miscellaneous Information section for more details.

    In addition to SOA/FMS, many other new features have been added to this release, all of which continue the focus on implementing state-of-the-art technology with outstanding usability. For a complete list of Solid Edge with Synchronous Technology enhancements, start Solid Edge and choose "What's New" from the Help menu or choose the "What's New" topic under the "Solid Edge ST Release Notes" available on the Support Web Page at http://support.ugs.com/docs/solid-edge.html


    Installing Solid Edge Embedded Client Administrator with Teamcenter Express V4

    The Teamcenter Express V4 installation kit includes the Solid Edge Overlay Template.

    Teamcenter Express includes all the necessary Solid Edge Overlay Template details to complete a new installation or upgrade. See the Teamcenter Express documentation for installation and supported upgrade details.

    Once the Teamcenter Express installation is complete, there is still a requirement to install the Solid Edge Embedded Client Administrator before you attempt to use Solid Edge/SEEC. The Solid Edge Embedded Client Administrator installation uses the Teamcenter 2-Tier RAC client installation and delivers prerequisite files to the Teamcenter data directory and optionally, it can load your Solid Edge templates. The user installing SEEC Administrator must have write access to both the Teamcenter application directory (TC_ROOT) and the Teamcenter Data directory (TC_DATA). For this reason, it is recommended that this installation be performed on the server machine where Teamcenter 2-Tier RAC is installed and the 4-Tier infrastructure is configured/running.

    Note: See Preparing for the Installation and Installing SEEC Administrator in the Installing Solid Edge Embedded Client Administrator with Teamcenter 2007.1 (unified architecture) section for additional details.


    Installing Solid Edge Embedded Client Administrator with Teamcenter 2007.1 (unified architecture)

    The Solid Edge Embedded Client Administrator installation is required for Teamcenter. The Solid Edge Embedded Client Administrator installation kit includes the Solid Edge Overlay Template. This template is used by the Teamcenter Environment Manager (TEM) and is required for upgrades to Teamcenter 2007.1 or new installations of Teamcenter 2007.1. Solid Edge Embedded Client Administrator should be installed on the Teamcenter server whenever possible.

    The Solid Edge Embedded Client Administrator installation uses the Teamcenter 2-Tier RAC client installation and delivers prerequisite files to the Teamcenter data directory, and can optionally load Solid Edge templates. The user installing SEEC Administrator must have write access to both the Teamcenter application directory (TC_ROOT) and the Teamcenter Data directory (TC_DATA). The user installing SEEC Administrator must have write access to both the Teamcenter application directory (TC_ROOT) and the Teamcenter Data directory (TC_DATA). For this reason, it is recommended that this installation be performed on the server machine where Teamcenter 2-Tier RAC is installed and the 4-Tier infrastructure is configured/running.

    Supported Teamcenter Versions for Upgrade

  • Teamcenter Engineering V9.1.3
  • Teamcenter Engineering 2005SR1

    Preparing for Installation

  • Back up the Teamcenter data directory (%TC_DATA%).
  • Validate in a test environment before installing in your production environment.
  • Perform a complete backup of your Teamcenter database and Teamcenter volumes.
  • Close all Teamcenter applications (for example, Rich Application Client).
  • Confirm the installation and configuration of FMS and Teamcenter 4-Tier infrastructure
  • Remove any previous installations of SEEC Administrator

    Upgrading from Solid Edge V18 OR Solid Edge V19

    1. Remove any previous installation of SEEC Administrator
    2. Install SEEC Administrator V19 Update 12 and install features SEEC Administrator Program Files and Configure Teamcenter Database
    3. Remove SEEC Administrator

    Upgrading from Solid Edge V20

    1. Remove any previous installation of SEEC Administrator
    2. Install SEEC Administrator V20 Update 7 (or higher) and install features SEEC Administrator Program Files and Configure Teamcenter Database
    3. Remove SEEC Administrator

    Brief Overview - How to use the SEEC Overlay Template

    The following steps apply to Teamcenter 2007.1 only. For Teamcenter Express, Version 4 includes the SEEC Overlay template and setup was modified to include this template and addresses a new installation or upgrade. See the Teamcenter Express documentation for additional details.

    1. The SEEC Overlay Template contains the Solid Edge Embedded Client schema.
    2. BMIDE is not required to install the SEEC Overlay Template. BMIDE is a new application introduced with unified architecture.
    3. Review the Teamcenter documentation when upgrading an existing Teamcenter installation. This is critical to a successful upgrade!
    4. The Solid Edge Overlay Template is used for both Teamcenter upgrades and new Teamcenter 2007.1 installations.
      • On the Select Features dialog, use the Browse button, select feature_seec.xml from the ...\SEEC overlay template\Teamcenter 2007.1 <MP> folder, where Teamcenter 2007.1 <MP> represents the Teamcenter Maintenance Pack.
      • On the Select Features dialog, look for feature Solid Edge Embedded Client Overlay under Teamcenter Corporate Server.
      • Do NOT browse for the SEEC Overlay Template on the Business Modeler IDE Templates dialog.
      • On the Database Template Summary dialog, you should see the Template Name of Solid Edge Embedded Client Overlay and Template File of seec_template.xml.
    5. If the Solid Edge Overlay Template was previously applied to your Teamcenter installation, your Teamcenter upgrade plan should consider impacts to your Solid Edge Overlay Template and applied according to your update plans. Information was provided below; Please see the Teamcenter documentation for additional details.

    Warning: The SEEC Administrator installation kit now includes a Template specific to a Teamcenter 2007.1 Maintenance Pack. You must consider this when installing or upgrading Teamcenter 2007.1.

    Installing SEEC Administrator

    When installing the SEEC Administrator using the Solid Edge with Synchronous Technology DVD,

    1. Run <DVD>:\SEEC Administrator\setup.exe
    2. Continue the installation following the steps below, SEEC Administrator continues as follows:

    When installing the SEEC Administrator from a Solid Edge Update downloaded from GTAC,

    1. Run SEEC_Administrator_ST.exe
    2. On Remove Installation Files dialog,
      • Choose second option, to save files once setup completes.
      • The user has an option to specify where the files should be saved, Save files in folder.
      • SEEC Overlay Template is contained in this kit
    3. Continue the installation following the steps below, SEEC Administrator continues as follows:

    SEEC Administrator continues as follows:

    1. On the Select Teamcenter Application Folder and Version dialogs,
      • Select Teamcenter 2007.1 (unified architecture) or Teamcenter Express V4
      • Verify Existing Teamcenter Application folder or select Change... and browse to the correct TC_ROOT folder
    2. On the SEEC Administrator ST Installer Information dialog,
      • Select I have read the SEEC_readme.htm document AND I have completed all the prerequisite steps, provided this was done, and choose Continue
      • If you have not read the SEEC_readme.htm document, choose Exit.
    3. On the Select Teamcenter Data Folder dialog,
      • Verify Teamcenter Data folder or Browse to TC_DATA. If this is the first time you are running this setup, you must select Change... and browse to your TC_DATA folder. Note, a UNC path is supported.
      • Enter a Teamcenter DBA User ID and Password
    4. On Custom Setup dialog,
      • Feature SEEC Administrator Program Files delivers the program files to INSTALLDIR and loads the SEEC Preferences into Teamcenter; It is a required feature.
      • Choose optional feature Import Solid Edge Templates to install your Solid Edge Templates.
      • Note, the optional feature Configure Teamcenter Database is not an available for unified architecture. The Solid Edge Overlay Template was created to support this task.
    5. On Solid Edge Template Folder dialog (which is an optional feature),
      • Verify Solid Edge Template folder or select Change... and browse to the folder that contains your unmanaged templates.
      • Enter your Teamcenter Database URL. This is how you connect to the Teamcenter 4-Tier infrastructure. See the SEEC Client setup section of this document for additional details. Your 4-tier infrastructure must be running to load Solid Edge Templates!
    6. When prompted, select Install and then Finish.

    Updating Solid Edge Overlay Template

    When the Solid Edge Embedded Client Overlay template needs to be update, these following steps could be useful.

    1. SEEC Administrator would be the deliver vehicle for an updated SEEC Overlay template.
    2. Follow Teamcenter documented procedures for updating a Template. This must include full Teamcenter backups.
    3. The following steps are for reference purposes only.
      1. Start Teamcenter Environment Manager (TEM)
      2. Maintenance, Configuration Maintenance: Perform maintenance on an existing configuration
      3. Feature Maintenance: Teamcenter Foundation: Update the database
      4. Database Updater: Browse and select seec_template.zip from the ...\SEEC overlay template\Teamcenter 2007.1 <MP> folder, where Teamcenter 2007.1 <MP> represents the Teamcenter Maintenance Pack.
      5. A new row should be added to Candidate Templates, Template Name: Solid Edge Embedded Client Overlay
      6. Choose Apply checkbox for Solid Edge Embedded Client Overlay
      7. Confirm Selections: should list the Solid Edge Embedded Client Overlay(seec). Select Next to install.
      8. Once complete, restart your 4-tier infrastructure.
    4. Start Rich Application Client (RAC), Product Structure Editor and Insert column(s) ...; SE Assembly Reports should be in the list.

    Note: See the section Silent Installation of Solid Edge Embedded Client Administrator for silent installation instructions.


    Installing Solid Edge Embedded Client Administrator with Teamcenter Express or Teamcenter Engineering 2005 SR1/2007

    The Solid Edge Embedded Client Administrator installation is required for Teamcenter Express (TcX) and Teamcenter Engineering (TcE).  Solid Edge Embedded Client Administrator should be installed on the Teamcenter server whenever possible.

    The Solid Edge Embedded Client Administrator installation uses the Teamcenter 2-Tier RAC client installation and delivers prerequisite files to the Teamcenter data directory, and can optionally load Solid Edge templates. The user installing SEEC Administrator must have write access to both the Teamcenter application directory (TC_ROOT) and the Teamcenter Data directory (TC_DATA). The user installing SEEC Administrator must have write access to both the Teamcenter application directory (TC_ROOT) and the Teamcenter Data directory (TC_DATA). For this reason, it is recommended that this installation be performed on the server machine where Teamcenter 2-Tier RAC is installed and the 4-Tier infrastructure is configured/running.

    Preparing for Installation

  • Back up the Teamcenter data directory (%TC_DATA%).
  • Validate in a test environment before installing in your production environment.
  • Perform a complete backup of your Teamcenter database and Teamcenter volumes.
  • Close all Teamcenter applications (for example, Rich Application Client).
  • Confirm the installation and configuration of FMS and Teamcenter 4-Tier infrastructure
  • Remove any previous installations of SEEC Administrator

    Installing SEEC Administrator

    When installing the SEEC Administrator using the Solid Edge with Synchronous Technology DVD,

    1. Run <DVD>:\SEEC Administrator\setup.exe
    2. Continue the installation following the steps below, SEEC Administrator continues as follows:

    When installing the SEEC Administrator from a Solid Edge Update downloaded from GTAC,

    1. Run SEEC_Administrator_ST.exe
    2. On Remove Installation Files dialog,
      • Choose second option, to save files once setup completes.
      • The user has an option to specify where the files should be saved, Save files in folder.
      • SEEC Overlay Template is contained in this kit
    3. Continue the installation following the steps below, SEEC Administrator continues as follows:

    SEEC Administrator continues as follows:

    1. On the Select Teamcenter Application Folder and Version dialogs,
      • Select Teamcenter Express V2.2.4 or Teamcenter Express V3 or Teamcenter Engineering 2005SR1/2007 MP3a
      • Verify Existing Teamcenter Application folder or select Change... and browse to the correct TC_ROOT folder
    2. On the Select Teamcenter Data Folder dialog,
      • Verify Teamcenter Data folder or select Change... and browse to the correct TC_DATA folder. For Teamcenter Engineering, you must browse for your TC_DATA folder.
      • Enter a DBA User ID and Password
    3. On Custom Setup dialog,
      • If this is a new Teamcenter installation, install all features
      • If you are upgrading a Teamcenter database that has been configured for Solid Edge/SEEC V18 or V19, install features SEEC Administrator Program Files and Configure Teamcenter Database. The Import Solid Edge Templates feature is optional. However, to take advantage of Solid Edge with Synchronous Technology, you must load the new Synchronous Part and Assembly templates.
      • If you have installed SEEC Administrator ST and have already selected Configure Teamcenter Database, you do not need to select this feature again. (For example, if your Solid Edge templates have changed and you need to upload them to Teamcenter.)
    4. On Solid Edge Template Folder dialog (which is an optional feature),
      • Verify Solid Edge Template folder or select Change... and browse to the folder that contains your unmanaged templates.
      • Enter your Teamcenter Database URL. This is how you connect to the Teamcenter 4-Tier infrastructure. See the SEEC Client setup section of this document for additional details. Your 4-tier infrastructure must be running to load Solid Edge Templates!
    5. When prompted, select Install and then Finish.

    Note: See the section Silent Installation of Solid Edge Embedded Client Administrator for silent installation instructions.


    Installing Solid Edge Embedded Client

    Solid Edge Embedded Client supports a single installation of Solid Edge on the client workstation. Remove all previous installations of Solid Edge Embedded Client and Solid Edge before continuing with a new release.

    A Teamcenter Rich Application Client (RAC) is expected to be installed on the Workstation to support the activities of an Author. This RAC client installation will deliver and configure the Teamcenter FMS client. This must be installed and functional before installing Solid Edge Embedded Client. Both the Teamcenter 2-Tier and 4-Tier RAC installations deliver FMS. Once this Teamcenter task is complete, the Solid Edge Embedded Client installation steps outlined below are performed on each of the Solid Edge client workstation.

    Teamcenter Express V2 introduced Express Translation Services (ETS) as a server-side product. If Solid Edge support is required, install Solid Edge on the Server before installing this option. DO NOT run the SEEC Client setup on the server.

    Preparing for Installation

    Before you Uninstall the Previous Release:

  • The Solid Edge Embedded Client cache for ST has been enhanced and it is not compatible with previous releases.
  • Check in all Solid Edge content for all users with accounts on the workstation running Solid Edge with the Solid Edge Embedded Client, V18 or V19. Once all content in the cache is Checked in, it is recommended that you Reset your cache. Reset is found in Cache Assistant; Select Manage->Cache Assistant and then Reset. Reset the cache for each Project.

    Prerequisite:

  • Install Solid Edge ST, 32-bit.

    Before You Run Setup:

  • If you are currently using a previous release of Solid Edge Embedded Client, check in all documents, then reset the cache.
  • Remove any previous installation of Solid Edge Embedded Client.
  • Stop all Solid Edge and Teamcenter sessions.

    Defining the Teamcenter Database:

    Solid Edge Embedded Client implements Teamcenter's SOA framework. Setup now requires a Teamcenter Uniform Resource Locator (URL) and it is this Teamcenter Database URL that SEEC uses to determine the specific Teamcenter's 4-Tier infrastructure to connect or communicate to. The (3) pieces of information you need to know before running SEEC Client setup are:

  • Teamcenter Database URL - Required - How you connect to the Teamcenter 4-Tier infrastructure.
  • Teamcenter Database Description - Required - How you describe this Teamcenter installation (this is displayed on the Login dialog).
  • Solid Edge Standard Parts Definition - Optional - If you are using Solid Edge Standard Parts with this Database, provide the Standard Parts configuration file.

    Note: Solid Edge Standard Parts installations must be maintained and managed with one and only one Teamcenter Database.

    Note: Validate your server configuration using the Teamcenter Web client. In a web browser, test your Teamcenter Database URL by typing:
      http://myteamcenter.solidedge.com:8080/tc/webclient where you substitute "myteamcenter.solidedge.com" with your server name.

    Installing SEEC Client

    The Solid Edge Embedded Client installation must be installed on each workstation that requires access to Teamcenter-managed Solid Edge data.

    1. Insert the Solid Edge DVD. Click Other Solid Edge Products and then Solid Edge Embedded Client.
    2. If autorun does not start, double-click autorun.exe located on the Solid Edge DVD.
    3. On the Select Teamcenter Version dialog,
      • Select Teamcenter Express if your organization uses Teamcenter Express
      • Select Teamcenter (unified architecture) or Engineering Engineering if your organization uses Teamcenter or Teamcenter Engineering 2005SR1/2007
      • Note: Software requirements are detailed in the Software Compatibility section of this document.
    4. On Teamcenter Database Information,
      • Teamcenter Database URL - Required
      • Teamcenter Database Description -Required
      • Solid Edge Standard Parts Definition - Optional
      • Note: This dialog now contains a Help button with additional details.
    5. Click Install and then Finish.

    Once the Solid Edge Embedded Client is successfully loaded, you are ready to use Teamcenter to manage your Solid Edge documents in a 4-Tier implementation. If a 2-Tier deployment is required, see section Configuring Solid Edge Embedded Client for a 2-Tier Deployment.

    Warning: The Teamcenter Rich Application Client delivers and configures FMS. This must be complete before attempting to run Solid Edge with SEEC.

    Warning: Solid Edge with Synchronous Technology delivers a new set of Solid Edge Templates. Based on an installation choice, a list of available templates is built and presented in the Create section of the Solid Edge startup screen. This choice should be considered with the templates that will be loaded into Teamcenter so the Create list of templates presented at Solid Edge startup screen is also available as managed templates. If this does not occur, the user will need to use the Edit Create Options to edit the list.

    Note: See the section Silent installation of Solid Edge Embedded Client for silent installation instructions.


    Running Solid Edge Embedded Client

    Select Start => Programs => Solid Edge ST => Solid Edge

    1. The installation of the Solid Edge Embedded Client will enable the Teamcenter mode. You can verify this by looking at the Application title and if it displays "Solid Edge ST - Teamcenter", you are ready to work with managed content. If the title displays "Solid Edge ST", then the mode is off. You can enable it by selecting  Application menu > Manage > Teamcenter.
    2. Click Open and log in to Teamcenter.
    3. With a successful login, the Open dialog is displayed showing the contents of your Teamcenter Home folder.


    Configuring Solid Edge Embedded Client for 2-Tier Deployment

    The SEEC Client setup requires the user to enter a 4-Tier Teamcenter Database Definition. Then, SEEC only requires Teamcenter FMS, which was installed on the workstation by a 2-Tier or a 4-Tier Teamcenter RAC installation. If an SEEC 2-Tier deployment is required, SEEC would be configured after the Solid Edge Embedded Client setup was completed using the Define Teamcenter Database application. A Teamcenter 2-Tier RAC installation must be completed before you run the application Define Database Definintion!

    Complete the steps outlined in the section Installing Solid Edge Embedded Client and then execute the following steps.

    Prerequisite:

  • Install a Teamcenter 2-Tier Rich Application Client. This installation delivers the required Teamcenter application support for an SEEC 2-Tier deployment and it delivers and configures FMS.
  • Apply all the Teamcenter patches to meet your deployments  Teamcenter application requirements. Then, as future patches are applied to the server, they must be deployed to the clients.
  • Verify your RAC installation: My Navigator, FMS and Embedded Visualization.

    Warning: You cannot deliver a Teamcenter 4-Tier client for an SEEC 2-Tier deployment.

    SEEC as a 2-Tier Client:

  • Use the Define Teamcenter Database application to add a 2-Tier connection. Select > Programs > Solid Edge ST > SEEC > Define Teamcenter Databases.
  • To use a preconfigured application, select the "2-Tier" check box under Teamcenter Database URL and then enter a Database Description.
  • Click Add.
  • The Define Teamcenter 2-Tier Server dialog is displayed.
  • A new row is added to the table. Click OK to save these changes.
  • When the user is prompt to Log in to Teamcenter, select the 2-Tier connection from the database drop-list.

    Note: You can define only (1) 2-Tier database definition. You can define (n) 4-Tier database definitions. However, you must verify that FMS was configured to support your deployment! FMS is a critical piece of your deployment infrastructure.

    Warning: SEEC Client can run as either 4-Tier or 2-Tier client. However, the cache is on the selected Teamcenter Database URL. Therefore, a 4-Tier connection DOES NOT use the same physical cache as a 2-Tier connection for the same Teamcenter Database and User ID.


    Importing Unmanaged Content to Teamcenter - Solid Edge ST Update

    The bulk migration process will change in an upcoming Solid Edge with Synchronous Technology Update. This section will describe the process for the Solid Edge with Synchronous Technology release.

    Note: The Solid Edge with Synchronous Technology Help documents Solid Edge ST Update. This section will document what is available in Solid Edge ST release.

    The Solid Edge Data Prep Utilities should continue to be used to prepare your unmanaged content for import to Teamcenter.

  • Solid Edge ST delivers the following applications to the following locations.
  • Neither Solid Edge ST or Solid Edge ST Update will create shortcuts to these applications.
  • The features of the Data Import Process Guide will be incorporated into the AddtoTeamcenter application at a Solid Edge ST Update.
  • The Data Prep Utilities will continue to be available on GTAC to support previous versions of Solid Edge/SEEC.

    For Solid Edge ST release only, the Data Prep process  begins with Data Import Process Guide.
    - The Data Import Process Guide, Data Import Process Guide.bat contains a consolidated set of options for performing the entire data preparation and import process including performing a dry run of the Add to Teamcenter utility, creating ordered lists of files from your unmanaged data, and importing the unmanaged data into the Teamcenter managed environment.

    Note: The Solid Edge to Teamcenter Import Data Preparation Utilities documentation was incorporated into the Solid Edge Embedded Client User's Guide, where this documentation supports the upcoming Solid Edge ST Update.


    Teamcenter Deployment Troubleshooting

    Sizing 4-Tier

    While using SEEC as a 4-Tier application, you must configure the Teamcenter middle tier with enough Teamcenter Business Logic Server processes to handle the incoming requests. You cannot arbitrarily set these numbers, as this will adversely impact reliability and performance. If the specified numbers are set too low, you will see reliability issues with Solid Edge operations that interact with Teamcenter, such File-Open, File-Save, and so forth. If the numbers are set too high, then performance is impacted. The following information is provided to help educate and guide you in configuring your server processes.

    For Teamcenter, the Server Manager configuration is managed in %TC_ROOT%\pool_manager\serverPool*.properties file. The file entries in which you are most interested are PROCESS_MAX, PROCESS_WARM, and PROCESS_TARGET.

    For Teamcenter Express, the Server Manager configuration can be managed via a web page. For example, http://myteamcenter.solidedge.com:8080/tc/admin, where you would substitute your server details in the URL. After a successful login, the Global Configuration page is displayed. Select the Server Manager pool in the Server Manager Instances section. (State should be running.) The Pool Configuration is displayed and can be updated using Edit. Here, Process Target is the parameter of interest.

    Consult the Teamcenter documentation for additional details on other parameters.

    Troubleshooting

    Error or Issue

    Description

    Corrective Actions

    Unexpected http response - 100

    Observed when working with large assemblies

    Increase the number of servers in the Pool

    EJB Exception: nested exception is: java.lang.OutOfMemoryError

    Application Server ran out of memory (J2EE only)

    Increase Application Server memory Example: -Xms1024m and -Xmx1024m

    Solid Edge Policy file failed to load

    Observed when importing large datasets (AddtoTeamcenter)

    Increase the number of servers in the Pool

    Login requested for <User ID> to <Description>

    Solid Edge policy file failed to load.

    SEEC Administrator loaded on Teamcenter Server.

    Confirm delivery of Policy files to TC_DATA

    Verify the Teamcenter URL was entered correctly.

    Verify the Port number is correct.

    If 2-Tier connection, verify you have access to TC_DATA

    Login requested for <User ID> to <Description>

    The username, password, group and role combination you used is not valid. Verify your cap lock key is not on and try to login again.

    Verify you correctly entered  your login, attempt to login again

    Verify you entered an correct Group, attempt to login again.

    Verify you entered a correct Role. Close Solid Edge and start it again.

    Login requested for <User ID> to <Description>

    FMS Failed to start durin%TC_ROOT%\fcc\fcc.xml

    Verify environment variable FMS_HOME

    %FMS_HOME%\fcc.xml

    From a command prompt, type:
    %FMS_HOME%\bin\fccstat.exe -status

    Login requested for <User ID> to <Description>

    Teamcenter returned 8004A0A0 which SEEC does not recognize as a known error. Review the log file for further information.

    For 2-Tier, verify you have access to TC_DATA


    Solid Edge Embedded Client Miscellaneous Information

    Solid Edge Templates:

    You must install the new templates if you wish to use the new functionality introduced in Solid Edge with Synchronous Technology!

    Solid Edge with Synchronous Technology delivers a new set of templates. The Administrator should add these new templates to their set of Templates and use SEEC Administrator's  Import Solid Edge Templates feature to import them to Teamcenter. Then, based on a new option called User Type, the user is presented a list of available templates.

    Solid Edge Template Migration:

    Skip this section if you are migrating from Solid Edge Embedded Client V18, V19 or V20. You can continue to use your existing Teamcenter managed templates.

    If you are using the former Solid Edge integration to Teamcenter (Edge Manager), SEEC has implemented a new process for managed Solid Edge templates and the Administrator must manually migrate your company's templates forward. This step must be completed before the installation of the SEEC Administrator so this new unmanaged folder can be selected at the time of installation. The steps to migrate your Edge Manager templates follows:

    1. Create an unmanaged "root" folder, where you will copy the documents that will be subsequently imported.
    2. Create unmanaged copies of your Teamcenter managed Solid Edge templates.
    3. Copy these unmanaged documents into the above mentioned folder. If a subfolder is created, Solid Edge will present it as a Tab. For example, File:New with the tabs representing the names of these folders and the files appear under each of these tabs.
    4. Only one level of folders is supported.
    5. Add the Solid Edge with Synchronous Technology templates to your root folder (required to use Synchronous Part and Assembly)
    6. When setup prompts for a Template folder, navigate to the root folder containing your unmanaged templates (created in step #1).

    Note: Section Installing SEEC Administrator details the installation process, and in Step 4 of the installation, you would navigate to this new unmanaged "root" folder created above.

    Attribute Mapping:

    Attribute mapping defines what document properties exchanged between Solid Edge and Teamcenter. In Teamcenter, the key attributes normally used to track part numbers and revisions are Item ID and Revision ID. Each of these Teamcenter attributes are limited to 32 characters. In addition to these two properties, Teamcenter also requires an Item Type and Item Name. SEEC additionally maps Dataset Description, providing another property to capture additional detail about the specific Solid Edge document. Your unmanaged data's properties should be reviewed and prepared for importing before the content is uploaded to Teamcenter.

    SEEC defines the following property mappings:

    Teamcenter

    Required

    Solid Edge

    File Property

    Type=String, String Length

    Item Type

    Required

    Teamcenter Item Type

    Custom (Localized)

    32

    Item ID

    Required

    Document Number

    Project

    32 (128)1

    Revision

    Required

    Revision Number

    Project

    32

    Item Name

    Required

    Project Name

    Project

    32 (128)1

    Dataset Name 2 Required Dataset Name Custom (English) 32 (128)1

    Dataset Description

    Optional

    TC Engineering Description

    Custom (Localized)

    140

    1 Teamcenter 2007.1 provides an option to expand the String length to 128.
    2 Dataset Name is Required, but if it is empty, SEEC will use the default of Item ID/Revision (there is no asterisk on CPD)

    The key properties that are automatically mapped to Teamcenter attributes are displayed on the Project tab of the Properties dialog box in Solid Edge. To display the dialog box, go to Application menu, -> Properties -> File Properties.

    Note: Solid Edge ST released new functionality for the Solid Edge property called Material. See Solid Edge Help and Solid Edge Embedded Client User's Guide for more details.

    When you import the unmanaged files into the managed environment, blank Solid Edge Document Number properties are automatically assigned an Item ID by Teamcenter. It is recommended that you populate the Document Number, Revision Number, and Project Name fields before loading your data into Teamcenter. If these fields are properly populated, your Teamcenter database will be more accurately populated.

    Note: When unmanaged 3D documents using the same Document Number property are imported into Teamcenter, a unique document number is assigned to each 3D file being imported. As a result, in Teamcenter there can only be one Solid Edge 3D Dataset per Item Revision. However, there can be multiple Solid Edge Draft Datasets per Item Revision. For your deployment, you must decide if you are going to save your Solid Edge Draft documents to the same Item Revision as the Solid Edge 3D content it defines or if you are going to save your Solid Edge Draft documents to a separate Item.

    You can create Solid Edge Custom properties to map to Teamcenter attributes. Refer to the Solid Edge Help topic, Create Custom Document Properties or the Solid Edge Embedded Client User's Guide for additional details. Run Solid Edge and choose Help Index for links.

    Warning: When defining the attribute mapping definition, SEEC requires the explicit Teamcenter Property. (SEEC does not support the short or abbreviated forms for Teamcenter Properties.)

    Warning: You must define an attribute mapping for Model_Type before you attempt to save any Synchronous documents to Teamcenter. With Teamcenter Express V4, a new Item Revision Master Form property was created. These details are outlined in the Solid Edge Embedded Client User's Guide. A link to this guide is available from Solid Edge Help. Other Teamcenter releases should follow this implementation, where this property is at the Item Revision level, not the Item level of the data model. Your Teamcenter Administrator should consider the impact of any custom Item Types.

    Teamcenter Express V4 introduced a new attribute to address the new requirement for Model Type. The attribute TCX_Model_Type was added to the Item Revision Master Form for Item Types equal to Item and Standard. This property exists to manage the process of converting Traditional documents to Synchronous. For that purpose, it was designed to be used with a Teamcenter Query and it would not be shown on the Form. The following Teamcenter Express V4 mapping example would be used applied to Dataset Types of SE Part and SE Assembly.

    Model_Type : ItemRevision.GRM(IMAN_master_form,ItemRevision Master).TCX_Model_Type /master=cad /description="Traditional or Synchronous"

    Defining Teamcenter Databases:

    During the installation of the Solid Edge Embedded Client, setup queried for the definition of your Teamcenter Database. Once the Solid Edge Embedded Client is successfully loaded, the Teamcenter Database definition was used to configure the workstation (all users) and you are ready to use Teamcenter to manager your Solid Edge documents. Solid Edge V20 introduced the ability to define multiple Teamcenter Databases. If you would like to configure additional databases for use with Solid Edge Embedded Client, from the Start menu, select Start => Programs => Solid Edge ST =>  SEEC => Define Teamcenter Databases.

    Once yOnce your initial installation of Solid Edge Embedded Client is complete, use the utility to maintain an accurate list of Teamcenter databases by adding, modifying, or deleting entries. Additional information regarding the utility is available in Appendix B - Configuring the Solid Edge Embedded Client Environment, of the Solid Edge Embedded Client User's Guide for Administrators and Clients document, SEECUsersGuide.pdf, installed in the ...\Solid Edge ST\Program\ResDlls\0009 subfolder.

    Teamcenter Preferences Impacting SEEC:

    Teamcenter preferences are now stored in the Teamcenter Database and these preferences can be viewed using RAC (Tools:Options:Index or Search). A complete listing is provided in the Solid Edge Embedded Client User's Guide for Administrators and Clients document, SEECUsersGuide.pdf, installed in the ...\Solid Edge ST\Program\ResDlls\0009 subfolder. Following are important preference details.

  • SEEC supports Teamcenter's preference hierarchy (or scope) of User, Role, Group and Site, except as detailed in the preference description. All AIE_* and EM_* preferences are deprecated with the exception the following:
  • Preference SEEC_Create_PDF_for_Draft was deprecated and replaced with SEEC_Image_Generate_PDF_For_Draft

  • Preference SEEC_Property_Synchronize_AsmOcc controls the synchronization of the Solid Edge Assembly occurrence properties with Teamcenter. With Solid Edge ST, the preference will be added and set to FALSE (Solid Edge/SEEC will not write Assembly occurrence property data to Teamcenter). If this functionality was TRUE in Solid Edge V20 or is set to TRUE following the installation of SEEC Administrator, the value will not be changed.

    The following list of preferences were not loaded, but effect the SEEC as described below.

    Preference

    Description

    Value or Default

    Comments

    SEEC_Property_Item_Type

    Solid Edge Custom property name defining Item Type

    Teamcenter Item Type

    Localized Property; Example is English

    SEEC_Property_UOM Solid Edge Custom property name defining Unit of Measure None The value is based on what we defined in Attribute Mapping. Solid Edge will display a localized string.
    SEEC_Property_DatasetName Solid Edge Custom property name defining Dataset Name Dataset Name English value. Solid Edge will display a localized string.

    SEEC_Property_Dataset_Description

    Solid Edge Custom property name defining Dataset NameD

    TC Engineering Description

    Localized Property; Example is English

    These SEEC mandatory properties are written to File Properties as Custom properties. If this is a multi-language deployment of Solid Edge, these properties should be defined in English and then use these property names with Solid Edge Draft title, for example.

    Note: For localized Solid Edge products, save a new file to Teamcenter and then go to File:Properties. Select the Custom tab and find the Property names.

    The following list of preferences affect how managed Solid Edge content is displayed in Teamcenter RAC OR impact SEEC behavior.

    Preference

    Description

    Value or Default

    Comments

    SE Draft_PseudoFolder

    Creates a pseudo folder for the Dataset showing related objects for the defined Relation.

    SE Interpart Draft Link
    SE External Link

    RAC configuration showing objects connected to the Dataset

    SE Part_PseudoFolder

    Creates a pseudo folder for the Dataset showing related objects for the defined Relation.

    SE External Link

    Any Solid Edge 3D Dataset could use this Relation. SE Part was provided as example.

    SE Draft_DefaultChildProperties

    List of properties that can be used as children for the indicated type.

    SE Interpart Draft Link

    If defined, double-click in RAC is expand.

    SE Part_DefaultChildProperties

    List of properties that can be used as children for the indicated type.

    SE External Link

    Any Solid Edge 3D Dataset could use this Relation. SE Part was provided as example.


    IMAN_BOM_Precision_Preference or
    TC_BOM_Precision_Preference

    Specifies the BOM precision to be used during the creation of new BOMViews/BOMViewRevisions

    Imprecise

    Imprecise or Precise


    IMAN_truncate_file_name or
    TC_truncate_file_name

    Preference to decide if truncation of original file name is necessary

    FALSE

    Do not truncate filenames.

    IMAN_config_rule_name or
    TC_config_rule_name

    Indicates the default config rule that will be used when opening/pringing Imprecise BOMView or BOMViewRevisions. If the rule does not exist, the system will default to "Latest Working"

    Latest Working

    The first Revision Rule in the Solid Edge File:Open dialog is intentionally left blank and it denotes the value of this Preference. Once Open, Assembly PathFinder displays the Revision Rule applied to this Assembly.

    WsoInsertNoSelectionsPref

    When saving new content to Teamcenter, if no Folder is specificed, the Item is connected to Newstuff. This preferences effects the Solid Edge Save for new Items.

    0

    Default is to use Newstuff.

    Note: Use SE Draft_PseudoFolder for a user with permissions to delete the relation. Use SE Draft_DefaultChildProperties for a user who would like to expand the Dataset and see the related object. If both are defined, SE Draft_PseudoFolder takes precedence.


    Silent Installation of Solid Edge Embedded Client

    The following is a complete command-line argument set for silently installing Solid Edge Embedded Client (Client installation).

    All arguments should be encased in double quotes if there are spaces in the paths.

    C:\>msiexec /i "<DVD>\Embedded Client\Solid Edge Embedded Client ST.msi"
        INSTALLDIR="C:\Program Files\Solid Edge ST"
        ALLUSERS=1
        TEAMCENTERTYPE="TCX"
        TCDBURL="http://myteamcenter.solidedge.com:8080/tc"
        TCDBDESC="Production"
        SPSACFILE="\\myteamcenter\SiemensPLM\Solid Edge Standard Parts\SMAPINIFile.sac"
        TCDBDEFAULT=1
        /qn+ /l*v c:\SEECST_Client.log

    where, <DVD> is your DVD drive letter (D:), a mapped network drive letter and path or a UNC path to the installation files.
    <Computer Name> is the name of the Computer sharing Teamcenter Data (TC_DATA)

    SEEC Client public properties are:

  • INSTALLDIR - Installation location for Embedded Client and in quotes (this should be the Solid Edge ST installation folder)
  • ALLUSERS - What users can execute the installed application? 1 for All Users.
  • TEAMCENTERTYPE - TCX or TCE and in quotes
  • TCDBURL - Teamcenter Database URL and in quotes, Required
  • TCDBDESC - Teamcenter Database Description and in quotes, Required
  • SPSACFILE - If Solid Edge Standard Parts were configured for use with Teamcenter, enter the SAC file configured for this Teamcenter Database, Optional
  • TCDBDEFAULT - Default Teamcenter Database; 0 for FALSE or 1 for TRUE, Optional

    For additional help on msiexec switches/options, from a DOS Prompt, C:> msiexec


    Silent Installation of Solid Edge Embedded Client Administrator

    The following is a complete command-line argument set for silently installing Solid Edge Embedded Client (Administrator installation). All arguments should be encased in double quotes if there are spaces in the paths.

    C:\>msiexec /i "<DVD>\SEEC Administrator\SEEC Administrator ST.msi"
        INSTALLDIR="C:\SiemensPLM\2005SR1"
        TCROOTDIR="C:\SiemensPLM\2005SR1"
        TCDATADIR="C:\SiemensPLM\tcdata"
        TCVERSION=1
        TEMPLATEFOLDER="c:\progra~1\solide~1\Program\Templates"
        DBUSERNAME="infodba"
        DBPASSWORD="infodba"
        ADDLOCAL=ALL /qn+ /l*v c:\SEEC_Administrator.log

    where <DVD> is your DVD drive letter (D:), a mapped network drive letter and path or a UNC path to the installation files.

    SEEC Administrator public properties are:

  • INSTALLDIR - Installation location for SEEC Administrator and in quotes (recommend TC_ROOT)
  • TCROOTDIR - Teamcenter Application folder (TC_ROOT) in 8.3 file format and in quotes
  • TCDATADIR - Teamcenter Data folder (TC_DATA) in 8.3 file format and in quotes
  • TCVERSION - Teamcenter version; 1 for TcXv2or3 and TcE2005SR1/2007  or 2 for TcXv4 and Teamcenter 2007.1 (unified architecture)
  • TEMPLATTEMPLATEFOLDER - Provide Solid Edge Template folder in 8.3 format and in quotes
  • DBUSERNAME - Username for Teamcenter, default=infodba
  • DBPASSWORD - Password for Teamcenter database, default=infodba
  • ADDLOCAL - Valid inputs include: ALL or ProgramFiles or ConfigureDB or ImportTemplates (example: ADDLOCAL=ImportTemplates)

    For additional help on msiexec switches/options, from a DOS Prompt, type C:> msiexec /h


    Uninstalling Solid Edge Embedded Client

    For Solid Edge Embedded Client, go to Add/Remove Programs, locate Solid Edge Embedded Client ST and click Remove.

    For Solid Edge Embedded Client Administrator installation, go to Add/Remove Programs, locate SEEC Administrator ST, and click Remove.

    Note: If the SEEC Administrator is uninstalled, no files supporting the Data Model are removed.


    Documentation

  • If you would like to send comments about Solid Edge documentation, email them to mailto:seedumedia@UGS.com?subject=SE Documentation Feedback.
  • Solid Edge Help now includes a link to the Solid Edge Embedded Client User's Guide.  
  • The Solid Edge to Teamcenter Import Data Preparation Utilities documentation was incorporated into the Solid Edge Embedded Client User's Guide, referenced above.
  • For additional information relating to Solid Edge visit: http://www.solidedge.com/

    Training

    Siemens PLM Software Education Services offers a blend of training solutions for all of our product lifecycle management products, including instructor led training classes and self-paced product training that enables each user to learn at their own pace.

  • To search for UGS instructor-led training, visit: http://training.ugs.com/finder/index.shtml
  • Your reseller may also provide training services. To learn more about training partnerships, visit: http://www.ugs.com/partners/

    Solid Edge Technical Support

    Maintenance customers in the United States or Canada can report problems or request enhancements by calling the Global Technical Access Center (GTAC), 800-955-0000 or by connecting to the GTAC web page (http://support.ugs.com/) using your World Wide Web browser. Outside the United States or Canada, contact your local Channel Partner.

    Phone Support Options:

    800-955-0000

    2 - Technical Support

    2.2 - Solid Edge & the UGS Velocity Series

    2.2.1 - Applications Questions or Issues (Solid Edge & FEMAP Express within SE)

    2.2.2 - Solid Edge Insight & Solid Edge Embedded Client

    2.2.3 - Installation & Licensing Questions or Issues

    2.2.4 - Teamcenter Express Questions or Issues

    2.2.5 - NX CAM Express

    2.2.6 - FEMAP