Post on 18-Feb-2022
2
Abstract
With its set-and-forget capabilities, Ingres has a long history of being embedded within devices and other software solutions. In this session, Emma McGrattan, Ingres SVP Engineering, will outline the features that have been added to Ingres in recent years to enhance its suitability as an embedded technology. Whether your interest is unattended installation or scripted housekeeping and maintenance, this session will outline the features you need to be aware of to ensure your success with embedded Ingres.
3
Biography
Emma K McGrattan
Ingres Corporation• Miss McGrattan is responsible for the development and
integration of the Ingres database and associated products and technologies. A leading authority in DBMS and open source technologies, Miss McGrattan has been instrumental in the ongoing success of the Ingres product line.
Born in Ireland, Miss McGrattan earned a bachelor's degree in electronic engineering from Dublin City University.
4
Agenda
• Ingres 2006 Unattended Installation
• Configuration
• Maintenance
• Icebreaker BI Appliance
• Q&A
6
Response File
• To generate a template response file:setup /c
• To invoke the installer with a response file:setup /r <response file name>
• Response File Sections• Component Selection• Location Specification• Configuration• Customizations
• ; must appear at the beginning of any comment
7
Component Selection
Component Value DefaultII_COMPONENT_DBMS “YES” or “NO” “YES”II_COMPONENT_NET “YES” or “NO” “YES”II_COMPONENT_DOCUMENTATION “YES” or “NO” “YES”
II_COMPONENT_DOTNET “YES” or “NO” “YES”II_COMPONENT_FRONTTOOLS “YES” or “NO” “YES”II_COMPONENT_REPLICATOR “YES” or “NO” “NO”II_COMPONENT_STAR “YES” or “NO” “NO”II_COMPONENT_ICE “YES” or “NO” “NO”II_COMPONENT_JDBC_CLIENT “YES” or “NO” “YES”
8
Location Specification
Location DefaultII_SYSTEM "C:\Program Files\Ingres\IngresII"II_DATABASE "C:\Program Files\Ingres\IngresII"II_CHECKPOINT "C:\Program Files\Ingres\IngresII"II_JOURNAL "C:\Program Files\Ingres\IngresII"II_WORK "C:\Program Files\Ingres\IngresII"II_DUMP "C:\Program Files\Ingres\IngresII"II_LOG_FILE "C:\Program Files\Ingres\IngresII"II_DUAL_LOG “”II_LOCATION_DOTNET "C:\Program Files\Ingres\Ingres .NET
Data Provider\"II_LOCATION_DOCUMENTATION "C:\Program Files\Ingres\Ingres 2006
Documentation\"
9
Ingres Configuration
Configuration Parameter Default (Generated in NY)II_INSTALLATION “II"II_CHARSET "WIN1252"II_TIMEZONE_NAME "NA-EASTERN"II_LANGUAGE "ENGLISH"II_TERMINAL (TERM_INGRES) "IBMPCD"II_DATE_FORMAT "US"II_DATE_TYPE_ALIAS "INGRES"II_MONEY_FORMAT “L:$”II_LOG_FILE_SIZE_MB “32” II_ENABLE_SQL92 “NO”
10
Windows Configuration Options
Configuration Variable DefaultII_ADD_REMOVE_PROGRAMS "YES"II_ADD_TO_PATH "YES"II_INSTALL_ALL_ICONS "YES"II_START_INGRES_ON_COMPLETE "YES"II_START_IVM_ON_COMPLETE "YES"II_SERVICE_START_AUTO "YES"II_SERVICE_START_USER “"II_SERVICE_START_USERPASSWORD “”II_ENABLE_WINTCP "YES"II_DEMODB_CREATE "YES"
11
Embedded Ingres API
Check to see if the name server has startedII_PingGCN
Function DescriptionII_GetIngresInstallSize Report the disk space needed for installationII_GetResource Get the value of a config.dat parameterII_GetEnvVariable Get the value of an Ingres environment variableII_GetVersion Report the Ingres version information II_GCNapi_ModifyNode Add, delete or modify a vnode II_GCNapi_Node_Exists Check for the existence of a vnodeII_GCNapi_TestNode Test the connection to a given vnode
II_GetIngresMessage Return the text associated with an Ingres status code
12
Embedded Ingres API
Determine if the Ingres service has startedII_ServiceStarted
Get the internal name of the Ingres serviceII_IngresServiceNameFunction Description
II_StartService Start the Ingres Service II_StartServiceSync Start the service and wait until completion
II_StopService Stop the Ingres ServiceII_StopServiceSync Stop the service and wait until completion
13
Manipulating config.dat
• iigetres – get the value of a parameter
• iisetres – set the value of a parameter
• ipset – set an environment variable to the configuration value returned by a program such as iigetres or ingprenv
• Exampleipset ORIG_TERM ingprenv TERM_INGRESipset ORIG_BUFFER_COUNT iigetres ii.%COMPUTERNAME%.rcp.log.buffer_countIF %ORIG_BUFFER_COUNT % GEQ 70 GOTO END
iisetres ii.%COMPUTERNAME%.rcp.log.buffer_count 70:END
14
Scripting Database Maintenance Tasks
• Table and index reorganization
• System catalog reorganization
• Gathering statistics
• Database relocation
• Database backup and recovery
• Database information
15
User Table Reorganization - Usermod
Modifies the user-defined tables of a database to their currently defined storage structure and recreates any secondary indexes that are currently defined.usermod dbname | vnode::dbname[/server_class] [-uusername] [tables] [-online] [-noint] [-repmod [+w|-w]]
16
User Table Reorganization
• Factors influencing frequency of reorganization• Number of pages• Number of indexes• Rate of growth• Rate of change
• Other options:• Modify to merge – for btree tables this will reorganize the
index pages• Drop and recreate an index – when the table doesn’t need
to be reorganized but an index does
17
Gathering Statistics
• Up to date statistical and histogram data for each column in the database will result in optimal query execution plan generation
• Factors influencing frequency optimizedb is run• Rate of change of histogram data within a column• Rate of change of range of values within a column
• Exampleoptimizedb -zf <filename>
18
System Catalog Reorganization
• Optimizedb will update the iistatistics and iihistograms system catalogs
• Catalogs should be reorganized
• sysmod utility reorganizes system catalogs• Requires exclusive access to the database • Can wait for database to become free
• Example• sysmod +w employee
19
Backing up the database
• Backup can be performed on-line or off-line
• Can be run against the entire database (recommended) or against individual tables
• Database journaling is recommended except where data is transient
• Recommend that backup is taken at the end of housekeeping cycle, or if time permits at the start and end of housekeeping cycle
21
Collecting an evidence set
• Configuration files – config.dat, symbol.tbl, version.rel, output of the “set” command etc
• Error log files – errlog.log
• Archiver and recovery logs iiacp.log and iircp.log
• VDBA error log file – errvdba.log
• Startup log file – ingstart.log
• Application specific logs
22
Introducing Ingres Icebreaker
• Definition• Ingres 2006 Database• Integrated with Linux• Validated & integrated maintenance stream
• Value for Customers• Easy deployment• Confidence in updates to environment• Built for database requirements
LinuxJava
Tomcat
Ingres 2006
Ingres
Icebreaker
23
Ingres Icebreaker BI Appliance
• A ready to run Business Intelligence Suite
• Reporting, Analytics, Data Integration, Database, Operating System
• One install, simplified configuration
• Purpose configured database• Validated maintenance
stream for updates• Remote Management
Services• rDBA, Online BI Services
• Built from Open Source technologies
LinuxJava
Apache Tomcat
Ingres 2006
Ingres
Icebreaker
ETLReport Server
Analytics Server
Report Designer
Reporting Solution
BI Appliance