Administer Integration Server from the command line

This post introduces a command-line utility for administering webMethods Integration Server. It’s not an official Software AG product and is not supported, but you may find it useful. The tool is written in node.js and can be viewed at https://www.npmjs.com/package/@softwareag/wmisa.

To get started

1. Install node.js from https://nodejs.org/
2. Install the tool with npm i @softwareag/wmisa
3. Explore

        wmisa -h view usage information
        wmisa info view tool help
        wmisa help view all the admin resources on the server
        wmisa help resource-type view all the operations for a resource
        wmisa help operation view the inputs and outputs for a resource operation

There is a series of short Youtube videos explaining how to use the tool:

• PART 1 - Installation and getting help
• PART 2 - Viewing administrative resources
• PART 3 - Modifying administrative resources
• PART 4 - Command-line options and setting defaults

The tool is wmisa , for webMethods Integration Server administration. It talks to IS’s Administrative API. Pretty much any operation you can do with the API can be executed from the command-line tool, with just a few exceptions.

This tool was a bit of a side project for me; a chance to get some exposure to node.js and make something useful for the community. It’s a bit rough around the edges. Unfortunately we are not able to support it at this time. We intend to put it on GitHub and let others improve it. That said, I think it will be useful in a scripting/devops environment. Here are a few of the many things you can do with this utility.

wmisa read keystore

Get a list of the server’s keystore aliases.

wmisa start cachemanager WarehouseStore

Start the cache manager named WarehouseStore.

wmisa create user --file newuser.json

Create a new user account. The file newuser.json contains the payload:

{
      "username": "tomasso",
      "groups": ["IT_Managers", "IT_Rome", "Everybody"],
      "enabled": true,
      "password": "ChangeThis",
      "allowDigestAuth": false
}

wmisa --host vmcambit01:5543 --secure update port https InternalAdmin --file portupdate.json

Update an HTTPS port with the alias InternalAdmin on vmcambit01:5543. Use TLS. The portupdate.json file contains the payload

{
     "keepAliveTimeout": 20000,
     "backlog": 300
}

wmisa --host vluxvm001.fr.mdd.org:9001 --basicauth TonyAdmin:MyS3cr3T! quiesce server

Quiesce the server at vluxvm001.fr.mdd.org:9001 using the account TonyAdmin.

Cheers,

Michael

Read full topic