T2P (Test to Production)
Contents
[hide]Overview
The Test to Production (T2P) feature allows the tracking and promotion of configuration changes on a project-by-project basis. This allows teams to independently implement changes within a project and later promote those changes to another SmartSimple environment. For example, you can move changes from a dedicated development environment to a production environment.
Notes:
- This feature is only available to clients with dedicated environments.
- Configuration changes are promoted based on individual objects. For example, if two projects modify the same object (such as a report), both sets of changes to the object will be promoted when either project involving that object is promoted.
- Some data will not be promoted when T2P is run. This includes the "Last Modified Date" for custom fields, details about the last and next run for autoloaders and scheduled exports, as well as associated organization IDs in signup pages and autoloader configurations.
- This article pertains to the online version of T2P, not the desktop tool.
Logging Changes Against a Project
After this feature has been configured, you can start logging changes for a specific project by following these steps:
- Go to User Menu > Personal Settings > Other tab > Under “T2P Project Assignment”, select the desired project to track changes against.
- Click Save. An orange header will appear at the top of the screen that indicates that any changes to the system are being logged against the selected project.
- Make desired configuration changes. Click the Pause button in the header if you want to pause tracking changes.
Exporting Changes to Another Environment
To export your changes to another environment, follow these steps:
- Go to Menu Icon > T2P (located under the “System Process” section) > Export tab
- Select the project to promote under Projects.
- Check the desired export setting under Export Name.
- Review changes logged against project.
- (Optional) To include any other changes, check the desired rows under “Changes Not Logged Against This Project” and click the Move Non-Project Changes to Current Project button.
- Click Export when finished.
Configuration
Configuring Feature Permissions
To set up feature permissions for T2P, follow these steps:
- Go to Global Settings > Security tab > System Feature Permissions > Features tab.
- Under the “Test to Production (T2P) - Access” section, select which roles are allowed to choose a project under their personal settings and log configuration changes against a project.
- Under the “Test to Production (T2P) - Manager” section, select which roles are allowed to import and export the configuration changes from the Menu Icon.
- Click Save.
Configuring Export Settings
Export settings allow you to transfer configuration changes from the current environment to another environment. For example, you could move changes from the test environment to production.
- Go to Global Settings > System tab > T2P Export Settings on the source environment (Example: the testing instance).
- Click New T2P Export Settings (looks like a plus sign).
- Fill in relevant fields and click Save.
- Generate a key pair and then copy the public key. The public key will be used when setting up the import settings.
- Toggle on Activate when you're ready to begin promoting configuration changes between SmartSimple environments.
Configuring Import Settings
Import settings allow you to apply configuration changes to the current environment from another environment (Example: Apply changes sent from test to production).
- Go to Global Settings > System tab > T2P Import Settings on the target environment (Example: the production instance).
- Click the New T2P Import Setting button (looks like a plus sign).
- Fill in relevant fields and click Save.
- For Public Key click the edit button (looks like a pencil) and paste key generated in the export settings.
- Toggle on Activate when you're ready to begin applying configuration changes made on another SmartSimple environment.
Creating a New Project to Record Changes
- Go to Global Settings > System tab > T2P Projects.
- Click the New Project button (looks like a plus sign)
- Fill in relevant fields and click Save.
- For Assigned Users, select which users will be allowed to add configuration changes to this project.
- When you're ready to begin tracking configuration changes, switch the Status to "In Progress". This makes the project available to be selected from the user’s personal settings.
Viewing the Export History
To view projects that have been exported and their status, follow these steps on the source environment (Example: the testing instance).
- Go to Menu Icon > T2P (located under the “System Process” section) > Export tab
- Click the Export History button located top left (looks like a curving arrow with clock hands inside)
Viewing the Import History
To view projects that have been Imported and their status, follow these steps on the target environment (Example: the production instance):
- Go to Menu Icon > T2P (located under the “System Process” section) > Import tab
- Click the View button (looks like and eye) to see the contents of the package that were imported.
- (Optionally) if desired you may check any row to delete that import log.