TCache Tools

This chapter describes TCache management tools.

1. pfmtcacheadmin

Creates, initializes, deletes, and monitors TCache and checks a caching report about data recorded from the initialization to the current period of time.

  • Usage

    $ pfmtcacheadmin [-s] [-S [sec]] [-c] [-d] [-r] [-R [sec]] [-C [sec]]
                 [-U ALL] [-u [cacheName]] [-t] [-i[cacheName]]
    Option Description

    [-s]

    Reports TCache information such as memory usage, TCache status, and cache hit and miss counts.

    For TCache performance, keep the Avg List value less than 6. You can decrease the value by increasing the SIZE_HASH value.

    [-S [sec]]

    Same as the -s option (periodically executed).

    [-c]

    Starts TCache. If TCache already exists in shared memory, no operation is performed.

    [-d]

    Deletes TCache from shared memory. Only the user who created the TCache (by executing "pfmtcacheadmin -c") can use this option.

    [-r]

    Recreates TCache. Same as using the -d and -c options.

    [-R [sec]]

    Recreates TCache if there is a lock that is not released in TCache (periodically executed).

    [-C [sec]]

    Checks whether there is a lock that is not released in TCache (periodically executed).

    [-U ALL]

    Releases all TCache locks.

    [-u [cacheName]]

    Releases locks of TCache with the specified name.

    [-t ]

    Keeps cache data stored in TCache and temporarily disables TCache APIs. To enable the TCache APIs, use this option again.

    [-i [cacheName]]

    Initializes specific TCache data when multiple caches are used. cacheName is CACHE_NAME defined in pfmtcache.cfg.

  • Examples

    • [-c]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacheadmin -c
TCACHE ver. 2.3.6
ERROR : TCACHE is already created.

    • [-d]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacheadmin -d
TCACHE ver. 2.3.6
This will delete TCACHE. Are you sure? [y/N] y
TCACHE deleted successfully.

    • [-r]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacheadmin -r
TCACHE ver. 2.3.6
This will clear and initialize all TCACHE contents. Are you sure? [y/N] y
The previous TCACHE removed successfully
New TCACHE initialized successfully.

    • [-t]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacheadmin -t
TCACHE ver. 2.3.6
TCACHE status changed to NO ACCESS.

    • [-i [cacheName]]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacheadmin -i PFM_SVC
TCACHE ver. 2.3.6
This will invalidate all contents in PFM_SVC. Are you sure? [y/N] y

    • [-s]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacheadmin -s
TCACHE ver. 2.3.6
Reporting TCACHE statistics. [SHMKEY = 0x70056]
version = 2.3.6
# of cache object = 8
status = AVAILABLE
local cache size = 10485760 bytes
Invalidate Type = 0
Tcache Agent Service =

CACHE_NAME  = PFM_SVC
SIZE_MEM    = 6710272 bytes
SIZE_HASH   = 1024 hash lists
SIZE_KEY    = 30 digits
SIZE_REC    = 2048 bytes per single record
INV_TIMEOUT = 10 sec.
USE HASH_FREE_LIST = 0
USE SEM LOCK = 0
Total # of slots         = 2941 slots
Total # of used slots    = 8 slots
Total # of free slots    = 2933 slots
Total # of GET req. (hit, miss, lock-fail)      = 0 (0, 0, 0) times
Total # of PUT req. (repl, out-mem, lock-fail)  = 8 (0, 0, 0) times
Total # of INV req. (lock-fail)                 = 0 (0) times
Total # of null-list.                           = 1016 lists(Avg List : 1.00)

CACHE_NAME  = PFM_SVC_EXT
SIZE_MEM    = 6710272 bytes
SIZE_HASH   = 1024 hash lists
SIZE_KEY    = 30 digits
SIZE_REC    = 2048 bytes per single record
INV_TIMEOUT = 10 sec.
USE HASH_FREE_LIST = 0
USE SEM LOCK = 0
Total # of slots         = 2941 slots
Total # of used slots    = 7 slots
Total # of free slots    = 2934 slots
Total # of GET req. (hit, miss, lock-fail)      = 0 (0, 0, 0) times
Total # of PUT req. (repl, out-mem, lock-fail)  = 7 (0, 0, 0) times
Total # of INV req. (lock-fail)                 = 0 (0) times
Total # of null-list.                           = 1017 lists(Avg List : 1.00)
.
.
.

2. pfmtcachebackup

Backs up TCache data loaded in shared memory.

  • Usage

    $ pfmtcachebackup -t [ALL | ITEM_NAME | PFM_*]
    Option Description

    -t ALL

    Backs up all data.

    -t [ITEM_NAME]

    Backs up specific data.

    -t PFM_*

    Backs up data that matches the wildcard character (*).

  • Examples

    • [ -t ALL]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcachebackup -t ALL
================= START TCACHE UNLOAD[PFM_SVC]
===================================================
    Successfully Finished
===================================================
 UNLOAD TCACHE NAME : [PFM_SVC]
 START         TIME : [2013-07-04 09:38:38]
 END           TIME : [2013-07-04 09:38:38]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC]
 TOTAL         CNT  : [         8]
 SUCCESS       CNT  : [         8]
 FAIL          CNT  : [         0]
===================================================

================= START TCACHE UNLOAD[PFM_SVC_EXT]
===================================================
    Successfully Finished
===================================================
 UNLOAD TCACHE NAME : [PFM_SVC_EXT]
 START         TIME : [2013-07-04 09:38:38]
 END           TIME : [2013-07-04 09:38:38]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC_EXT]
 TOTAL         CNT  : [         7]
 SUCCESS       CNT  : [         7]
 FAIL          CNT  : [         0]
===================================================
.
.
.

    • [-t PFM_SVC]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcachebackup -t PFM_SVC
================= START TCACHE UNLOAD[PFM_SVC]
===================================================
    Successfully Finished
===================================================
 UNLOAD TCACHE NAME : [PFM_SVC]
 START         TIME : [2013-07-04 09:39:06]
 END           TIME : [2013-07-04 09:39:06]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC]
 TOTAL         CNT  : [         8]
 SUCCESS       CNT  : [         8]
 FAIL          CNT  : [         0]
===================================================

    • [-t PFM_*]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcachebackup -t PFM_*
================= START TCACHE UNLOAD[PFM_SVC]
===================================================
    Successfully Finished
===================================================
 UNLOAD TCACHE NAME : [PFM_SVC]
 START         TIME : [2013-07-04 09:39:29]
 END           TIME : [2013-07-04 09:39:29]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC]
 TOTAL         CNT  : [         8]
 SUCCESS       CNT  : [         8]
 FAIL          CNT  : [         0]
===================================================

================= START TCACHE UNLOAD[PFM_SVC_EXT]
===================================================
    Successfully Finished
===================================================
 UNLOAD TCACHE NAME : [PFM_SVC_EXT]
 START         TIME : [2013-07-04 09:39:29]
 END           TIME : [2013-07-04 09:39:29]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC_EXT]
 TOTAL         CNT  : [         7]
 SUCCESS       CNT  : [         7]
 FAIL          CNT  : [         0]
===================================================
.
.
.

3. pfmtcacherestore

Loads a backup file data as TCache data.

  • Usage

    $ pfmtcacherestore -d [Date : YYYYMMDD] -t [ALL | ITEM_NAME | PFM_*]
    Option Description

    -d [Date : YYYYMMDD]

    Loads backup files created on the specified backup date.

    -t ALL

    Loads all data in backup files.

    -t [ITEM_NAME]

    Loads specific data in backup files.

    -t PFM_*

    Loads backup files that match the wildcard character (*).

  • Examples

    • -d [YYYYMMDD] -t ALL

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacherestore -d 20130704 -t ALL
============>[8]
================= START TCACHE LOAD[PFM_SVC]
===================================================
    Successfully Finished
===================================================
 LOAD   TCACHE NAME : [PFM_SVC]
 START         TIME : [2013-07-04 09:40:10]
 END           TIME : [2013-07-04 09:40:10]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC]
 TOTAL         CNT  : [         8]
 SUCCESS       CNT  : [         8]
 FAIL          CNT  : [         0]
===================================================

================= START TCACHE LOAD[PFM_SVC_EXT]
===================================================
    Successfully Finished
===================================================
 LOAD   TCACHE NAME : [PFM_SVC_EXT]
 START         TIME : [2013-07-04 09:40:10]
 END           TIME : [2013-07-04 09:40:10]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC_EXT]
 TOTAL         CNT  : [         7]
 SUCCESS       CNT  : [         7]
 FAIL          CNT  : [         0]
===================================================
.
.
.

    • -d [YYYYMMDD] -t [ITEM_NAME]

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacherestore -d 20130704 -t PFM_SVC
============>[8]
================= START TCACHE LOAD[PFM_SVC]
===================================================
    Successfully Finished
===================================================
 LOAD   TCACHE NAME : [PFM_SVC]
 START         TIME : [2013-07-04 09:41:44]
 END           TIME : [2013-07-04 09:41:44]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC]
 TOTAL         CNT  : [         8]
 SUCCESS       CNT  : [         8]
 FAIL          CNT  : [         0]
==================================================

    • -d [YYYYMMDD] -t -t PFM_*

      [midas:/home/midas/proframe5.0/package/proframe/pfm/bin]$ pfmtcacherestore -d 20130704 -t PFM_*
============>[8]
================= START TCACHE LOAD[PFM_SVC]
===================================================
    Successfully Finished
===================================================
 LOAD   TCACHE NAME : [PFM_SVC]
 START         TIME : [2013-07-04 09:40:33]
 END           TIME : [2013-07-04 09:40:33]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC]
 TOTAL         CNT  : [         8]
 SUCCESS       CNT  : [         8]
 FAIL          CNT  : [         0]
===================================================

================= START TCACHE LOAD[PFM_SVC_EXT]
===================================================
    Successfully Finished
===================================================
 LOAD   TCACHE NAME : [PFM_SVC_EXT]
 START         TIME : [2013-07-04 09:40:33]
 END           TIME : [2013-07-04 09:40:33]
---------------------------------------------------
 WRITE   FILE  NAME : [./20130704/PFM_SVC_EXT]
 TOTAL         CNT  : [         7]
 SUCCESS       CNT  : [         7]
 FAIL          CNT  : [         0]
===================================================
.
.
.