BlackArmor NAS - Setting up an iSCSI Target and Device for MacOS

Prerequisites:

• Update the BlackArmor NAS to the latest firmware ver. 4000.1211
  1. Check the NAS firmware version by logging into the NAS Manager page as Admin.
  2. The System Status page opens by default and the Firmware Version will be listed.
  3. Click here to download firmware version 4000.1211 if necessary.
  4. Follow the update procedure listed on that page to update the firmware.
     Remember to backup any critical data before updating the firmware.
• The iSCSI feature is only available for the BlackArmor NAS 400 Series.
• iSCSI cannot be used with an encrypted volume on the BlackArmor NAS.
• The (Free) globalSAN iSCSI Initiator for OS X may not connect when using CHAP Authentication.

The BlackArmor NAS Manager page is used to setup an iSCSI Target and Device

1. Enabling the iSCSI Service using the BlackArmor NAS Manager page:
   1. Log in to the NAS Manager page.
   2. In the menu bar, highlight Storage and then click iSCSI Manager.
   3. Click Enable next to iSCSI Target Service.
      • Communication to and from the server is made through the default port 3260. A different port may be used if desired. If the port is changed, confirm it is within the specified port range.
      • (Optional - These instructions do not use this option.)
        The Internet Storage Name Service (iSNS) is used for automated discovery of an iSCSI drive over your network. Click Enable next to iSNS Service if you want to set up this optional service.
        If you enable the iSNS Service, the BlackArmor server is used by default as the iSNS server. If you would rather use a different server, enter its IP address instead.
   4. Click Submit.
      
      
      
      The iSCSI Setup Wizard should begin.
      
      A setup wizard is available in the BlackArmor Manager Web UI to assist in setting up iSCSI. The setup process includes the steps to create the device and target.
2. Using the iSCSI Setup Wizard:
   
   The LUN ID (Logical Unit Number) is set to 0 by default for each target you create. A LUN is a logical volume that is mapped to the iSCSI target.
   1. Device Name: Enter a name for the device.
       The iSCSI device name can have a maximum of 16 characters, and only alphanumeric characters and hyphens are allowed. The iSCSI device name must begin with an alphanumeric character.
   2. Size: Enter the amount of storage space to allocate for this device.
      See the * at the end of this article for information concerning iSCSI Device size.
       
   3. Location: Choose the volume in which the device will reside.
   4. Click Next.
      
      
       
3. Creating an iSCSI Target:
   After creating the device, the target Add iSCSI Target page displays.
   Complete the page as follows:
   1. IQN (iSCSI Qualified Name): Enter the name that you want to call the target. The full name, including the information preceded by the name you provide, is what the client will see from the globalSAN iSCSI Initiator.
       The iSCSI target name can have a maximum of 32 characters and only alphanumeric characters, decimal points, colons, and hyphens are allowed. The iSCSI target name must begin with an alphanumeric character.
   2. Header and Data Digest: Enable the optional Header and/or Data Digest options to verify the iSCSI Initiator when it attempts to connect to the target.
      • Optional:
        One-way and Mutual CHAP: The optional Challenge Handshake Authentication Protocol is used for authentication between the iSCSI Initiator and the iSCSI target. If you use One-way CHAP, only the iSCSI target authenticates the Initiator. Enable Mutual CHAP if you want the client to perform an additional check to ensure that it is accessing the correct target. Create a user name and password for the CHAP settings you enable.
   3. Click Next when you are finished.
      
      
       
   4. Review your settings on the Summary page and then click Back to make any changes, or Submit to complete iSCSI setup.
      
      
      
      The iSCSI Target and Device is now setup.
      
      
       
   5. Click the lock to unlock the iSCSI Initiator and enter the Mac User and Password.
      
      
       

How to mount an iSCSI device in Snow Leopard or Leopard

1. Download the Free globalSAN iSCSI Initiator for OS X and install it in Leopard or Snow Leopard. A restart will be required after installation.
   File name:  globalSAN 4.1.0.279.dmg (Third-party software versions may change over time.)
   This application will not connect to an iSCSI Target when using CHAP Authentication.
2. To open the globalSAN iSCSI application after installation, click the Apple and open System Preferences.
   
   
    
3. Click the + sign and choose Portal. Enter the BlackArmor NAS IP address and click Add.
   
   
    
4. The list of Targets will be shown. Click OK.
   
   
    
5. Select the Connection, check-mark Persistent, and click Connect. The green light indicates connected.
   
   
    
6. When the iSCSI drive connects, it will report The disk you inserted was not readable by this computer. Click Initialize.
   
   
    
7. If the Disk Utility does not open automatically, click Go.
   Then choose Utilities and open the Disk Utility.
   Select the iSCSI drive on the left.
   Select the Erase option if needed, name the drive, and click Erase.
   
   
    
8. It will prompt, Are you sure you want to erase the disk "SCST_FIO____"?
   Click Erase.
   
   
    
9. When the Erase completes, the iSCSI drive will be mounted on the Desktop.
   
   
   
   These devices need to be checked in Finder Preferences before they will display on the Desktop.
   
   
    

*The iSCSI device should not be larger than the available free space on the NAS. A percentage of used space and the volume size can be found in the NAS Manager page, under Storage and Volumes. This can be used to calculate the free space of the NAS.

iSCSI devices and additional iSCSI devices that exceed the free space on the NAS can be created on the NAS without triggering a warning. This is not recommended.

The ability to create iSCSI drives larger than the available free space on the NAS is by design. The iSCSI user can also overshoot the volume capacity. It is the NAS Administrator's responsibility to avoid exceeding the available volume when setting up iSCSI device(s). The globalSAN iSCSI Initiator does not have the ability to distinguish what shares exist on the volume of the NAS. The administrator of the NAS needs to set these limits on the NAS when setting up the various iSCSI devices.

In reality, the best practice would be not to have normal shares on a volume with iSCSI devices. If it is decided to use a mix of iSCSI devices and User Shares on the same volume, free space can be controlled by setting up Quotas on the shares, and the iSCSI Targets can be created based on the free space on the NAS and the Quotas that are set.

When the NAS is full, MacOS may show free space on an iSCSI drive, but when trying to add more data, MacOS will report errors.

Additional Information:
See Document ID: 219651 for more information about iSCSI.