webMethods Integration Server Administration

wmisa is a command line client for administering webMethods Integration Server. Use it to perform operations on administrative resources and execute administrative actions such as restarting the server, installing a package or enabling a cache manager. wmisa will work with Integration Server version 10.7 or later.

Installation

wmisa requires Node.js version 10.15 or later.

npm install -g @softwareag/wmisa

Usage

There are three categories of commands. | Category |Description | |:--|:--| |Server Commands | Perform administrative operations and actions. | |Help Commands | Discover types of resources, the operations they support and their inputs and outputs. | |Default Commands | View and modify default values for command line options. |

Server Commands

Server commands are sent to the Integration Server identified by the --host command line option. There are two types of server commands: CRUD commands and action commands.

CRUD commands are used to view and modify the configuration of an Integration Server. Not all types of resources support all CRUD operations. For example, the server resource can be used to read high-level information about the server. It cannot be used to create a new server or delete and existing one.

CRUD Command Formats and Examples

wmisa read <resource-type>

Lists all instances of a type of resource. When combined with the --expand option, the details of each resource is displayed. Not all resource types support this operation.   Example: List all keystore aliases. wmisa read keystore   Example: List details for all keystore aliases. wmisa read keystore --expand

wmisa read <resource-type> <resource-id>

Displays a resource.   Example: Displays the remote server wmrestoneng01. wmisa read remoteserver vmrestoneng01

wmisa create <resource-type>

Creates a new instance of a resource. Requires a payload defining the state of the resource. Put the payload a file and use the --file option.   Example: Create a cache manager named Purchasing from a file.     wmisa create cachemanager Purchasing --file ./newcachemgr.json   Example: Create a cache named Orders in the Purchasing cache manager from a file.     wmisa create cachemanager Purchasing cache Orders --file ./newcache.json

wmisa update <resource-type> <resource-id>

Updates an existing resource. The payload of changes to make to the resource must be supplied to this command. You can put the payload in a file and use the --file option.   Example: Update the user btaylor's password. wmisa update user btaylor --file "temp_password.json"

wmisa delete <resource-type> <resource-id>

Deletes a resource.   Example: Delete the trusted JWT issuer IdProvider01. wmisa delete jwt issuer IdProvider01

Action commands perform administrative actions on server resources. Each type of resource has its own set of actions. Use the help command to discover them. Most action commands include name=value sub-commands. In DOS, these must be surrounded by double quotes.

Action Command Format and Examples

wmisa <admin-action> [sub-command] <resource-type> <resource-id>

Performs the indicated administrative action on a resource.   Example: Shut down a running Integration Server. wmisa stop server   Example: Restarts an Integration Server immediately, even if there are active sessions. wmisa restart server "force=true"   Example: Install the TestPkg package from Integration Server's replicate/inbound directory but don't activate it.     wmisa install package "filename=TestPkg.zip" "activate=false"

Help Commands

Use help commands to discover the types of resources available on an Integration Server, the operations each type of resource supports and the inputs and outputs of each operation.

wmisa help

Lists all types of resources on the Integration Server.

wmisa help <resource-type>

Lists all the operations that can be performed on the indicated resource.   Example: Lists all operations that can be performed on a cache manager. wmisa help cachemanager

wmisa help <verb> <resource-type> {<resource-id>}

Lists the inputs and outputs of an operation.   Example: displays inputs to and outputs from a cache manager operation.
    wmisa help read cachemanager {cacheManagerName}

You can also get help for the wmisa command line tool.

wmisa --help

Displays basic usage information.

wmisa info

Displays extended usage information.

Default Commands

wmisa has several command line options. You can save default values for the options so they do not have to be entered on the command line every time. Any option that is supplied on the command line will override its corresponding saved default. The default value is used for any option that is not supplied on the command line.

When referring to an option with a default command, use the option's full name, without the dashes. For example, use 'port', not '--port' or '-p'.

wmisa comes with the following out-of-the-box defaults

host: localhost:5555
basicauth: Administrator:manage

`wmisa default`

Lists the defaults for all command line options. Options that do not have a default are not listed.

`wmisa default <option>`

Displays the default value for a command line option.   Example: Display the current default value for the --host option. wmisa default host

wmisa default <option> <default-value>

Sets a default value for a command line option.   Example: Change the default for the --host option to is-east001:5589. wmisa default host is-east001:5589

wmisa default reset <option>

Resets the default value for a command line option to the factory default.   Example: Change the default for the --host option to the factory setting, which is localhost:5555.     wmisa default reset host

wmisa default reset

Resets the default values for all command line options to the factory defaults.

Options

The function of wmisa is controlled by command-line options. You can view the options with the wmisa --help command. | Option | Description | |:--|:--| |-v, --version | display the version number | |-H, --host <host:port> | host and port of the Integration Server instance to connect to (default: localhost:5555)| |-s, --secure | use HTTPS to connect to Integration Server (default: false) | |-b, --basicauth <user:pass> | username:password to use when connecting to Integration Server (default: Administrator:manage)| |-f, --file <file-name> | name of file that holds the request payload in JSON format | |-x, --expand | expand lists of resource names to full resources (default: false) | |-c, --certificate <cert-file> | certificate in PEM format to use for HTTPS ports that accept client certificates | |-k, --key <key-file> | private key in PEM format to use for HTTPS ports that accept client certificates | |-a, --authority <auth-file> | certificate chain in PEM format to use to verify the server's certificate on HTTPS ports; if not specified, server's certificate is not validated | |-h, --help | display basic usage information |

Default values for these options can be changed with the wmisa default command, described above. Saved defaults can be overridden by specifying the option on the command line. For all options that are not specified on the command line, the default is used.

License of this package

Apache-2.0

Copyrights and Licenses of dependencies

See file in package Third-Party-Terms-of-Dependencies.pdf