Best practice to upgrade Teamcenter Connector from v3.5.0 to v2506 in Mendix

0
We are currently using Teamcenter Connector v3.5.0 in our Mendix application and are planning to upgrade to Teamcenter Connector v2506.Given the large version gap, I would like to understand the recommended upgrade approach and best practices.Specifically, I am looking for guidance on:Whether a direct upgrade from v3.5.0 to v2506 is supported or if incremental upgrades are recommended
asked
3 answers
2

I'd recommend upgrading to 2512.1.0. That version no longer has the OIDC module dependency and is much easier to set up.


If your reason to upgrade to 2506 is because you're using Teamcenter 2506, please be aware that Teamcenter Connector 2512 is compatible with Teamcenter 2506, per the compatibility matrix.

answered
-2

From what I know about upgrading, a direct upgrade over such a large version gap (like v3.5.0 ->  v2506) is usually not recommended.


Even if it technically works, you may run into:

  • breaking changes in Java actions
  • dependency/version mismatches
  • required changes in configuration or data model


As a safer approach, I would suggest:

  • First check the release notes between versions to identify breaking changes
  • If possible, upgrade incrementally (e.g. to an intermediate stable version first)
  • Re-download the connector from Marketplace instead of relying only on version bump
  • Clean userlib and re-resolve dependencies after upgrade
  • Test integrations step by step (especially Teamcenter calls)


So while a direct upgrade might work, based on experience it’s generally safer to treat this as a migration rather than a simple version update.


If this resolves your issue, you can mark it as accepted.



answered
-3

hi,


Upgrading from Teamcenter Connector v3.5.0 to v2506 is a significant jump, so a direct upgrade is generally not recommended.


1. Perform incremental upgrades

Instead of upgrading directly:

  • Upgrade step-by-step across major versions (for example: v3.x → v4.x → later versions → v2506)
  • At each step:
    • Resolve errors
    • Test integrations
    • Validate data flows

This reduces risk and makes troubleshooting easier.

2. Check compatibility first

Before upgrading, verify:

  • Mendix Studio Pro version compatibility
  • Teamcenter server version compatibility
  • Connector dependencies and required modules

Newer connector versions often require:

  • Updated Mendix versions
  • Different configurations

3. Review breaking changes

Between v3.5.0 and v2506, expect:

  • Changes in domain model (entities/associations)
  • Updated Java actions and APIs
  • Modified authentication or configuration setup

Carefully review:

  • Release notes
  • Migration guides (if available)

4. Refactor instead of replace blindly

Avoid simply replacing the module.

Instead:

  • Compare old vs new module
  • Migrate required logic step-by-step
  • Update microflows and integrations accordingly

5. Test thoroughly after each step

Focus on:

  • Service calls to Teamcenter
  • Data synchronization
  • Error handling

6. Backup and branch strategy

  • Take a full backup before starting
  • Perform upgrade in a separate branch
  • Do not upgrade directly in production

When direct upgrade may work

A direct upgrade might work only if:

  • No heavy customization is done
  • Minimal dependency on old connector logic

Even then, it is not recommended for large version gaps.


  • Do not upgrade directly from v3.5.0 → v2506
  • Use incremental upgrades
  • Review compatibility and breaking changes
  • Refactor integration logic carefully
  • Test at each stage



answered