View
123
Download
1
Category
Tags:
Preview:
Citation preview
User Group Informix
France
New Environment and Dynamic Setting in IDS 12.10
yoram.benchetrit@fr.ibm.com
Jeudi 12 Septembre 2013
User Group Informix
France 2
Agenda
Legacy Engine Environment and Setting
New Environment Management
New Onconfig Dynamic Setting
New Sysadmin API
Example
User Group Informix
France 3
Legacy Engine Environment and Setting
Environment variable
– INFORMIXDIR, ONCONFIG, INFORMIXSERVER, INFORMIXSQLHOSTS, PATH
ONCONFIG file
– Static setting
– Dynamic setting
• Onmode -wf / -wm
– Deprecated parameter
User Group Informix
France 4
New Server Environment Management
Ability for DBA to start database server reading the environment to use from a file
Ability to run Informix utility/binary without having to set environment in the shell before
Ability for DBA to start database server from a remote machine without creating specific environment files and „‟wrappers‟
Set environment reading a file during binary execution using new -FILE option
– -FILE=/path_to_file_that_contains_env
The format of the file is #$NAME VALUE
Onconfig file can be used to set environment variables
User Group Informix
France 5
New Server Environment Management (cont)
Supported binaries:
– oninit, onstat, onmode,oncheck, ontape,onclean,onload, onlog, onunload, onparams,onspaces
Values in –FILE option take precedence over values that are set in local shell environment
INFORMIXDIR environment variable is set based on binary path.
– If INFORMIXDIR is not set in the environment or is not set from the environment file then the PATH to the binary is used
– binary assumed to be in subdirectory of INFORMIXDIR
User Group Informix
France 6
New Server Environment Management (cont)
Environment Variable can be embedeed in onconfig file
– Syntax: PARAMETER_NAME $ENVIRONMENT_VAR # comments
Example: $ cat IDS1210FC1.env #$ONLINELOG1 /usr2/support/chunks/IDS1210FC1/online1.log In ONCONFIG: MSGPATH $ONLINELOGINST1 $ oninit -FILE=IDS1210FC1.env
Environment variable must be set for any program that read onconfig file:
– Oninit, oncheck, onbar, ontape, onlog and archecker utilities
User Group Informix
France 7
New Server Environment Management - Example
Environment File: $ cat IDS1210FC1.env #$INFORMIXSERVER sar12101shm #$INFORMIXSQLHOSTS /usr2/support/products/sqlhosts #$ONCONFIG onconfig.saroumane
PATH Setting $ echo $PATH /usr2/support/products/IDS1210FC1B4/bin:/usr/local/bin:/bin:/usr/bin
Binary execution $ oninit -FILE=IDS1210FC1.env $ onstat -FILE=IDS1210FC1.env – IBM Informix Dynamic Server Version 12.10.FC1 -- On-Line -- Up 00:00:19 -- 149788 Kbytes $ onmode -FILE=IDS1210FC1.env -ky $ onstat -FILE=IDS1210FC1.env - shared memory not initialized for INFORMIXSERVER 'sar12101shm'
User Group Informix
France 8
New Onconfig Dynamic Setting
Generalize dynamic tuning for all parameters
Onconfig parameter cleanup
New onstat -g cfg command to manage onconfig parameter
New SQL admin API command for onconfig dynamic setting
New SQL admin API command for onconfig parameter export and import
– Configuration snapshot can be exported to a file
– Configuration file can be imported to a running server
Avoid to shutdown IDS when changing a configuration parameter
Long term goal is IDS self-tuning
User Group Informix
France 9
Onconfig Parameters Cleanup
Deprecated Parameters Removed AFF_NPROCS AFF_SPROCBUFFERS DRNODEJDKVERSION LOG_BACKUP_MODELRU_MAX_DIRTY LRU_MIN_DIRTYLRUPOLICY LRUSNOAGE NUMAIOVPSNUMCPUVPS OPCACHEMAXOPTICAL_LIB_PATH RA_THRESHOLDSPINCNT STAGEBLOB
An unknown parameter in your config file will now produce this message during startup
– attn: Ignoring unknown or deprecated config parameter (%s)
User Group Informix
France 10
Dynamic Setting Parameter
More Parameters can be modified on the fly BAR_ACT_LOG BAR_BSALIB_PATH BAR_DEBUG BAR_HISTORY BAR_IXBAR_PATH BAR_MAX_BACKUP DS_POOLSIZE DUMPCORE PC_POOLSIZE RAS_LLOG_SPEED RAS_PLOG_SPEED SDS_ENABLE SDS_FLOW_CONTROL SMX_PING_INTERVAL SMX_PING_RETRY STMT_CACHE STMT_CACHE_HITS etc...
User Group Informix
France 11
Onstat -g cfg
Onstat –g cfg / onstat –g cfg <param>
– Displays the current value of all, or given parameter
Onstat –g cfg full
– Display full info of parameter (defaut, onconfig and current value + message)
onstat -g cfg tunable
– Displays full info for all dynamically tunable parameters
onstat -g cfg diff
– Displays full info for all parameters whose current value differs from that of the config file
onstat -g cfg msg
– Displays any error or warning messages associated with parameters
User Group Informix
France 12
Example: onstat -g cfg
$ onstat -g cfg IBM Informix Dynamic Server Version 12.10.FC1 -- On-Line – Up 02:41:38 -- 149788 Kbytes Configuration Parameter List name current Value ROOTNAME rootdbs ROOTPATH /work//rootchunk ROOTOFFSET 0 ROOTSIZE 200000 MIRROR 1 MIRRORPATH MIRROROFFSET 0 DBSERVERNAME mors SERVERNUM 43 MSGPATH /work/online.log ...
User Group Informix
France 13
Example: onstat -g cfg full <parameter>
$ onstat -g cfg full MSGPATH Configuration Parameter Info id name type maxlen units rsvd tunable 10 MSGPATH CHAR 257 * * default : /dev/tty onconfig: $ONLINELOG1 current : /usr2/support/chunks/IDS1210FC1/online1.log Description: Use the MSGPATH configuration parameter to specify the full pathname of the message-log file. The database server writes status messages and diagnostic messages to this file during operation.
User Group Informix
France 14
new SQL admin API commands
modify config [persistent]
– EXECUTE FUNCTION task("modify config", "LTAPEDEV", "/dev/null");
• Modify onconfig parameter in memory
– EXECUTE FUNCTION task("modify config persistent", "LTXHWM", "75");
• Modify onconfig parameter in memory and in onconfig file
reset config [all]
– Reset command synchronizes parameter value in memory with parameter onconfig value as shown by onstat -g cfg full.
– EXECUTE FUNCTION task("reset config", "LTAPEDEV");
– EXECUTE FUNCTION task("reset config all");
User Group Informix
France 15
SQL Admin API Onconfig Dynamic Setting - Example
> onstat -g cfg full LTXEHWM IBM Informix Dynamic Server Version 12.10.FC1 -- On-Line -- Up 03:13:07 – 149788 Kbytes Configuration Parameter Info id name type maxlen units rsvd tunable 25 LTXEHWM INT4 12 % * * min/max : 1,100 default : 80 onconfig: 80 current : 80 > execute function task("modify config", "LTXEHWM", "70"); > onstat -g cfg full LTXEHWM IBM Informix Dynamic Server Version 12.10.FC1 -- On-Line -- Up 03:17:36 – 149788 Kbytes Configuration Parameter Info id name type maxlen units rsvd tunable 25 LTXEHWM INT4 12 % * * min/max : 1,100 default : 80 onconfig: 80 current : 70
User Group Informix
France 16
Export and Import of Configuration Parameters
Export Configuration Parameters
– onmode –we <filename>
– EXECUTE FUNCTION task(“export config”, “filename”);
– All parameters are exported
– Template used: $INFORMIXDIR/etc/onconfig.std
Import Configuration Parameters
– onmode –wi <filename>
– EXECUTE FUNCTION task(“import config”, “filename”);
– Only tunable parameters in the file are modifed – Others are ignored
– Convenient way to modify mutiple parameters with one command
User Group Informix
France 17
Thank you!
Recommended