Hi Folks,
Greetings! I hope you are all doing well.
During a recent System Refresh activity, I encountered an issue where the Transport Route configuration could not be edited in the Quality system after restoring a backup from the Production system. Since this issue can occur frequently during refresh cycles, I am sharing the root cause, analysis, and step-by-step resolution.
Issue Summary: –
After performing a backup restore from Production to Quality, we executed the standard post-refresh activities—one of which includes clearing the existing TMS configuration in the target (Quality) system.
However, once the system came up and I launched STMS, the Edit / Change icon was disabled, preventing me from defining or modifying the transport routes.
Because the Quality system was refreshed from Production, the original routes and controller information were overwritten or removed—leading to a mismatch between the local TMS configuration and the domain controller.
Root Cause:-
During the system refresh:
Transport Management System (TMS) data from Production overwrote the Quality system’s configuration.As part of cleanup, TMS routes were deleted or became inconsistent.The system lost its connection to the Domain Controller, causing the edit icon in STMS Transport Routes to become unavailable.
Essentially, the Quality system was no longer recognized as part of the transport domain.
Technical Explanation: –
After the refresh:
The refreshed system contains production TMSADM keys, not matching the domain controller.Therefore, the system cannot authenticate with the domain controller.As a result, STMS → Transport Routes goes into read-only mode.
To synchronize the system again, we must update the local TMS config with the domain controller.
Solution – Restore TMS Route Using “Adjust with Controller: –
Perform the steps in the Quality system:
Step 1: Log in with DDIC user in client 000
This is mandatory because TMS configuration changes can only be done in:
Client 000With DDIC or TMSADM authorized users
Step 2: Execute Transaction STMS
The system will try to connect to the domain controller.
STMS T-code
Step 3: Navigate to Transport Routes
Step 4: Adjust Configuration with Domain Controller
Go to: Configuration>Adjust with controller
You will notice the Edit icon is disabled.
Then click on configuration and get option is adjust with controller just see below snap.
Click Yes when prompted.
This action forces the Quality system to:
Re-import TMS configuration from the Domain ControllerRegenerate TMSADM RFC connectionRestore the correct system role (Dev → QA → Prod)Load the existing route definitions
Step 5: Save the Transport Route
After synchronization, the correct routes appear automatically.Click Save to activate the configuration.
Additional Technical Checks (Optional but Recommended)
Verify RFC connection of TMSADM
SM59 → ABAP Connections → TMSADM_<SID>_XXX
Status should be green.
Check Domain Controller system
In Domain Controller (usually DEV system):
STMS → Overview → Systems
Ensure the refreshed system is visible and status is Active.
Check consistency
Run:
STMS → System Overview → Extras → Verify Configuration
Conclusion
After a system refresh, you may find the Edit option disabled in STMS due to mismatched TMS configuration. Using “Adjust with Controller” is the correct approach to synchronize the system with the transport domain controller and restore the predefined routes.
This process ensures that:
Quality system aligns with the domain controllerRoutes are restored without manual reconstructionTMS remains consistent and operational
Thanks for Reading!
Please feel free to share your thoughts, improvements, or any similar experiences you’ve encountered during system refreshes.
Regards,
Nishant Garg
Hi Folks,Greetings! I hope you are all doing well.During a recent System Refresh activity, I encountered an issue where the Transport Route configuration could not be edited in the Quality system after restoring a backup from the Production system. Since this issue can occur frequently during refresh cycles, I am sharing the root cause, analysis, and step-by-step resolution.Issue Summary: -After performing a backup restore from Production to Quality, we executed the standard post-refresh activities—one of which includes clearing the existing TMS configuration in the target (Quality) system.However, once the system came up and I launched STMS, the Edit / Change icon was disabled, preventing me from defining or modifying the transport routes. Because the Quality system was refreshed from Production, the original routes and controller information were overwritten or removed—leading to a mismatch between the local TMS configuration and the domain controller.Root Cause:-During the system refresh:Transport Management System (TMS) data from Production overwrote the Quality system’s configuration.As part of cleanup, TMS routes were deleted or became inconsistent.The system lost its connection to the Domain Controller, causing the edit icon in STMS Transport Routes to become unavailable.Essentially, the Quality system was no longer recognized as part of the transport domain.Technical Explanation: -After the refresh:The refreshed system contains production TMSADM keys, not matching the domain controller.Therefore, the system cannot authenticate with the domain controller.As a result, STMS → Transport Routes goes into read-only mode.To synchronize the system again, we must update the local TMS config with the domain controller.Solution – Restore TMS Route Using “Adjust with Controller: -Perform the steps in the Quality system:Step 1: Log in with DDIC user in client 000This is mandatory because TMS configuration changes can only be done in:Client 000With DDIC or TMSADM authorized usersStep 2: Execute Transaction STMSThe system will try to connect to the domain controller.STMS T-codeStep 3: Navigate to Transport RoutesStep 4: Adjust Configuration with Domain ControllerGo to: Configuration>Adjust with controllerYou will notice the Edit icon is disabled.Then click on configuration and get option is adjust with controller just see below snap. Click Yes when prompted.This action forces the Quality system to:Re-import TMS configuration from the Domain ControllerRegenerate TMSADM RFC connectionRestore the correct system role (Dev → QA → Prod)Load the existing route definitionsStep 5: Save the Transport RouteAfter synchronization, the correct routes appear automatically.Click Save to activate the configuration.Additional Technical Checks (Optional but Recommended)Verify RFC connection of TMSADM SM59 → ABAP Connections → TMSADM_<SID>_XXX Status should be green.Check Domain Controller system In Domain Controller (usually DEV system): STMS → Overview → Systems Ensure the refreshed system is visible and status is Active.Check consistency Run: STMS → System Overview → Extras → Verify ConfigurationConclusionAfter a system refresh, you may find the Edit option disabled in STMS due to mismatched TMS configuration. Using “Adjust with Controller” is the correct approach to synchronize the system with the transport domain controller and restore the predefined routes.This process ensures that:Quality system aligns with the domain controllerRoutes are restored without manual reconstructionTMS remains consistent and operational Thanks for Reading!Please feel free to share your thoughts, improvements, or any similar experiences you’ve encountered during system refreshes.Regards,Nishant Garg Read More Technology Blog Posts by SAP articles
#SAP
#SAPTechnologyblog
