Administer Integration Server from the command line
Tags: integration, javascript, node, tutorial
Published: 2021-10-27 11:48:12

---
title: Administer Integration Server from the command line
published: true
date: 2021-10-14 13:04:28 UTC
tags: #integration, #javascript, #node, #tutorial
canonical_url: https://tech.forums.softwareag.com/t/administer-integration-server-from-the-command-line/245032
---

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](https://www.npmjs.com/package/@softwareag/wmisa).

To get started

1. Install node.js from [https://nodejs.org/](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](https://www.youtube.com/playlist?list=PL3HwmrSYjxiMn6mUciPZ4Q8r65xYNnnX0) explaining how to use the tool:

- [PART 1](https://www.youtube.com/watch?v=_NEnVbsx8vY&list=PL3HwmrSYjxiMn6mUciPZ4Q8r65xYNnnX0&index=1) - Installation and getting help
- [PART 2](https://www.youtube.com/watch?v=l9J0i-W7zd4&list=PL3HwmrSYjxiMn6mUciPZ4Q8r65xYNnnX0&index=2) - Viewing administrative resources
- [PART 3](https://www.youtube.com/watch?v=pItvSUV1adw&list=PL3HwmrSYjxiMn6mUciPZ4Q8r65xYNnnX0&index=3) - Modifying administrative resources
- [PART 4](https://www.youtube.com/watch?v=qWNyouqOsRs&list=PL3HwmrSYjxiMn6mUciPZ4Q8r65xYNnnX0&index=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](http://vluxvm001.fr.mdd.org:9001) using the account TonyAdmin.

Cheers,  
Michael

[Read full topic](https://tech.forums.softwareag.com/t/administer-integration-server-from-the-command-line/245032)