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 up to 4 comma-separated
values each one representing one of the 4 interfaces
that a Nirvana Realm can use. Each wire protocol has
a security and performance weight associated with it
and the nSession object that will get created will take
this into account. For example if an nSession
object is created with an RNAME string containing
one entry for sockets and one entry for SSL, the session
will first attempt to connect with SSL and should that
fail, it will try to connect using sockets.
|
|
