1

Embedding Ingres forSimplified DeploymentEmma McGrattanSVP, Engineering

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

5

Long Legacy as Embedded Database

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

20

Collecting Database Information - infodb

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

24

Who has the first question?

25

http://blogs.ingres.com/emmamcgrattan

Hasta la Vista?

Innovation at Work andat Play

Total Eclipse

of the Heart

Lazy Susan

A Whole Heap of Trouble