Skip to main content

  • ​
    alterTier

    public AlterTierResponse alterTier(AlterTierRequest request) throws GPUdbException
    Alters properties of an existing tier to facilitate resource management.

    To disable watermark-based eviction, set both HIGH_WATERMARK and LOW_WATERMARK to 100.

    Parameters:
    request - Request object containing the parameters for the operation.
    Returns:
    Response object containing the results of the operation.
    Throws:
    GPUdbException - if an error occurs during the operation.

  • ​
    alterTier

    public AlterTierResponse alterTier(String name, Map<String,String> options) throws GPUdbException
    Alters properties of an existing tier to facilitate resource management.

    To disable watermark-based eviction, set both HIGH_WATERMARK and LOW_WATERMARK to 100.

    Parameters:
    name - Name of the tier to be altered. Must be an existing tier group name: vram, ram, disk[n], persist, cold[n].
    options - Optional parameters.
    • CAPACITY: Maximum size in bytes this tier may hold at once, per rank.
    • HIGH_WATERMARK: Threshold of usage of this tier’s resource that once exceeded, will trigger watermark-based eviction from this tier. The minimum allowed value is ‘0’. The maximum allowed value is ‘100’.
    • LOW_WATERMARK: Threshold of resource usage that once fallen below after crossing the HIGH_WATERMARK, will cease watermark-based eviction from this tier. The minimum allowed value is ‘0’. The maximum allowed value is ‘100’.
    • WAIT_TIMEOUT: Timeout in seconds for reading from or writing to this resource. Applies to cold storage tiers only.
    • PERSIST: If TRUE the system configuration will be written to disk upon successful application of this request. This will commit the changes from this request and any additional in-memory modifications. Supported values:The default value is TRUE.
    • RANK: Apply the requested change only to a specific rank. The minimum allowed value is ‘0’. The maximum allowed value is ‘10000’.
    The default value is an empty Map.
    Returns:
    Response object containing the results of the operation.
    Throws:
    GPUdbException - if an error occurs during the operation.