Documentos de Académico
Documentos de Profesional
Documentos de Cultura
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.
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
www-01.ibm.com/support/docview.wss?uid=swg27017313
8/8