Enabling a universal share with object store
A universal share or instant access with object stores are enabled by default on AKS or EKS. But for the cloud virtual machines to enable the object store feature, you must manually enable this feature.
Enable a universal share with object store
- Add the universal-share-object-store = 1 option into the
etc/msdp-releasefile.Example:
cat /etc/msdp-release universal-share-object-store = 1
- Verify that the UNIVERSAL_SHARE_OBJECT_STORE name is in the extendedcapabilities option.
Example:
nbdevconfig -getconfig -stype PureDisk -storage_server your_storage_server_name |grep UNIVERSAL_SHARE_OBJECT_STORE
- On the media server or the primary server, run the following commands to reload the storage server attributes:
nbdevconfig -getconfig -stype PureDisk -storage_server your_storage_server_name > /tmp/flags
nbdevconfig -setconfig -stype PureDisk -storage_server your_storage_server_name -configlist /tmp/flags
The following are optional parameters you can add to the universal share with object store. These options are located in: storage_path/etc/puredisk/vpfsd_config.json
Snapshot retention:
"cloudFullTaskInterval": 36000,: Automatically creates the full snapshot for the universal share interval and the default value is 10 hours. This entry must be an integer using the unit of seconds.
"cloudIncrTaskInterval": 1800,: Automatically creates the incremental snapshot for the universal share interval and the default value is 30 minutes. This entry must be an integer using the unit of seconds.
"cloudFullSnapshotRetention": 172800,: The retention time of the full snapshot copy. When the retention expires, the full snapshot is deleted from local storage and the cloud bucket storage. The default value is 48 hours. If the retention is set longer than 48 hours, there might be an effect on space reclamation.
Local disk cache configuration:
"CloudCacheSize": 500,: The local disk cache size for the universal share and instant access. This option applies only to the universal share with object store and instant access with object store. The vpfsd command removes this amount of space from the spoold service so you must verify there is enough space for the cache size. Otherwise, the universal share with object store or instant access for the object store are not created. MSDP verifies that there is enough configured space before the creation of the universal share. You must restart vpfsd when you increase the size of the cache and be aware that if there is not enough free space for the cache size, vpfsd cannot start.
After the universal share or instant access with object store is removed, that amount of space does not return to spoold automatically. Reduce the CloudCacheSize to return some space back to spoold. You must restart vpfsd after the removal.
"CloudCacheLowThreshold": 50,: The vpfsd service starts to reclaim the space of the cloud cache when the space usage of the cache reaches the low threshold. This entry is in the unit of percentage.
"CloudCacheHighThreshold": 85,: The vpfsd service stops any data from being written or the download of any data when the space usage of the cache reaches the high threshold. The data write and the data download continue when there is some free space. This entry is in the unit of percentage.
Snapshot management:
List all of the snapshots which include the full snapshot and incremental snapshot in the cloud bucket:
/usr/openv/pdde/vpfs/bin/vpfscld - list
Manually take snapshot and upload snapshot and data to cloud bucket:
/usr/openv/pdde/vpfs/bin/vpfscld --snapshot --share_id <share> --snap_type <full|incr>
Manually remove a snapshot from local and cloud, please be aware of that the expired snapshot is not recoverable:
/usr/openv/pdde/vpfs/bin/vpfscld --expire --share_id <share> --pit <point in time>
Manually recover a snapshot from a cloud bucket:
/usr/openv/pdde/vpfs/bin/vpfscld -recover --share_id <share> [--tgt_id <target>] [--pit <point in time>] [--force]
Note:
To enable object store for universal share and instant access, add universal-share-object-store = 1 and instance-access-object-store = 1 to /etc/msdp-release.
Note:
Save a copy of <MSDP directory>/var/keys/auth.key at a secure location on another computer. It is needed in some instances of universal share disaster recovery.