NXKnowledge

Content Migration Manager > Product documentation

CMM 1921 install notes and release notes

CMM 1921 Install Notes October 1, 2020

Unrestricted 1

Software Copyright and Trademark Notices

© 2020 Siemens. All Rights Reserved. This software and related documentation are proprietary to Siemens Industry Software Inc. LIMITATIONS TO U.S. GOVERNMENT RIGHTS. UNPUBLISHED - RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. This computer software and related computer software documentation have been developed exclusively at private expense and are provided subject to the following rights: If this computer software and computer software documentation qualify as "commercial items" (as that term is defined in FAR 2.101), their use, duplication or disclosure by the U.S. Government is subject to the protections and restrictions as set forth in the Siemens Digital Industries Software commercial license for the software and/or documentation, as prescribed in FAR 12.212 and FAR 27.405(b)(2)(i) (for civilian agencies) and in DFARS 227.7202-1(a) and DFARS 227.7202-3(a) (for the Department of Defense), or any successor or similar regulation, as applicable or as amended from time to time. If this computer software and computer documentation do not qualify as "commercial items," then they are "restricted computer software" and are provided with "restrictive rights," and their use, duplication or disclosure by the U.S. Government is subject to the protections and restrictions as set forth in FAR 27.404(b) and FAR 52-227-14 (for civilian agencies), and DFARS 227.7203-5(c) and DFARS 252.227-7014 (for the Department of Defense), or any successor or similar regulation, as applicable or as amended from time to time. Siemens Digital Industries Software, 5800 Granite Parkway, Suite 600, Plano, Texas 75024.

Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

Part of the software embedded in this product is gSOAP software. Portions created by gSOAP are Copyright © 2001–2004 Robert A. van Engelen, Genivia inc. All Rights Reserved.

THE SOFTWARE IN THIS PRODUCT WAS IN PART PROVIDED BY GENIVIA INC AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

All other trademarks or registered trademarks belong to their respective holders.

Unrestricted 2

Table of Contents Preface .......................................................................................................................................................... 3 Audience ................................................................................................................................................... 3 Submitting comments ............................................................................................................................... 3 Software version prerequisites ..................................................................................................................... 4 Installing the software .................................................................................................................................. 5 Installation Steps ....................................................................................................................................... 5 Choosing your Application ........................................................................................................................ 5 Installing Additional CAD Translators ....................................................................................................... 6 Known Issues with This Release .................................................................................................................... 7 Additional Considerations ............................................................................................................................. 7 Teamcenter ............................................................................................................................................... 7 2-tier vs. 4-tier Teamcenter Environment ............................................................................................ 7 Running Teamcenter Single Sign On ..................................................................................................... 7 Running under Client Dispatcher .......................................................................................................... 8 Working with I-deas data in Client Dispatcher ..................................................................................... 9 Other considerations ................................................................................................................................ 9 Working with CATIA V4 in Teamcenter ................................................................................................. 9 32 bit Java ............................................................................................................................................. 9

Unrestricted 3

Preface Audience This document is intended to help you install Content Migration Manager and its associated products. It provides information on the installation process and things you should consider prior to installing the software. It also contains the latest information on supported software versions and installation considerations. Submitting comments Portions of Teamcenter software are provided by third-party vendors. Special agreements with these vendors require Siemens to handle all problem reports concerning the software they provide. Please submit all comments directly to Siemens Digital Industries Software.

Submit incident reports to Support Center. https://support.sw.siemens.com/en-US/

Unrestricted 4

Software version prerequisites

Teamcenter version Teamcenter 11.2.1 and later Teamcenter 11 releases Teamcenter 12.1, 12,2, and 12.3

Java Runtime

Version 1.8 (Certified with Adopt Open JDK 8 version 1.8.0_242 and Azul Zulu JRE 8 version 1.8.0_242)

NX Version

1899 or later in 1899 series

I-deas Version

I-deas does not need to be installed on the computer performing the migration

I-deas data must be from a release of I-deas Master Series 8 or later; up to I-deas NX Series 6.7

Pro/ENGINEER Version

CreoParametric 3 (M110 or later) CreoParametric 4 (M020 or later) CreoParametric 5 (5.0.0.0 or later) CreoParametric 6 (6.0.1.0 or later)

A licensed copy of Pro/ENGINEER must be available on the computer performing the migration. It is accessed by the CMM software.

CATIA

V4 (MEC) V5 R24, R25, R26, R27, R28, R29

To migrate CATIA V5 data, a licensed copy of CATIA V5 must be available. It is accessed by the CMM software. To migrate CATIA V4 data, CATIA does not need to be installed.

SolidWorks

SolidWorks 2018, 2019, 2020

A licensed copy of SolidWorks must be available on the computer performing the migration. It is accessed by the CMM software.

Microsoft Windows Version

Microsoft Windows 10 SP 1 64 bit

Unrestricted 5

Installing the software

Installation Steps

  1. If your CD fails to run automatically, please start the install by running the following command ➢ Setup.exe
  2. Select the Content Migration Manager product you wish to install and follow the installation steps. During the install, you must select the components to install and the location of the installed code. After the installation completes, you may be asked to restart your computer. You can do this now or after you have completed installing any additional CAD translators you wish to install. (See step 3.)
  3. After the Content Migration Manager or NX Migration Manager has been installed, you can install Additional CAD Translators for migrating other CAD data such as Pro/Engineer, CATIA V4, CATIA V5 or SolidWorks. All translators require appropriate licenses in order to operate.
  4. You must install the CMM Business Modeler IDE template for Teamcenter within your database if this is not already installed. The templates have been updated for this release and are now required. The templates are specific to the Teamcenter version you are using. To install them, you will use the Teamcenter Environment Manager (TEM). Choosing your Application During the install process, you will be given the choice of 3 different applications to install. Which you choose depends on what you intend to migrate and how your environment is setup. The table below will guide you in your installation choice. Remember, you must have to correct license to be able to use each tool. Application CAD Type Supported Notes Content Migration Manager I-deas, Pro Engineer, SolidWorks, Catia V5, Catia V4
  • This provides fully featured migration.
  • When used with Teamcenter, it may be used in a 2-tier or 4-tier environment.
  • It may be used with Client Dispatcher NX Migration SolidWorks, Catia V5, Catia V4
  • This is limited to BRep only migration.
  • When used with Teamcenter, it may be used in a 2-tier or 4-tier environment.
  • It does not support Client Dispatcher View Reporting No data can be migrated
  • This is limited to viewing reports, monitoring migrations and gathering statistics about migrations.
  • If the Client Dispatcher is installed on the host machine, you may also use it to submit translations to Client Dispatcher.
  • It may be used in a 2-tier or 4-tier environment.
  • This does not require a separate license.

Unrestricted 6

Installing Additional CAD Translators

  1. For Pro/E and CATIA V5, the translator version you select must match the installed version of the software product. It does not have to match the data version. However, the installed version must be equal to or later than the version where the data was created.
  2. If you reinstall Content Migration Manager, you must reinstall the additional translators.
  3. The additional translators provided with CMM 1921 require NX 1899 or later in 1899 series. They do not work with earlier releases of NX.
  4. If you are installing for CATIA V5, you must select the correct translator and then perform the steps described in the document \plugins\CADFeature\BOS_Readme.pdf in order to build the CAA plugin. A CAA license level of at least CDV is required.
  5. The Additional Translators do not include 32-bit versions. You must use them on 64-bit operating systems. In addition, the CATIA V5 or Pro/Engineer used must be 64-bit.
  6. While installing the Additional Translators, you will be asked to enter an optional “Customization String”. Most users will leave this blank and press “Next” on this entry screen.
  7. The Additional Translators are installed in the “plugins” directory of the CMM installation directory.

Unrestricted 7

Known Issues with This Release Additional Considerations This section provides additional information for specific aspects of your environment. Teamcenter Due to the wide variety of ways Teamcenter can be configured there are many things to consider when using CMM with Teamcenter. The following section discusses some of these considerations 2-tier vs. 4-tier Teamcenter Environment Content Migration Manager products support direct migration in either a 2-tier or 4-tier Teamcenter environment. In 2-tier mode, the Teamcenter client, server and all required CMM applications execute on a single workstation. The Teamcenter volume is normally located on a network location and accessed from the 2-tier installation as well as all other clients. 2-tier mode is required for any installation that runs through Client Dispatcher. 4-tier mode is often preferred for large groups of users scattered in varying offices. Since migration is generally handled by a small group of collocated individuals, many of the advantages of 4-tier installations may lost. You may install CMM in a 2-tier environment for the users performing migrations even if the majority of Teamcenter users are in a 4-tier environment. You may decide you want a limited number of users performing migrations and a larger number of users reviewing reports or doing part repair. For users who are only viewing reports or doing part repair may find installing only the Report Viewer application. It is usually best to install this application in the users environment type. When deciding whether to use 2-tier or 4-tier environment for you CMM users, it is important to consider several things. These include your network and environment performance characteristics, the location and number of members of your migration team, whether you are planning to use Client Dispatcher in your migration process and which application you are installing. Running Teamcenter Single Sign On Some Teamcenter installations use the Teamcenter Single Sign On capability. To allow CMM to work with this capability, take the following steps.

  1. From TC, start NX
  2. In NX, get the Single Sign On preferences by selecting File->Utilities->Customer Defaults
  3. Scroll down in the defaults to Teamcenter Integration for NX and then to Miscellaneous.
  4. Select Miscellaneous
  5. Select the Security Services tab

Unrestricted 8

  1. Get the value of Teamcenter Security Service Login URL and Teamcenter Security Services Application ID
  2. Edit the nx_defaults.xml file found in the \Config directory
  3. Add these settings

Running under Client Dispatcher CMM supports running under the control of Teamcenter’s Client Dispatcher mechanism, formerly known as Translation Services. You cannot install CMM to run with Dispatcher Client in 4-tier mode. In order to enable the feature, please complete the following steps:

  1. Make sure that the Teamcenter setting IIOP_SERVER_ACTIVIATION is set to PER_CLIENT. This is done through the Teamcenter Environment Manager (TEM).
  2. Set the Teamcenter preferences. You may either do this manually or use Teamcenter’s facilities to import the preferences from the

\dispatcher\ETSCMMPreference_merge.xml file. Please see the CMM Users Guide for how to do this. 3. You may need to add the following access rules. a. From Access Manager, add the following rule to the rule tree under Has Class (POM_application_object)->Working. Condition = Has Class Value = DispatcherRequest ACL Name = DispatcherRequest ACE Type of Accessor = User ACE ID of Accessor = ETS Proxy User ID ACE Privilege = Write ACE Privilege Value = Grant ACE Privilege = Delete ACE Privilege Value = Grant b. Add ETS Proxy user ID to (POM_application_object)->Working. Condition = Has Class Value = POM_application_object ACL Name = Working ACE ID of Accessor = ETS Proxy User ID ACE Privilege = Write

Unrestricted 9

    ACE Privilege Value = Grant
    ACE Privilege = Delete
    ACE Privilege Value = Grant

Many users choose to have the Dispatcher process running on a different computer than where CMM is installed. The automated CMM install process cannot update all dispatcher configurations in this case. If you chose to have the Dispatcher running on a different machine from where the CMM Modules run, you need to take the following steps.

  • Copy the file CMMETSTaskPrep.jar from the CMM installation directory to the %DISPATCHER_ROOT%\DispatcherClient\lib directory. Make sure you choose the correct CMMETSTaskPrep.jar for your Teamcenter release. The .jar files are found in the

\dispatcher directory.

  • Modify the file %DISPATCHER_ROOT%\DispatcherClient\conf\Service.properties to add “ETSCMMService” at the end of the first “import” line in the file

Working with I-deas data in Client Dispatcher I-deas has an 80 character limit for the path and file name to its data files. Since CMM uses I-deas in its migration process, the path to the dispatcher staging location must be much shorter than 80 characters. It is recommended that you limit it to 10 characters at the most. Other considerations Working with CATIA V4 in Teamcenter CATIA V4 data uses .model files. These model files may represent a large number of individual parts. A setting in CMM (“Convert Model to Single Part”) allows you to control whether these .model files get migrated as a single part or are separated into individual NX parts for each part in the model file. If you choose to separate the CATIA model into individual NX parts, large numbers of new items could be created. By default, all of these items will be put into the users Newstuff folder. This is particularly important when running many migrations at the same time through Dispatcher Client. When Teamcenter tries to place very large numbers of items from different processes into the Newstuff folder a performance bottleneck can occur. To avoid this, create the following Teamcenter preferences as User preferences for the Dispatcher Client migration user. Preference Name= WsoInsertNoSelectionsPref with Value=3 Preference Name= WsoInsertSelectionsPref with Value=4

32-bit Java The default memory requested by CMMBatch.cmd and CMMSolo.cmd has been increased. It now exceeds the amount allowed by 32-bit Java Virtual machines. It is recommended that you use 64-bit

Unrestricted 10

java for CMM. If you must use 32-bit Java, you need to edit the CMMBatch and CMMSolo.cmd files. Change the Xmx value to something 1300.

Source: CMM 1921 download (Support Center PL20201112075217794, CMM1921.7z), NXMigration/Documentation/ReleaseNotes.pdf · retrieved 2026-10-02