SQWareProduction:postgres:etc:sqwpg GlobalVar.cfg

From Wiki_dbSQWare
Revision as of 08:38, 24 December 2024 by BatchUser (talk | contribs) (Updated by BatchUser)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Configuration file $gvsqw_PgBin/../etc/sqwpg_GlobalVar.cfg:
Global var for Postgres
It contains the operating variables of SQWareProduction.

File content:

#!/bin/bash
###################################################################
# SQWareProduction for Postgres module of dbSQWare
# 
# dbSQWare is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# CGU/CGA for more details.
# 
# You should have received a copy of the CGU/CGA
# along with this program.  If not, see <http://www.dbsqware.com/licenses/>.
# 
# For information : contact@dbsqware.com or www.dbsqware.com
###################################################################
## @Synopsis	Global var for Postgres
## @Copyright	Copyright 2007-2025, dbSQWare (www.dbsqware.com)

#global
export gvsqw_SqwVersionDbms=2025.11
export gvsqw_ConnectString=''
export gvsqw_PGPASSFILE='$gvsqw_PgBin/../etc_cust/.pgpass'
export gvsqw_DistConnectString='-h $gvsqw_PostgresHost -p $gvsqw_PostgresPort -U $gvsqw_DbaUser'
export gvsqw_RootAdmin='$HOME/${PG_SID}'
export gvsqw_RootAdminDisable='$HOME'
export gvsqw_RootAdminDist='$HOME/admin/postgres/${PG_SID}'
export gvsqw_RootCfg='$gvsqw_RootAdmin/sqwConfig'
export gvsqw_RootDbf='/pgdata/$PG_SID/data'
export gvsqw_RootLog='/pgdata/$PG_SID/pg_log'
export gvsqw_NbThreadReindex=2
export gvsqw_NbThreadAnalyze=2
export gvsqw_NbThreadDump=2
export gvsqw_NbThreadVacuum=2
export gvsqw_NbThreadCopyDump=2
export gvsqw_NbThreadRestore=2
export gvsqw_PostgresErrorMsg="^ERROR:|^FAILED:|^ERREUR:|^FATAL:|^PANIC:|psql:.* ERROR:|psql:.* FAILED:|psql:.* ERREUR:|psql:.* FATAL:|psql:.* PANIC:|could not connect"
export PAGER=more
##export gvsqw_PgDefaultExcludeDb="datname not like 'template%'" For RDS support !
export gvsqw_PgDefaultExcludeDb="datname not like 'template%' and datname!='rdsadmin' and datname!='azure_maintenance' and datname!='azure_sys'"
#Sort databases list, put "pg_database_size(oid) desc" to sort by size desc
export gvsqw_PgDefaultSortDb="1"
#Option for quiet psql (don't put -w for old versions <= 8.3)
export gvsqw_PsqlQuietOption='-q -X -w -A -t'
export gvsqw_DbAlias='$PG_SID'

#for Dump scripts
export gvsqw_RootDump='/pgbackup/$PG_SID'
export gvsqw_RootDumpSource='/pgbackup/$lvsqw_InstanceSource'
export gvsqw_ExcludeDatabasesCopy='^postgres$'
export gvsqw_DumpNbGeneration=2
export gvsqw_ForceDump=Disable #Put Enable to force the dump even if the cluster is in recovery mode
#use pigz if installed or gzip if not (use "export gvsqw_DumpPigzMaxProc=x" to limit the number of processes to x)
export gvsqw_DumpCompressorExt=gz
export gvsqw_DefCopyDumpNbGeneration=1
export gvsqw_DumpFormat='p'
export gvsqw_PgDumpOpt_p='-Z0'	# for plain
export gvsqw_PgDumpOpt_c=''		# for custom
export gvsqw_PgDumpOpt_d='-j 2'	# for directory
export gvsqw_PgDumpOpt_t=''		# for tar
export gvsqw_RsyncDefaultSourceDir='/pgbackup/$PG_SID'
export gvsqw_DropDb=Enable
export gvsqw_CreateDb=Enable

#for archive pg_xlog script
## put the destination list (1,2,3, ... corresponding to gvsqw_ArchiveXlog_destx, put dest1 to local destination)
export gvsqw_ArchiveXlog_enabled=1
export gvsqw_ArchiveXlog_dest1='/pgdata/$PG_SID/archive_xlog'
#export gvsqw_ArchiveXlog_dest2='destusr@desthost:/pgdata/$PG_SID/archive_xlog'
#use pigz if installed or gzip if not (use "export gvsqw_ArchiveXlogPigzMaxProc=x" to limit the number of processes to x)
export gvsqw_ArchiveXlogCompressorExt=gz
export gvsqw_ArchiveXlogMaxMail=2

#for PITR scripts
export gvsqw_RootPitr='/pgbackup/$PG_SID/PITR'
export gvsqw_PitrNbGeneration=2
export gvsqw_ForcePitr=Disable #Put Enable to force the PITR even if the cluster is in recovery mode
#use pigz if installed or gzip if not (use "export gvsqw_PitrPigzMaxProc=x" to limit the number of processes to x)
export gvsqw_PitrCompressorExt=gz
export gvsqw_PitrFormat='tar'
export gvsqw_PgPitrOpt=''
export gvsqw_PitrWaitTimeOut=900
#To autostart SqwArchmon when backup (enable/disable)
export gvsqw_PitrAutoStartSqwArchmon=enable
#Delay max between two backup of archives in s by default (unit: s,m,h)
export gvsqw_PitrArchLogsTimeTreshold=6h
#Delay between two tests in s by default (unit: s,m,h)
export gvsqw_PitrArchLogsInterval=5m
#Threshold for trigger backup ArchiveXlog in M by default (unit: K,M,G,%)
export gvsqw_ArchiveXlog_dest1_threshold=100M
#Wait for end of pg_start_backup/pg_backup_start before exit error
export gvsqw_WaitTimeOutStartBackup=900
export gvsqw_WaitStepStartBackup=5
#Wait for end of pg_stop_backup/pg_backup_stop before exit error
export gvsqw_WaitTimeOutStopBackup=900
export gvsqw_WaitStepStopBackup=5

#for pgbackrest scripts
export gvsqw_PgBackrestType=Local #put Local or Central
export gvsqw_PgBackrestList=$HOME/sqwConfig/sqwpg_PgbackrestClusters.lst #for sqwpg_PgBackrestAll.ksh
export gvsqw_PgBackrestNbThread=2
export gvsqw_PgBackrestAggressivenessRun=1
export gvsqw_PgBackrestAggressivenessCheckEnd=10

#For Vacuum
export gvsqw_VacuumAnalyze=Disable #Put Enable to activate 'VACUUM ANALYZE'

#For reorg
export gvsqw_Concurrently=Enable #Put Disable to desactivate CONCURRENTLY rebuild option (version >= 12)
export gvsqw_DropTmpIndexes=Enable #Put Disable to desactivate drop if exist index_name like '%ccnew%' or index_name like '%ccold%'

#for indicators
export gvsqw_SizeMinTableIndicators=10
export gvsqw_GenExcludeDatabasesObjects="^postgres$"
export gvsqw_GenExcludeDatabasesObjectsExtra=""
export gvsqw_PathList="HOME;gvsqw_RootAdmin;gvsqw_RootCfg;gvsqw_RootDump;gvsqw_RootPitr;gvsqw_ArchiveXlog_dest1"
export gvsqw_PathListExtra=""
export gvsqw_CommandPathVersionList="$gvsqw_CommandPathVersionList psql;--version pgbackrest;version"

##Globaly forcing return code for scripts
#export gvsqw_ForcedReturnCodeScript_sqwpg_DumpDatabase=0


Variables explanation:

#General variables
gvsqw_SqwVersion => SQWare Production version
gvsqw_SuppArchAlert => number of days to delete archives of alert files
gvsqw_SuppArchSlow => number of days to delete archives of slow query files
gvsqw_RootAdmin => admin directory
gvsqw_RootCfg => configuration directory
gvsqw_RootDbf => datafiles directory
gvsqw_RootLog => logfile directory
gvsqw_PostgresErrorMsg => format of MySQL errors
gvsqw_ConnectString => XXXXX
gvsqw_DistConnectString => XXXXX
gvsqw_RootAdminDisable => XXXXX
gvsqw_RootAdminDist => XXXXX
gvsqw_PGPASSFILE => path file for pgpass
gvsqw_NbThreadVacuum => XXXXX
gvsqw_PgDefaultExcludeDb => XXXXX
gvsqw_PgDefaultSortDb => XXXXX
gvsqw_DbAlias => Database Alias

#for Dump scripts
gvsqw_NbThreadDump => default number of thread for parallelism for pg_Dump
gvsqw_RootDump => default pg_Dump directory
gvsqw_DumpNbGeneration => default number generation of pg_Dump to keep online
gvsqw_PgDumpOpt => postgres Dump command
gvsqw_DumpCompressorExt => XXXXX
gvsqw_DumpFormat => XXXXX

#for archive pg_xlog script
gvsqw_ArchiveXlog_dest1 => XXXXX
gvsqw_ArchiveXlog_enabled => XXXXX
gvsqw_ArchiveXlogCompressorExt => XXXXX
gvsqw_ArchiveXlogMaxMail => XXXXX

#for PITR scripts
gvsqw_RootPitr => XXXXX
gvsqw_PitrNbGeneration => XXXXX
gvsqw_PitrCompressorExt => XXXXX
gvsqw_PgPitrOpt => XXXXX
gvsqw_PitrWaitTimeOut => XXXXX
gvsqw_PitrAutoStartSqwArchmon => XXXXX
gvsqw_PitrArchLogsTimeTreshold => XXXXX
gvsqw_PitrArchLogsInterval => XXXXX
gvsqw_ArchiveXlog_dest1_threshold => XXXXX

#for indicators
gvsqw_SizeMinTableIndicators => Size min in Meg of table to insert into SQWare Repository
gvsqw_GenExcludeDatabasesObjects => XXXXX
gvsqw_GenExcludeDatabasesObjectsExtra => XXXXX

#for optimize scripts
gvsqw_NbThreadReindex => default number of thread for parallelism for optimize

#for analyse scripts
gvsqw_NbThreadAnalyze => default number of thread for parallelism for analyse

##Globaly forcing return code for scripts
gvsqw_ForcedReturnCodeScript_sqwpg_DumpDatabase => To force return code of sqwpg_DumpDatabase.ksh
...

#for SQWare Web
gvsqw_WebDbaUserConn => Connection string ssh user@hostname to SQWare Web
gvsqw_WebDbaDirSlowQuery => Directory to store SlowQuery files on SQWare Web
Note:
You can overload variables contain in $gvsqw_PgBin/../etc/sqwpg_GlobalVar.cfg

by the same variables in $gvsqw_PgBin/../etc_cust/sqwpg_GlobalVar.cfg for all your environnement
or in $HOME/sqwConfig/sqwpg_GlobalVar.cfg specifically for this user.