Doc:latest/sdkguide/commandref - Revision history

Stone: /* Logging */

2016-08-25T21:17:09Z

‎Logging

Stone: undo spam

2014-10-29T01:09:25Z

undo spam

Stone: Reverted edits by MediaWiki spam cleanup (talk) to last revision by 176.8.88.41

2014-10-29T01:07:37Z

Reverted edits by MediaWiki spam cleanup (talk) to last revision by 176.8.88.41

MediaWiki spam cleanup: Reverting to last revision not containing links to www.buyxanaxitem.com

2012-02-21T03:50:04Z

Reverting to last revision not containing links to www.buyxanaxitem.com

MediaWiki spam cleanup: Reverting to last revision not containing links to www.buyxanaxonlinepill.com

2012-02-21T03:48:24Z

Reverting to last revision not containing links to www.buyxanaxonlinepill.com

MediaWiki spam cleanup: Reverting to last revision not containing links to www.buyxanaxitem.com

2012-02-21T03:23:51Z

Reverting to last revision not containing links to www.buyxanaxitem.com

176.8.88.41: wVwEleARIzw

2012-02-20T09:09:11Z

wVwEleARIzw

176.8.90.7: /* SAFplus Platform Command Line and Environment Variable Reference */

2012-02-11T15:12:33Z

‎SAFplus Platform Command Line and Environment Variable Reference

Show changes

Bot: 1 revision

2011-10-24T19:05:00Z

1 revision

Senthilk at 04:11, 27 August 2010

2010-08-27T04:11:30Z

New page

==SAFplus Platform Command Line and Environment Variable Reference==

===Environment Variables===

====Variables controlling automatic restart or reboot of SAFplus Platform or Node====
* '''ASP_RESTART_SAFplus''' -- If set to 1 will restart SAFplus Platform in case AMF crashed or SAFplus Platform was not able to come up for some reason, if set to 0 will not restart SAFplus Platform. Default value is 1.
* '''ASP_NODE_REBOOT_DISABLE''' --
* '''ASP_NODE_RESTART''' --

<br>
This table describes the interaction between the various SAFplus Platform restart and reboot variables:
{| border="0" cellpadding="3"
|- style="color:#ffffff; background:#549cc6"
!style="color:#66b154; background:#09477c"| ASP_NODE_REBOOT_DISABLE
!style="color:#66b154; background:#09477c"| ASP_RESTART_SAFplus Platform
!style="color:#66b154; background:#09477c"| ASP_NODE_RESTART
!style="color:#66b154; background:#09477c"| Action taken
|- style="color:#ffffff; background:#549cc6"
| undefined
| undefined
| undefined
| reboot
|- style="color:#ffffff; background:#549cc6"
| 1
| undefined
| undefined
| Restart SAFplus Platform
|- style="color:#ffffff; background:#549cc6"
| 1
| 0
| undefined
| SAFplus Platform stopped
|- style="color:#ffffff; background:#549cc6"
| 1
| 0
| 1
| Restart SAFplus Platform
|}

====Cluster Membership Configuration (GMS)====
* '''CL_LEADER_NODE_ID''' --
* '''LINK_NAME''' -- This tells SAFplus Platform which Network Interface (ex. eth0, bind0, lo, etc.) to be used for communication with other SAFplus Platform's on same/other nodes.
* '''ASP_MULTINODE''' -- This environment variable must be used, when multiple SAFplus Platform's are to be run on single machine. Then user must export this environment variable before starting each of SAFplus Platform's.

====ValGrind====
* '''ASP_VALGRIND_FILTER''' --
* '''ASP_VALGRIND_CMD''' --

====Logging====

* '''ASP_LOG_FILTER_DIR''' -- place where log filter file should be present. It should be named logfilter.txt. Default value /tmp
* '''CL_LOG_SEVERITY''' -- Environment variable used to set the log filter. You can export this env variable to any log severity like DEBUG, INFO, NOTICE, ERROR, etc. Note that setting of this env variable has higher priority than the log filter file explained above.
* '''CL_LOG_CODE_LOCATION_ENABLE''' -- Environment variable if set to 1, will show the file name, function name and line number when displaying logs. Default value is 0.
* '''CL_LOG_TO_FILE'''
* '''CL_LOG_STREAM_ENABLE'''
* '''CL_LOG_TIME_ENABLE'''
* '''CL_LOG_DEBUG_LEVEL''' (clLogDebug.c)
* '''ASP_SAVE_PREV_LOGS''' -- if set to 1 will save logs in the sandbox from the previous run of SAFplus Platform (if any) during SAFplus Platform startup into location specified by the environment variable ASP_PREV_LOG_DIR or to /tmp/asp_saved_logs, creating the directory if necessary. If set to 0, the logs will deleted. Default value is 1.
* '''ASP_PREV_LOG_DIR''' -- place where logs of previous SAFplus Platform run will be stored. Default value is /tmp/asp_saved_logs
* '''AMS_DEBUG''' -- Enable special availability management framework console logging. This occurs outside of the normal log infrastructure since the AMF process manages the logging process.
* '''AMS_NOTIFICATION_DEBUG''' --
* '''CPM_LOG_FILE_SIZE''' --
* '''CPM_LOG_FILE_ROTATIONS''' --
* '''ASP_CPM_LOGFILE''' --

====Miscellaneous====
* '''ASP_RMD_METRIC''' --
* '''CL_TXN_DSBLE_CKPT''' --
* '''CL_HEAP_DEBUG''' --
* '''CL_MEM_TIME''' --
* '''ASP_WITHOUT_CPM''' --
* '''CL_NODE_REPRESENTATIVE''' --
* '''ASP_DB_SYNC''' --

====Debugging====
* '''CL_DEBUG_PAUSE''' --
* '''CL_DEBUG_PAUSE_CODE_ERROR''' --
* '''CL_DEBUG_COMP_NO_KILL''' --
* '''CL_DEBUG_COMP_TIMEOUT_OVERRIDE''' --
* '''CL_DEBUG_LOG_LEVEL''' --
* '''CL_DEBUG_RESOURCE_LOG_LEVEL''' --
* '''CL_DEBUG_REVERSE_TIMING''' --

====Intra-Cluster Message Traffic Shaping====
OpenClovis SAFplus Platform optionally uses a well known traffic shaping algorithm to modulate intracluster traffic. This is very useful if the internal communications between your applications can potentially overwhelm an application with requests. But if your application's inter-communication is designed to ensure that this cannot happen then the traffic shaping is not needed. By default (compile time) it is off.

These environment variables can be used to override the default leaky bucket intra-cluster message shaping parameters.
* '''CL_LEAKY_BUCKET_VOL''' -- Leaky bucket volume in bytes
* '''CL_LEAKY_BUCKET_LEAK_SIZE''' -- Leaky bucket removal in bytes
* '''CL_LEAKY_BUCKET_LEAK_INTERVAL''' -- How often the leak occurs in milliSeconds

===Environment Variables Set by OpenClovis SAFplus Platform===
These variables are available for use in your application:

====Locations====
Note these environment variables have equivalent "C" global variables (defined in clEoApi.h) which are recommended over using the environment variable directly.

* '''ASP_NODENAME''' -- The name of the node (as defined in the SAF AMF model)
* '''ASP_COMPNAME''' -- The name of this component (as defined in the SAF AMF model)
* '''ASP_RUNDIR''' -- The "current working directory" SAFplus Platform runs from
* '''ASP_LOGDIR''' -- The SAFplus Platform log directory
* '''ASP_BINDIR''' -- The location of SAFplus Platform binaries
* '''ASP_APP_BINDIR''' -- The location of the program binary. This is often, but not always the same as ASP_BINDIR.
* '''ASP_CONFIG''' -- Directory of the SAFplus Platform configuration files (normally <asp install dir>/etc)
* '''ASP_CPM_CWD''' -- The current working directory to use for SAFplus Platform and programs started by SAFplus Platform (defaults to var/run)
* '''ASP_DBDIR''' -- The location the SAFplus Platform stores its database files

===Starting and Stopping SAFplus Platform: <aspDir>/etc/init.d/asp===
Usage : asp {start|stop|restart|console|status|zap|help} [options]

options can be one of the following : (these options only work with start command, e.g. etc/init.d/asp start -v etc.)

-v : Be verbose
--enforce-tipc-settings : Use etc/asp.conf's TIPC settings overriding the system TIPC settings
--ignore-tipc-settings : Use systems TIPC settings ignoring the etc/asp.conf's settings
--remove-persistent-db : Delete all of the SAFplus Platform persistent database files
--asp-log-level <level> : Start SAFplus Platform with particular log level. <level> is [trace|debug|info|notice|warning|error|critical]

===CLI===

====bin/asp_console====
SAFplus Platform console is a comprehensive CLI for examination and debugging of the SAFplus Platform system. SAFplus Platform console documentation is available as a separate document.

Start:
<aspDir>/etc/init.d/asp console
or
<aspDir>/bin/asp_console

====bin/asp_info====
The SAFplus Platform info CLI is a simple interface for display of SAFplus Platform status and basic control

<aspDir>/bin/asp_info

===Directly running a component: bin/asp_run===

← Older revision		Revision as of 01:07, 29 October 2014
Line 1:		Line 1:
−	http://www.~~buyxanaxonlinepill~~.com/ ~~cheap~~ xanax ~~without a prescription~~ - xanax ~~online no prescription~~	+	http://www.buyxanaxitem.com/ xanax to buy - xanax

← Older revision		Revision as of 03:50, 21 February 2012
Line 1:		Line 1:
−	http://www.~~buyxanaxitem~~.com/ xanax ~~to buy~~ - xanax	+	http://www.buyxanaxonlinepill.com/ cheap xanax without a prescription - xanax online no prescription

← Older revision		Revision as of 03:48, 21 February 2012
Line 1:		Line 1:
−	http://www.~~buyxanaxonlinepill~~.com/ ~~cheap~~ xanax ~~without a prescription~~ - xanax ~~online no prescription~~	+	http://www.buyxanaxitem.com/ xanax to buy - xanax

← Older revision		Revision as of 03:23, 21 February 2012
Line 1:		Line 1:
−	http://www.~~buyxanaxitem~~.com/ xanax ~~to buy~~ - xanax	+	http://www.buyxanaxonlinepill.com/ cheap xanax without a prescription - xanax online no prescription

← Older revision		Revision as of 09:09, 20 February 2012
Line 1:		Line 1:
−	http://www.~~buyxanaxonlinepill~~.com/ ~~cheap~~ xanax ~~without a prescription~~ - xanax ~~online no prescription~~	+	http://www.buyxanaxitem.com/ xanax to buy - xanax

@@ Line 53: / Line 53: @@
 * '''CL_LOG_SEVERITY''' -- Environment variable used to set the log filter. You can export this env variable to any log severity like DEBUG, INFO, NOTICE, ERROR, etc. Note that setting of this env variable has higher priority than the log filter file explained above.
 * '''CL_LOG_CODE_LOCATION_ENABLE''' -- Environment variable if set to 1, will show the file name, function name and line number when displaying logs. Default value is 0.
-* '''CL_LOG_TO_FILE'''
+* '''CL_LOG_TO_FILE''' -- sends all logs to a file or stdout.  Very useful when debugging issues that occur before the SAFplus log server is up
 * '''CL_LOG_STREAM_ENABLE'''
 * '''CL_LOG_TIME_ENABLE'''

← Older revision		Revision as of 01:09, 29 October 2014
Line 1:		Line 1:
−	~~http~~://~~www~~.~~buyxanaxitem~~.~~com~~/ ~~xanax~~ to ~~buy~~ - ~~xanax~~	+	==SAFplus Platform Command Line and Environment Variable Reference==
		+
		+	===Environment Variables===
		+
		+
		+	====Variables controlling automatic restart or reboot of SAFplus Platform or Node====
		+	* '''ASP_RESTART_SAFplus''' -- If set to 1 will restart SAFplus Platform in case AMF crashed or SAFplus Platform was not able to come up for some reason, if set to 0 will not restart SAFplus Platform. Default value is 1.
		+	* '''ASP_NODE_REBOOT_DISABLE''' --
		+	* '''ASP_NODE_RESTART''' --
		+
		+	<br>
		+	This table describes the interaction between the various SAFplus Platform restart and reboot variables:
		+	{\| border="0" cellpadding="3"
		+	\|- style="color:#ffffff; background:#549cc6"
		+	!style="color:#66b154; background:#09477c"\| ASP_NODE_REBOOT_DISABLE
		+	!style="color:#66b154; background:#09477c"\| ASP_RESTART_SAFplus Platform
		+	!style="color:#66b154; background:#09477c"\| ASP_NODE_RESTART
		+	!style="color:#66b154; background:#09477c"\| Action taken
		+	\|- style="color:#ffffff; background:#549cc6"
		+	\| undefined
		+	\| undefined
		+	\| undefined
		+	\| reboot
		+	\|- style="color:#ffffff; background:#549cc6"
		+	\| 1
		+	\| undefined
		+	\| undefined
		+	\| Restart SAFplus Platform
		+	\|- style="color:#ffffff; background:#549cc6"
		+	\| 1
		+	\| 0
		+	\| undefined
		+	\| SAFplus Platform stopped
		+	\|- style="color:#ffffff; background:#549cc6"
		+	\| 1
		+	\| 0
		+	\| 1
		+	\| Restart SAFplus Platform
		+	\|}
		+
		+	====Cluster Membership Configuration (GMS)====
		+	* '''CL_LEADER_NODE_ID''' --
		+	* '''LINK_NAME''' -- This tells SAFplus Platform which Network Interface (ex. eth0, bind0, lo, etc.) to be used for communication with other SAFplus Platform's on same/other nodes.
		+	* '''ASP_MULTINODE''' -- This environment variable must be used, when multiple SAFplus Platform's are to be run on single machine. Then user must export this environment variable before starting each of SAFplus Platform's.
		+
		+	====ValGrind====
		+	* '''ASP_VALGRIND_FILTER''' --
		+	* '''ASP_VALGRIND_CMD''' --
		+
		+	====Logging====
		+
		+	* '''ASP_LOG_FILTER_DIR''' -- place where log filter file should be present. It should be named logfilter.txt. Default value /tmp
		+	* '''CL_LOG_SEVERITY''' -- Environment variable used to set the log filter. You can export this env variable to any log severity like DEBUG, INFO, NOTICE, ERROR, etc. Note that setting of this env variable has higher priority than the log filter file explained above.
		+	* '''CL_LOG_CODE_LOCATION_ENABLE''' -- Environment variable if set to 1, will show the file name, function name and line number when displaying logs. Default value is 0.
		+	* '''CL_LOG_TO_FILE'''
		+	* '''CL_LOG_STREAM_ENABLE'''
		+	* '''CL_LOG_TIME_ENABLE'''
		+	* '''CL_LOG_DEBUG_LEVEL''' (clLogDebug.c)
		+	* '''ASP_SAVE_PREV_LOGS''' -- if set to 1 will save logs in the sandbox from the previous run of SAFplus Platform (if any) during SAFplus Platform startup into location specified by the environment variable ASP_PREV_LOG_DIR or to /tmp/asp_saved_logs, creating the directory if necessary. If set to 0, the logs will deleted. Default value is 1.
		+	* '''ASP_PREV_LOG_DIR''' -- place where logs of previous SAFplus Platform run will be stored. Default value is /tmp/asp_saved_logs
		+	* '''AMS_DEBUG''' -- Enable special availability management framework console logging. This occurs outside of the normal log infrastructure since the AMF process manages the logging process.
		+	* '''AMS_NOTIFICATION_DEBUG''' --
		+	* '''CPM_LOG_FILE_SIZE''' --
		+	* '''CPM_LOG_FILE_ROTATIONS''' --
		+	* '''ASP_CPM_LOGFILE''' --
		+
		+	====Miscellaneous====
		+	* '''ASP_RMD_METRIC''' --
		+	* '''CL_TXN_DSBLE_CKPT''' --
		+	* '''CL_HEAP_DEBUG''' --
		+	* '''CL_MEM_TIME''' --
		+	* '''ASP_WITHOUT_CPM''' --
		+	* '''CL_NODE_REPRESENTATIVE''' --
		+	* '''ASP_DB_SYNC''' --
		+
		+	====Debugging====
		+	* '''CL_DEBUG_PAUSE''' --
		+	* '''CL_DEBUG_PAUSE_CODE_ERROR''' --
		+	* '''CL_DEBUG_COMP_NO_KILL''' --
		+	* '''CL_DEBUG_COMP_TIMEOUT_OVERRIDE''' --
		+	* '''CL_DEBUG_LOG_LEVEL''' --
		+	* '''CL_DEBUG_RESOURCE_LOG_LEVEL''' --
		+	* '''CL_DEBUG_REVERSE_TIMING''' --
		+
		+	====Intra-Cluster Message Traffic Shaping====
		+	OpenClovis SAFplus Platform optionally uses a well known traffic shaping algorithm to modulate intracluster traffic. This is very useful if the internal communications between your applications can potentially overwhelm an application with requests. But if your application's inter-communication is designed to ensure that this cannot happen then the traffic shaping is not needed. By default (compile time) it is off.
		+
		+	These environment variables can be used to override the default leaky bucket intra-cluster message shaping parameters.
		+	* '''CL_LEAKY_BUCKET_VOL''' -- Leaky bucket volume in bytes
		+	* '''CL_LEAKY_BUCKET_LEAK_SIZE''' -- Leaky bucket removal in bytes
		+	* '''CL_LEAKY_BUCKET_LEAK_INTERVAL''' -- How often the leak occurs in milliSeconds
		+
		+	===Environment Variables Set by OpenClovis SAFplus Platform===
		+	These variables are available for use in your application:
		+
		+	====Locations====
		+	Note these environment variables have equivalent "C" global variables (defined in clEoApi.h) which are recommended over using the environment variable directly.
		+
		+	* '''ASP_NODENAME''' -- The name of the node (as defined in the SAF AMF model)
		+	* '''ASP_COMPNAME''' -- The name of this component (as defined in the SAF AMF model)
		+	* '''ASP_RUNDIR''' -- The "current working directory" SAFplus Platform runs from
		+	* '''ASP_LOGDIR''' -- The SAFplus Platform log directory
		+	* '''ASP_BINDIR''' -- The location of SAFplus Platform binaries
		+	* '''ASP_APP_BINDIR''' -- The location of the program binary. This is often, but not always the same as ASP_BINDIR.
		+	* '''ASP_CONFIG''' -- Directory of the SAFplus Platform configuration files (normally <asp install dir>/etc)
		+	* '''ASP_CPM_CWD''' -- The current working directory to use for SAFplus Platform and programs started by SAFplus Platform (defaults to var/run)
		+	* '''ASP_DBDIR''' -- The location the SAFplus Platform stores its database files
		+
		+	===Starting and Stopping SAFplus Platform: <aspDir>/etc/init.d/asp===
		+	Usage : asp {start\|stop\|restart\|console\|status\|zap\|help} [options]
		+
		+	options can be one of the following : (these options only work with start command, e.g. etc/init.d/asp start -v etc.)
		+
		+	-v : Be verbose
		+	--enforce-tipc-settings : Use etc/asp.conf's TIPC settings overriding the system TIPC settings
		+	--ignore-tipc-settings : Use systems TIPC settings ignoring the etc/asp.conf's settings
		+	--remove-persistent-db : Delete all of the SAFplus Platform persistent database files
		+	--asp-log-level <level> : Start SAFplus Platform with particular log level. <level> is [trace\|debug\|info\|notice\|warning\|error\|critical]
		+
		+	===CLI===
		+
		+	====bin/asp_console====
		+	SAFplus Platform console is a comprehensive CLI for examination and debugging of the SAFplus Platform system. SAFplus Platform console documentation is available as a separate document.
		+
		+	Start:
		+	<aspDir>/etc/init.d/asp console
		+	or
		+	<aspDir>/bin/asp_console
		+
		+	====bin/asp_info====
		+	The SAFplus Platform info CLI is a simple interface for display of SAFplus Platform status and basic control
		+
		+	<aspDir>/bin/asp_info
		+
		+	===Directly running a component: bin/asp_run===