Universal Messaging 10.5 | Administration Guide | Command Line Administration Tools | Syntax reference for command line tools | Syntax: Interface Tools
 
Syntax: Interface Tools
AddHTTPInterface

Tool name:
AddHTTPInterface

Description:
Adds a HTTP interface on the specified adapter and port,
on the specified realm.

Usage:
runUMTool AddHTTPInterface -rname=<rname> -adapter=<adapter> -port=<port>
[optional_args]

Examples:
AddHTTPInterface -rname=nsp://localhost:8080 -adapter=0.0.0.0 -port=9090
-usewebsockets=true

Required arguments:

rname :
URL of the realm to which the realm node, on which the interface
will be created, is connected.

adapter :
Adapter (network card) to which interface will bind.

port : Port on which the interface will listen.

Optional Parameters:

usehttp1.1 :
Whether to use HTTP1.1.

usewebsockets :
Whether WebSockets are used.

ajaxactivedelay :
Time to wait (for additional events) before delivering to
Long Poll style subscribers.

ajaxidledelay :
Time to wait before returning from a Long Poll call if no events
have been received.

isnativecomet :
Whether JavaScript is enabled on the interface.

allowedorigins :
Set the Allowed Origins for CORS as a comma-separated list of origins
(use '*' to allow all), e.g. origin1,origin2,origin3

crossorigincredentials :
Whether to allow credentials header to be sent with CORS requests.

enablegzip :
Whether or not GZIP compression is enabled for javascript Long Poll
connections.

minimumbytes :
Set the minimum number of bytes in a packet before GZIP
is enabled (default 1000).

autostart :
Whether this interface will automatically be started when
the realm server starts.

advertise :
Set the current advertise status for this interface.

allowinterrealm :
Whether this interface is allowed to be used in
inter realm/cluster communication.

allowclientconnections :
Whether this interface can accept client connections or not.

allownio :
Whether NIO is enabled on the interface.

authtimeout :
Set the number of milliseconds that the remote client
has to authenticate with the server.

backlog :
Set the number of connections to queue before the Operating System
will send rejects to the remote client.

threads :
Set the thread pool size handling the client connections.

selectthreads :
Set the number of select threads used by NIO.

adapteralias :
Set the interface's alias.

receivebuffersize :
Set the socket buffer size in bytes used by this
interface when receiving data.

sendbuffersize :
Set the socket buffer size in bytes used by this
interface when sending data.



username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
AddHTTPSInterface

Tool name:
AddHTTPSInterface

Description:
Adds a HTTPS interface on the specified adapter and port,
on the specified server.

Usage:
runUMTool AddHTTPSInterface -rname=<rname> -adapter=<adapter> -port=<port>
[optional_args]

Examples:
AddHTTPSInterface -rname=nsp://localhost:8080 -adapter=0.0.0.0 -port=9090
-alias=myAlias

Required arguments:

rname :
URL of the realm to which the realm node, on which the interface
will be created, is connected.

adapter :
Adapter (network card) to which interface will bind.

port :
Port on which the interface will listen.

Optional Parameters:

alias :
Set the certificate name/alias that this interface will use to
select its certificate from a keystore with multiple entries.

keystore :
Set the keystore file that this interface uses to load the certificate.

kspassword :
Set the keystore password that this interface will use to
access the keystore file specified.

truststore :
Set the truststore file against which this interface will
validate the client certificate.

tspassword :
Sets the truststore password that the server uses to access the
trust store.

privatepassword :
Private key password; used so that the key can be loaded
from the key store.

ciphers :
Names of the ciphers enabled for use by this interface, as a
comma-separated list of ciphers, e.g. cipher1,cipher2,cipher3.

rndalg :
Set the SecureRandom algorithm to use for this interface.

rndprov :
Set the SecureRandom provider to use for this interface.

clientcertrequired :
Whether this interface requires SSL client authentication.

crl :
Set the certificate revocation list file name that the interface
should use to check incoming SSL connections.

crlclassname :
Name of the class used to validate a client connection.

provider :
Name of the JSSE provider to use for the interface.

usehttp1.1 :
Whether to use HTTP1.1.

usewebsockets :
Whether WebSockets are used.

ajaxactivedelay :
Time to wait (for additional events) before delivering
to Long Poll style subscribers.

ajaxidledelay :
Time to wait before returning from a Long Poll call if
no events have been received.

isnativecomet :
Whether JavaScript is enabled on the interface.

allowedorigins :
Set the Allowed Origins for CORS as a comma-separated list of origins
(use '*' to allow all), e.g. origin1,origin2,origin3.

crossorigincredentials :
Whether to allow credentials header to be sent with CORS requests.

enablegzip :
Whether or not GZIP compression is enabled for javascript
Long Poll connections.

minimumbytes :
Set the minimum number of bytes in a packet before GZIP
is enabled (default 1000).

autostart :
Whether this interface will automatically be started when
the realm server starts.

advertise :
Set the current advertise status for this interface.

allowinterrealm :
Whether this interface is allowed to be used in
inter realm/cluster communication.

allowclientconnections :
Whether this interface can accept client connections.

allownio :
Whether NIO is enabled on the interface.

authtimeout :
Set the number of milliseconds that the remote client
has to authenticate with the server.

backlog :
Set the number of connections to queue before the Operating System
will send rejects to the remote client.

threads :
Set the thread pool size handling the client connections.

selectthreads :
Set the number of select threads used by NIO.

adapteralias :
Set the interface's alias.

receivebuffersize :
Set the socket buffer size in bytes used by this
interface when receiving data.

sendbuffersize :
Set the socket buffer size in bytes used by this interface
when sending data.

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
AddSHMInterface

Tool name:
AddSHMInterface

Description:
Adds a shared memory interface with the specified path, buffer size and
timeout, on the specified server.

Usage:
runUMTool AddSHMInterface -rname=<rname> -path=<path> [optional_args]

Examples:
AddSHMInterface -rname=nsp://localhost:11000 -path=/dev/shm -buffer=1024
-timeout=2000 -autostart=true

Required arguments:

rname :
URL of the realm to which the realm node, on which the interface
will be created, is connected.

path :
The path where the shared memory files will be stored.

Optional Parameters:

buffer :
The size of the shared memory buffer which will be used. If not
provided a default value of 1024000 will be used.

timeout :
The timeout value that will be used for read / write. If not
provided a default value of 20000 will be used.

autostart :
Whether this interface will be automatically started when
the Realm Server starts. Default is set to true.

interrealmallow :
Sets whether this interface is allowed to be used
in inter realm / cluster communication. Default is set to false.

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
AddSSLInterface

Tool name:
AddSSLInterface

Description:
Adds a SSL interface on the specified adapter and port,
on the specified server.

Usage:
runUMTool AddSSLInterface -rname=<rname> -adapter=<adapter> -port=<port>
[optional_args]

Examples:
AddSSLInterface -rname=nsp://localhost:8080 -adapter=0.0.0.0 -port=9090
-alias=myAlias

Required arguments:

rname :
URL of the realm to which the realm node, on which the interface
will be created, is connected.

adapter :
Adapter (network card) to which interface will bind.

port :
Port on which the interface will listen.

Optional Parameters:

alias :
Set the certificate name/alias that this interface will use to
select its certificate from a keystore with multiple entries.

keystore :
Set the keystore file that this interface uses to load the
certificate.

kspassword :
Set the keystore password that this interface will use to
access the keystore file specified.

truststore :
Set the truststore file against which this interface will
validate the client certificate.

tspassword :
Sets the truststore password that the server uses to access
the trust store.

privatepassword :
Private key password; used so that the key can be loaded
from the key store.

ciphers :
Names of the ciphers enabled for use by this interface,
as a comma-separated list of ciphers, e.g. cipher1,cipher2,cipher3.

rndalg :
Set the SecureRandom algorithm to use for this interface.

rndprov :
Set the SecureRandom provider to use for this interface.

clientcertrequired :
Whether this interface requires SSL client authentication.

crl :
Set the certificate revocation list file name that the interface
should use to check incoming SSL connections.

crlclassname :
Name of the class used to validate a client connection.

provider :
Name of the JSSE provider to use for the interface.

autostart :
Whether this interface will automatically be started when the
realm server starts.

advertise :
Set the current advertise status for this interface.

allowinterrealm :
Whether this interface is allowed to be used in
inter realm/cluster communication.

allowclientconnections :
Whether this interface can accept client connections.

allownio :
Whether NIO is enabled on the interface.

authtimeout :
Set the number of milliseconds that the remote client has to
authenticate with the server.

backlog :
Set the number of connections to queue before the Operating System
will send rejects to the remote client.

threads :
Set the thread pool size handling the client connections.

selectthreads :
Set the number of select threads used by NIO.

adapteralias :
Set the interface's alias.

receivebuffersize :
Set the socket buffer size in bytes used by this
interface when receiving data.

sendbuffersize :
Set the socket buffer size in bytes used by this interface
when sending data.

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
AddSocketInterface

Tool name:
AddSocketInterface

Description:
Adds a socket interface on the specified adapter and port,
on the specified server.

Usage:
runUMTool AddSocketInterface -rname=<rname> -adapter=<adapter> -port=<port>
[optional_args]

Examples:
AddSocketInterface -rname=nsp://localhost:8080 -adapter=0.0.0.0 -port=9090
-autostart=true

Required arguments:

rname :
URL of the realm to which the realm node, on which the interface
will be created, is connected.

adapter :
Adapter (network card) to which interface will bind.

port :
Port on which the interface will listen.

Optional Parameters:

autostart :
Whether this interface will automatically be started when the
realm server starts.

advertise :
Set the current advertise status for this interface.

allowinterrealm :
Whether this interface is allowed to be used in
inter realm/cluster communication.

allowclientconnections :
Whether this interface can accept client connections.

allownio :
Whether NIO is enabled on the interface.

authtimeout :
Set the number of milliseconds that the remote client has
to authenticate with the server.

backlog :
Set the number of connections to queue before the Operating System
will send rejects to the remote client.

threads :
Set the thread pool size handling the client connections.

selectthreads :
Set the number of select threads used by NIO.

adapteralias :
Set the interface's alias.

receivebuffersize :
Set the socket buffer size in bytes used by this
interface when receiving data.

sendbuffersize :
Set the socket buffer size in bytes used by this interface
when sending data.

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
DeleteInterface

Tool name:
DeleteInterface

Description:
Deletes the specified interface from the specified server.

Usage:
runUMTool DeleteInterface -rname=<rname> -interface=<interface>
[optional_args]

Examples:
DeleteInterface -rname=nsp://localhost:8080 -interface=interface0

Required arguments:

rname :
URL of the realm to which the realm node, from which the interface
will be deleted, is connected.

interface :
Name of the interface to be deleted.

Optional Parameters:

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
ListInterfaces
Tool name:
ListInterfaces

Description:
Lists details of the interfaces on the specified server.

Usage:
runUMTool ListInterfaces -rname=<rname> [optional_args]

Examples:
ListInterfaces -rname=nsp://localhost:9000

Required arguments:
rname:
URL of the realm for which the details of all the interfaces will be listed.

Optional Parameters:
format:
Format to print output in (plaintext/xml/json).
ModifyInterface

Tool name:
ModifyInterface

Description:
Modifies the specified interface on the specified server .

Usage:
runUMTool ModifyInterface -rname=<rname> -interface=<interface>
-command=<command> [optional_args]

Examples:
ModifyInterface -rname=nsp://localhost:9000 -interface=interface0
-command=modify -usewebsockets=true

Required arguments:

rname :
URL of the realm to which the realm node, on which the interface
will be modified, is connected.

interface :
Name of the interface to be modified.

command :
Whether the interface is to be stopped (STOP), started (START),
or have its fields modified (MODIFY).

Optional Parameters:

usehttp1.1 :
Whether to use HTTP1.1.

usewebsockets :
Whether WebSockets are used.

ajaxactivedelay :
Time to wait (for additional events) before delivering
to Long Poll style subscribers.

ajaxidledelay :
Time to wait before returning from a Long Poll call if no
events have been received.

isnativecomet :
Whether JavaScript is enabled on the interface.

allowedorigins :
Set the Allowed Origins for CORS as a comma-separated list of origins
(use '*' to allow all), e.g. origin1,origin2,origin3.

crossorigincredentials :
Whether to allow credentials header to be sent with CORS requests.

enablegzip :
Whether or not GZIP compression is enabled for javascript
Long Poll connections.

minimumbytes :
Set the minimum number of bytes in a packet before GZIP is
enabled (default 1000).

alias :
Set the certificate name/alias that this interface will use to
select its certificate from a keystore with multiple entries.

keystore :
Set the keystore file that this interface uses to load the certificate.

kspassword :
Set the keystore password that this interface will use to
access the keystore file specified.

truststore :
Set the truststore file against which this interface will
validate the client certificate.

tspassword :
Sets the truststore password that the server uses to access
the trust store.

privatepassword :
Private key password; used so that the key can be loaded
from the key store.

ciphers :
Names of the ciphers enabled for use by this interface,
as a comma-separated list of ciphers, e.g. cipher1,cipher2,cipher3.

rndalg :
Set the SecureRandom algorithm to use for this interface.

rndprov :
Set the SecureRandom provider to use for this interface.

clientcertrequired :
Whether this interface requires SSL client authentication.

crl :
Set the certificate revocation list file name that the interface
should use to check incoming SSL connections.

crlclassname :
Name of the class used to validate a client connection.

provider :
Name of the JSSE provider to use for the interface.

autostart :
Whether this interface will automatically be started when the
realm server starts.

advertise :
Set the current advertise status for this interface.

allowinterrealm :
Whether this interface is allowed to be used in
inter realm/cluster communication.

allowclientconnections :
Whether this interface can accept client connections.

allownio :
Whether NIO is enabled on the interface.

authtimeout :
Set the number of milliseconds that the remote client has
to authenticate with the server.

backlog :
Set the number of connections to queue before the Operating System
will send rejects to the remote client.

threads :
Set the thread pool size handling the client connections.

selectthreads :
Set the number of select threads used by NIO.

adapteralias :
Set the interface's alias.

receivebuffersize :
Set the socket buffer size in bytes used by this
interface when receiving data.

sendbuffersize :
Set the socket buffer size in bytes used by this interface
when sending data.

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.