Readme File. Hyperion System 9 BI+ Application Builder.NET Release 9.2 Readme. Hyperion System 9 BI+ Application Builder.NET Release 9.

Transcription

1 Hyperion System 9 BI+ Application Builder.NET Release 9.2 Readme Readme File This file contains the following sections: Purpose... 2 New Features... 2 Grid Adapters... 2 Grid Adapter Generic... 2 Grid Adapter OWC Web Metadata Adapters... 3 Drop-Down List Adapter... 3 List Box Adapter... 3 Installation Updates... 3 Application Builder.NET Prerequisites... 3 Programming Environment... 3 Using Hyperion Application Builder.NET with EDS Replacing ESS_JAPI.JAR... 3 Deploying EssbaseObjects.war file... 4 Using Application Builder for.net Release 9.2 to work with Oracle s Hyperion Essbase System 9 Release Deployment Solution 1:... 4 Deployment Solution 2:... 4 Known Issues... 5 Grid Adapters... 5 GridAdapterGeneric error "The Operation could not be completed" ( )... 5 GridAdapterOWC11 error "The Operation could not be completed" ( )... 5 Grid Adapter for Web-OWC11 Spread Sheet Adapter ( )... 5 OWC 11 AllowFlashback Property ( )... 5 Web Metadata Adapter... 6 List Box Adapter Data Server not visible in Data Server property ( )... 6 List Box Adapter and :... 6 Interoperability

2 Support of Essbase Non-Unique members ( )... 6 Configuration Utility... 6 Configuring the Analytic High Availability Services... 6 Configuration... 7 Step 1 Start the High Availability Server (EDS):... 7 Step 2 Start the EAS server and launch the EAS console:... 7 Step 3 In the left pane, select High Availability Servers, right click and select Add High Availability Servers Step 4 Note the added High Availability Server, expand the particular High Availability Server, right click on the Essbase node and select Create > Analytic Server... 8 Step 5 - Expand the High Availability Server which you added to Essbase > Accounts, right click on the Users and select Create User Verifying the Installation... 9 Note: Any references in the documentation to the Oracle E-Delivery site pertain if your site has access. Purpose This document includes important, late-breaking information about this release of Application Builder for.net. Review this information thoroughly before installing Application Builder for.net. This release has been created to address a specific issue(s). To ensure that this release is appropriate for your installation, or if you have questions regarding supported platforms, installation steps, addressed issues, or any other issues, please contact Customer Support before installing this release. Top of Document New Features Grid Adapters The Web grid adapters enable you to select the data server controls and exchange data from different data grid types and controls the information exchanged between them. Grid Adapter Generic The GridAdapterGeneric class is used to pass information between grids that have a data source property supporting a dataset. Grid Adapter OWC11 The Grid Adapter OWC11 control enables communication between Analytic Services related functionality and a Microsoft Office Web Components (OWC11) Spreadsheet. 2

3 Web Metadata Adapters The Web metadata adapter components enable you to exchange metadata between Data Servers and the list. Drop-Down List Adapter The DropDownListAdapter class is used to access the Data Server controls using the drop-down list. The DropDownListAdapter class encapsulates the information and actions used to add and remove Analytic Services members to or from a drop-down list. List Box Adapter The ListBoxAdapter class is used to access the Data Server controls using the list box. The ListBoxAdapter class encapsulates the information and actions used to add and remove Analytic Services members to or from a list box. Top of Document Installation Updates The section includes important information about installing this release of Application Builder for.net. Application Builder.NET Prerequisites Before you begin installation, you should have the following Hyperion products already installed: Hyperion Essbase 7x or Hyperion System 9 BI+ Analytic Services Release 9.0 Hyperion System 9 BI+ Analytic High Availability Services Release 9.0 Note: HAB.NET Release 9.2 is not supported with Hyperion Essbase Deployment Services Release 7.x Sun Java JDK (provided as an Application Builder.NET installation option) Office Web Components 11, Microsoft Data Grid or Web Data Grid, or other grid software When using the Office Web Components 11 (OWC11), the Microsoft Office Primary Interop Assemblies are required for all Windows operating systems Programming Environment Application Builder.NET requires Microsoft Visual Studio for.net 2003 as a programming environment. Using Hyperion Application Builder.NET with EDS This release of Hyperion Application Builder.NET installs EDS Release 9.2 by default. If you want to use this release of Hyperion Application Builder.NET with EDS Release 7.1.2, you must complete the following tasks. Replacing ESS_JAPI.JAR To replace ess_japi.jar (9.2) with ess_japi.jar (7.1.2) in EssbaseObjects.war: 3

4 Copy the EssbaseObjects.war file from HABNET_HOME\servlet to a temporary folder, such as C:/warUpdate. Unzip and extract the war file to the same temporary folder. The temporary folder should now contain two sub-folders: META-INF and WEB-INF. The WEB-INF folder should contain a lib folder and the web.xml file. Browse to HABNET_HOME\Essjapi7.1.2 and copy the ess_japi.jar (7.1.2) to the WEB- INF\Lib folder in the temporary directory you previously created, overwriting the ess_japi.jar (9.2). Open a command prompt and navigate to the temporary folder you created (c:\warupdate). Enter the following command: jar -cvf EssbaseObjects.war *.* The temporary folder (C:/warUpdate) now contains the updated EssbaseObjects.war file. Deploying EssbaseObjects.war file To deploy the EssbaseObjects.war file: Copy the updated EssbaseObjects.war file to the following folders: HABNET_HOME\products\Essbase\habnet\Server\servlet HABNET_HOME\deployments\Tomcat\5.0.28\webapps Navigate to HABNET_HOME\bin and start any of the Hyperion Application Builder.NET Servers (Tomcat, WebLogic, or WebSphere) Using Application Builder for.net Release 9.2 to work with Oracle s Hyperion Essbase System 9 Release Deployment Solution 1: Note: Opt for this solution when all servers are present on one machine 1. Install Application Builder for.net Release 9.2 and configure. 2. Update and deploy EssbaseObjects.war per instructions provided. ** 3. Install other applicable products from the release on the server on which the Application Builder for.net is installed. 4. Do Not re-run the Application Builder for.net Release 9.2 installer again as running this installer will replace the modified EssbaseObjects.war and other common settings. Deployment Solution 2: Note: Opt for this solution if the Application Builder for.net is present on a separate machine Install Application Builder for.net Release 9.2 on a dedicated server. 4

5 Update and deploy EssbaseObjects.war per instructions provided. ** Install all other products on different server(s). **The modified war file referenced in the following steps is attached for your convenience (change the extension of the attached file from.warx to.war). Unwar the Application Builder for.net Release 9.2 war file. Replace the ess_japi.jar 9.2 version with the ess_japi.jar version. Create war file and replace the old war file in the following locations: a. HAB.NET_HOME/Deployments/Tomcat/5.0.28/webapps b. HAB.NET_HOME/products/Essbase/habnet/Server/servlet Change the content of the file <HAB.NET_HOME>\lib\Habnet.properties to the following: EDSUrl= Top of Document Known Issues The following are some known issues in Application Builder.NET Release 9.0.1: Grid Adapters GridAdapterGeneric error "The Operation could not be completed" ( ) When you drag and drop the GridAdapterGeneric control, the error "The Operation could not be completed" is displayed and the Adapter cannot be dropped into components tray. To address the issue, add the reference Hyperion.Objects.Essbase.Commom.Grid.WebDataGrid" to the project reference and then drag and drop the control. GridAdapterOWC11 error "The Operation could not be completed" ( ) When you drag and drop the GridAdapterOWC11 control, the error "The Operation could not be completed" is displayed and the Adapter cannot be dropped into components tray. To address the issue, add the reference "Hyperion.Objects.Essbase.Commom.Grid.OWC11" to the project reference and then drag and drop the control. Grid Adapter for Web-OWC11 Spread Sheet Adapter ( ) One of the requirements for the Grid Adapter for Web-OWC11 Spread Sheet Adapter is that the object link supports 127 properties in the OWC11 adapter. The current version of this adapter in.net supports only 27 properties. OWC 11 AllowFlashback Property ( ) AllowFlashback is not implemented for OWC 11. 5

6 Web Metadata Adapter List Box Adapter Data Server not visible in Data Server property ( ) When you drag and drop the List Box adapter, the data server is not visible in the data server property. To address the issue, delete all the components in the components tray and then drag and drop the control. List Box Adapter and : When List Box controls are created for all stored dimensions in the outline, if multiple members are selected from all List Boxes, when retrieving data, the following error will appear: You must have a column header in order to perform this retrieval. This issue will be addressed in the Release 9.3. Interoperability Support of Essbase Non-Unique members ( ) Essbase Non-Unique members are not supported in this release. Configuration Utility When running the Hyperion Configuration Utility after upgrading products from release to release 9.2.0, the product selection page may display multiple listings for a product or may not list the product you are trying to configure. If this problem occurs, perform these steps: Navigate to the following directory: (Windows): <HYPERION_HOME>\common\config\product\<product>\<release number> (UNIX): <HYPERION_HOME>/common/config/product/<product>/<release number> Where <HYPERION_HOME> is the Hyperion Home location on the machine and <product> is the product name or abbreviation, for example: c:\hyperion\common\config\product\planning\9.3.0 Delete the oldest *.xml file from this directory. For example, if the directory contains two files named planning_1.xml and planning_2.xml, delete the older file. Re-run the Configuration Utility. Top of Document Configuring the Analytic High Availability Services This section details how to configure Analytic High Availability Service with Application Builder.NET; specifically the registration process for High Availability Server (EDS) and Analytic Server in the Analytic Administration Services (EAS) Console. Note that the following 6

7 procedures refer to Analytic Administration Services (EAS) Release 9, however EAS 7x can also be used to configure EDS. Configuration Step 1 Start the High Availability Server (EDS): Start > Programs > Hyperion System 9 BI+ > Analytic High Availability Services > Start High Availability Services Server HTTP Step 2 Start the EAS server and launch the EAS console: Start EAS server: Start > Programs > Hyperion System 9 BI+ > Analytic Administration Services > Start Administration Service Server Launch the EAS Administration Console: Start > Programs > Hyperion System 9 BI+ > Analytic Administration Services > Start Administration Services Console When prompted, log on to the EAS Admin console: Step 3 In the left pane, select High Availability Servers, right click and select Add High Availability Servers. The following dialog box is displayed: 7

8 In the previous dialog box, if all the servers are running on the same machine and default port, leave the default and click OK. Otherwise, if EDS is running on another system or port, enter the necessary machine IP Address and/or port in the URL. Step 4 Note the added High Availability Server, expand the particular High Availability Server, right click on the Essbase node and select Create > Analytic Server. In the previous screen, if all the servers are running in the same machine you enter server name as a localhost, otherwise if Essbase is running on another machine enter the server name as that Essbase running machine IP address. 8

9 Step 5 - Expand the High Availability Server which you added to Essbase > Accounts, right click on the Users and select Create User. In the previous screen, enter the following information: User Name: This user name should be Essbase user name only. Password: Password should be Essbase password only. Administrator Privileges: By Default, it will be False, change it to True. Click OK. The configuration is now complete. Verifying the Installation First ensure the Analytic Server (Essbase), Analytic High Availability Services (EDS) and Application Builder.NET (HAB.NET) servers are running: Essbase Server: Start > Programs > Hyperion System 9 BI+ > Analytic Services > Start Analytic Server Analytic High Availability Services (EDS) Server: Start >Programs > Hyperion System 9 BI+ > Analytic High Availability Services > Start High Availability Services Server HTTP Application Builder.Net (HAB.NET) Server: Start >Programs > Hyperion System 9 BI+ > Application Builder.NET > Start HABNET Server Once running, verify the two installations by launching the following URLs in a browser: Note: the URLs are case sensitive, and in both cases, a welcome page is displayed: 9

10 Top of Document Copyright 1991, 2008 Oracle and / or its affiliates. All rights reserved. P/N DJ