News from JahnTech View online
JahnTech JahnTech
webMethods Tools & Consulting
Newsletter #3

This is "already" the third newsletter. In hindsight I am really not sure why I hadn't thought about starting it earlier. But hey, isn't it always like that? And sometimes you just need an eye-opener.

In my case this was Udemy with their "interesting" approach to getting consent for training their AI model with people's courses. For me it was yet another case of a large player trying to change the rules after the fact.

I have to thank them (no irony!) for teaching me a valuable lesson in risk management.

But now to the actual content. Here is what I have for you in this issue:

  • webMethods operations on Linux with a powerful shell script
  • My journey with data and backups
  • webMethods CI/CD playground with Docker Compose
  • Humble Bundle: Software Architecture 2024 (O'Reilly)

With that let's jump into the content and I wish you all a great week.

Best wishes,
Christoph

PS: Below is a photo of my very own copy of Hewlett-Packard's "Rule of the Garage", which was handed to me when starting my first job after university.

Computer keyboard
Operations on Linux with a powerful shell script

Back in 2009 I wrote the initial version of this script for a large webMethods customer. It has been made available by Software AG as open source a while ago.

The script offers a convenient and unified way to interact with all supported components of the webMethods Suite. The clever use of aliases allows you to e.g. restart Integration Server with a simple

wmis restart

For Universal Messaging it is, you guessed,

wmum restart

In addition you can perform the following operations:

  • Start (asynchronous, returns immediately)
  • Stop (synchronous, waits for end of shutdown)
  • Restart (stop + start)
  • Kill
  • Get process ID (PID)
  • Check on status (OS-level process running, no functional check)
  • View log files
  • Get log file names
  • Install the script

The GitHub repo is at https://github.com/JahnTech/webmethods-suite-linux-scripts

My journey with data and backups

I started with PCs in 1990 on a 286 with a 42 MB hard disk (Seagate ST251-1), which about one year later had issues with faulty sectors. This was a couple of years before (consumer) hard disks started to internally re-map bad sectors. And it was also the first and last time that I lost data. Ever since, I have been paranoid about backups (and more importantly restores).

I started with simple floppy disks for source code, spreadsheets, etc. and went for a DAT streamer in 1996 (HP C1536). This only lasted 3 years and after that abysmal experience I switched to a QIC streamer (Tandberg SLR-24), which lasted until about 2008. Well, that’s when I took it out of service.  It was in perfect working condition but 12 GB capacity per cartridge started to be an issue. Since then I have used hard disks in various ways, since streamers have become a prohibitive upfront investment for me. I would still prefer streamers, but that is a different story.

All the people I know (incl. at work) initially think of my efforts as overkill. Until they loose 10 years of digital pictures, esp. when their children are involved. That is when they are willing to invest time and money. The same goes for many companies, unfortunately. A friend told me about a malware attack on his employer about a year ago. All of a sudden there was budget for keeping backups longer than just 30 days, a properly segmented network, and other things their IT department had wanted for more than a decade. Everybody (incl. me – see above) has to learn this the hard way, I guess.

A side note on NAS gear that is typically more in the consumer space. In summer of 2020 I was in the process of switching to a new FreeNAS (now TrueNAS) box. There were long deliberations as to whether I should go for Synology instead. The core reason why I stayed with FreeNAS is that it I have flexibility. From a usability and ease-of-use perspective I got the impression that Synology is (far?) superior. But that comes at the price of limitations. A mass market product needs to keep support tickets under control and the only way for that is to constrain people’s options. And I wanted to stay flexible, even if that meant to spend more money (hardware specs are considerably higher than the Synology model in question) and time for setting things up.

Finally, I went for for FreeNAS 11.3 U5 and later upgraded to TrueNAS 12. It has also been upgraded with SSDs for VM storage and a 10 Gbps NIC with SFP+ connectors.

Behind the scenes: CI/CD tooling for Integration Server

As mentioned in the last newsletter, my current focus is on CI/CD with webMethods Integration Server. As part of this I am now working on a tool to set up a complete CI/CD playground/learning environment in a single VM (Debian 11) with Docker Compose.

Learnings so far:

  • An automated setup of Nexus as a Docker registry with a self-signed certificate is not that straightforward. To be fair, I have had the same experience with other registries.
  • I have lost faith that in this live I will still become a fan of certificates and PKI stuff. For my taste things are way too hard.
  • To use the GitLab REST API you need an access token. You can prepare a deep link that makes the creation relatively easy. With that access token in place, the rest of the setup (incl. a GitLab Runner with Docker) is easy to automate.
  • Docker Compose is great for such a use-case.
  • The overall automation with Debian 11 is simple and so far seems to have been a good decision.

This tooling will be a part of my upcoming course on CI/CD for webMethods Integration Server. I will continue to inform you about the progress here.

If you are interested in particular aspects, please let me know.

Humble Bundle: Software Architecture Books 2024

This is an incredible offer, if you are interested (like me) in software architecture. It is definitely one of the best packages I have seen from Humble Bundle so far.

Direct link: https://www.humblebundle.com/books/software-architecture-2024-oreilly-books

My personal favorites from the list:

  • Sam Newman: Building Microservices
  • Gregor Hohpe: The Software Architect Elevator
  • Sam Newman: Monolith to Microservices

The other titles also look very promising and for the price of around EUR/$ 30 it is an absolute bargain in my opinion.

I am not affiliated with the seller in any way and have bought the package with my own money as a regular customer.

Quick links

Here are some curated links that might be interesting for you:

JahnTech, Inhaber Christoph Jahn
Nussbaumallee 61, D-64297 Darmstadt, Germany