General commands

connect

This command connects to a specific runtime from a command console, either from Semarchy xDI Designer or from the startcommand script.

connect [to <host>] [port <port>] [user <user>] [password <password>] [silent]
Option Mandatory Description

to <host>

No

Hostname or IP address of the host. The protocol must be part in the string, such as https://example.com. If not set, defaults to localhost.

When connecting to a local runtime that listens to local connections only , use localhost as hostname.

port <port>

No

Network port the runtime is listening on.

user <user>

No

Runtime user to connect with.

password <password>

No

Password of the runtime user. The password can be in plain text, or in its encrypted form.

silent

No

Prevents text feedback from being written to the standard output.

encrypt

This command encrypts a password, and returns the encrypted string.

You can use the encrypted string in various places, such as properties that ask for an encrypted password, or in configuration files.

encrypt <password> [cipheringKey <encryption_key>]
Option Mandatory Description

<password>

Yes

Password to encrypt.

cipheringKey <encryption_key>

No

Specifies a custom encryption key from a predefined keystore to use for encryption. When this option is not set, uses default xDI encryption settings.

execute commands in file

This command executes one or more commands saved in a text file.

execute commands in file <file>
Option Mandatory Description

file <file>

Yes

Path to a file containing a list of runtime commands, with one command per line.

Example 1. Command file example
execute delivery myDelivery synch
execute delivery myDelivery2
stop runtime

exit

This command ends the command line session without stopping the runtime.

exit

help

This command shows the list of available commands, or the description for a specific command.

help [on <commandName>]

Option

Mandatory

Description

on <commandName >

No

Shows help information for a specific command.

kill runtime

This command stops the connected runtime without waiting for active sessions to complete.

kill runtime

reload-modules

This command reloads the modules in the connected runtime.

reload-modules
You can configure automated modules reload using the moduleRefreshMode runtime parameter.

runtime version

This command displays the version of the current runtime.

runtime version

stop runtime

This command stops the connected runtime. All services are stopped, and all running sessions are killed.

stop runtime [wait sessions]
Option Mandatory Description

wait sessions

No

When specified, the runtime waits for all the running sessions to complete before stopping. During that period, the runtime will not start additional sessions.

versions

This command displays the version of installed components for the active runtime.

versions