storparam

Modifies the settings for the StorMan server without restarting it. All settings are valid for the current StorMan server session. They can optionally be maintained persistent for further sessions.

Syntax

storparam { –show | [ –debug level ] [ –debugcom comopt ]
          [ –traceworker level] [ –tracefilemaxage level]
          [ –save ]

Parameters

–show

Shows the settings of the StorMan server.

–debug level

Sets the debug level of the server. Supported values:

0	Trace severe errors only
1	Trace errors too
2	Trace even warnings
3	Trace information
4	Trace debug (default)
5	Trace extended debug

 

–debugcom comopt

Sets the debug option for communication (only active if the overall debug level is 5). Supported values:

1	Trace tcp / ip calls of clients
2	Trace messages of clients
4	Trace tcp / ip calls of provider communication
8	Trace messages of provider communication

Adding the values enables multiple traces. 

–traceworker level

Enables the tracing of background threads with debug trace level (not higher than the level set by debug) to the trace file. Supported values:

0	Trace off (default)
1	Trace worker
2	Trace system updater
4	Trace mirror updater
8	Trace provider status updater
16	Trace statistics collector
32	Trace main thread
64	Trace indication handler
128	Trace script updater
256	Trace volume updater
512	Trace cluster updater

Adding the values enables multiple levels.

 

–tracefilemaxage level

Defines how many days the StorMan log files are kept before they are automatically deleted. Supported values:

0	No limit (default)
n	n = number of days

–save

Saves the currently specified parameter values to the file smserver.ini to be preserved for subsequent sessions (restart of StorMan server). 

Return codes

Error Code	Name	Error Type
0	STORMAN_OK	Function successful
7	STORMAN_INV_PARAMETERS	Specified parameters invalid
13	STORMAN_COMMUNIC_ERROR	Error in StorMan communication between client and server
16	STORMAN_FAULT	Unexpected error in function
36	STORMAN_AUTH_FAILED	User / password for StorMan not valid

Examples

Output of the StorMan parameters storparam –show :

service@mu1(MU): storparam -show
debug level: 5
communication debug level: 0
worker trace: 0
authorization level: enabled
max trace file age: 90days