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.