Unable to make any change to the process due to step name 'contains invalid characters'

Recently upgraded Octopus from 2.5.x to

Before the upgrade, I was able to create multiple steps with name:

“Replace #{DMDSWebsiteName} to be #{LLNW.WebCdn.Host} in templateEngine2.Config File - plugins (imagePath only).”

The Octopus server was upgraded fine.

Now it looks like I am unable to make any change to the process. I cannot add a step, update a step, remove a step…it’s stuck. See the attached screenshot.

Any help is greatly appreciated.

Hi Tiger,

Thanks for getting in touch! I am sorry to say, that in a version of 2.5 our validation was broken. It allowed you to create steps with such names when it shouldn’t have.
You will have to rename those steps to be valid.

Sorry for the crappy news.

Hi Vanessa,

There is no way to rename those steps one at a time, or all at once. There are more than 1 step names containing invalid characters. I want to rename the step name, but it doesn’t allow me because it always complains about other steps having invalid characters in the step names. It’s a “chicken-and-egg” problem!

Please help. This is completely blocking our deployment process since some change needs to be made ASAP.



Hi Tiger,

Your options will be to change the data directly in Raven, or revert back to 2.5.7 or lower to update the data.
For the later you can download 2.5.7 here: http://octopusdeploy.com/downloads/2.5.7
Otherwise if you open your Octopus Manager and select ‘Browse RavenDB’ you need to find DeploymentProcess under Documents
You will need to identify which projects have this issue and double click on those records and update the json data that you see.

If you don’t feel comfortable doing this, you can schedule a call and we can talk you through it. https://octopusdeploy.acuityscheduling.com/schedule.php