Managing the iSCSI service

Verifying that the iSCSI service is running

Verifying that the iSCSI service is running using the command line

To verify that the iSCSI service is running, complete the following step.

Step	Action
1	On the storage system console, enter the following command: iscsi status Result A message is displayed indicating whether iSCSI service is running.

Verifying that this iSCSI service is running using FilerView

To verify that the iSCSI service is running, complete the following step.

Step

Action

1
Click LUNs > Enable/Disable.

Result

The status of the iSCSI service is displayed.

Step	Action
1	Click LUNs > Enable/Disable. Result The status of the iSCSI service is displayed.

Note
If the iSCSI service is not running, verify that the iSCSI license is enabled and start the service.

Verifying that iSCSI is licensed

Verifying that iSCSI is licensed using the command line

To verify that the iSCSI service is licensed, complete the following step.

Step	Action
1	On the storage system console, enter the following command: license Result A list of all available licenses is displayed. An enabled license shows the license code.

Verifying that iSCSI is licensed using FilerView

To verify that the iSCSI service is licensed, complete the following step.

Step	Action
1	Click Filer > Manage Licenses. Result A list of all available licenses is displayed. An enabled license shows the license code.

Enabling the iSCSI license

Enabling the iSCSI license using the command line

To enable the iSCSI license, complete the following step.

Step	Action
1	On the storage system console, enter the following command: license add license_code license_code is the license code provided to you.

Enabling the iSCSI license using FilerView

To enable the iSCSI license, complete the following steps.

Step	Action
1	Click Filer > Manage Licenses.
2	In the iSCSI field, enter the license code provided to you.
3	Click Apply.

Starting and stopping the iSCSI service

Starting and stopping the iSCSI service using the command line

To start or stop the iSCSI service, complete the following step.

Step	Action
1	On the storage system console, enter the following command: iscsi {start\|stop}

Starting and stopping the iSCSI service using FilerView

To start or stop the iSCSI service, complete the following steps.

Step	Action
1	Click LUNs > Enable/Disable.
2	To start the iSCSI service, check the Enable box. To stop the iSCSI service, clear the Enable box.
3	Click Apply.

Displaying the target node name

Displaying the target node name using the command line

To display the storage system's target node name, complete the following step.

Step	Action
1	On the storage system console, enter the following command: iscsi nodename Example iscsi nodename iSCSI target nodename: iqn.1992-08.com.netapp:sn.12345678

Displaying the target node name using FilerView

To display the storage system's target node name, complete the following step.

Step	Action
1	Click LUNs > iSCSI > Manage Names. Result The target node name is displayed in the "Change node name" field.

Changing the target node name

Changing the storage system's node name while iSCSI sessions are in progress does not disrupt the existing sessions. However, when you change the storage system's node name, you must reconfigure the initiator so that it recognizes the new target node name. If you do not reconfigure the initiator, subsequent initiator attempts to log in to the target will fail.

Node name rules

If you change the storage system's target node name, be sure the new name follows all of these rules:

A node name can be up to 223 bytes.
Uppercase characters are always mapped to lowercase characters.
A node name can contain alphabetic characters (a to z), numbers (0 to 9) and three special characters:
- Period (".")
- Hyphen ("-")
- Colon (":")
The underscore character ("_") is not supported.

Changing the target node name using the command line

To change the storage system's target node name, complete the following step.

Step	Action
1	On the storage system console, enter the following command: iscsi nodename iqn.1992-08.com.netapp:unique_device_name unique_device_name is the unique name for the storage system. Example iscsi nodename iqn.1992-08.com.netapp:filerhq

Changing the target node name using FilerView

To change the storage system's target node name, complete the following steps.

Step	Action
1	Click LUNs > iSCSI > Manage Names.
2	Enter the new target node name in the "Change node name" field.
3	Click Apply.

Displaying the target alias

The target alias is an optional human-readable name for the iSCSI target. For example, if your target node name was iqn.1992-08.com.netapp:sn.33604646, you might want an alias such as Filer_1. The alias is a text string with a maximum of 128 characters.

The alias is intended to be displayed by an initiator's user interface to make it easier for someone to identify the desired target in a list of targets. Depending on your initiator, the alias may or may not be displayed in the initiator's user interface.

Displaying the target alias using the command line

To display the storage system's target alias, complete the following step.

Step	Action
1	On the storage system console, enter the following command: iscsi alias Example iscsi alias iSCSI target alias: Filer_1

Displaying the target node name using FilerView

To display the storage system's target alias, complete the following step.

Step	Action
1	Click LUNs > iSCSI > Manage Names. Result The target alias is displayed in the Change Alias field.

Adding or changing the target alias

You can change the target alias or clear the alias at any time without disrupting existing sessions. The new alias will be sent to the initiators the next time they log in to the target.

Changing the target alias using the command line

To create, change, or clear the storage system's target alias, complete the following step.

Step	Action
1	On the storage system console, enter the following command: *iscsi alias [-c \| string]* `-c` clears the existing alias value string is the new alias value, maximum 128 characters Example 1 iscsi alias Filer_2 New iSCSI target alias: Filer_2 Example 2 iscsi alias -c Clearing iSCSI target alias

Step

Action

On the storage system console, enter the following command:

iscsi alias [-c | string]

-c clears the existing alias value

string is the new alias value, maximum 128 characters

Example 1

iscsi alias Filer_2

New iSCSI target alias: Filer_2

Example 2

iscsi alias -c

Clearing iSCSI target alias

Changing the target node name using FilerView

To create, change, or clear the storage system's target alias, complete the following steps.

Step	Action
1	Click LUNs > iSCSI > Manage Names. Result The current target node alias is displayed in the Change Alias field.
2	Enter the new target alias in the Change Alias field. To clear the target alias, delete all of the existing text in the field.
3	Click Apply.

Step

Action

Click LUNs > iSCSI > Manage Names.

Result

The current target node alias is displayed in the Change Alias field.

Enter the new target alias in the Change Alias field. To clear the target alias, delete all of the existing text in the field.

Click Apply.