Chapter 5. Working with Counters

Procedure

1. Run create counter with the appropriate arguments.

   1. Create my-weak-counter.

      [//containers/default]> create counter --concurrency-level=1 --initial-value=5 --storage=PERSISTENT --type=weak my-weak-counter

   2. Create my-strong-counter.

      [//containers/default]> create counter --initial-value=3 --storage=PERSISTENT --type=strong my-strong-counter

2. List available counters.

   [//containers/default]> ls counters
   my-strong-counter
   my-weak-counter

3. Verify counter configurations.

   1. Describe my-weak-counter.

      [//containers/default]> describe counters/my-weak-counter
      
      {
          "weak-counter":{
              "initial-value":5,
              "storage":"PERSISTENT",
              "concurrency-level":1
          }
      }

   2. Describe my-strong-counter.

      [//containers/default]> describe counters/my-strong-counter
      
      {
          "strong-counter":{
              "initial-value":3,
              "storage":"PERSISTENT",
              "upper-bound":5
          }
      }

Procedure

1. Select a counter.

   [//containers/default]> counter my-weak-counter

2. List the current count.

   [//containers/default/counters/my-weak-counter]> ls
   5

3. Increment the counter value by 2.

   [//containers/default/counters/my-weak-counter]> add --delta=2

4. Decrement the counter value by -4.

   [//containers/default/counters/my-weak-counter]> add --delta=-4