fccstat

Monitors the local FMS cache (FCC). By default, this utility is stored in the $FMS_HOME/bin directory. If no arguments are given fccstat reports whether FCC is online, FCC versions, and run time (if running). Syntax fccstat [-x] [-status] [-config] [-performance [cloud]] [-reconfig] [-purge] [-clear] [-restart] [-start] [-stop] [-kill] [-h] Arguments -x Displays an FCC cache statistics summary, including whole file read, whole file write, and segment cache statistics. In addition, this option displays all offline FSC connections. Offline FSC connections are those that have been attempted and failed but have not yet been restored to service. -status Displays an FCC status and statistics summary, including whole file read, whole file write, and segment cache statistics, as well as client request statistics, FSC upload and download statistics, and the currently active assigned FSC. Assigned FSCs are listed as active by default, even if they have never been used. FSC addresses that have been attempted and failed, but have not yet been restored to service, are reported as offline. -config Displays the name of the local FCC configuration file used for bootstrapping. -performance Displays statistics on network parameters such as latency and bandwidth between the current FSC and the client (FCC) it is connected to. These measurements provide an indication of the network conditions that can be used to diagnose issues with performance. Be aware that these values can vary widely based on network load, time of day, number of hops between the FCC and FSC, and so on. Therefore, the values reported using -performance should not be taken as an absolute measure of performance. Instead, use them only to troubleshoot performance issues. Use the cloud argument with -performance to report performance statistics when communicating with cloud (DSS) based volumes. The disk or cloud volume used to measure upload and download performance is arbitrary. You cannot specify a particular volume. -purge Purges all files from the FCC cache, including the segment cache extent files. -clear Purges the cache completely. This removes all data but retains the segment cache extent files. -reconfig Reloads the FCC configuration. Use this option to update a running FCC with changes made to the local FCC XML configuration files. -restart Stops (if running) and restarts the FCC, effectively reloading the configuration. Environment variables still override any configuration file settings or changes. -start Starts the FCC if it is not already started. -stop Shuts down the FCC process immediately if no other clients are connected or if all connected clients are idle. Otherwise, a warning message is displayed. -kill Immediately and unconditionally shuts down the FCC process. -h Displays help for this utility. Help can be localized if the FCC is running. Environment As specified in Setting up a Teamcenter command-line environment and the following: The FMS_HOME variable must be set to a valid FMS server directory. The JAVA_HOME variable must be set to a valid Java SDK directory. FCC must be running. This command must be run in an FMS operating environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples To determine whether the FCC is running, run the fccstat command. For example: Copy TC_ROOT\tccs>fccstat Example output: Copy fccstat: FCC offline. To display help for this utility and a statistic summary, run the fccstat command with the status argument. For example: Copy TC_ROOT\tccs>>fccstat -? -x -status fccstat -?: Example output: Copy FMS Client Cache Status Utility fccstat command line options: no options Display FCC component versions and execution time. -help Display this help message. -h Display this help message. -? Display this help message. -x Display FCC status summary. -status Display complete FCC status. -config Display FCC configuration filename. -purge Clear the FCC Cache and remove extents. -clear Clear the FCC Cache and retain extents. -remove (UID) Remove a UID from the FCC Cache. -restart Stop and restart the FCC. -stop Stop the FCC if no clients are connected. -kill Stop the FCC even if clients are connected. fccstat -x: Cache: segment: 1 files, 507904 bytes. read: 38 files, 268433410 bytes. write: 0 files, 0 bytes. Servers: 0 files downloaded. Active assigned FSC is 'http://127.0.0.1:4444/' fccstat -status: Cache: segment: 1 files, 507904 bytes, 0 hits, 0 misses. read: 38 files, 268433410 bytes, 0 hits, 0 misses. write: 0 files, 0 bytes. Clients: 3 Client connections established. 6 Client request messages processed. 5 Client response messages processed. 0 Client status messages processed. 0 Client error messages processed. Servers: 0 segments downloaded. 0 files downloaded. 0 files uploaded. Active assigned FSC is 'http://127.0.0.1:4444/' To display the name of the local FCC configuration file and clear the cache, run the fccstat command with the clear argument. For example: Copy TC_ROOT\tccs>>fccstat -config -clear Example output: Copy fccstat -config: Z:\pkmvob1\fms\build\install\fms/fcc.xml fccstat -clear: Cache cleared. To purge a UID from the cache, run the fccstat command with the remove argument. For example: Copy TC_ROOT\tccs>fccstat -remove abcd1234fedc9876ef005678ba005432 Example output: Copy fccstat -remove: UID abcd1234fedc9876ef005678ba005432 has been removed from Copy the FCC Cache. To stop the FCC, run the fccstat command with the stop argument. For example: Copy TC_ROOT\tccs>>fccstat -stop Example output: Copy fccstat -stop: FCC Stopped. To restart the FCC, run the fccstat command with the restart argument. For example: Copy TC_ROOT\tccs>>fccstat -restart Example output: Copy fccstat -restart: FCC Started. To shut down the FCC process immediately when no clients are connected or all clients are idle, run the fccstat command with the stop argument. For example: Copy TC_ROOT\tccs>>fccstat -stop Example output: Copy fccstat -stop: FCC Stopped. To kill the FCC, run the fccstat command with the kill argument. For example: Copy TC_ROOT\tccs>>fccstat -kill Example output: Copy fccstat -kill: FCC Stopped. To print an FCC status and statistics summary, including whole file read, whole file write, and segment cache statistics, as well as client request statistics, FSC upload and download statistics, and the currently assigned FSC, run the fccstat command with the status argument. For example: Copy TC_ROOT\tccs>fccstat -status Example output: Copy fccstat -status: Cache: segment: 19 files, 52854784 bytes, 590722 hits, 1781 misses. read: 19 files, 134216705 bytes, 106253 hits, 38 misses. write: 0 files, 0 bytes. Clients: 5 Client connections established. 388741 Client request messages processed. 392284 Client response messages processed. 79 Client status messages processed. 1 Client error messages processed. Servers: 839 segments downloaded. 19 files downloaded. 0 files uploaded. Active assigned FSC is 'http://127.0.0.1:4444/' Entering fccstat -reconfig and the operation is successful returns the following message: Copy FCC successfully reconfigured. Entering fccstat -reconfig and the operation is not successful returns the following message: Copy FCC reconfiguration failed: Cannot reconfigure FCC pipe name.