ISNSADM(8) System Manager's Manual ISNSADM(8) (NAME) isnsadm - iSNS (SYNOPSIS) isnsadm [options...] --register object... isnsadm [...] --query attr[=value] isnsadm [...] --deregister attr=value isnsadm [...] --list type attr=value isnsadm [...] --dd-register attr=value isnsadm [...] --dd-deregister dd-id attr=value isnsadm [...] --enroll client-name attr=value isnsadm [...] --edit-policy attr=value (DESCRIPTION) isnsadm iSNS . . isnsadm . (OPTIONS) isnsadm /etc/isns/isnsadm.conf : --config filename, -c filename ( ). --debug facility, -d facility . : +--------+---------------------------------------------------------------------------------------------------+ |socket | / | |auth | | |message | iSNS | |state | | |scn | SCN ( ) | |esi | ESI ( ) | |all | | +--------+---------------------------------------------------------------------------------------------------+ --local isnsadm iSNS ( ) . . () . --server servername, -s servername ( ). --control isnsadm . . isnsadm DSA Control.SourceName Control.AuthKeyFile . --key attr=value . (Registration mode) . --keyfile=filename iSNS isnsadm DSA . iSNS keyfile . --help . (Built-in help) isnsadm . --help . help : isnsadm --register help . (Supported attributes) . . name=value . ( NIL) . (value) . . ( entity) . . --edit-policy node-type policy-node-type . . : isnsadm --query pg-name=iqn.com.foo pg-addr=10.1.1.1 pg-port=860/tcp isnsadm --query pg-name=iqn.com.foo addr=10.1.1.1 port=860/tcp isnsadm : +-----------------------+---------------------------------------------------------------------------------------------------------+ | (Context) | (Attribute) iSNS (Aliases) | +-----------------------+---------------------------------------------------------------------------------------------------------+ |Network Entity | entity-id 1 eid | | | entity-prot 2 | | | entity-index 7 | |iSCSI Storage Node | iscsi-name 32 | | | iscsi-node-type 33 | | | iscsi-alias 34 | | | iscsi-idx 36 | | | iscsi-authmethod 42 | |Portal | portal-addr 16 | | | portal-port 17 | | | portal-name 18 | | | portal-esi-port 20 | | | portal-esi-interval 21 | | | portal-idx 22 | | | portal-scn-port 23 | |Portal Group | portal-group-index 52 | | | pg-name 48 | | | pg-addr 49 | | | pg-port 50 | | | pg-tag 51 pgt | | | pg-idx 52 | |Discovery Domain | dd-id 2065 | | | dd-name 2066 | | | dd-member-iscsi-idx 2067 | | | dd-member-name 2068 | | | dd-member-fc-name 2069 | | | dd-member-portal-idx 2070 | | | dd-member-addr 2071 | | | dd-member-port 2072 | | | dd-features 2078 | |Policy Object | policy-name - spi | | | policy-key - | | | policy-entity - | | | policy-node-type - | | | policy-object-type - | | | policy-functions - | +-----------------------+---------------------------------------------------------------------------------------------------------+ (Portal attributes) (Portal) iSNS IP TCP/UDP (TCP UDP) . TCP/UDP Open-iSNS . "iscsi-target" . isnsadm . : addr=
port=[/protocol]. portal=
:port[/protocol] addr/port pg-portal=.... IPv6 : portal=[2001:5c0:0:2::24]:860/tcp (Bitfield attributes) iSNS . isnsadm . . (+) (,) : node-type=control+initiator (Registration mode) --register iSNS . ( ) . . : target=iqn.2005-01.org.open-iscsi.foo:disk1,alias=disk1 : entity=name (Network Entity) . iSNS . initiator[=name] iSCSI (initiator) . iSNS . iSCSI . target[=name] iSCSI (target) . iSNS . initiator . control[=name] iSCSI (control) . iSNS . iSNS . initiator . portal=[address:port/proto] . isnsadm IP . initiator ( ) 860/tcp target 3260/tcp . (multi-homed) . . pg (portal group) . RFC 4171 . . (PGT) pgt . . --replace . . --replace . . . --key . 10.1.1.1:860 10.2.7.7 . () : isnsadm --replace --key portal=10.1.1.1:860 portal=10.2.7.7:860 --key : +----------------------------------+---------------------+ | (Object type) | (Syntax) | +----------------------------------+---------------------+ |Entity | eid=identifier | |Portal | portal=address:port | |iSCSI Node | iscsi-name=name | +----------------------------------+---------------------+ isnsadm --register help . (Query mode) --query . attr=value . . ( attr) . . isnsadm --query help . (List Mode) isnsadm . attr=value . portals . : entities nodes portals dds ddsets portal-groups policies. : isnsadm --list help. (Deregistration mode) . ( ). attr=value . . (Discovery Domain Registration) . attr=value . . . . (Discovery Domain Deregistration mode) . ( ). attr=value . . (Client Enrollment) : isnsadm --local isnsd . --local . isnsadm --control . isnsadm DSA Control.SourceName Control.AuthKeyFile . . --enroll () . . / : +----------------------------+----------------------------------------------------------------------------------------------------------------------------------+ | (Attribute) | (Description) (Aliases) | +----------------------------+----------------------------------------------------------------------------------------------------------------------------------+ |name | spi | |key | DSA | |entity | | |node-type | | |node-name | | |functions | | |object-type | | +----------------------------+----------------------------------------------------------------------------------------------------------------------------------+ key DSA . isnsadm PEM . key key=gen isnsadm DSA . --keyfile=filename . object-type . type:perm type entity iscsi-node portal portal-group dd ddset policy . rw r . functions . RFC 4171 DevAttrReg DevAttrQry . open-isns isns_config(5) . : DSA DSA . isnsadm /etc/isns/dsa.params . isnsd --init . : openssl dsaparam 1024 -out /etc/isns/dsa.params 1024 DSA . (EXAMPLES) Open-iSNS DSA DSA . : isnsd --init /etc/isns/auth_key auth_key.pub . isns.control : isnsadm --local --keyfile=control.key --enroll isns.control \ node-type=ALL functions=ALL object-type=ALL DSA control.key . /etc/isns/control.key iSNS . : isnsadm --local --register control : isnsadm --control --keyfile=somehost.key --enroll iqn.2005-01.org.open-iscsi.somehost \ node-type=target+initiator DSA auth_key . --control isnsadm . somehost.key /etc/isns/auth_key . ( /etc/isns/auth_key.pub ) /etc/isns/server_key.pub . ( initiator target) iSNS . target initiator ( DD) . . iSNS DD . : isnsadm --control --dd-register dd-name=mydomain \ member-name=iqn.org.bozo.client iqn.org.bozo.jbod ... DD - DD ( RFC ): isnsadm --control --dd-register dd-id=42 \ member-name=iqn.com.foo member-name=iqn.com.bar DD DD : isnsadm --control --query dd-name=mydomain . client.bozo.org : isnsadm --control --register entity=client.bozo.org \ initiator=iqn.org.bozo.client portal=191.168.7.1:860 . CONTROL . (SEE ALSO) RFC 4171, isnsd(8), isns_config(5). (AUTHORS) Olaf Kirch 11 May 2007 ISNSADM(8)