This is archived documentation for an older version of Nirvana (v3.1).
Please refer to documentation for the
latest version if required.
What is a Nirvana Realm Name (RNAME)?
The RNAME is a string very
similar to a URL, which facilitates specifying all the
necessary parameters required to connect to a Nirvana
Realm. All the sample applications provided with Nirvana
use an RNAME Java system property to tell it how to connect
to a Nirvana server.
Anatomy of an RNAME
An RNAME string looks like:
<wire protocol> :// <hostname> :< port>,
<wire protocol> :// <hostname> : <port>
etc
where:
<wire protocol> can be one of
the 4 available wire protocol
identifiers nsp (socket), nhp
(HTTP), nsps (SSL) and nhps(HTTPS).
<hostname> is the hostname or
IP address that the Nirvana Realm is running
<port> is the TCP port on that
hostname that the Nirvana Realm is bound to using the
same wire protocol.
The RNAME entry can contain a comma-separated list
of values each one representing the communications protocol,
host and port currently running on a Nirvana Realm.
If a Nirvana session
becomes disconnected and cannot reconnect it will cascade
through the list of RNAMES provided in the comma separated
RNAME until it managed to reconnect.
|
|
