Command

This command sets the value of a parameter.

  • If the parameter type is Dynamic, the set operation is committed, and the value is updated immediately.
  • If the parameter type is Static, the set operation will be logged by parman but not committed immediately. 
    • The user can continue to set additional parameter values.
  • Finally, when the user issues the update-parameters command, all changed static parameters will be updated and the component restarted.


[admin]$ python3 parman.py set-parameter -h

usage: parman.py set-parameter [-h] -c {IOF,DRVA,Domain,RocVA} [-n COMPNAME]

-pn PARAMNAME -pv PARAMVAL


optional arguments:

-h, --help

    Show this help message and exit

-c {IOF,DRVA,Domain,RocVA}, --component-type {IOF,DRVA,Domain,RocVA}

    Type of component

-n COMPNAME, --component-name COMPNAME

    Name of the component. E.g. If --component-type is DRVA, then name of specific DRVA

-pn PARAMNAME, --parameter-name PARAMNAME

    Name of the parameter

-pv PARAMVAL, --parameter-value PARAMVAL

    Value of the parameter to be set. Note that specifying keyword 'default' resets the value to default


[admin]$


The set-parameter sub-command requires the component name, parameter name and parameter value as input.

-n COMPNAME

    Name of the component. E.g. If --component-type is DRVA, then name of specific DRVA

-p PARAMNAME

    Name of the parameter whose value has to be set

-pv PARAMVAL

    Value of the parameter to be set. Note that specifying keyword 'default' resets the value to default


NOTE: The parameter value “default” can be used restore the value of some parameters to their default setting specified by the system.


Examples

Dynamic Parameter

[admin]$ python3 parman.py -m 10.40.1.150 -vi fs161v08-vc.st.jsoft.com -vu [email protected] -vp xxxxx set-parameter -c Domain 

-n mg_domain1 -pn inflightGcThreshold -pv 12


[admin]$ python3 parman.py -m 10.40.1.150 -vi fs161v08-vc.st.jsoft.com -vu [email protected] -vp xxxxx get-parameters -c Domain -n mg_domain1

Name                   Value               Unit    Type        Component   Component Name  Default    Range

---------------------  ------------------  ------  ----------  ----------  --------------  ---------  -------------------------------

accessKey              minio               -       Hard-coded  Domain      mg_domain1      -          -

allocatedGcBudget      512.00              KB/sec  Hard-coded  Domain      mg_domain1      0.0        -

bitmapConcurrency      1                   -       Dynamic     Domain      mg_domain1      32         -

btreeCacheSize         256.00              MB      Static      Domain      mg_domain1      128.00     -

bucket                 jetdr-dom-5d77afdc  -       Hard-coded  Domain      mg_domain1      -          -

                       -99e4-11eb-a409-00

                       505684db87-1618049

                       166465

bucketRegion                               -       Hard-coded  Domain       mg_domain1     -          -

chanType               S3                  -       Hard-coded  Domain       mg_domain1     S3         [ESX, S3, Azure, DRVA]

compressAlg            zstd                -       Hard-coded  Domain       mg_domain1     none       [none, zstd, zlib]

compressLevel          3                   -       Hard-coded  Domain       mg_domain1     -          [0..9 for zlib, 0..22 for zstd]

endPoint               10.40.3.24:9000     -       Hard-coded  Domain       mg_domain1     -          -

gcCheckpointThreshold  1.00                GB      Dynamic     Domain       mg_domain1     1.00       [1GB..50GB]

gcClassification       False               -       Hard-coded  Domain       mg_domain1     False      [true, false]

hotTrafficPercent      80                  -       Hard-coded  Domain       mg_domain1     80         [0..100]

inflightGcThreshold    12                  -       Dynamic     Domain       mg_domain1     10         -

maxGcFrequencyPerSec   64                  -       Dynamic     Domain       mg_domain1     64         [1..10000]

maxInflightObjIdDiff   1024                -       Static      Domain       mg_domain1     1024       [1024..2048]

numObjs                64                  -       Static      Domain       mg_domain1     14         [0..128]

objSize                4.00                MB      Hard-coded  Domain       mg_domain1     4.00       [4MB]

protocol               http                -       Hard-coded  Domain       mg_domain1     https      [http, https]

readerBufferSize       128.00              MB      Static      Domain       mg_domain1     700.00     [700MB - 1GB]

replicationRate        100.00              GB/sec  Dynamic     Domain       mg_domain1     100.00     -

scheduledRereadsThres  1000                -       Dynamic     Domain       mg_domain1     1000       -

hold

secretKey              ********            -       Hard-coded  Domain       mg_domain1     -          -

verifySSL              False               -       Hard-coded  Domain       mg_domain1     -          [true, false]


[admin]$ python3 parman.py -m fs057-ms3.st.jsoft.com -vi fs175-psc.st.jsoft.com -vu [email protected] -vp xxxxx set-parameter 

-c RocVA -n mg_domain2 -pn objStorFailureTimeoutSec -pv 900


[admin]$ python3 parman.py -m fs057-ms3.st.jsoft.com -vi fs175-psc.st.jsoft.com -vu [email protected] -vp xxxxx get-parameters 

-c RocVA

Name                   Value               Unit    Type        Component   Component Name  Default    Range

---------------------  ------------------  ------  ----------  ----------  --------------  ---------  -------------------------------

accessKey              minio               -       Hard-coded  RocVA       mg_domain2      -          -

activeWatermarkLag     256.00              KB      Hard-coded  RocVA       mg_domain2      256.00     [256KB..]

bucket                 jetdr-dom-b0b55973  -       Hard-coded  RocVA       mg_domain2      -          -

                       -99e4-11eb-a409-00

                       505684db87-1618049

                       306120

bucketRegion                               -       Hard-coded  RocVA       mg_domain2      -          -

diskWriteErrorTimeout  300                 Seconds Dynamic     RocVA       mg_domain2      300        -

Sec     

domainId               00000104000000005b  -       Hard-coded  RocVA       mg_domain2      -          -

                       cac5afa47d3900

downloadResumeDelay    30                  -       Dynamic     RocVA       mg_domain2      30         -

Sec

downloadResumeSeqNum   8192                -       Dynamic     RocVA       mg_domain2      8192       -

Delta 

downloadSuspendObject  2000                -       Dynamic     RocVA       mg_domain2      2000       -

IdLag 

endPoint               10.40.3.24:9000     -       Hard-coded  RocVA       mg_domain2      -          -

getHighestObjectId     300                 Seconds Hard-coded  RocVA       mg_domain2      300        -

FrequencySec    

limitingObjectId       0                   -       Hard-coded  RocVA       mg_domain2      0          -

lowerBufAllocResume    3500                -       Dynamic     RocVA       mg_domain2      3500       -

PerDiskCount   

lowerBufAllocResume    15                  -       Dynamic     RocVA       mg_domain2      15         [0..100]

Percent

lowerBufAllocSuspend   5000                -       Dynamic     RocVA       mg_domain2      5000       -

PerDiskCount

lowerBufAllocSuspend   20                  -       Dynamic     RocVA       mg_domain2      20         [0..100]

Percent

minNumBufs             32                  -       Hard-coded  RocVA       mg_domain2      32         -

mode                   continuous          -       Hard-coded  RocVA       mg_domain2      default    [continuous, default]

objStorFailureTimeout  900                 Seconds Dynamic     RocVA       mg_domain2      300        -

Sec

protocol               http                -       Hard-coded  RocVA       mg_domain2      https      [http, https]

recentObjTimestamp     1800                Seconds Dynamic     RocVA       mg_domain2      1800       -

LagSec

secretKey              *******             -       Hard-coded  RocVA       mg_domain2      -          -

startGcCheckpoint      0                   -       Hard-coded  RocVA       mg_domain2      0          -

ObjectId 

startObjectId          0                   -       Hard-coded  RocVA       mg_domain2      0          -

startSeqNum            0                   -       Hard-coded  RocVA       mg_domain2      0          -

testRecoveryTo                             -       Hard-coded  RocVA       mg_domain2      -          -

useLimitingObject      False               -       Hard-coded  RocVA       mg_domain2      False      [true, false]

verifySSL                                  -       Hard-coded  RocVA       mg_domain2      -          [true, false]

logLevel               9                   -       Dynamic     RocVA       mg_domain2      4          [1..9]


[admin]$


Static Parameter

[admin]$ python3 parman.py -m 10.40.1.150 -vi fs161v08-vc.st.jsoft.com -vu [email protected] -vp xxxxx set-parameter -c DRVA

-n drva1 -pn CPU -pv 8


[admin]$ python3 parman.py -m 10.40.1.150 -vi fs161v08-vc.st.jsoft.com -vu [email protected] -vp xxxxx set-parameter -c DRVA 

-n drva1 -pn Memory -pv 16gb


[admin]$ python3 parman.py -m 10.40.1.150 -vi fs161v08-vc.st.jsoft.com -vu [email protected] -vp xxxxx get-parameters -c DRVA

Name                   Value               Unit    Type        Component   Component Name  Default    Range

---------------------  ------------------  ------  ----------  ----------  --------------  ---------  -------------------------------

CPU                    4                   -       Static      DRVA        drva1           4          [4..8]

Memory                 8                   GB      Static      DRVA        drva1           8          [8GB..16GB]

logLevel               7                   -       Dynamic     DRVA        drva1           4          [1..9]


[admin]$


NOTE: the change will take place in the update-parameters command.