System Administration Commands isns(1M)
NAME
isns - Internet Storage Name Service
SYNOPSIS
/usr/sbin/isns
DESCRIPTION
The Internet Storage Name Service (iSNS) provides consoli-
dated discovery services for Internet SCSI (iSCSI) and
Internet Fibre Channel Protocol (iFCP) devices in an IP net-
work. iSNS uses a client/server mechanism: servers store
configuration information for clients, and provide that
information upon a client's request. IETF RFC 4171
describes the protocols between the server and client.
This man page provides a summary of the Solaris iSNS server
implementation. The current implementation does not support
iFCP devices.
Solaris iSNS server is implemented as the daemon isns, which
binds to the well -known port 3205 to service client
requests. The daemon is started by the service management
facility (smf(5)), using the fault management resource iden-
tifier (FMRI):
svc:/network/isnsserver
Use svcadm(1M) to enable isns. Enabling the service means
that it starts and runs automatically whenever the operating
system is booted. The state of service can be displayed with
the svcs(1) command.
The service properties listed below can be managed using
svccfg(1M). The default value is assigned per RFC 4171 and
implementation choice.
datastorelocation
Configuration data store location. The default location
is /etc/isns/isnsdata.xml.
ESIretrythresholdcount
Entity Status Inquiry retry threshold counter. The
SunOS 5.11 Last change: 8 Nov 2007 1
System Administration Commands isns(1M)
default count is 3.
ManagementSCNsEnabled
Boolean that determines whether Management State Change
Notification is enabled. The default is yes.
AuthorizedControlNodes
Control node names.
After changing a property value, you must use svcadm(1M)
refresh to enable isns to recognize the new value. If you
change the datastorelocation property, you must enter a
svcadm restart command for the change to take effect.
RFC 4171 defines the default discovery domain, the default
domain set, and the "Default D/DS" setting with the intent
of managing clients that have not been assigned to any
user-defined discovery domain. The server adopts the follow-
ing behaviors with respect to the default discovery domain
and domain set:
o An unassigned client is added to the default
discovery domain. A newly registered client or a
client that was removed from its last discovery
domain membership is considered to be an unassigned
client.
o When a client gets assigned to a user-defined
discovery domain, the server will remove the client
from the default discovery domain.
o The default discovery domain set is allowed to be
administratively activated or deactivated in order
to let the administrator control discovery among
clients in the default discovery domain.
o It is not allowed to administratively add a client
to the default discovery domain, nor to administra-
tively add a user-defined discovery domain to the
default discovery domain set.
o The default state of the Default discovery domain
set is inactive.
SunOS 5.11 Last change: 8 Nov 2007 2
System Administration Commands isns(1M)
The isns server supports certain rbac(5) authorizations that
allow you to administer isns activity. These authorizations
include the following authattr(4) privileges:
solaris.isnsmgr.write
Required to create a discovery domain or domain set, to
enable/disable a discovery domain set and to change
grouping of iSNS clients in a discovery domain or
grouping of discovery domains in a discovery domain set.
solaris.smf.manage.isns
Required to manage the isns server through the smf(5).
solaris.smf.value.isns
Required to change the SMF service properties associated
with isns.
The iSNS Server Management profile (see profattr(4))
includes all of the preceding authorizations. See rbac(5)
for an overview of roles and authorizations.
OPTIONS
There are no options supported by the isns daemon.
EXAMPLES
Example 1 Starting an isns Server
The following command starts the isns server.
# svcadm enable svc:/network/isnsserver
Example 2 Stopping an isns Server
The following command stops the isns server.
# svcadm disable svc:/network/isnsserver
SunOS 5.11 Last change: 8 Nov 2007 3
System Administration Commands isns(1M)
Example 3 Changing an isns Property
The following sequence of commands changes the value of the
ESIretrythresholdcount property.
# svccfg -s svc:/network/isnsserver setprop \
config/ESIretrythresholdcount = 6
# svcadm refresh svc:/network/isnsserver
FILES
/usr/sbin/isns
iSNS daemon binary.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWisnsr
Interface Stability Standard
SEE ALSO
svcs(1), isnsadm(1M), svcadm(1M), svccfg(1M), authattr(4),
profattr(4), attributes(5), rbac(5), smf(5)
NOTES
It is strongly recommended that you restart the server
(svcadm restart) after a service property is changed. This
allows the server to apply a uniform setting for existing
and new clients.
A control node, as described in RFC 4171, is not required to
administer the server. Control node operations can be
achieved through the isnsadm(1M) command interface on the
local host. For example, isnsadm enables you to create a
discovery domain and a discovery domain set and to add a
member to it, in order to create discovery domain and
discovery domain set associations.
SunOS 5.11 Last change: 8 Nov 2007 4
|
