Running MSR outside Service Designer

If you want to run the the webMethods Microservices Runtime that comes with Service Designer separately, you can do that. But the start script for Linux and macOS contains an error. It is easy to fix and here are the details.

I love working with webMethods Service Designer. Its ease-of-installation and the fact that you get everything in a nice package make it a no-brainer for me.

The one thing I dislike about it is that you are being pushed to have the MSR running inside Designer. I need to restart Designer every now and then and MSR gets in the way here. But you can also run MSR separately. It comes with the usual scripts.

Unfortunately, there is a bug in server.sh (on Linux and macOS), which makes it impossible to start MSR this way. And since server.sh is used under the covers by startup.sh, the latter is no alternative either. But the issue is easy to fix, so here we go.

You need to correct the path for running the Java binary. So you need to search for the lines below. They are pretty much at the end of the script around line 123 or so.

				
					## .... run Microservices Runtime
${JAVA_RUN} ${JAVA_D64} ${JAVA_OPTS} -DWM_HOME=${WM_HOME} -Dwatt.server.homeDir=${MSR_DIR} -classpath ${CLASSPATH} ${PROXY_MAIN} ${MSR_DIR}/bin/ini.cnf ${PREPENDCLASSES_SWITCH} ${PREPENDCLASSES} ${APPENDCLASSES_SWITCH} ${APPENDCLASSES} ${ENV_CLASSPATH_SWITCH} ${SAVED_CP}: $*

				
			

The problem is with ${JAVA_RUN}. It has been determined as a relative path. Nothing wrong with that in general. But here the current working directory has been changed after that, which obviously breaks things. So you must add a small snippet before ${JAVA_RUN}.

				
					${SCRIPTDIR}/
				
			

Just copy-paste this before ${JAVA_HOME} and you are fine.

Alternatively you can run the following command, which will fix the script automatically. You must be in the same directory as server.sh for it to work.

				
					sed -i bak 's/^${JAVA_RUN} ${JAVA_D64}/${SCRIPTDIR}\/${JAVA_RUN} ${JAVA_D64}/g' server.sh
				
			

I tested it with Server Designer 10.15 and 11.1, so it should work for you as well.

For other versions of Service Designer, you must check whether the script logic has been changed. Do not simply run it.

If you want me to write about other aspects of this topic, please leave a comment or send an email to info@jahntech.com. The same applies if you want to talk how we at JahnTech can help you with your project.

© 2024, 2025 by JahnTech GmbH and/or Christoph Jahn. No unauthorized use or distribution permitted.

Share:

Facebook
Twitter
Pinterest
LinkedIn

Leave a Reply

Your email address will not be published. Required fields are marked *

On Key

Related Posts

Running MSR outside Service Designer

If you want to run the the webMethods Microservices Runtime that comes with Service Designer separately, you can do that. But the start script for Linux and macOS contains an error. It is easy to fix and here are the details.

Tips for job seekers

The IT job market is not a cozy place right now. To help people find their new job, I put together this list of recommendations. While originally targeted for webMethods, much of it is also applicable for other roles.

webMethods and AS/400

The IBM AS/400 midrange system is a fascinating piece of technology. But it does quite a few things differently than PC-based servers. So be prepared to run into a few challenges when working with it for the first time. Here is my story from a really interesting project.

How to give a presentation

Giving a presentation is vital not only in business but many situations in life. In essence it is about conveying some content in an effective way. Here are a few basic points that will help you.