Core concepts

Undoing changes

Two ways to undo a configuration change: roll an environment back to an earlier version right now, or revert a change so it's no longer part of your configuration at all.

Mochi Deploy manages your Aprimo configuration: fields, content types, classifications, rules, and settings. Sometimes a change needs undoing: something reached an environment and caused a problem, or a change that's part of your configuration shouldn't be. Mochi gives you two tools for that, and they do different jobs.

Roll back an environment

Rolling back puts the configuration Mochi manages in one environment back to an earlier version. That includes anything changed in the environment directly since, which is usually the reason for rolling back in the first place. Items you don't track are left exactly as they are. It's the quick fix for “something reached this environment and I need it the way it was.” It changes only the items you track. Anything else in that Aprimo instance is left alone. Every environment keeps a version history (the versions it has been brought to), and you pick the one to return to.

Open the environment from the Environments tab.
Open Version history. Each entry is a version this environment has held, newest first, with the current one marked.
Choose an earlier version and select Roll back. Mochi restores the live configuration in that environment to how it was at that version.

How a rollback is gated, and what it doesn't do

Whether a rollback needs approval is set per environment (in Settings, under the environment's menu). By default it happens right away, for putting things right quickly; an environment can instead wait for someone to approve the rollback first, which is useful where Mochi is the only sanctioned way to change that environment. Rolling back a production environment asks you to type its name first, and every rollback is recorded. It runs the same safety checks a delivery does. And it isn't a full restore: it moves only the items you track and keeps no snapshot, working out the earlier version from your change history. The changes you rolled back are still part of your configuration, so they can reach the environment again later; to make the undo permanent, revert those changes too.

Revert a change

Reverting undoes a change in your configuration itself. It creates a new change set that reverses an earlier one, and that new change set moves through your pipeline to your environments like any other change. Use it when a change shouldn't be part of your configuration anymore.

Open the change in the Changes tab. A change can be reverted once it's part of your configuration.
Select Revert. Mochi creates a new change set that undoes it, labelled so you can see what it reverses.
It gets approved like any change. If your workspace asks for approval, the undo waits for it too, and the approvers hear about it. With approvals off it's part of your configuration straight away.
It travels like any change. The reversal reaches your environments the same way the original did.

Once per change

A change can be undone once. If someone got there first, Mochi tells you so instead of making a second reversal, and says whether the undo has already gone through or is still waiting to be approved. If an undo was turned down, the change can be undone again later.

Which one to use

Roll back when you need an environment fixed now. Revert when a change should leave your configuration for good. Often you'll do both: roll an environment back to stop the problem immediately, then revert the change so it doesn't come back the next time that environment is brought up to date.

PreviousHeads-up rules NextBroken references