IBM Support

Setting up and troubleshooting the RAID Array on the hard drives

News


Abstract

This technote lists the recommended steps for setting up the RAID disk array to avoid unpredictable results that may include the device becoming unresponsive as well as troubleshooting steps if there are problems with the raid array.

Content

Important: Read all notes

  • Make sure the device has no other activity during this process
  • Failing to initialize the file system on the disk, or not waiting until the initialization of the file system is complete, before enabling the raid-volume could have "unpredictable" results. The system would be attempting to mount a disk full of random data
  • It will take approximately an hour for the contents of the primary drive to be copied to the secondary drive (synchronization) after you receive the "Action Completed Successfully" message when initializing the raid or manually starting the synchronizing of the raid volume.
  • During the synchronization the performance of the Disk Array may be slower than normal. The amber (!) LED on the front of the appliance and the HDD LED on the rear of the appliance may also be lit until the synchronization is complete.
  • If possible leave the device untouched during this process. The RAID Volumes status provider allows you to monitor the progress of synchronization (see Troubleshooting below)
  • The directory name MUST NOT be the same as any domain name ensure the name chosen will never be used as a domain name.
  • When initialized the raid directory will be accessible from the "local" and "logstore" directories.
    Example: To identify the location for a file type logging target to use the raid directory use the format:
    logstore:///<raid dir name>/<file name for log target>


Use these steps for initializing the RAID array.

Follow these steps if using the CLI and logged in as admin:

  1. config
  2. raid-initialize raid0
  3. raid-volume-initialize-filesystem raid0 (This step will take a few minutes)
  4. raid-volume raid0
  5. directory <name> (The directory name appears in the file manager under the "Local" directory. This name must not be the same as any domain name)
  6. admin-state enabled
  7. exit
  8. write mem
  9. When prompted about overwrite {y/n,}, select y


Follow these steps if using the WebGUI logged in as admin:

  1. Log into the default domain and navigate to Objects>System Settings>Hard Disk Array
  2. Select raid0
  3. Initialize Hard Disk Array
  4. Click Confirm (Wait for completion message)
  5. Click Close
  6. Initialize File System
  7. Click Confirm (This may take a few minutes. Do not select Close until the action is complete.)
  8. Click Close
  9. Set the admin State to enabled and the set the directory name. (This name must not match any domain name)
  10. Click Apply
  11. Click Save Config


Troubleshooting the RAID array

Note: For some of the CLI commands to display correctly, set your console display to be 120 columns wide.

To check the free space:
From the WebGUI select: Status -> RAID Partition Status
From the CLI enter: "show raid-partitions"

If you see the LED's on for the HDD's or the raid is not working correctly, check the status:

From the WebGUI select: Status -> RAID Volumes
From the CLI enter: "show raid-volumes"

Verify that "Enabled" is "True" and check if the "State" is "Degraded" if so check if "Resync in Progress" is "True"

If a Resync is in progress the amber (!) LED on the front and the HDD LED on the rear of the appliance may be on. This is normal and they will go out when the resync is complete which normally takes approximately one hour to complete.
Note: If the raid array is being used during a resync, it will impact performance of the writing to the raid as well as prolonging the resync.
You can use the "raid volumes" status provider to monitor the "Resync Percentage"

If "Enabled" is false or there is no resync in progress and the LED's are on check the "Physical disk" status.

From the WebGUI select: Status -> RAID Physical Disks
From the CLI enter: "show raid-phys-disks"

Check the "online" status of the disks. If one is "offline", Contact DataPower Support.


If you see these errors in the logs:
"cannot make storage volume accessible".
"raid-volume (raid0): Unable to attach storage volume, error device number out of range"


The error-messages indicates there was a problem when initializing the raid array.
To resolve these errors, the raid array will need to be deleted and initialized again. Follow the steps and notes above.

To remove the raid array from the configuration:
From the WebGUI select: Objects>System Settings>Hard Disk Array -> raid0
Verify the status is "disabled" and if not select: disabled -> Apply
Next select the "Delete Hard Disk Array" link in the list to the right of the screen
Select "Save Config" then reboot the appliance.

From the CLI enter:
config
raid-volume raid0
admin-state disabled
exit
raid-delete raid0
write mem
exit
shutdown reboot


If reinitialize the appliance to factory settings:

1. You will not be able to access the information previously stored on the RAID array

2. To activate the array you may use either of the following procedures:

A) Enable the array using the existing partition on the hard drives

WebGUI:

  1. Log into the default domain and navigate to Objects>System Settings>Hard Disk Array
  2. Select raid0
  3. Set the admin State to enabled and the set the directory name. (This name must not match any domain name)
  4. Click Apply
  5. Save config

CLI:
  1. config
  2. raid-volume raid0
  3. directory <name> (The directory name appears in the file manager under the "Local" directory. This name must not be the same as any domain name)
  4. admin-state enabled
  5. exit
  6. write mem
  7. When prompted about overwrite {y/n,}, select y

B) Delete the existing partition and initialize the array

To remove the existing partition from the hard drives:
From the WebGUI select: Objects>System Settings>Hard Disk Array -> raid0
Select the "Delete Hard Disk Array" link in the list to the right of the screen
Select "Save Config" then reboot the appliance.

From the CLI enter:
config
raid-delete raid0
write mem
exit
shutdown reboot

When the appliance has rebooted follow the steps at the beginning of this technote to initialize the RAID array.

Contacting Support:

See this link for information to Contact DataPower Support.

Collect and provide the following information:
  1. Generate an error report
  2. Capture these CLI command outputs:
    show version
    show raid-volumes
    show raid-phys-disks
    config
    test hardware
  3. Provide the status of the LED's on the front and rear of the appliance.

Cross reference information
Segment Product Component Platform Version Edition
Business Integration WebSphere DataPower Integration Appliance XI50 Not Applicable Firmware 4.0.2, 4.0.1, 5.0.0, 6.0.0 All Editions
Business Integration WebSphere DataPower XML Security Gateway XS40 Not Applicable Firmware 4.0.2, 4.0.1, 5.0.0, 6.0.0 All Editions
Business Integration WebSphere DataPower XML Accelerator XA35 Not Applicable Firmware 4.0.2, 4.0.1, 5.0.0 Edition Independent
Business Integration WebSphere DataPower B2B Appliance XB62 Not Applicable Firmware 4.0.1, 4.0.2, 5.0.0, 6.0.0 All Editions

Document information

More support for: IBM DataPower Gateways
General

Software version: 4.0.1, 4.0.2, 5.0.0, 6.0.0, 6.0.1, 7.0.0, 7.1, 7.2

Operating system(s): Firmware

Reference #: 1358544

Modified date: 13 April 2011


Translate this page: