test

System Administration Guide: Devices and File Systems

Using the Command Line Interface to Configure iSNS

This section provides the procedures for configuring the iSNS server using the command line interface. The following topics are discussed:

These procedures use the isnsadm(1M) command. See the man page for a complete description of all of the command options.

ProcedureHow to Display the Current Server Configuration

  1. The following command shows the properties of the iSNS server:


    #isnsadm show-config
        Data Store Location: /etc/isns/isnsdata.xml
        Entity Status Inquiry Non-Response Threshold: 3
        Management SCN Enabled: yes
        Authorized Control Node Names: -

ProcedureHow to Enable the Default Discovery Domain Set

  1. Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

    Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Activate the default discovery domain set:


    #isnsadm enable-dd-set Default

ProcedureHow to Create the Discovery Domain Sets

  1. Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

    Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Create a discovery domain set:


    #isnsadm create-dd-set set_name

  3. Enable the discovery domain set:


    #isnsadm enable-dd-set set_name

  4. View all the discovery domain sets, including the new one:


    #isnsadm list-dd-set -v
        DD Set name: Default
            State: Enabled
        DD Set name:set_name
            State: Enabled

    The list of discovery domain sets includes the default discovery domain set as well as the new one.

ProcedureHow to Create the Discovery Domains

New discovery domains are members of the default discovery domain set. After you create them, you add them to the new discovery domain set.

  1. Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

    Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Create the discovery domain:


    #isnsadm create-dd domain_name

  3. View the new discovery domain in the Default discovery domain set:


    #isnsadm list-dd-set Default
         DD name: name
             DD set(s): Default

  4. Create other discovery domains.

ProcedureHow to Add a Discovery Domain to a Discovery Domain Set

This task removes the discovery domain from the default discovery domain set and adds it the discovery domain set that you specify. Because the new discovery domain set has been enabled, all the clients in its discovery domains can be discovered by the iSNS server.

You do not need to have privileges to list the members of the discovery domains and discovery domain sets.

  1. Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

    Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. List the discovery domains to identify the one you want to add.


    #isnsadm list-dd -v Default

  3. List the discovery domain sets to identify the one you want as the container for the new discovery domain.


    #isnsadm list-dd-set

  4. Move the discovery domain to the discovery domain set that you want:


    #isnsadm add-dd domain_name -s set_name

  5. View the new addition to the discovery domain set:


    #isnsadm list-dd-set -v domain_name

ProcedureHow to Assign Clients to a Discovery Domain

Before You Begin

Use the client's management interface to register the client. Using the iSCSI configuration function, specify the IP address of the iSNS server and allow discovery of the client by the iSNS server.

  1. Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

    Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Verify that the client has been registered with the iSNS server:


    #isnsadm list-node 
       iSCSI Name: iqn.1986-03.com.sun:01:000e0c9f10da.45173FEA.engr
	      Alias: STK5320_NAS
	      Type: Target
	      .
       iSCSI Name: iqn.1986-03.com.sun:01:000e0c9f10da.454F00A2.acct
	      Alias:
	      Type: Initiator

    The output shows the clients' iSCSI names.

  3. Verify the name of the discovery domain:


    #isnsadm list-dd

  4. Add the client to the discovery domain:


    #isnsadm add-node  -d domain_name iSCSI_Name

    For example, to add the target called “STK5320_NAS” to the Eng-dd discovery domain:


    #isnsadm add-node -d Eng-dd  iqn.1986-03.com.sun:01:000e0c9f10da.454F00A2.engr

  5. List all the clients in the discovery domain to verify the client has been added:


    #isnsadm list-dd -v domain_name

    For example, to check the Eng-dd discovery domain:


    #isnsadm list-dd -v Eng-dd
     	 DD name:	Eng-dd
          DD set: Development-dds
         iSCSI Name:	iqn.1986-03.com.sun:01:000e0c9f10da.45173FEA.engr
	        iSCSI Name:	iqn.1986-03.com.sun:01:000e0c9f10da.454F00A2.acct
	        iSCSI name: iqn.1986-03.com.sun:01:e00000000000.46fd8e2b