You are on page 1of 8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

DeployingtheRationalInsight WarehouseonanOracleDatabase

Document information
RationalInsight Installation Softwareversion: 1.0,1.0.0.1 Operatingsystem(s): Linux,Windows

Productdocumentation Abstract
Thisdocumentexplainsandoutlinestheprocesstofollowfordeployingthe IBMRationalInsightdatawarehouseschemasonapreexistingOracledatabase forRationalInsightconsumersthatareconstrainedbyprocessesthatdonot allowtheautomaticormanualcreationofthedatabasebymeansalready providedintheRationalInsightoffering.

Reference#: 7017313 Modifieddate: 20091111

Content
1.Creatingthedatabase 1.1.Databasecharacterset TheRationalInsightwarehousesupportsstoringdatafromdifferentlanguages. TheOracledatabasethattheRationalInsightschemasandobjectswillresidein musthavethe'characterset'settoAL32UTF8andthe'nationalcharacterset' settoUTF8.Therefore,ifyoumustcreatethedatabaseoutsideoftheautomated ormanualprocessalreadyprovidedbyRationalInsightmakesureitisa databasethathastheabovesettingspriortodeployingandcreatingtheschemas andobjects. 2.Tablespaces 2.1.Operationaldatastore Therearetwotablespacesallocatedtotheoperationaldatastore.Oneforthe regulartablescalledVNF_32KandtheotherfortheindexescalledVNF_IDX. ThescriptthatcreatesthetablespacesforRationalInsightonOracleiscalled

www-01.ibm.com/support/docview.wss?uid=swg27017313

1/8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

tbspace.sqlandislocatedintheddlfolderinthe [rational_insight_installation_directory]/datawarehouse/dwinstallationdirectory. Itisaparameterizedscript,wherethesystemaccountpassword,fullyqualified pathforthelocationofthetablespacefilesandORACLE_SIDarepassedas argumentstothescript.Ifyouneedtofollowsomeothernamingconventionfor thetablespacenames,keepinmindthatyouwillalsoneedtochangetheDDL scriptsthatreferencethesetwotablespaces.Thescriptsthatreferencethetable spacesarelocatedintheddlfolderinthe [rational_insight_installation_directory]/datawarehouse/dwdirectory.These scriptsare: createUsers.sql createSTGCFG.ddl createNF.ddl

2.2.Datamart Therearetwotablespacesallocatedtothedatamart.Onefortheregulartables calledVSTR_32KandtheotherfortheindexescalledVSTR_IDX.Thescript thatcreatesthetablespacesforRationalInsightonOracleiscalledtbspace.sql andislocatedintheddlfolderinthe [rational_insight_installation_directory]/datawarehouse/dwinstallationdirectory. Itisaparameterizedscript,wherethesystemaccountpassword,fullyqualified pathforthelocationofthetablespacefilesandORACLE_SIDarepassedas argumentstothescript.Ifyouneedtofollowsomeothernamingconventionfor thetablespacenames,keepinmindthatyouwillalsoneedtochangetheDDL scriptsthatmakereferencetothesetwotablespaces.Thescriptsthatreference thetablesspacesarelocatedintheddlfolderinthe [rational_insight_installation_directory]/datawarehouse/dwdirectory.These scriptsare: createUsers.sql createSTAR.ddl Additionally,thereisanothertemporarytablespacecreatedcalledRIS_TEMP thatiscommontoboththeODSandDMandisthedefaulttemporaryspacefor theRationalInsightOracleuseraccounts. Theparametersspecifiedintbspace.sqlare: Systemaccountpasswordparameter>sysPassword Basedirectoryforlocationofthedatafilesparameter>DATA_HOME OracleSIDoftheRationalInsightdatabaseparameter>ORACLE_SID 3.Useraccounts 3.1.Accounts ThenumberofOracleaccountsthatarecreatedandrequiredbytheRational Insightdatabasearefive.However,onlytwoarecreatedasactiveaccounts,the otherthreeareinactiveexpiredaccountsusedonlytoqualifyanddemarcatethe

www-01.ibm.com/support/docview.wss?uid=swg27017313

2/8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

threephysicalareasinthedatabase.Thescriptusedtocreatethedatabaseuser accountsislocatedintheddlfolderinthedatawarehouseinstallationdirectory andiscalledcreateUsers.sq.Anydefaultrolesanddatabaseprivilegesare grantedtotheusersinthisscript.Itisaparameterizedscriptwherethefollowing areargumentstothescript: Systemaccountpasswordparameter>sysPassword DBAaccount(activeaccountwithDBArolegranted) parameter>DBA_USER DBAaccountpasswordparameter>DBA_PASSWORD Operationaldatastoreaccount(dormantaccountusedonlytogroupandqualify objects)parameter>NF_SCHEMA,default>RIODS Datamartaccount(dormantaccountusedonlytogroupandqualifyobjects) parameter>STAR_SCHEMA,default>RIDW Reportuseraccount(activeaccountlimitedtoselectprivilegesagainstthedata marttablesandviews)parameter>REP_USER,default>RPTUSER Reportuserpasswordparameter>REP_PASSWORD,default>Rat10nal ThefifthaccountcreatedistheconfigurationaccountcalledCONFIGwhichis notparameterizedandisadormantaccountusedonlytogroupandqualify objects.Objectscreatedunderthisschemaareusedintheadministrativeand controlofdatabaseobjectsandextract,transformandloadaudit/processing.This accountnameshouldnotbechanged. Fortheitemsinthelistabovewhereadefaultisspecified,thesearethedefaults assumedwithanautomatedinstallationandthesearethedefaultsassumedinthe reportmetadata(FrameworkManagermodel,CognosBIreports).Unless otherwiseconstrainedbyanITprocess,usethesedefaults,otherwiseadditional changeswillberequireddownthelineintheDDLscripts,frameworkmodel andreportpackages.ForconsumersofRationalCommonReporting(RCR), thesedefaults(withtheexceptionofthereportuserpassword)mustbeusedand nodeviationshouldbeallowedsincethereportingsolutionwillotherwisenot work. 4.Schemas Fromthelistofaccountsspecifiedinsec3.1,onlythreehavedatabaseobjects relatedtothemhencethreeschemas.Thoseschemasandassociatedaccounts are: Configurationschema:CONFIGaccount Operationaldatastoreschema:DefaultRIODSaccount Datamartschema:DefaultRIDWaccount 4.1.Configurationschema:CONFIG TheobjectsassociatedwiththisschemacanbefoundinthecreateSTGCFG.ddl scriptlocatedintheddlfolderunderthe [rational_insight_installation_directory]/datawarehouse/dwdirectory. Additionally,someofthetablesinthisschemaneedtobeinitialized.The initializationrecordsarefoundinaseparatescriptcalledinitCONFIG.sqllocated inthescriptsfolderunderthe

www-01.ibm.com/support/docview.wss?uid=swg27017313

3/8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

[rational_insight_installation_directory]/datawarehouse/dwdirectory.These scriptsarenotparameterized.Ifthetablespacenamesarenotthoseprovidedby defaultintheinstallationpackage(sec.2.1),thenadditionalmodificationofthis scriptisrequiredtoreplaceanyreferencetoVNF_IDXandVNF_32Kwiththe correspondingtablespacenames. 4.2.Operationaldatastoreschema:RIODS TheobjectsassociatedwiththisschemacanbefoundinthecreateNF.ddlscript intheddlfolderunderthe [rational_insight_installation_directory]/datawarehouse/dwdirectory. Additionally,thetablesinthisschemaneedtobeinitialized.Theinitialization recordsarefoundinaseparatescriptcalledinitNF.sqllocatedinthescripts folderunderthe[rational_insight_installation_directory]/datawarehouse/dw directory.Boththesescriptsareparameterized.Onlyoneargumentisrequired, thatoftheoperationaldatastoreschemaname.Theparameterinthescriptsis calledNF_SCHEMAwhichbydefaultshouldbesettoRIODS(sec.3.1).Ifthe tablespacenamesarenotthoseprovidedbydefaultintheinstallationpackage (sec.2.1),thenadditionalmodificationofthisscriptisrequiredtoreplaceany referencetoVNF_IDXandVNF_32Kwiththecorrespondingtablespacenames intheabovescripts. 4.3.Datamartschema:RIDW TheobjectsassociatedwiththisschemacanbefoundinthecreateSTAR.ddl, createSTARViews.ddlscriptintheddlfolderunderthe [rational_insight_installation_directory]/datawarehouse/dwdirectory. Additionally,thetablesinthisschemaneedtobeinitialized.Theinitialization recordsarefoundinaseparatescriptcalledinitSTAR.sqllocatedinthescripts folderunderthe[rational_insight_installation_directory]/datawarehouse/dw directory.Allthesescriptsareparameterized.Onlyoneargumentisrequiredfor createSTAR.ddl,createSTARViews.ddlandinitSTAR.sqlthatofthedatamart schemaname.TheparameterinthescriptsiscalledSTAR_SCHEMAwhichby defaultshouldbesettoRIDW(sec.3.1).ThecreateSTARViews.ddlscripts requirestwoparametersthatoftheschemanameusedforthedatamartandthe schemanameusedfortheoperationaldatastore.Thoseparametersare representedbySTAR_SCHEMAwhichshouldbesettoRIDWand NF_SCHEMAwhichshouldbesettoRIODS(sec.3.1).Ifthetablespace namesarenotthoseprovidedbydefaultintheinstallationpackage(sec.2.1), thenadditionalmodificationofthisscriptisrequiredtoreplaceanyreferenceto VSTR_IDXandVSTR_32Kwiththecorrespondingtablespacenamesinthe abovescripts. Thedatamartschemahasadditionalobjects,apackage,proceduresand functions.Onescriptisusedtograntprivilegestothereportuserthatisusedto connectandexecutequeriesagainstthedatabaseonbehalfofthereport execution.Thepackageisusedtostoreconstantsbasedonasupportedlanguage whichisusedbytheproceduresandfunctions.Theproceduresaidinpopulating thedatedimensioninthedatamartandETLprocessing.

www-01.ibm.com/support/docview.wss?uid=swg27017313

4/8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

TheOraclelanguagepackagesarelocatedinscripts/ascii(windows)and scripts/utf_8(unix)foldersunderthe [rational_insight_installation_directory]/datawarehouse/dwdirectory.Onlyone languagewillapplytoyourenvironment.Allofthepackagescriptsare parameterized,theycontainonlyoneparameterrepresentedbySTAR_SCHEMA whichshouldbesettoRIDWbydefault(sec.3.1). Theproceduresandfunctionsthataidinpopulatingthedatedimensioninthe datamartandaidintheETLprocessing,areinthedtPopulate.sqlscriptinthe scriptsfolderunderthe [rational_insight_installation_directory]/datawarehouse/dwdirectory.Thescript isparameterized,itcontainsonlyoneparameterrepresentedbySTAR_SCHEMA whichshouldbesettoRIDWbydefault(sec.3.1). ThescriptthatgrantsSELECTprivilegestothereportuseraccount(sec.3.1) forthedatamartschemaRIDW(sec.3.1)tablesandviewsiscalled star_grants.sqlandislocatedinthescriptsfolderunderthe [rational_insight_installation_directory]/datawarehouse/dwdirectory.Itisa parameterizedscriptthatacceptstwoarguments,thedatamartschemaname representedbySTAR_SCHEMAwhichshouldbesetbydefaulttoRIDW(sec. 3.1)andthereportaccountusernamerepresentedbyREP_USER(sec.3.1). 5.OracleaccountforETLexecution Forsimplicity,noadditionalorseparateaccountiscreatedfortheETL execution.IftheaccountwithDBAroleisnotallowedtoexecutetheETL,then anotheraccountneedstobecreatedthatwillhaveauthoritytodothefollowing: Insert,update,select,delete,truncatefromallthetablesandviewsinthedata martschemaRIDW,theoperationaldatastoreschemaRIODSandthe configurationschemaCONFIG(sec.3.1,4) Privilegesonthetablespaceswithnospacequotas(sec.2) Privilegestoexecuteprocedures,functionandaccesspackagesinthedatamart schemaRIDW(sec.3.1,4.3) 6.Bringingitalltogether Thescriptsmentionedinsection2to5areallsetupforexecutioninonescript calledbuildDW.sqllocatedinthe [rational_insight_installation_directory]/datawarehouse/dw.IftheOracle databaseisalreadysetuptohosttheRationalInsightschemas,thenthisscript couldbeusedtodeploytheschemasevenonaremoteOracledatabase(append theconnectcommandwith@&&ORACLE_SIDforremoteexecutioninthe script).Thescriptexpectstoworkfromadirectorycalledwork_sp.Createthis directoryunder[rational_insight_installation_directory]/datawarehouse/dwand copytheddlscriptsfolderandthebuildDW.sqlfilelocatedin [rational_insight_installation_directory]/datawarehouse/dwdirectoryintothe newlycreatedwork_spcfolder. 6.1.Preparingtheexecutionofbuildw.sql

www-01.ibm.com/support/docview.wss?uid=swg27017313

5/8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

Anyportionofthestepsmentionedinsections2through5thathavebeen executedmanuallyoutsidethescopeofanautomatedormanualRationalInsight installation,musthavethecorrespondingscriptreferencesinbuildDW.sql commentedoutpriortoexecutingbuildDW.sql.Forexample,ifthetablespaces arecreatedoutsidethescopeofthebuildDW.sqlscript,thentheywouldneedto commenttheline@'&&CD/work_spc/ddl/tbspace.sql'inbuildDW.sqlby prependingitwithtwodashes: @'&&CD/work_spc/ddl/tbspace.sql' IfwelookatthecontentsofbuildDW.sql,weseeatthetop,thelistofarguments andparametersthatsetupthevaluesforthescriptexecutionsthatfollow.Intotal therearesixteenparametersthatareexpected.Theyare: ORACLE_HOME:Oracleinstallationdirectory ORACLE_SID:OracleSIDoftheRationalInsightOracledatabase CD:containsthevalueofthecurrentdirectory,thecontextinwhichallthe scriptsarelocatedandfromwheretheywillexecute sysPassword:Thepasswordofthesystemaccount ORACLE_BASE:TheOraclebaseinstallationdirectory DBA_USER:TheOracleaccountwiththeDBAroleassigned(sec.3.1) DBA_PASSWORD:ThepasswordfortheDBAaccount NF_SCHEMA:Thevalueoftheoperationaldatastoreaccountnamethe defaultRIODSshouldbespecified(sec.3.1) STAR_SCHEMA:Thevalueofthedatamartaccountname,thedefault RIDWshouldbespecified(sec.3.1) REP_USER:Thereportuseraccounttousetoexecutethequeriesonbehalfof thereports(sec.3.1) ORA_CMD:SettoeitherONorOFFfortheechoingofthecommandsasthe scriptsexecute START_YEAR:Theminimumyearnumberforwhichthedatedimension shouldcontaindata END_YEAR:Themaximumyearnumberforwhichthedatedimension shouldcontaindata REP_PASSWD:Thepasswordofthereportuseraccount(sec.3.1) DATA_HOME:Thebasedirectoryforthetablespacedatafiles(sec.2) SQLVARF:Pointstooneofthelanguagescriptsforthepackagerequiredby thedatamartschemaRIDW(sec.4.3) 6.2.ExecutingbuidDW.sql Knowingwhattheparametersareandtheirmeaning,youcanexecute buildDW.sqlbyinvokingthescriptandpassingthesixteenargumentstothe scriptasdoesinstall.batandinstall.shbatchandshellscriptinthe [rational_insight_installation_directory]/datawarehouse/dwdirectory: SETORACLE_SID=RIDW(windows) exportORACLE_SID=RIDW(unix) sqlplus/nolog@[rational_insight_installation_directory]/datawarehouse/dw /work_spc/buildDW.sql"param1""param2""param3"..."param16"

www-01.ibm.com/support/docview.wss?uid=swg27017313

6/8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

Yourotheroptionistomodifythecopyof [rational_insight_installation_directory]/datawarehouse/dw /work_spc/buildDW.sqlandtosetthevaluesaccordingly,hereisanexampleof thepresetinformationinthebuildDW.sqlscript: DEFINEORACLE_HOME=C:/oracle11g/product/11.1.0/db_1' DEFINEORACLE_SID='RIDW DEFINECD='C:/ProgramFiles/IBM/RationalInsight/datawarehouse/dw' DEFINEsysPassword='somepassword' DEFINEORACLE_BASE='C:/oracle11g' DEFINEDBA_USER='RIDBA' DEFINEDBA_PASSWORD='dbapassword' DEFINENF_SCHEMA='RIODS' DEFINESTAR_SCHEMA='RIDW' DEFINEREP_USER='RPTUSER' DEFINEORA_CMD='ON' DEFINESTART_YEAR=2005 DEFINEEND_YEAR=2012 DEFINEREP_PASSWD='Rat10nal' DEFINEDATA_HOME='c:/tbs/datafiles' DEFINESQLVARF='ascii/vars_en.sql' InvokingthebuildDW.sqlscripttocreatetheobjectsissimplified: SETORACLE_SID=RIDW(windows) exportORACLE_SID=RIDW(unix) sqlplus/nolog@[rational_insight_installation_directory]/datawarehouse/dw /work_spc/buildDW.sql 7.Otherconsiderations RationalInsightrequiresfourdifferentlogicaldatabaseswiththesamecharacter set: RationalInsightWarehouse RationalInsightSampleWarehouse(optional,notavailableforRCR) CognosContentStore CognosDataManagerCatalog(notavailableforRCR) Youcandeploy(thoughnotrecommended)anyofthecombinationsaboveinto differentschemasinthesameOracledatabase.However,youcannotdeploythe RationalInsightwarehouseandtheRationalInsightsamplewarehouseonthe sameOracledatabase.Foranyothercombinationabove,makesurethatthe ownersoftheobjectsdonotoverlapacrosslogicaldatabases.Forexample,the account/schemausedastheownerandcreatorofthecontentstoredatabase objectsshouldnotbethesameoneusedforthecatalog.

Copyrightandtrademarkinformation

www-01.ibm.com/support/docview.wss?uid=swg27017313

7/8

12/04/12

IBM Deploying the Rational Insight Warehouse on an Oracle Database - United States

IBM,theIBMlogoandibm.comaretrademarksofInternationalBusiness MachinesCorp.,registeredinmanyjurisdictionsworldwide.Otherproductand servicenamesmightbetrademarksofIBMorothercompanies.Acurrentlistof IBMtrademarksisavailableontheWebat"Copyrightandtrademark information"atwww.ibm.com/legal/copytrade.shtml.

www-01.ibm.com/support/docview.wss?uid=swg27017313

8/8

You might also like