Skip to content
Documentation

Managing storage pools

During the life of a storage pool many things can happen: the pool could run out of space, disks could fail, the network topology might change etc.

To manage a storage pool click on the Storage pool in the Storage page list.

  1. A Drive is a volume that MetalSoft allocates to an instance from this storage pool (not a physical disk)
  2. A File Share is a drive that you can attach to multiple instances (e.g., for VMware)
  3. An Object Storage Bucket is a logical container used to store objects, which are units of data that include:
    • The actual data (e.g., a file, image, video, backup)
    • Metadata (descriptive information about the object)
    • A unique identifier (used to retrieve the object)

Putting a storage pool in maintenance mode

Section titled “Putting a storage pool in maintenance mode”

Maintenance mode blocks all subsequent provisioning on the respective pool but does not affect existing LUNs.

Depending on the operation the admin wants to perform, the admin might need to shut down all servers that use volumes from this storage system.

The admin should contact all users of those servers and schedule the downtime.

Storage pool allocation algorithm

Section titled “Storage pool allocation algorithm”

When you register more than one storage pool, MetalSoft checks available disk space on all storage pools and allocates new LUNs on a storage pool based on the following conditions:

  1. All storage pools connected to the fabric of the logical network to which the drive is attached.
  2. MetalSoft selects all storage pools not in maintenance.
  3. MetalSoft selects all storage pools with sufficient available capacity.

MetalSoft uses the first storage pool in the resulting list to allocate the volume.

Managing storage via the API

Section titled “Managing storage via the API”

Listing all storage systems

Section titled “Listing all storage systems”
Terminal window
curl "https://<your-server>/api/v2/storages" \
  -H "Authorization: Bearer <API_KEY>"

Getting storage details

Section titled “Getting storage details”
Terminal window
curl "https://<your-server>/api/v2/storages/{storageId}" \
  -H "Authorization: Bearer <API_KEY>"

Getting storage statistics

Section titled “Getting storage statistics”
Terminal window
curl "https://<your-server>/api/v2/storages/{storageId}/statistics" \
  -H "Authorization: Bearer <API_KEY>"

Listing drives on a storage system

Section titled “Listing drives on a storage system”
Terminal window
curl "https://<your-server>/api/v2/storages/{storageId}/drives" \
  -H "Authorization: Bearer <API_KEY>"

Listing file shares on a storage system

Section titled “Listing file shares on a storage system”
Terminal window
curl "https://<your-server>/api/v2/storages/{storageId}/file-shares" \
  -H "Authorization: Bearer <API_KEY>"

Listing storage interfaces

Section titled “Listing storage interfaces”
Terminal window
curl "https://<your-server>/api/v2/storages/{storageId}/interfaces" \
  -H "Authorization: Bearer <API_KEY>"

Creating a new storage system

Section titled “Creating a new storage system”
Terminal window
curl -X POST "https://<your-server>/api/v2/storages" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "siteId": 1,
    "name": "storage-01",
    "vendor": "Dell",
    "model": "PowerStore",
    "managementAddress": "192.168.1.200",
    "managementUsername": "admin",
    "managementPassword": "password"
  }'