Managing Devices in Oracle^® Solaris 11.3

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 tasks are described in this section:

• How to Display the Current Server Configuration

• How to Enable the Default Discovery Domain Set

• How to Create the Discovery Domain Sets

• How to Create the Discovery Domains

• How to Add a Discovery Domain to a Discovery Domain Set

• How to Assign Clients to a Discovery Domain

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

How to Display the Current Server Configuration

• 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: -

How to Enable the Default Discovery Domain Set

1. Use the following profiles to obtain the authorizations needed for managing the iSNS service:

   • solaris.isnsmgr.write

   • solaris.smf.manage.isns

   • solaris.smf.value.isns

   For more information about roles, see Chapter 3, Assigning Rights in Oracle Solaris in Securing Users and Processes in Oracle Solaris 11.3.

2. Activate the default discovery domain set:

   # isnsadm enable-dd-set Default

How to Create the Discovery Domain Sets

1. Use the following profiles to obtain the authorizations needed for managing the iSNS service:

   • solaris.isnsmgr.write

   • solaris.smf.manage.isns

   • solaris.smf.value.isns

   For more information about roles, see Chapter 3, Assigning Rights in Oracle Solaris in Securing Users and Processes in Oracle Solaris 11.3.

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.

How 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 following profiles to obtain the authorizations needed for managing the iSNS service:

   • solaris.isnsmgr.write

   • solaris.smf.manage.isns

   • solaris.smf.value.isns

   For more information about roles, see Chapter 3, Assigning Rights in Oracle Solaris in Securing Users and Processes in Oracle Solaris 11.3.

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
   DD name: name
   DD set(s): Default

4. Create other discovery domains.

How 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 following profiles to obtain the authorizations needed for managing the iSNS service:

   • solaris.isnsmgr.write

   • solaris.smf.manage.isns

   • solaris.smf.value.isns

   For more information about roles, see Chapter 3, Assigning Rights in Oracle Solaris in Securing Users and Processes in Oracle Solaris 11.3.

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

   # isnsadm list-dd -v

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

How 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 following profiles to obtain the authorizations needed for managing the iSNS service:

   • solaris.isnsmgr.write

   • solaris.smf.manage.isns

   • solaris.smf.value.isns

   For more information about roles, see Chapter 3, Assigning Rights in Oracle Solaris in Securing Users and Processes in Oracle Solaris 11.3.

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