Enable fast duplication for large structures

You can significantly reduce the time required to duplicate large product structures. This feature leverages parallel processing for duplicating structures with a high number of BOM lines, such as structures with over 5000 BOM lines.

Prerequisites

• Dispatcher license is available and active, because the structure is duplicated in the background and requires Dispatcher services.
• Multiple Teamcenter servers are available for parallel processing.
• Administrator access is available to you for the Teamcenter installation directories.

Procedure

1. Stop the Dispatcher services if they are running.
2. Configure the Dispatcher Translator properties.

   1. Navigate to the Teamcenter installation root directory and open the <Teamcenter_Installation_Directory>/dispatcher/module/conf/translator.xml file for editing.

   2. Locate the AsyncService section, add the maxlimit attribute to it, and set its value to match the number of parallel processes you want to run.

      Example, after setting the value of the maxlimit attribute to 50:

      <AsyncService isactive="true" provider="siemens" maxlimit="50" server="asyncservice">
      

      The limit value determines how many requests the translator can handle concurrently. The specific value depends on your system's capacity and the desired concurrency. For example, to run 10 parallel processes, set the limit to 10.

   3. Open the <Teamcenter_Installation_Directory>/dispatcher/module/conf/transmodule.properties file, and set the MaximumTasks property to define how many processes run in parallel.

3. Configure the Server Pool properties.
   1. Open the <Teamcenter_Installation_Directory>/pool_manager/confs/config1/serverPool.properties file.
   2. Ensure that the values for PROCESS_MAX and PROCESS_WARM parameters are set to the required numbers.
4. Restart the Teamcenter Server Pool Manager service.
5. Start the Dispatcher Modeler, Scheduler, and Client services to apply the updated configurations.
6. Set the Teamcenter preferences.

   1. From Launcher, click Preferences.

      If this option is unavailable, search for it. You can pin it from the search results for future access.

   2. Search for the TCFastStructureClone preference and set its value to true.

   3. (Optional) Search for the TCStructureCloneBatchSize preference and set its value to the number of BOM lines within the structure to be processed in a single batch during parallel processing.

      The default value is 500, which is suitable for many large structures. For extremely large structures, adjusting this value can further optimize performance by creating appropriately sized batches for parallel processing.

Results

Teamcenter is configured for duplicating large structures. The fast duplication operation runs in the background, and business users receive notifications upon completion.

What to do next

Inform business users that the fast duplication for large structures feature is enabled and that this operation always runs in the background. Advise business users that, for optimal performance, structures must contain at least 5000 BOM lines to benefit from parallel processing.

After the duplication of large structures is finished, set the TCFastStructureClone preference to false if you want to allow engineering users to duplicate the structures manually in the foreground.