Runtime Manager Command-Line Interface
Anypoint Platform provides a scripting and command-line tool for Runtime Manager. The command-line interface (CLI) supports both the interactive shell and standard CLI modes and works with:
Locally Deployed Applications Managed by Runtime Manager
For the Anypoint Platform CLI to recognize your target servers, each server must be manually registered with the platform.
| Command | Description |
|---|---|
Downloads a standalone application artifact binary |
|
Deploys or redeploys an application to an on-premises server, server group, or cluster |
|
Shows a raw standalone application JSON response |
|
Changes a standalone application artifact |
|
Starts a standalone application |
|
Deletes a standalone application |
|
Shows detailed information for a standalone application |
|
Lists all standalone applications in the environment |
|
Restarts a standalone application |
|
Stops a standalone application |
|
Copies a standalone application |
runtime-mgr standalone-application artifact
> runtime-mgr standalone-application artifact [options] <identifier> <directory>
This command downloads the application artifact of the identifier application, to the directory passed in directory.
The identifier parameter can be either an application ID or name.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr standalone-application deploy
> runtime-mgr standalone-application deploy [options] <targetIdentifier> <name> <zipfile>
This command deploys or redeploys the application passed as a ZIP file in the path zipfile to the on-premises target passed in targetIdentifier.
The targetIdentifier parameter can be either a target ID or name.
A target can be either a server, server group, or cluster.
This command accepts only the default options: --help, -f/--fields and -o/--output.
To redeploy an app and set a logging level or turn on Insight event tracking, see runtime-mgr standalone-application modify.
runtime-mgr standalone-application describe-json
> runtime-mgr standalone-application describe-json [options] <identifier>
This command describes the standalone (on-premises) application passed in identifier as a raw JSON response.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr standalone-application modify
> runtime-mgr standalone-application modify [options] <identifier> <zipfile>
This command modifies the standalone (on-premises) application passed in identifier with the ZIP file application passed in zipfile as a path.
The identifier parameter specifies the application identifier.
To retrieve the identifier, see
runtime-mgr standalone-application list.
In addition to the default --help, -f/--fields and -o/--output options, this command also takes:
| Value | Description |
|---|---|
|
Stores message metadata of every Mule transaction. |
|
Sets the logging level and scope pair:
To set multiple logging levels, provide multiple |
runtime-mgr standalone-application start
> runtime-mgr standalone-application start [options] <identifier>
This command starts the standalone (on-premises) application passed in identifier.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr standalone-application delete
> runtime-mgr standalone-application delete [options] <identifier>
This command deletes the standalone (on-premises) application passed in identifier.
This command accepts only the default options: --help, -f/--fields and -o/--output.
| This command does not prompt twice before deleting. If you send a delete instruction, it does not ask for confirmation. |
runtime-mgr standalone-application describe
> runtime-mgr standalone-application describe [options] <identifier>
This command shows detailed information, such as status, creation date, and last update, for the standalone (on-premises) application passed in identifier.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr standalone-application list
> runtime-mgr standalone-application list [options]
This command lists all standalone (on-premises) applications.
Besides the default --help, -f/--fields and -o/--output options, this command also takes:
| Value | Description |
|---|---|
|
Specifies the number of results to retrieve |
|
Offsets the number of applications passed |
runtime-mgr standalone-application restart
> runtime-mgr standalone-application restart [options] <identifier>
This command restarts the standalone (on-premises) application passed in identifier.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr standalone-application stop
> runtime-mgr standalone-application stop [options] <identifier>
This command stops the standalone (on-premises) application passed in identifier.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr standalone-application copy
> runtime-mgr standalone-application copy [options] <source> <target> <targetIdentifier>
This command copies the standalone (on-premises) application passed in source to the target passed in target and the server, server group or cluster ID or Name passed in targetIdentifier.
Both arguments source and destination are represented using the format: <organizationName>:<environmentName>/<appName>, for example:
> runtime-mgr standalone-application copy Services:QA/application-1 Development:QA/application-2 123456
Copies the application named application-1 from the QA environment of the Services organization to the QA environment of the Development organization in the server ID 123456.
If the Anypoint Platform CLI is using the QA environment in the Services organization, the command can simply take the application name as a source:
> runtime-mgr standalone-application copy application-1 Development/QA/application-2 123456
Running this command requires for your user to have read/write access to the /tmp directory of the OS where the CLI is installed.
|
This command accepts only the default options: --help, -f/--fields and -o/--output.
Alerts for Locally Deployed Applications Managed by Runtime Manager
| Command | Description |
|---|---|
Describes an alert |
|
Creates new alert for standalone runtime |
|
Modifies alert for standalone runtime |
|
Lists all alerts for standalone runtimes in the environment |
runtime-mgr standalone-alert describe
> runtime-mgr standalone-alert describe [options] <alertId>
This command describes the alert passed in alertId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr standalone-alert create
> runtime-mgr standalone-alert create [options] <name>
This command creates a new alert for a standalone runtime with the ID passed in name.
The alert name is limited to 256 characters.
Besides the default --help, -f/--fields and -o/--output options, this command also takes:
| Value | Description |
|---|---|
|
Alert severity |
|
Alert resource type |
|
Alert resource ID. Can be used multiple types. If not provided alert triggers for all resources. Depending on |
|
Alert trigger condition |
|
Condition duration in minutes |
|
Condition threshold number |
|
Condition operator explaining values relation to threshold. |
|
Alert notification email subject |
|
Alert notification email body |
|
Username to send alert notification to. Can be used multiple times to specify up to 20 platform user IDs. |
|
Email address to send alert notification to. Can be used multiple times to specify up to 20 email addresses. |
runtime-mgr standalone-alert modify
> runtime-mgr standalone-alert modify [options] <alertId>
This command modifies the alert passed in alertId.
Besides the default --help, -f/--fields and -o/--output options, this command also takes:
| Value | Description |
|---|---|
|
Alert name |
|
Alert severity |
|
Alert resource type |
|
Alert resource ID. Can be used multiple types. If not provided alert triggers for all resources. Depending on |
|
Alert trigger condition |
|
Condition duration in minutes |
|
Condition threshold number |
|
Condition operator explaining values relation to threshold. |
|
Alert notification email subject |
|
Alert notification email body |
|
Username to send alert notification to. Can be used multiple times to specify up to 20 platform user IDs. |
|
Email address to send alert notification to. Can be used multiple times to specify up to 20 email addresses. |
Local Servers
| Command | Description |
|---|---|
Describes server |
|
Modifies server |
|
Gets server registration token. This token needs to be used to register a new server |
|
Deletes server |
|
Changes an standalone application artifact |
runtime-mgr server describe
> runtime-mgr server describe [options] <serverId>
This command describes the server passed in serverId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr server modify
> runtime-mgr server modify [options] <serverId>
This command modifies the server passed in serverId.
In order to update the id for the cluster, you need to pass the --name option.
Besides the --name option, this command also takes the default --help, -f/--fields and -o/--output options.
runtime-mgr server token
> runtime-mgr server token [options]
This command gets server registration token. This token needs to be used to register a new server.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr server delete
> runtime-mgr server delete [options] <serverId>
This command deletes the server passed in serverId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
| This command does not prompt twice before deleting. If you send a delete instruction, it does not ask for confirmation. |
Local Server Groups
| Command | Description |
|---|---|
Creates server group from servers |
|
Describes server group |
|
Modifies server group |
|
Adds server to a server group |
|
Deletes server group |
|
Lists all server groups in the environment |
|
Removes server from a server group |
runtime-mgr serverGroup create
> runtime-mgr serverGroup create [options] <name> [serverIds...]
This command creates a server group with the name passed in name using the server Id(s) passed as argument(s) thereafter.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr serverGroup describe
> runtime-mgr serverGroup describe [options] <serverGroupId>
This command describes the server group passed in serverGroupId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr serverGroup modify
> runtime-mgr serverGroup modify [options] <serverGroupId>
This command modifies the server group passed in serverGroupId.
In order to update the id for the cluster, you need to pass the --name option.
Besides the --name option, this command also takes the default --help, -f/--fields and -o/--output options.
runtime-mgr serverGroup add server
> runtime-mgr serverGroup add server [options] <serverGroupId> <serverId>
This command adds the server passed in serverId to the server group passed in serverGroupId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr serverGroup delete
> runtime-mgr serverGroup delete [options] <serverGroupId>
This command deletes the server groups passed in serverGroupId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
| This command does not prompt twice before deleting. If you send a delete instruction, it does not ask for confirmation. |
Local Cluster Servers
| Command | Description |
|---|---|
Adds server to cluster |
|
Deletes cluster |
|
Lists all clusters in the environment |
|
Removes server from a cluster |
|
Creates new cluster |
|
Describes server cluster |
|
Modifies cluster |
runtime-mgr cluster add server
> runtime-mgr cluster add server [options] <clusterId> <serverId>
This command adds the cluster in clusterId to the server passed in serverId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr cluster delete
> runtime-mgr cluster delete [options] <clusterId>
This command deletes the cluster passed in clusterId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
| This command does not prompt twice before deleting. If you send a delete instruction, it does not ask for confirmation. |
runtime-mgr cluster list
> runtime-mgr cluster list [options]
This command lists all clusters in the environment.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr cluster remove server
> runtime-mgr cluster remove server [options] <clusterId> <serverId>
This command removes the server passed in serverId from the cluster passed in clusterId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr cluster create
> runtime-mgr cluster create [options] <name>
This command creates a cluster using the id passed in name.
Besides the default --help, -f/--fields and -o/--output options, this command also takes:
| Value | Description |
|---|---|
|
Whether cluster should be multicast |
|
Pair of server ID and IP address. Latter is optional for multicast cluster. Provide multiple values to add multiple servers |
runtime-mgr cluster describe
> runtime-mgr cluster describe [options] <clusterId>
This command describes the cluster passed in clusterId.
This command accepts only the default options: --help, -f/--fields and -o/--output.
runtime-mgr cluster modify
> runtime-mgr cluster modify [options] <clusterId>
This command modifies the cluster passed in clusterId.
In order to update the id for the cluster, you need to pass the --name option.
Besides the --name option, this command also takes the default --help, -f/--fields and -o/--output options.
Runtime Fabric Instances
| Command | Description |
|---|---|
Lists available Runtime Fabric instances |
runtime-mgr rtf list
> runtime-mgr rtf list [options]
This command lists available Runtime Fabric instances.
This command accepts only the default options: --help, -f/--fields and -o/--output.
For information about managing your Runtime Fabric instances using the command line, see Supported rtfctl Commands.