Need to upgrade from 8.2.2 to 9.12


We are planning to upgrade from webMethods 8.2.2 to 9.12.
I’m new to this upgrade concept and would need help in this.
I would like to know, the procedure/process to upgrade and whom should we contact for software purchase etc details.
we have 1 IS and JDBC Adapter. We have windows 7 and RHEL Linux 7.2 OS on which new wM 9.12 should be installed.

Is there any pre-requisites before going for upgrade.

Please advise on this.


Hi Naramsimha,

please check the webinar section of the software ag pages for further informations.

Additionally download and check the upgrade guides for all intermediate versions.
For the requirements check the appropriate requirements guide available from empower or community documentation section.

Most likely this will be a 2-step upgrade as there is no direct upgrade path from 8.2 to 9.12.

Youn will have to contact your sales rep to receive the new license files.

Please check if Broker->UM migration is neccessary and if an upgrade of JDBC Adapter is neccessary.
There are currently 3 versions of JDBC Adapter: 6.5, 9.0 and 9.10

You can ask SAG for Migration support via Consulting.


1 Like

hi Naramsimha, to elaborate on Holger’s reply concerning relevant documentation:

A good document to look at when figuring out your upgrade path(s) is Supported Upgrade Paths for Software AG Products. You can find this in the doc area of Empower and in the upgrade area in TECHCommunity. As Holger says, you will most likely have to make two hops to get from 8.2.2 to 9.12.

After you determine your two paths (for example, 8.2.2 to 9.5, and then 9.5 to 9.12), you’ll need the upgrade paths for each of those target releases (for example, the 9.5 upgrade guide and the 9.12 upgrade guide). You’ll also need the readmes for your products for ALL intermediate releases (that is, 9.0, 9.5 . . . 9.12) so you will know the changes that have occurred in each release, and will be able to update your own code accordingly. The upgrade guides cover the readme requirement and other important requirements.

Good luck with your upgrade,


1 Like

It seems to be your upgrading webMethods and also migrating windows to Linux. Please follow the correct path what Holger/Marianne has suggested and also you have to check all the below points…

  • Capacity planning
  • Validate whether the latest webMethods version is supporting your DB and OS, plan accordingly
  • if you are using any windows batch scripts, Need to convert into Linux (.sh)
  • are you planning to add any new webMethods Components (like TN,MWS, UM ,UM/IS Clustering), if yes, then redesign the wM architecture


Hi All,

Currenlty we are using webMethods 8.2.2 and planning to upgrade to 9.8 or 9.12.

Are there any technical challenges while upgrading?
Do we need to make any codes changes?
Is some one please share tips and tricks which can help in upgrade?


Please check the previous posts in this thread from Marianne and me.

Documentation is available via Empower or from the community.

You will have to do 2 migrations: 8.2 to 9.8 and 9.8 to 9.12.
There is no direct upgrade path from 8.2 to 9.9 and newer.

Please note that the last Broker version is 9.6 which can be used even with 9.12.
Migrations will always be side-by-side.

As long as you do not plan a different OS and/or database vendor than before there should not be any technical challenges except for the migration from Broker to Universal Messaging.

Remember to plan the following:

  • Apply latest Fixes to your 8.2 environments
  • Test your application against this version
  • Backup 8.2 Installations and corresponding database schemas.
  • Prepare new installations for 9.x and apply latest fixes for it.
  • Migrate Database schemas to recent 9.x versions.
  • Migrate source code using the provided migration scripts (i.e. JDBC Adapter has its own migration script)
  • Check your source code for the usage of deprecated/chaned services and modify it. (refer to the Readmes and Built-In Services guides for details)
  • After this has been done, Test your application again to check if it is still working.


One small change to Holger’s last reply - you can do a type of overinstall if you are using Command Central. From the CC upgrade doc (which I write):

Same Installation Directory, Hosts, and Ports; Live Database
Command Central renames the old product installation directory, then uses the old
directory name for the new product installation.
Benefits: Simple; similar to overinstall in that all paths, hosts, and ports remain the same.
Can fully automate using custom composite templates.
Cautions: Risky; rollback is complicated. Significant downtime. Must back up live
databases; use of cloned databases is not supported. Requires double disk space because
old installation is still present. Requires extensive automated testing before production
environments can be migrated.

And of course you can also do side-by-side upgrade from CC.

If you do end up using CC for upgrade, make sure to get the CC doc and follow the instructions in that guide along with the Upgrading SAG Products guide.

1 Like


Do we need to ask SAG for two licenses for interim and target versions or they provide a single license for complete migration.

Need to know as we arent directly interacting with SAG support but its via a mediator from client.
We need to keep the mediator well informed with the relevant technical questions and the related requirements while he does the interaction.


Hi Mayank,

please check the supported upgrade path documentation.

At least the license files for 9.5 seems to be working with 9.12, but I am not sure if this is true for the other way round.


Hi Holger,

Thanks for the info, will check the upgrade guide for the exact details.


Hi Holger,

We have got confirmation from SAG that 9.8 license would work for 9.12 too.