Skip to main content
Version: 3.1

Disable pool caching

Prerequisites

Before you can disable pool caching, you must have a storage pool with caching configured and enabled.

You can use the following commands to check if caching is enabled:

  1. First, run the pxctl status command the get the id of your pool:

    pxctl status
    Status: PX is operational
    License: Trial (expires in 29 days)
    Node ID: xxxxxxxx-xxxx-xxxx-xxxx-f929bc658862
    IP: X.X.X.28
    Local Storage Pool: 1 pool
    POOL IO_PRIORITY RAID_LEVEL USABLE USED STATUS ZONE REGION
    0 HIGH raid0 128 GiB 8.4 GiB Online default default
    Local Storage Devices: 2 devices
    Device Path Media Type Size Last-Scan
    0:0 /dev/sdf STORAGE_MEDIUM_MAGNETIC 128 GiB 20 Sep 19 19:44 UTC
    total - 128 GiB
    Cache Devices:
    Device Path Media Type Size Last-Scan
    0:1 /dev/sdc STORAGE_MEDIUM_SSD 70 GiB 20 Sep 19 19:44 UTC
    Cluster Summary
    Cluster ID: doc-cluster-caching-2.2.0
    Cluster UUID: xxxxxxxx-xxxx-xxxx-xxxx-70019d925a4a
    Scheduler: none
    Nodes: 3 node(s) with storage (3 online)
    IP ID SchedulerNodeName StorageNode UseCapacity Status StorageStatus Version Kernel OS
    X.X.X.28 xxxxxxxx-xxxx-xxxx-xxxx-f929bc658862 N/A Yes 8.4 GiB 128 GiB Online Up (This node) 2.2.0.0-328a043 4.20.13-1.el7.elrepo.x86_64 CentOS Linux 7 (Core)
    X.X.X.240 xxxxxxxx-xxxx-xxxx-xxxx-2ae648891072 N/A Yes 8.4 GiB 128 GiB Online Up 2.2.0.0-328a043 4.20.13-1.el7.elrepo.x86_64 CentOS Linux 7 (Core)
    X.X.X.32 xxxxxxxx-xxxx-xxxx-xxxx-9bf257e9973a N/A Yes 8.4 GiB 128 GiB Online Up 2.2.0.0-328a043 4.20.13-1.el7.elrepo.x86_64 CentOS Linux 7 (Core)
    Global Storage Pool
    Total Used : 25 GiB
    Total Capacity : 384 GiB
  2. Run the pxctl service pool cache status command with the id of your storage pool as a parameter:

    pxctl service pool cache status 0
    Pool ID:  0
    Enabled: true
    Members: [/dev/sdc]
    TotalBlocks: 71660
    UsedBlocks: 15
    DirtyBlocks: 0
    ReadHits: 582
    ReadMisses: 168
    WriteHits: 1157
    WriteMisses: 127
    BlockSize: 1048576
    Mode: writeback
    Policy: smq
    Tunables: migration_threshold=20480

Disable pool caching

  1. Enter pool maintenance mode:

    pxctl service pool maintenance --enter
    Pool transition operation will restart PX.
    Are you sure you want to proceed ? (Y/N): Y
    Pool transition request submitted.
  2. If your cache is running in the default writeback mode, you must flush your cache before disabling it:

    pxctl service pool cache flush <pool_id>

    The following example flushes the cache on a pool with an ID of 0:

    pxctl service pool cache flush 0
    Pool 0 has completed flush successfully
  3. Enter the pxctl service pool cache disable command, specifying the <pool_id> of the pool you want to disable caching for:

    pxctl service pool cache disable <pool_id>

    The following example disables caching for a pool with an ID of 0:

    pxctl service pool cache disable 0
    Pool 0 detached cache successfully
  4. Exit pool maintenance mode:

    pxctl service pool maintenance --exit
    Pool transition operation will restart PX.
    Are you sure you want to proceed ? (Y/N): Y
    Pool transition request submitted.
  5. At this point, you can run the pxctl service pool cache status command to see if caching is disabled:

    pxctl service pool cache status 0
    PX Cache Configuration and Status:
    Pool ID: 0
    Enabled: false
    Members: [/dev/sdc]
    TotalBlocks: 0
    UsedBlocks: 0
    DirtyBlocks: 0
    ReadHits: 0
    ReadMisses: 0
    WriteHits: 0
    WriteMisses: 0
    BlockSize: 1048576
    Mode: writeback
    Policy: smq
    Tunables: migration_threshold=20480