Refreshing the OBIEE Lineage From Existing Exports

14 Product TitleBookTitle as a Variable

19.5 Automating the Lineage Tasks

Scripts are also provided to automate the lineage tasks. These scripts can be used instead of the wizard and require that option values are provided in a property file instead. The scripts for automating the lineage tasks are in the bin sub-folder of the Lineage installation folder. This section describes how to automate lineage tasks with scripts and contains the following topics: ■ Configuring the Scripts ■ Automating Lineage Deployment 4 ODI Repository Connection Information Screen If Export Metadata from OBIEE and Refresh Lineage or Refresh Lineage is selected on the Select Action screen. Provide the ODI repository connection information: Oracle Data Integrator Connection ■ User : Enter the ODI username. This user should have SUPERVISOR privileges. ■ Password : Enter this user’s password. Database Connection Master Repository ■ User : Enter the database user name to connect to the schema or database, library that contains the ODI Master Repository. ■ Password : Enter this user’s password. ■ Driver Name : Enter the name of the driver used to connect to the master repository. ■ URL : Enter the URL used to connect to the master repository. Work Repository ■ Work Repository : Use the Select button to select a work repository attached to the master repository. The Lineage Tables will be created in this Work Repository, and the lineage consolidated into these tables. Click Next to continue. 5 Mapping Information If Export Metadata from OBIEE and Refresh Lineage or Refresh Lineage is selected on the Select Action screen. Use this table to provide the correspondence mapping between the ODI data models and the OBIEE physical schemas: 1. From the BI Mapping -Physical DB, Schema, Catalog list, select the OBIEE physical schema you want to map. 2. From the ODI Model list, select the ODI Model you want to map to this OBIEE schema. 3. For each mapping that you want to define, click Add . This adds a new row to the table. 4. Repeat the previous steps for each mapping. Click Next to continue. 6 Action Complete Screen Always Click Finish to dismiss the wizard. Table 19–3 ContinuedInstructions for Refreshing the OBIEE Lineage Artifacts No. Screen When Does This Screen Appear? Description and Action Required 15 ■ Automating Lineage Refresh

19.5.1 Configuring the Scripts

Before starting any of the scripts, you need to provide the configuration information in a property file. This property file contains the values provided via the wizard user interface. Figure 19–4 lists the properties defined in the property file. Note: When running the wizard, a property file is automatically generated in the tmp sub-folder of the Lineage installation folder. You can re-use this property file as a starting point for working with the command line scripts. Table 19–4 Properties Property Values Required for Description OBIEE_VERSION 10g|11g install | export |refresh Version of the OBIEE Server. OBIEE_RPD rpd_file_ location install | export Location of the repository .rpd file of the BI Server. OBIEE_WEBCAT web_catalog_ folder install | export Required only for OBIEE 11g Location of the Web Catalog folder used by the BI Server. OBIEE_RPD_PASS rpd_file_pwd install | export The RPD File Password. OBIEE_RPD_USER rpd_file_ username install | export Required only for OBIEE 10g The RPD File username. OBIEE_RPD_ EXPORT_FILE rpd_export_ file_location refresh Location of the OBIEE Repository Documentation export file used for refreshing the lineage. OBIEE_WEBCAT_ EXPORT_FILE webcat_export_ file_location refresh Location of the OBIEE Web catalog report used for refreshing the lineage. OBIEE_ORACLE_ HOME obiee_oracle_ home install | export The BI Server Oracle Home directory OBIEE_ INSTANCE_HOME obiee_instance_ home install | export Required only for OBIEE 11g. The BI Server Instance Home directory. ODI_MASTER_ URL odi_master_url export | refresh The JDBC URL to connect to the ODI Master Repository ODI_MASTER_ DRIVER odi_master_ driver export| refresh The DB Driver to connect to the ODI Master Repository 16 Product TitleBookTitle as a Variable Example 19–1 shows a sample property file: Example 19–1 Property File Version of BIEE Server. Values: 10g 11g OBIEE_VERSION=10g The location of the repository documentation .rpd file of the BI Server OBIEE_RPD=C:obiee11ginstancesinstance2bifoundation OracleBIServerComponentcoreapplication_obis1repositoryTechDemo_11g.rpd The location of the Web Catalog folder used by the BI Server. Required only for OBIEE 11g. OBIEE_WEBCAT=C:obiee11ginstancesinstance2bifoundation OracleBIPresentationServicesComponentcoreapplication_obips1catalogTechDemo The OBIEE Repository user. Required only for OBIEE 10g. OBIEE_RPD_USER=Administrator The password of the OBIEE Repository user OBIEE_RPD_PASS=obiee password The location of the exported Repository Documentation file OBIEE_RPD_EXPORT_FILE=c:odilineagerunrepo_doc.txt The location of the exported Web catalog file OBIEE_WEBCAT_EXPORT_FILE=c:odilineagerunwebcat_doc.txt The BI Server Oracle Home directory OBIEE_ORACLE_HOME=C:obiee11gOracle_BI1 The BI Server Instance Home directory. Required only for OBIEE 11g. OBIEE_INSTANCE_HOME=C:obiee11ginstancesinstance2 The JDBC URL to connect to the ODI Master Repository ODI_MASTER_URL=jdbc:oracle:thin:localhost:1521:orcl ODI_ SUPERVISOR_PASS odi_supervisor_ pwd export | refresh The ODI Password for ODI User with SUPERVISOR privileges ODI_ SUPERVISOR_ USER odi_supervisor_ user export |refresh The ODI user with SUPERVISOR privileges ODI_MASTER_ USER odi_master_ user export | refresh The ODI Master repository username ODI_MASTER_ PASS odi_master_ password export | refresh The ODI Master repository password ODI_SECU_ WORK_REP odi_work_rep export | refresh The Name of the Work Repository containing the lineage tables. OBIEE_WEBCAT_ FOLDER_TO_ EXPORT webcat_folder_ to_export install | export The Web Catalog folder to export in the report. For example: sharedODI INSTALL_ODI_ LINEAGE yes|no only used in script Set to yes to deploy ODI Artifacts on the BIEE Server. EXPORT_OBIEE_ METADATA yes|no only used in script Set to yes to export BI Metadata as flat files. Set to no to only refresh lineage metadata. Table 19–4 ContinuedProperties Property Values Required for Description