Example: Dynamic Mapping to Define User-Preferred Currency Options
17.1.1.2 Attribute Files for Objects
Each object has a corresponding attribute file. For example, the analysis called Analysis1 would have a corresponding attribute file named Analysis1.atr. The attribute file contains the objects full name, access control list ACL, description, and so on. To access an object in the catalog, users must have appropriate ACL entries for that object. All objects in the catalog use ACL entries.17.1.1.3 Lock Files for Objects
To guarantee that only one user can write to a file at one time, a lock file is created when an object is being written to. On rare occasions for example, after a power outage, temporary lock files in the catalog might not be removed completely. If Presentation Services reports of such a lock file, then you must delete it manually.17.1.2 Locations for the Catalog
The following list provides the default locations for the directory that holds catalog files: ■ On Windows systems: ORACLE_ INSTANCE\bifoundation\OracleBIPresentationServicesComponent\coreapplicati on_obipsn\catalog ■ On UNIX systems: ORACLE_ INSTANCEbifoundationOracleBIPresentationServicesComponentcoreapplicati on_obipsncatalog You are not required to store the catalog in its default location. You can store the catalog in other locations. When you work in a cluster configuration, you store the catalog on a shared file system that all nodes in the cluster can access. For information, see Section 5.4.2, Sharing the Oracle BI Presentation Catalog. See Section 17.1.3.3, Handling Catalog Files on Various Platforms for more information on catalog directory names. 17-4 System Administrators Guide for Oracle Business Intelligence Enterprise Edition17.1.3 File System Guidelines for Catalogs
This section describes the following guidelines for working with objects in catalogs in file systems: ■ Section 17.1.3.1, Handling Users of the Catalog ■ Section 17.1.3.2, Handling Heterogeneous Nodes ■ Section 17.1.3.3, Handling Catalog Files on Various Platforms ■ Section 17.1.3.4, Known Issues with Catalog Files17.1.3.1 Handling Users of the Catalog
The catalog is designed to scale to thousands of concurrent users. To achieve this scaling, the catalog adheres to the following guidelines: ■ The average user typically only reads from the catalog and rarely, if ever, writes to it. In Release 11g, each user is constantly and automatically updating his or her Most Recently Used file, but each users read operations still far outweigh the users writes operations. Therefore, the read-to-write ratio is typically at least 100 to 1. ■ While a locking mechanism guarantees that only one user can write to an object at a time, it is rare for multiple users to attempt to write simultaneously to the same object. A feature called lazy locking allows users to continue reading an object even when another user is updating that object. ■ Modern file systems cache small files directly inside the directory record, such that reading any information on a directory simultaneously loads all small files directly into the operating systems memory cache. Therefore, it is good practice to keep files in the catalog small, especially the frequently read .atr metadata files. When these metadata files remain small, then all the .atr files in a directory are loaded into memory with one physical hard disk read. Every file that exceeds the small threshold adds another physical hard disk read, which can cause a 100 degradation for each large file. In other words, use care when considering storing arbitrary Properties in .atr files. ■ Reading an objects .atr metadata file using NFS is far slower than reading it directly from a local disk. For this reason, Presentation Services additionally caches all .atr files internally. This cache can become briefly stale when another node in the cluster writes data to the file that is newer than the data that is cached by the current node. Therefore, all nodes are refreshed according to the MaxAgeMinutes element in the instanceconfig.xml, whose default for a cluster is 5 minutes. This default setting commonly achieves the best trade-off between the possibility of stale data and the known performance impact. The default for an environment without clusters is 60 minutes. You can modify the MaxAgeMinutes element for your system. Its parent elements are Cache and CatalogAttributes. Before you modify the element, ensure that you are familiar with the information in Section 3.4, Using a Text Editor to Update Configuration Settings.17.1.3.2 Handling Heterogeneous Nodes
To allow heterogeneous nodes in a cluster, the catalog adheres to the following guidelines: ■ The maximum length for the name of an object on disk is 256 bytes, which is 64 Unicode characters. The logical name is restricted to 256 Unicode characters. To adhere to this restriction, logical names greater than 32 characters are hashed. Configuring and Managing the Oracle BI Presentation Catalog 17-5 ■ The maximum length for the name of a path on disk is 32KB, which is 8000 Unicode characters. The logical path is restricted to 16000 Unicode characters. ■ All path names on disk are all lowercase. The logical path name allows mixed case, but is still case-insensitive. ■ Certain characters are not allowed for path names on disk, while the logical path name allows all characters. For example, Windows systems disallow certain characters such as the colon :, so those characters are mapped using standard HTML escape sequences. For example, the period character . becomes 2e. ■ Certain file names are not allowed on disk, while the logical object name has no restrictions. For example, Windows systems disallow certain file names such as COM, so those names are mapped using standard HTML escape sequences. For example, com becomes co6d.17.1.3.3 Handling Catalog Files on Various Platforms
Keep the following points in mind when handling catalog files on various platforms: ■ For UNIX Platforms: UNIX kernels must commonly be configured to allow more than 4000 subdirectories per directory. See Section 17.2.1, Manually Changing Additional Configuration Settings for the Catalog for information on the HashUserHomeDirectories element. ■ For Windows Platforms: When users want to navigate catalog files using a tool such as Microsoft Windows Explorer, then they want the catalog structure based on a short path name such as c:obidemo, rather than the long default path name. Note that such navigation is not recommended. – FAT is not supported, and NTFS is required. – Performance on Windows platforms degrades noticeably when more than 8000 files exist in a single directory. Because each catalog object has two files the data file and the .atr metadata file, it is strongly recommended that you not store more than 4000 catalog objects in a single directory. See Section 17.2.1, Manually Changing Additional Configuration Settings for the Catalog for information on the HashUserHomeDirectories element. – Windows Explorer does not handle long path names properly, and it is recommended to not use Windows Explorer to navigate the internal structure of the catalog. While the file system can handle path names as large as 32KB and Presentation Services is not negatively affected, you cannot use Windows Explorer with any path name that is longer than approximately 2KB. Because a single Unicode character can require as many as 4 bytes, you might be unable to use Windows Explorer with path names of only 500 Unicode characters. This limitation does not affect Presentation Services. Because of this limitation, place the catalog in a top-level directory, such as c:\mycatalog\sales.17.1.3.4 Known Issues with Catalog Files
The following issues are known when working with catalog files: ■ Locking across NFS systems is difficult, but Presentation Services provides an effective locking mechanism in recent patches. Obtain key patches to update older versions of Oracle BI EE as necessary. For more information, see Section 17.2.4, Validating the Catalog. 17-6 System Administrators Guide for Oracle Business Intelligence Enterprise Edition ■ Various third-party FTP programs have issues handling escape sequences, which often results in a renamed file that is doubly escaped. For example, a file that is named sa2epaint whose logical name is SA.Paint is incorrectly renamed to sa252epaint whose logical name is SA2ePaint. Avoid using an FTP program directly against a catalog. Instead, download and use the 7-Zip utility to compress the catalog files, then use an FTP program to transfer the resulting compressed file.17.2 Maintaining the Oracle BI Presentation Catalog
This section contains the following topics on maintaining a catalog: ■ Section 17.2.1, Manually Changing Additional Configuration Settings for the Catalog ■ Section 17.2.2, Manually Creating a New Oracle BI Presentation Catalog ■ Section 17.2.3, Deploying Catalogs and Objects to Production ■ Section 17.2.4, Validating the Catalog17.2.1 Manually Changing Additional Configuration Settings for the Catalog
In addition to the presentation settings that you can change in Fusion Middleware Control, you can modify other settings manually. Use various elements in the instanceconfig.xml file to change these settings. Before you begin this procedure, ensure that you are familiar with the information in Section 3.4, Using a Text Editor to Update Configuration Settings . To manually change additional configuration settings for the catalog: 1. Open the instanceconfig.xml file for editing as described in Section 3.6, Where Are Configuration Files Located?2. Locate the Catalog section in which you must add the following element:
■ HashUserHomeDirectories : Specifies the hashing of directories. If you have more than 4000 catalog users or if you intend to have more than 4000 catalog users in the future, then you must turn on the hashing of users home directories to address a file system limitation. To do so, set the HashUserHomeDirectories element to 2 from its default value of 0. When this element is turned on, for example, the default name for user Steves home directory would become usersststeve.3. Include the element and its ancestor element as appropriate, as shown in the
following example: ServerInstance ps:Catalog xmlns:ps=oracle.bi.presentation.servicesconfigv1.1 Caution: Keep the following points in mind: ■ The HashUserHomeDirectories element must be set immediately after installing Oracle BI EE to be effective. ■ Include only one Catalog element in the instanceconfig.xml file or unexpected results might occur. Unless expressly noted, include most nodes in an XML document only once.Parts
» Oracle Fusion Middleware Online Documentation Library
» What Are the Oracle Business Intelligence System Administration Tasks?
» Getting Started with Managing Oracle Business Intelligence
» A Single Host and Enterprise Install
» A Single Host and Simple Install
» Oracle Business Intelligence on Multiple Hosts
» About Java Components About Java Components and System Components for Oracle Business Intelligence
» What Is the Administration Server?
» Fusion Middleware Control What System Administration Tools Manage Oracle Business Intelligence?
» Oracle WebLogic Server Administration Console
» Oracle Process Manager and Notification Server OPMN Tool
» Oracle Weblogic Scripting Tool WLST
» Oracle BI Administration Tool
» Job Manager What System Administration Tools Manage Oracle Business Intelligence?
» Working with the Sample Application
» Oracle BI Publisher Integration
» Topics of Interest in Other Guides
» System Requirements and Certification
» Why Use Fusion Middleware Control and WebLogic Server Administration Console?
» Logging into Fusion Middleware Control to Manage Oracle Business Intelligence
» Using Fusion Middleware Control to Manage Oracle Business Intelligence System Components
» About the Navigation Tree in Fusion Middleware Control
» Configuring Oracle Business Intelligence
» Using Fusion Middleware Control to Update Oracle Business Intelligence Configuration Settings
» Using the Oracle BI Systems Management API to Update Configuration Settings
» Using a Text Editor to Update Configuration Settings
» Where Are Configuration Files Located?
» About Starting and Stopping Oracle Business Intelligence
» Starting Oracle Business Intelligence on Windows Platforms
» Starting Oracle Business Intelligence on UNIX Platforms
» Using Oracle WebLogic Server Administration Console to Start and Stop Java Components
» Using the OPMN Command Line to Start, Stop, Restart, and View the Status of System Components
» Using a Windows Service to Start and Stop System Components
» Confirming Whether the Administration Server Is Running
» Click Start. Oracle Fusion Middleware Online Documentation Library
» Administration Server Fails to Start When the Database Is Not Running
» Oracle BI Server Fails to Start
» Oracle BI Presentation Services Fails to Start
» Cannot Log In Troubleshooting System Startup
» How Do I Know When to Scale Out Processes?
» What Processes Should I Scale?
» Vertically Scaling Oracle Business Intelligence Horizontally Scaling Oracle Business Intelligence
» Uploading and Sharing the Oracle BI Repository
» Using Fusion Middleware Control to Identify Single Points of Failure
» Achieving High Availability Using an Active-Passive Model
» Using Fusion Middleware Control to Configure Primary and Secondary Instances
» Setting Optional Cluster Controller Parameters
» Setting Optional Presentation Services Parameters
» Setting Optional Oracle BI Presentation Services Plug-in Parameters
» Status Information Viewing and Managing Cluster Information
» Cache Information Viewing and Managing Cluster Information
» Select Action, and then select an option.
» Server Information Viewing and Managing Cluster Information
» Using Fusion Middleware Control to View Common Performance Metrics
» Using Fusion Middleware Control to View All Oracle Business Intelligence Metrics
» Using the Administration Console to View Metrics for Java Components
» About Query Performance Tuning
» Using Fusion Middleware Control to Disallow RPD Updates
» Using Fusion Middleware Control to Set the User Session Log-Off Period
» Using Fusion Middleware Control to Set the Maximum Number of Rows Processed to Render a Table
» Query Cache Architecture About the Oracle BI Server Query Cache
» Advantages of Caching About the Oracle BI Server Query Cache
» Administrative Tasks Costs of Caching
» Keeping the Cache Up To Date
» About the Refresh Interval for XML Data Sources
» Using Fusion Middleware Control to Enable and Disable Query Caching
» Using Fusion Middleware Control to Set Query Cache Parameters
» Manually Editing Additional Query Cache Parameters
» Using Fusion Middleware Control to Set Global Cache Parameters
» Manually Editing Additional Global Cache Parameters
» Disable Caching for the System
» In the Physical Table properties dialog, in the General tab, make one of the
» To set a cache expiration time, specify a Cache persistence time and specify a unit
» Click OK. Caching and Cache Persistence Timing for Specified Physical Tables
» Configure Oracle BI Server Event Polling Tables
» Storing and Purging Cache for SAPBW Data Sources
» Online Mode How Repository Changes Affect the Query Cache
» Offline Mode How Repository Changes Affect the Query Cache
» Switching Between Repositories How Repository Changes Affect the Query Cache
» Changes to Dynamic Repository Variables
» Ensuring Correct Cache Results When Using Row-Level Database Security
» Running a Suite of Queries to Populate the Cache
» Using Agents to Seed the Oracle BI Server Cache
» Displaying Global Cache Information in the Cache Manager
» Select Manage, then Cache to open the Cache Manager dialog.
» Select Cache or Physical mode by selecting the appropriate tab in the left pane.
» Select the cache entries to purge, and then select Edit, then Purge to remove them.
» Polling Table Structure Setting Up Event Polling Tables on the Physical Databases
» Sample Event Polling Table CREATE TABLE Statements
» Making the Event Polling Table Active
» Populating the Oracle BI Server Event Polling Table
» Troubleshooting Problems with Event Polling Tables
» Managing the Oracle BI Presentation Services Cache Settings
» Using Fusion Middleware Control to View Log Information, Error Messages, and Alerts
» Click Lock and Edit Configuration to enable changes to be made.
» Click Apply, then click Activate Changes.
» Return to the Business Intelligence Overview page and click Restart.
» Locate the section in which you must add the Format element, which specifies the
» Include the element and its ancestor elements as appropriate, as shown in the
» What Are Diagnostic Log Files and Where Are They Located?
» What Are Diagnostic Log Configuration Files and Where Are They Located?
» What Are Log File Message Categories and Levels?
» What Messages Are Included in the System Log?
» Setting the Query Logging Level
» Double-click the name of the user for which you want to set the query logging
» Set the logging level by clicking the Up or Down arrows next to the Logging Level
» Click OK. Setting the Query Logging Level for a User
» Running the Log Viewer Utility
» Interpreting the Log Records
» Examples of the Formats of Logged Messages
» Oracle BI Presentation Services Message Structure
» Oracle BI Presentation Services Log Filters
» Diagnosing Issues with Agents
» Setting Up Direct Insertion to Collect Information for Usage Tracking
» Selecting an Output Location
» File Naming Conventions Output File Format
» Performance Considerations Setting Up a Log File to Collect Information for Usage Tracking
» Description of the Usage Tracking Data
» Understanding Modes Why Upload a Repository and Set the Catalog Location?
» Understanding Repository Version Numbers
» Using the System MBeans to Upload the Metadata Repository
» Click OK. Configuring E-Mail and Agents
» Using Fusion Middleware Control to Configure the Connection to the Marketing Content Server
» Configuring to Download Oracle Hyperion Smart View for Office
» Using Fusion Middleware Control to Change Presentation Setting Defaults
» What Are the System Requirements for Map Views?
» Associating Layers with Columns
» Changes to Spatial Metadata Require Restart
» Administration Page Functions Administering Maps
» Administering Maps Using Administration Pages
» Hardware Sizing and Deployment Strategy for Maps Why and Where are Time Zones Used?
» Setting Time Zones Oracle Fusion Middleware Online Documentation Library
» Description of Time Zone Settings
» Example: Configuration File Settings for Specifying the Time Zone
» What Components Are Translated?
» Tasks for Localizing Oracle Business Intelligence Components
» Understanding the Directory Structure for Localizing Presentation Services
» Click Languages. Specifying the Default Language for the Sign-In Page
» Use the Move Up and Move Down buttons to position the desired language at the
» Locate the ServerInstance section, in which you must add the following elements:
» Specifying the Language in the URL
» From the Tools menu, select Export Captions.
» Click Browse to select the location in which to write the output file, then click OK.
» To exclude the Description properties from the export, select Exclude
» Click OK. Step 2: Exporting Text Strings in the Catalog
» Step 1: Understanding the Export Process Step 3: Editing Exported Strings in XML Files
» Click OK. Step 4: Handling Duplicate Exported Text Strings
» The export process not only generates new XML files, but the process also
» Sign into Oracle Business Intelligence and select the appropriate language, such as
» Display the translated content.
» Tip for Arabic and Hebrew in Mozilla Firefox Browsers
» Setting the Current Locale in Catalog Manager
» Setting the Locale on UNIX Systems
» Handling the NLS Locale Not Supported Error Message
» Setting the Japanese Locale on AIX Systems
» Localizing Metadata Names in the Repository
» What is Multilingual Data Support?
» What is Lookup? Supporting Multilingual Data
» What is Double Column Support?
» A Lookup Table for Each Base Table
» A Lookup Table for Each Translated Field
» Creating Logical Lookup Tables
» Designating a Logical Table as a Lookup Table About the LOOKUP Function Syntax
» Creating Logical Lookup Columns
» Creating Physical Lookup Tables and Physical Lookup Columns
» Supporting Multilingual Data in Essbase Through Alias Tables Enabling Lexicographical Sorting
» Defining User-Preferred Currency Options Using a Dynamic Mapping
» Example: Dynamic Mapping to Define User-Preferred Currency Options
» Handling Users of the Catalog
» Handling Heterogeneous Nodes File System Guidelines for Catalogs
» Handling Catalog Files on Various Platforms Known Issues with Catalog Files
» Manually Changing Additional Configuration Settings for the Catalog
» Manually Creating a New Oracle BI Presentation Catalog
» Deploying Catalogs to Production
» Performing a Basic Validation of the Catalog
» Locate the Catalog section in which you must add the elements that are described
» Include the elements and their ancestor element as appropriate, as shown in the
» Save your changes and close the file.
» Guidelines for Working with Catalog Manager
» Tips for Working with Catalog Manager
» Starting Catalog Manager Starting Catalog Manager and Opening Catalogs
» Online Mode Understanding the Two Catalog Modes
» Take Presentation Services on each computer in the cluster out of Maintenance
» Operations Available in Online Mode and Offline Mode
» Opening an Oracle BI Presentation Catalog
» What Does the Catalog Manager Workspace Do?
» What Does the Catalog Manager Workspace Look Like?
» Managing the View of the Catalog Manager Workspace
» Searching for Catalog Objects Using Catalog Manager
» In the source catalog, right-click the source object and select Copy.
» Advanced Options for Pasting Objects
» Renaming Catalog Objects Working with the Properties of Catalog Objects
» Setting Permissions of Catalog Objects
» Previewing Objects from Catalog Manager
» What Happens When Tenants are Provisioned?
» What Options are Available for Provisioning?
» Locate the section in which you must add the EnableMultiTenancy element.
» Viewing and Editing Catalog Objects in XML
» Searching for and Replacing a Simple Catalog Text String
» XML File Format for Searching for and Replacing Text Strings
» Example XML File for Searching for and Replacing Text Strings
» Searching for and Replacing Multiple Catalog Text Strings
» Creating Reports to Display Catalog Data Using Catalog Manager
» Archiving a Folder Using Catalog Manager
» Unarchiving a Folder Using Catalog Manager
» What is a Full-Text Catalog Search?
» Deployment of Oracle Full-Text Catalog Search
» How is Security Handled in the Full-Text Catalog Search?
» Click Administration in the global header.
» On the Administration tab, click Manage Privileges.
» Step 2: Ensuring that Secure Enterprise Search is Available
» Display the Identity Management Setup page using steps such as the following:
» Click Finish. Step 3: Configuring Identity Management for Full-Text Catalog Search
» In the Source Type list, select Oracle Fusion, then click Create.
» If you clicked Create and Customize, then on the Documents tab, add the RTF
» Click Apply. Step 4: Creating the Data Source for Full-Text Catalog Search
» Step 5: Editing the Schedule for Full-Text Catalog Search
» Select Global Settings, then Configure Search Result List in the Out-of-Box
» Enable the replication of the Oracle BI Presentation Catalog.
» Perform a full crawl on the catalog.
» Locate the section in which you must add the Replication element.
» Restart Oracle Business Intelligence.
» Step 8: Configuring Properties for Full-Text Catalog Search Manually
» Step 9: Allowing Users to Access the Full-Text Catalog Search
» Replication Log File Records
» Configuring to Replicate an Oracle BI Presentation Catalog
» Copying Oracle BI Presentation Catalog Files
» mark Using the Oracle BI Presentation Services Replication Agent
» remotecopy Using the Oracle BI Presentation Services Replication Agent
» run Using the Oracle BI Presentation Services Replication Agent
» Structure of the Configuration File
» Elements of the Configuration File
» Editing the instanceconfig.xml File for Replication
» Resuming Replication if Replication Log Files Are Unavailable
» Managing Dashboards Oracle Fusion Middleware Online Documentation Library
» Providing Access to Metadata Dictionary Information
» Supporting Nested Folders, Navigation, and Drill-Down
» Manually Configuring Cube Settings for Pivot Tables and Graphs
» Manually Configuring Settings for Data in Views
» Configuring Fonts for Graphs
» Manually Changing Alternating Bar Color
» Manually Changing Presentation Setting Defaults
» Configuring Links to Dashboard Pages
» Configuring an Alternate Toolbar for Oracle BI Publisher
» Modifying the Table of Contents for PDF Versions of Briefing Books
» Storing JavaScript Files Blocking Analyses in Answers
» Blocking Analyses Based on Criteria
» Blocking Analyses Based on Formula
» Validation Helper Functions Blocking Analyses in Answers
» XML Message Files for View Defaults
» Adding a Default Header or Footer to New Analyses Preventing Auto-Previewing of Results
» Setting Defaults for Analyses in the Compound Layout Changing Dashboards Section Defaults
» Specifying Dashboard Page Defaults Including Headers and Footers
» Write-Back Limitations Configuring for Write Back in Analyses and Dashboards
» Locate the ServerInstance section in which you must add the LightWriteback
» Requirements for the Write-Back Template
» Example: Write-Back Template About the Write-Back Template
» How Does Antivirus Software Affect Agents?
» What Privileges Affect Agents?
» Manually Configuring Presentation Services Settings That Affect Agents
» Manually Changing Additional Scheduler Settings That Affect Agents
» General Scheduler Configuration Settings That Affect Agents
» E-Mail Scheduler Configuration Settings That Affect Agents
» Agent Scheduler Configuration Settings
» Controlling Delivery Options for Agents
» Managing Device Types for Agents
» Monitoring Active Agent Sessions
» Configuring MapViewer to Support Map Views
» Manually Configuring for Map Views
» Inserting Text on a Map Configuring Maps for External Consumption
» What Is the Oracle BI Systems Management API?
» Accessing Oracle BI Systems Management API Methods
» Example: Using a Java Program to Display the Status of Oracle Business Intelligence
» Example: Using WLST Commands to Stop and Start Oracle Business Intelligence
» Example: Using WLST to Edit the E-Mail Sender Display Name Configuration Setting
» Example: Using a Java Program to Edit the E-Mail Sender Display Name Configuration Setting
» Example: Using WLST to Scale Out to Servers
» Example: Using a Java Program to Scale Out to Servers
» Using the Dynamic Monitoring Service for Metrics
» Verify that you are in online mode by viewing the following prompt:
» Descriptions of JMX Admin MBeans and Methods for the Oracle BI Systems Management API
» Step 1: Stop System Component Processes for Oracle BI EE
» Step 2: Invoke OPatch with -rollback Option
» Step 3: Start System Component Processes for Oracle BI EE
» Step 4: Redeploy J2EE Applications
Show more