• No results found

Pool Commands

In document Command Line Interface (Page 57-64)

Removing a Password Requirement

To remove the requirement for an Administrator password, press Enter at each password prompt instead of entering a new password.

Setting a New Operator Password

To change the Operator password, enter:

password operator

When prompted, enter the new password, then enter it again. For example:

adaptec adaptec

Note Press Ctrl+C at either password prompt to leave the existing password unchanged.

Removing a Password Requirement

To remove the requirement for an Operator password, press Enter at each password prompt instead of entering a new password.

Pool Commands

Use the commands in this section to manage the storage pools on your iSCSI Storage Appliance. To enter the pool context, enter:

pool

Alarm

This command manages the alarm on your iSCSI Storage Appliance. You can use this command to view the current alarm settings, and you can enable or disable the alarm, test it, and silence a sounding alarm.

To view current alarm settings, enter:

alarm info

To enable or disable the alarm, enter:

alarm enable_or_disable To test the alarm, enter:

Pool Commands

Create

Note Administrator access only.

This command creates a new pool. Up to 20 pools are supported on a single iSCSI Storage Appliance. The complete command syntax is:

create pool_name RAID_level stripe_depth disk_drive_list Where:

pool_name is a unique name for the pool

RAID_level is the RAID level you want to apply to the pool (if any)

Note Ensure that you have enough available disk drives to support the RAID level you want.

stripe_depth is the stripe depth for the pool

disk_drive_ID_list is the ID number of the disk drive(s) to be included in the pool Note To find a disk drive’s ID, exit the pool context then enter device list. To create a pool with no RAID level, enter:

create poolA 0

To create a pool with RAID 5, enter:

create poolB raid5 256 0 512 768

Note Ensure that you list the minimum number of disk drives required to support the RAID level you want.

Creating a Pool with RAID 50 or RAID 60

To create a pool with RAID 50 or RAID 60, you must specify six or eight disk drives (respectively) and arrange them into groups. You must also specify the number of groups you want.

To create a pool with RAID 50 or RAID 60, enter:

create pool_name RAID_50_or_60 stripe_depth disk_drive_list group number_of_groups For example:

create poolA raid50 256 0 256 512 768 1024 1280 group 2

Pool Commands

Destroy

Note Administrator access only.

This command deletes a specified pool or pools. After a pool is deleted, the disk drives that comprised it become available for use.

You must specify each pool by its name. Enter destroy then press Tab twice, to see the names of pools that can be deleted. You can’t delete a pool that includes logical devices. (To delete a logical device, see “Destroy” on page 38.)

Foreign pools must be imported before they can be deleted. See “Import” on page 50 for more information.

Caution Before you begin, ensure that you have backed up any data you want to save.

When the pool is deleted, any data or programs stored on that pool are also deleted.

You will be prompted to confirm the deletion before the task completes.

To delete a pool or pools, enter:

destroy pool_name_list yes

The pool is deleted immediately.

Note Depending on your OS, the drive-letter assignments of any remaining drives may change after a pool is deleted and the system is rebooted.

Export

Note Administrator access only. This command is used in conjunction with the import command. See “Import” on page 50 for more information.

This command exports one or more pools so that it can be moved to a different iSCSI Storage Appliance. You must specify each pool by its name. (To find the name of a pool, enter list.) You will be prompted to confirm the export before the task is completed.

Notes 1) Ensure that no iSCSI initiators are accessing a pool before you attempt to export it. Pools being accessed can’t be exported. 2) Adaptec recommends that you not export a pool while it is building, rebuilding, or synchronizing. If you do, it appears as an alien pool when you import it to a new iSCSI Storage Appliance. (An alien pool is a partially completed pool whose creation was interrupted; it contains no iSCSI Storage Appliance information. Alien pools can’t be imported or used to store data, and should be deleted.)

Pool Commands

Next Steps

After the pool has been exported, shut down both iSCSI Storage Appliances—the appliance you are exporting from and the appliance you are importing to. (For instructions refer to the Snap Server 700i Series User’s Guide on the User CD.) Move the disk drives that comprise the pool to the new iSCSI Storage Appliance, following the manufacturer’s instructions, power on the new iSCSI Storage Appliance, then import the foreign pools using the import command (see page 50).

Only one foreign pool at a time appears in the CLI; after you import the first foreign pool, the next foreign pool appears in the CLI, and so on.

Identify

Note Administrator access only.

This command helps you identify disk drives included in a pool or pools by blinking their LEDs. You must specify each pool by its name. (To find the name of a pool, enter list.)

To start blinking disk drive LEDs, enter:

identify pool_name_list start For example:

identify pool-1 pool-2 start (blinks the disk drives in pool-1 and pool-2) identify pool-3 start (blinks the disk drives in pool-3)

The LEDs will stop blinking automatically after 30 seconds. You can stop the blinking sooner by entering:

identify pool_name_list stop

Import

Note Administrator access only. This command is used in conjunction with the export command. See “Export” on page 49 for more information.

This command imports foreign pools to your iSCSI Storage Appliance. You will be prompted to confirm the export before the task is completed.

To import a pool, enter:

import pool_name_list yes

Pool Commands

Info

In the pool context, this command displays information about one or more pools, including status, cache settings, and the disk drives that comprise each pool. You must specify each pool by its name. (To find the name of a pool, enter list.)

To display information about all pools associated with your iSCSI Storage Appliance, enter:

info

To display information about a specific pool, enter:

infopool_name

To display information about multiple pools simultaneously, enter:

info pool_name_list

List

In the pool context, this command lists all known pools associated with your iSCSI Storage Appliance:

list

Manage Commands

Note Administrator access only.

Use these commands to modify the settings for a specified pool. You must specify the pool by its name. (To find the name of a pool, enter list.)

To enter a pool’s manage context, enter:

manage pool_name

Cache

This command enables or disables the cache settings for the pool. You can set the read cache and write cache settings separately.

To change the cache settings for the pool, enter:

cache read_or_write enable_or_disable For example:

cache read enable

Pool Commands

Identify

This command helps you identify the disk drives included in the pool by blinking its LEDs:

identify

The LEDs will stop blinking automatically after 30 seconds. You can stop the blinking sooner by entering:

identify stop

Info

In a pool’s manage context, this command displays information about the pool, including its status, cache settings, and disk drives that comprise the pool:

info

Rename

This command changes the name of the pool:

rename

Spare Commands

In a pool’s manage context, these commands create and remove designated hot spares for the pool. You can also use this command to view a list of the pool’s existing hot spares.

To enter the pool’s spare context, enter:

spare

• Add—This command designates a specified disk drive as a dedicated hot spare.

Only disk drives that are available (not used in any existing pools) can be designated as hot spares. You must specify the disk drive by its ID number. (To find a disk drive’s ID number, exit the pool context and enter device list.)

add disk_drive_ID

The disk drive is immediately designated as a dedicated hot spare.

• List—This command lists the disk drives in your iSCSI Storage Appliance that are designated as dedicated hot spares for the pool:

list

Pool Commands

Task Rate

This command sets the speed of whatever job is currently running on the pool (building, rebuilding, synchronizing, or verifying). You can change this setting to high, medium, or low.

To change a job’s speed, enter:

task rate speed

Verify

This command begins a background verification on the pool:

verify

To stop all running background verifcation jobs, see “Verify Commands” on page 55.

Migrate

Note Administrator access only.

This command modifies a specified pool by changing its RAID level, stripe depth, and/or list of disk drives that comprise the pool.

This table lists supported RAID-level migrations. Ensure that you have enough available disk drives to support the new RAID level.

Note You can also migrate from RAID 1 or RAID 5 to RAID 0. If the pool has a spare drive associated with it, the RAID 0 pool retains the spare drive.

You must specify the pool by its name. (To find a pool’s name, enter list. To view a pool’s other settings, enter info.) You must specify disk drives by their ID number.

(To find a disk drive’s ID, exit the pool context and enter device list.) You will be From RAID Level To RAID Level

Simple Volume RAID 1

RAID 0 RAID 5 or RAID 10

RAID 1 Simple Volume, RAID 5, or RAID 10 RAID 5 RAID 0, RAID 10, or RAID 6

RAID 6 RAID 5

RAID 10 RAID 0 or RAID 5

Pool Commands

The complete command syntax is:

migrate pool_name RAID_level stripe_depth disk_drive_ID_list Where:

pool_name is the name of the pool

RAID_level is either the existing RAID level or a new RAID level for the pool

stripe_depth is either the existing stripe depth or a new stripe depth for the pool

disk_drive_ID_list is either the existing or a new list of disk drives (by disk drive IDs) comprising the pool

For example, to migrate an existing pool with RAID 1, a stripe depth of 128, and two disk drives (ID 0 and 256), to a RAID 5 pool with the same stripe depth, enter:

migrate pool-1 raid5 128 0 256 512 yes

In document Command Line Interface (Page 57-64)

Related documents