61
1 Lab 1.1 Lab Environment and Installations 1 Overview This lab provides you the steps to prepare your laptop for use in the hands-on labs You will perform the following tasks: - Copy all class files from the DVD to your hard drive - Unzip and enable VMware Image - Install Hyperion Client Tools Essbase Integration Services Console Essbase Client Essbase Administration Services Console 2 Copy Class Files and Enable VMware Image In all of the labs you will be using a VMware image containing Oracle Enterprise Linux (version 4.0), an Oracle 10g Database, and an Essbase Server environment. You will connect to this image via the Local Private network that is established by VMware by default. 1. Copy the contents of the DVD to your hard drive. There are two folders, In Class Files and Installs, and one self-extracting zip file, ESSBASE_OEL4.exe. The In Class Files folder contains all the necessary files for you to complete your exercises, the Installs folder contains all the software installation needed for the labs, and ESSBASE_OEL4.exe contains the VM that you will be using to run your labs. 2. Double-click or run ESSBASE_OEL4.exe to extract the VM. The contents of the VM will be in a folder called ESSBASE_OEL4. 3. Your extracted folder should appear as below:

Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

Embed Size (px)

Citation preview

Page 1: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

1

Lab 1.1 Lab Environment and Installations

1 Overview

This lab provides you the steps to prepare your laptop for use in the hands-on labs You will perform the following tasks: - Copy all class files from the DVD to your hard drive - Unzip and enable VMware Image - Install Hyperion Client Tools

• Essbase Integration Services Console

• Essbase Client

• Essbase Administration Services Console

2 Copy Class Files and Enable VMware Image

In all of the labs you will be using a VMware image containing Oracle Enterprise Linux (version 4.0), an Oracle 10g Database, and an Essbase Server environment. You will connect to this image via the Local Private network that is established by VMware by default.

1. Copy the contents of the DVD to your hard drive. There are two folders, In Class Files and Installs, and one self-extracting zip file, ESSBASE_OEL4.exe. The In Class Files folder contains all the necessary files for you to complete your exercises, the Installs folder contains all the software installation needed for the labs, and ESSBASE_OEL4.exe contains the VM that you will be using to run your labs.

2. Double-click or run ESSBASE_OEL4.exe to extract the VM. The contents of the VM will be in a folder called ESSBASE_OEL4.

3. Your extracted folder should appear as below:

Page 2: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

2

4. There are several options to start the VMware image. The easiest is to double-click the “Oracle Enterprise Linux 4.vmx” file. This will start up your default VMware product installation: VMware Workstation, VMware Server, or VMware Player. If you failed to prepare your laptop prior to class an installer for VMware Player (VMware-player-2.0.2-59824.exe) and VMware Server (VMware-server-installer-1.0.4-56528.exe) have been included in the Installs/VMware folder. Player runs slightly faster than Server, but it does not allow you to create your own Virtual Machines. Server also has more setup options than Player.

5. For our VMware Networking option we will use the “Host-Only: setting to create a private network. If your Host Laptop has a Cisco VPN Client installed and the Cisco VPN Service running you may be unable to Ping or communicate with the Guest (Linux). Please check your Windows Services for the status of the “Cisco Systems, Inc. VPN Service”. If it is started, please stop it.

6. Once the VM program opens press the Play button to start your VM image.

Page 3: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

3

You will be presented with a window regarding the VMware unique ID for this image. Select “Keep” so you can avoid any potential virtual hardware reconfiguration that might be asked of you.

7. Background processes on the VM including the Oracle 10g Database will start so the boot up may take a few minutes. At the login screen sign in as: Username: oracle Password: oracle

8. Once the OS finishes loading, click the “ShowIP” shortcut on desktop

Page 4: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

4

The IP Address for the Linux Server will be returned.

9. Write down the IP Address from the Terminal window, you will need it in later steps.

10. Leave the VMware instance running for now. You will need it for the next set of labs. If you need to shutdown the VM or your computer for any reason, on the Linux tool bar (at the top) click Actions -> Logout -> Shutdown You should always ensure that prior to starting any lab that your VM instance is running and you are logged in as “oracle” / ”oracle”.

3 Install Hyperion Client Tools

In order to communicate with the Hyperion server, the following Windows clients need to be installed: - EIS Console. - Essbase Client (includes Excel Add-in). - EAS Console

4.1 Install EIS Console

1. Navigate to the location on your drive where you copied the Installs folder from the DVD.

2. Open the EIS folder.

3. Double-click or run “setup.exe”.

4. The InstallShield Wizard appears and prepares your Java Virtual Machine to perform your EIS installation using the wizard.

Page 5: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

5

5. Initially you are presented with a screen to select the language for the install wizard.

Click “OK”

6. Click “Next” at the welcome screen.

7. Click “Next” at the location screen.

Page 6: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

6

8. Select “I AGREE” and click “Next” at the license agreement screen.

9. Enter the Hyperion Home directory and click “Next”

10. Enter the EIS directory that EIS will install into (C:\Hyperion\EIS) and click “Next”

Page 7: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

7

11. Select “Custom” for installation type and click “Next”

12. Make sure that “Console” is the only item selected for installation by de-selecting “Server” and “Sample Applications” and click “Next”

13. Click “Next” at the installation summary screen.

Page 8: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

8

14. The installation will proceed as a status window appears. Click “Next” once installation has finished.

15. Click “Finish” to exit the installation wizard.

16. Verify that the EIS Console shortcut was created by going to Start->Programs->Hyperion->Integration Services->Integration Services Console.

Page 9: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

9

4.2 Install Essbase Add-in for Excel

1. Navigate to the location on your drive where you copied the Installs folder from the DVD.

2. Open the EssbaseClient folder.

3. Double-click or run “setup.exe”.

4. The InstallShield Wizard appears and prepares your Java Virtual Machine to perform your Essbase Add-in installation using the wizard.

5. Initially you are presented with a screen to select the language for the install wizard.

Click “OK”

6. Click “Next” at the welcome screen.

Page 10: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

10

7. Click “Next” at the location screen.

8. Select “I AGREE” and click “Next” at the license agreement screen.

9. Enter the Hyperion Home directory and click “Next”

Page 11: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

11

10. Enter the directory that the Essbase Add-in will install into (C:\Hyperion\Essbase\client) and click “Next”

11. Select “Typical” for installation type and click “Next”

12. Click “Next” at the ESSLANG and installation summary screens.

Page 12: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

12

13. The installation will proceed as a status window appears. Click “Next” once installation has finished.

Click “Finish” to exit the installation wizard.

Page 13: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

13

14. Open Excel. “Essbase” should appear in the menu bar. If it does not, proceed with a manual configuration.

15. To manually add/remove the Essbase Add-in, from the menu bar, choose Tools->Add-Ins…

16. Check/un-check the two Hyperion Essbase options. Click “OK”.

Page 14: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

14

17. If no Hyperion Essbase options appear on the Add-Ins list, click “Browse…”. Navigate to the bin folder of the location you installed the Essbase Client (C:\Hyperion\Essbase\client\bin)

18. Double-click or select “essexcln.xll” and click “OK”.

The Essbase Add-in for Excel should now appear on the Add-Ins list. Proceed with Step 16 above to enable the Add-in.

Page 15: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

15

4.3 Install EAS Console

1. Navigate to the location on your drive where you copied the Installs folder from the DVD.

2. Open the EAS folder.

3. Double-click or run “setup.exe”.

4. The InstallShield Wizard appears and prepares your Java Virtual Machine to perform your EIS installation using the wizard.

5. Initially you are presented with a screen to select the language for the install wizard.

Click “OK”

6. Click “Next” at the welcome screen.

Page 16: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

16

7. Click “Next” at the location screen.

8. Select “I AGREE” and click “Next” at the license agreement screen.

9. Enter the Hyperion Home directory and click “Next”

Page 17: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

17

10. Enter the EAS directory that EAS will install into (C:\Hyperion\EAS) and click “Next”

11. Select “Custom” for installation type and click “Next”

12. Make sure that “Console” is the only item selected for installation by de-selecting “Server” and “SAP Plugin” and click “Next”

Page 18: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

18

13. Click “Next” at the installation summary screen.

14. The installation will proceed as a status window appears. Click “Next” once installation has finished.

Click “Finish” to exit the installation wizard.

15. Verify that the EAS Console shortcut was created by going to Start->Programs->Hyperion->Administration Services->Start Administration Services Console.

Page 19: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

19

4 Post-Installation Steps

Edit the hosts file to create a network alias for the Linux VM.

1. In Windows Explorer, navigate to C:\WINDOWS\system32\drivers\etc and open the “hosts” file in a text editor or right-click and select “Open”.

Select Notepad and click “OK”.

Page 20: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

20

2. Add a new line at the bottom of the file and type “<IP Address> ptsessbase.us.oracle.com ptsessbase”, where <IP Address> is the IP address you took from your Linux VM in Step 2.9. Save and close the file.

From now on whenever you need to refer to the Linux VM, the server name will be called ptsessbase.

Page 21: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

21

Page 22: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

22

Lab 1.2 Cube Building (BSO) with Essbase Integration Services

1 Overview

This lab steps through the process of building an Essbase BSO cube using Essbase Integration Services (EIS). EIS is a multithreaded server software that is the bridge between the data source, OLAP Metadata Catalog, and Essbase. EIS enables several tasks:

• Retrieves OLAP model and meta-outline information from OLAP Metadata Catalog

• Generates SQL statements

• Retrieves data from external sources

• Loads members and data into the Essbase database In this lab, you will perform the following tasks:

• Start the Hyperion servers

• Connect to the Data Warehouse

• Build an OLAP Model

• Build a Metaoutline

• Create an Essbase Cube

• Query the Cube using EAS or Add-in

2 Start Hyperion Servers

There are four Hyperion services that will need to be started before you can complete the lab:

• Shared Services

• Essbase

• Essbase Administration Services

• Essbase Integration Services

1. Ensure that your VM instance is running and you are logged in as: Username: oracle Password: oracle

In the Linux VM, you will need open several terminal sessions to start up the Hyperion services.

Page 23: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

23

You can open a terminal window in one of three ways: 1. Click on the terminal window icon on the toolbar at the top of the screen.

2. Right-click anywhere on the desktop and select “Open Terminal” from the top of the list.

3. Go the Applications menu, select System Tools and then Terminal from the list of programs.

Page 24: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

24

The resulting Terminal Window will appear as below:

As a convenience, a text file on /home/oracle/Hyperion called Hyperion_Start_Stop_Order.txt can be used to copy/paste the directories and scripts for the subsequent steps. To access the file, double-click on oracle’s Home File Browser icon from the desktop.

Double-click to open the Hyperion folder.

Page 25: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

25

Double-click to open Hyperion_Start_Stop_Order.txt.

To copy/paste text, highlight the text, copy the text by pressing CTRL+C or selecting Edit->Copy. In a terminal window, press <SHIFT>+CTRL+V or select Edit->Paste to paste the text.

Page 26: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

26

In a terminal window, at the prompt type: “cd /home/oracle/Hyperion/deployments/Tomcat5/bin” or paste the directory after you have typed “cd ”. At the prompt, type or paste: “./startSharedServices9.sh” to start up Shared Services. Your window will appear like the one below. Minimize the window (DO NOT CLOSE). Wait approximately 30 seconds before continuing to the next step.

2. Open another terminal window and type: “cd /home/oracle/Hyperion/essbase/bin” or paste the directory after you have typed “cd ”. At the prompt, type or paste: “./startEssbase.sh” to start up the Essbase server in the foreground. At the password prompt, type “oracle” and press <Enter>. Your window will appear like the one below. Minimize the window (DO NOT CLOSE).

Page 27: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

27

Alternatively, you can start Essbase in the background by typing: “./startEssbase.sh oracle &” where “oracle” is the password.

3. Open another terminal window and type: “cd /home/oracle/Hyperion/EAS/server/bin” or paste the directory after you have typed “cd ”. At the prompt, type or paste: “./startEAS” to start up the EAS server. This should take approximately 30 seconds to complete. Your window will appear like the one below. Minimize the window (DO NOT CLOSE).

4. Open another terminal window and type: “cd /home/oracle/Hyperion/EIS” ” or paste the directory after you have typed “cd ”. At the prompt, type or paste: “ ./ais_start” to start up the EIS server. Your window will appear like the one below. Minimize the window (DO NOT CLOSE).

Page 28: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

28

5. You can verify that all the servers/services started by opening another terminal window and typing: “ps –u oracle” You should see a list of processes with the Hyperion ones near the bottom as shown below.

3 Stop Cisco VPN Client Service.

If installed, verify that the status of the Cisco VPN Client Service is stopped as discussed in the Installation lab.

1. Open Services console: Start->Settings->Control Panel->Administrative Tools->Services

If the Cisco VPN Client Service has started, right-click and select “Stop”.

Page 29: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

29

4 Connect to the Data Warehouse

To connect to an RDBMS, EIS supports ODBC, OCI for Oracle databases or DataDirect Wire Protocol drivers for DB2, Informix, Oracle, or Sybase. ASCII text files are also supported using a DataDirect Text driver. Before you begin, make sure that all the Hyperion servers are running on your Linux VM. You will perform the following tasks:

• Open the EIS Console

• Connect to the OLAP Metadata Catalog and Essbase

• Connect to the Data Warehouse

1. Open the EIS Console by selecting the following shortcut: Start->Programs->Hyperion->Integration Services->Integration Services Console.

The first time you start the console, you will be asked to create an OLAP Metadata Catalog. Since this has already been done for you on the Linux VM, you can uncheck the box saying “Show this dialog at Startup” and click “Close”.

Page 30: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

30

2. Login to the OLAP Metadata Catalog, “ptsessbase” for the Server, “EIS_CAT” for the OLAP Metadata Catalog, “eis” for the User Name, and “oracle” for the Password.

Also, provide the login information to Essbase using “ptsessbase” for the Server, “essadmin” for the User Name, and “oracle” for the Password. Click “OK”

3. In the “New” tab, double-click “OLAP Model” or select it and click “Open”.

Page 31: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

31

4. To open the data model you will be using, enter “TBC” for Data Source, “tbc” for User Name, and “oracle” for password. Click “OK”.

5. Once connected, you will see Schemas/Tables going down the left side and an empty workspace to the right. You are now ready to begin building your OLAP Model.

5 Building the OLAP Model

OLAP models are based on the idea that values in a data source can be categorized as either facts or dimensions of facts. Facts are the numeric, variable values in the database, such as numbers of units sold. Associated with facts are related data values that provide additional information, such as store locations. An OLAP model contains a fact table, dimension tables, and dimension branches. An OLAP model may contain time and accounts dimensions. EIS creates an OLAP model that is a logical model, not a physical star schema, and is a logical representation of data values you select from the data sources. You will perform the following tasks:

• Create a logical model consisting of Fact and Dimension tables.

• Create the hierarchies for the dimensions.

1. To enlarge your workspace area, turn off “Intelligent Help” by de-selecting Tools->Intelligent Help from the menu bar.

Page 32: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

32

2. Display the TBC tables by clicking on “+” to the left of “TBC” and “TABLES”.

3. Begin by dragging the fact table, “TBC.SALES” to the middle of the workspace.

4. A dialog box will appear asking if you would like to create a Time dimension from the fact table, click “Yes”.

Note: Since a Time dimension table does not currently exist, you are “creating” one using a copy of the fact table. This is not a recommended practice since fact tables are generally very large and joining two fact tables together could cause long query times. It is best practice to have a Time dimension table or view pre-existing in the schema. This exercise is merely to show that it can be done with EIS, but it is extremely uncommon in practice due to performance reasons.

Page 33: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

33

5. Another dialog box will appear asking if you would like to add an Accounts dimension from the fact table, click “No”.

6. Double-click the line joining the “SALES” fact table to the “Time” dimension table.

7. If the join does not get automatically created (as shown in the bottom box), highlight “TRANSDATE” in both the “SALES” and “Time” tables and click “Add”. Click “Close” when the join exists in the Current Join Information box..

8. Drag “TBC.MEASURES” next to “SALES” (It can be placed anywhere in the Model workspace area, Measures is shown above Sales in the graphic below). A Create New Dimension dialog box will appear, click “OK”.

Page 34: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

34

Since a primary key/foreign key join has already been created between the two tables, the join will automatically be set. You can verify this by double-clicking on the join. Note: You can set the Dimension Type here to be “Accounts”, but we will be doing this later in the lab, so you can leave it as “Default”.

9. Drag “TBC.SCENARIO” next to “SALES”. A Create New Dimension dialog box will appear, click “OK”.

10. Drag “TBC.PRODUCT” next to “SALES”. A Create New Dimension dialog box will appear, click “OK”.

Drag “TBC.PRODUCTDIM” next to “PRODUCT”. A dialog box will appear asking if you would like to add this table to the current model, click “OK”. The header area for PRODUCTDIM will be blank at this point.

This dialog box appears because no primary key/foreign key has been set up with the fact table. You will need to manually create the join in order to incorporate “PRODUCTDIM” into the model.

Page 35: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

35

11. Enable Joins Mode by clicking on the “Join” icon as shown below. Drag a line from the “PRODUCT” table to the “PRODUCTDIM” table (the table name in the header area will be blank).

12. Highlight “SKU” in both the “PRODUCT” and “PRODUCTDIM” tables and click “Add”. Click “Close” when the join has been added in the Current Join Information box.

13. Click on the “Join” icon again to exit Joins Mode. The model should appear similar to what is shown below. Both tables are called “PRODUCT” to indicate that they both make up the PRODUCT dimension.

Page 36: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

36

14. Drag “TBC.MARKET” next to “SALES”. A Create New Dimension dialog box will appear, click “OK”.

Drag “TBC.REGION” next to “MARKET”. A dialog box will appear asking if you would like to add this table to the current model, click “OK”.

15. As before, enable Joins Mode by clicking on the “Join” icon. Drag a line from the “MARKET” table to the “REGION” table (the table name in the header area will be blank). If the join has not been created already, set the join by highlighting “REGIONID” in both tables and click “Add”. Click “Close” when the join has been added in the bottom box.

Page 37: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

37

16. Your model should now look similar to the one shown below. Now that the facts and dimensions have been identified, the next step is to create the hierarchies.

17. Right-click the header area of the “Time” dimension table and select “View Columns”. Right-click “Time” in the area underneath the header and click “Properties…”.

18. In the “Columns” tab, select “TRANSDATE” and click on “Date-Hierarchy”.

Page 38: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

38

19. Select “Year, Quarter, Month” and click “OK”. Four “new” fields appear in the “Columns” tab. The Date fields are logical fields that have been created by EIS using SQL functions specific to the connected RDBMS source. User defined SQL is also supported to create additional logical fields. Click “Close” to return to the OLAP Model.

20. Right-click the header area of the “Time” dimension table and select “Properties…”. The Time hierarchy is created automatically using the previous method. Select “Year_Quarter_Month” in the Dimension Properties dialog and click “Edit…”.

Page 39: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

39

21. The hierarchy is made up of Year, Quarter and Month. In the Name field, change Year_Quarter_Month to “Time”. Highlight “Time.Year” and click “Sort Order…”.

In the Column dropdown box, select “Year”. In the Sort Order dropdown box, select “Ascending”. This sets the sort order for the years in the Time hierarchy. Click “OK”.

In the Edit Hierarchy dialog box, highlight “Time.Quarter” and click “Transform…”.

Page 40: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

40

Click on the “Prefix/Suffix” tab. The member names for Quarters are 1, 2, 3 & 4. Since there are multiple years in the Time dimension, uniqueness for the Quarter names can be achieved by attaching the year to the name as well as additional text before or after the member name (ex. Qtr1-2006). The radio button selections under Prefix and Suffix refer to ancestral member names that can be attached to the Quarter’s member name, while the Custom text boxes allow you to attach additional text. In our example we want to add the text “Qtr” as a prefix to the quarter member and then “-” + Year as a suffix. So under Prefix, select the “None” radio button since we do not want to attach any ancestral member names to the prefix and type “Qtr” in the Custom Prefix box since we want to attach it to the beginning. Under Suffix, select the “Parent Name” radio button since we want the Year to be attached at the end and type “-” in the Custom Prefix to separate the Quarter from the Year.

Click on “Preview Results” to see what the Quarter member names will look like in Essbase. Click “Close”. Click “OK” in the Edit Transformations – Quarter dialog box.

Page 41: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

41

In the Edit Hierarchy dialog box, highlight “Time.Month” and click “Transform…”.

Click on the “Prefix/Suffix” tab. As with Quarters uniqueness for the Month names can also be achieved using a similar method (ex. Jan-2006). In this example we want to add “-” + Year as a suffix. So under Prefix, select the “None” radio button and leave the Custom Prefix box blank since we do not want to attach anything before the Month name. Under Suffix, select the “Grandparent Name” radio button since we want the Year to be attached at the end and type “-” in the Custom Prefix to separate the Month from the Year.

Page 42: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

42

Click on “Preview Results” to see what the Month member names will look like in Essbase. Click “Close”.

Click “OK” in the Edit Transformations – Month dialog box. Click “OK” in the Edit Hierarchy dialog box. Click “OK” in the Dimension Properties dialog box. Essbase supports non-unique member names, so it is not necessary to force uniqueness of member names. However, for better end-user readability and improved query performance, it is recommended that unique member names be enforced.

22. Right-click the header area of the “MEASURES” dimension table and select “View Columns”. Right-click “MEASURES” in the area underneath the header and click “Properties…”. Go to the “Physical Joins” tab.

23. Select “CHILD” in the Child column and “PARENT” in the Parent column. Click “Add”. The Recursion dialog box appears, click “OK”. A parent-child relationship has been created for this dimension table. Click “Close”.

Page 43: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

43

24. Right-click the header area of the “MEASURES” dimension table and select “Properties…”. Click “Add” to create a hierarchy.

25. Type “Measures” in the Name text box. Drag “CHILD” from the left panel to the right underneath “Measures”. Recursive hierarchies only require that the Child field be in the hierarchy. Click “OK” twice to return to the model.

Page 44: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

44

26. Right-click the header area of the “PRODUCT” dimension table that is joined to “SALES” and select “Properties…”. Click “Add” to create a hierarchy. Type “Product” in the Name text box. Expand “PRODUCTDIM”. Drag the “FAMILY” field below “PRODUCTDIM” from the left panel to the right underneath “Product”. Then drag the “SKU” field below “PRODUCTDIM” from the left panel to the right underneath “PRODUCTDIM.FAMILY”. Click “OK” twice to return to the model.

27. Right-click the header area of the “MARKET” dimension table that is joined to “SALES” and select “Properties…”. Click “Add” to create a hierarchy. Type “Market” in the Name text box. Expand “REGION” and then “MARKET”. Drag the “REGION” field below “REGION” from the left panel to the right underneath “Market”. Then drag the “STATE” field below “MARKET” from the left panel to the right underneath “REGION.REGION”. Click “OK” twice to return to the model.

Page 45: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

45

28. Verify the model by going to File->Verify. If no errors were found, proceed with the lab.

29. Save the model by selecting File->Save, pressing Ctrl+S or clicking the Save icon. Name the model “TBC Model” and click “OK”

Page 46: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

46

6 Building the Metaoutline

A metaoutline is a template containing the structure and rules for creating an Essbase model or outline. A metaoutline is based on the structure of an OLAP model. Metaoutlines have several features:

• They can be the basis for multiple Essbase outlines.

• They can be defined at a central location and used to create multiple Essbase outlines in multiple locations.

• They enable you to create Essbase databases on demand.

• They enable you to view sample Essbase outlines before building them.

• They automatically generate SQL to retrieve data from an external source.

• They enable you to filter data before you build the associated Essbase outline.

• They enable you to transform data as you create an Essbase outline.

1. Click File->New. Select “OLAP Metaoutline” in the New tab. In the dropdown where it says ‘Select the model that the metaoutline should be based on’, ensure that “TBC Model” is selected. Click “Open”.

2. To enlarge your workspace area, turn off “Intelligent Help” by selecting Tools->Intelligent Help from the menu bar.

Start by expanding the “ Time” dimension (under TBC Model in the left pane). Drag the “ Time” hierarchy until it is underneath “Untitled” in the right pane and a tree symbol with an “L” attached to it is showing.

.

Page 47: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

47

3. Repeat by expanding the “ MEASURES” dimension and dragging the “ Measures” hierarchy underneath “Untitled” (make sure you see the tree symbol with an “L” attached to it as shown below).

4. Since no Scenario hierarchy was defined, drag the “ SCENARIO” field (first expand the “ SCENARIO”

dimension and then expand the “ SCENARIO” table) and place it underneath “Untitled” as shown below (make sure you see the tree symbol with an “L” attached to it as shown below).

Page 48: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

48

5. For the “PRODUCT” dimension, drag the “ Product” hierarchy underneath “Untitled” (make sure you see the tree symbol with an “L” attached to it as shown below).

6. Do the same with the “ MARKET” dimension, drag the “ Market” hierarchy underneath “Untitled” (make sure you see the tree symbol with an “L” attached to it as shown below).

Page 49: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

49

7. Right-click on the top level of “Time” and select “Properties”.

8. In the Member Info tab, select “Dynamic Calc” under the Data Storage section.

Page 50: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

50

9. Go to the Dynamic Time Series tab. Enable “H-T-D”, “Y-T-D” and “Q-T-D” by checking the boxes. In the Generation column, use the drop down and select “1” for “H-T-D”, “2” for “Y-T-D” and “3” for “Q-T-D”. Click “OK”.

10. Right-click on “Time.Year” and select “Properties”. In the Member Info tab, select “Dynamic Calc”. Click “OK”.

Page 51: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

51

11. Right-click on “Time.Quarter” and select “Properties”. In the Member Info tab, select “Dynamic Calc”. Click “OK”.

12. Right-click on the top level of “MEASURES” and select “Properties”. In the Member Info tab, select “Accounts” under Dimension Type, “Dense” under Dimension Storage, and “Label Only” under Data Storage. Click “OK”.

Page 52: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

52

13. Right-click on “MEASURES.CHILD” and select “Properties”. In the Member Info tab, select “From Database Column” under Consolidation and choose “CONSOLIDATION” in the drop down. Select “From Database Column” under Two Pass Calculation and choose “TWOPASSCALC” in the drop down. Select “From Database Column” under Data Storage and choose “STORAGE” in the drop down.

14. In the Account Info tab, select “From Database Column” under Time Balance and choose “TIMEBALANCE” in the drop down. Select “From Database Column” under Skip and choose “SKIP” in the drop down. Select “Variance Reporting” under Data Storage and choose “VARIANCEREPORTING” in the drop down.

Page 53: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

53

15. . In the Formula tab, select “From Database Column” and choose “FORMULA” in the drop down.

16. In the Alias tab, under the New Alias section in the Alias drop down, select “MEASURES_ALIAS” and click “Add”. “MEASURES_ALIAS” should now appear under Existing Alias. Click “OK”.

Page 54: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

54

17. Right-click on the top level of “SCENARIO” and select “Properties”. In the Member Info tab, select “Label Only” in the Data Storage section. Click “OK”.

18. Highlight “SCENARIO.SCENARIO” and click on the Add a Member as a Sibling icon as shown below. Type “Variance” for the member name and click “OK”.

Page 55: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

55

20. Highlight “Variance” and click on the Add a Member as a Sibling again. Type “Variance%” for the member name and click “OK”.

21. Right-click on “Variance” and select “Properties”. In the Member Info tab, select “Two Pass Calculation” under Two Pass Calculation and “Dynamic Calc” under Data Storage.

Page 56: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

56

22. In the Formula tab, type “@VAR(Budget,Actual);” in the Formula box. Click “OK”. Note: Even though the formula is correct, it will not Verify unless you place double quotes ( “ ” ) around Budget and Actual.

23. Right-click on “Variance%” and select “Properties”. In the Member Info tab, select “Two Pass Calculation” under Two Pass Calculation and “Dynamic Calc” under Data Storage. In the Formula tab, type “@VARPER(Budget,Actual);” in the Formula box. Click “OK”.

Page 57: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

57

24. Right-click on the top level of “PRODUCT” and select “Properties”. In the Outline Build tab, select “Add as Shared Members” under Duplicate Member Names. Click “OK”.

25. Right-click on “PRODUCTDIM.FAMILY” and select “Properties”. In the Alias tab, under the New Alias section in the Alias drop down, select “FAMILY_ALIAS” and click “Add”. “FAMILY_ALIAS” should now appear under Existing Alias. Click “OK”.

Page 58: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

58

26. Right-click on “PRODUCTDIM.SKU” and select “Properties”. In the Alias tab, under the New Alias section in the Alias drop down, select “SKU_ALIAS” and click “Add”. “SKU_ALIAS” should now appear under Existing Alias. Click “OK”.

27. Right-click on “Untitled” and select “Properties”. In the Data Storage Model tab, select “Block Storage” under Data Storage Option.

Page 59: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

59

28. In the Database Measures tab, click “Add”. Select “AMOUNT” and click “OK” twice to return to the metaoutline.

29. Verify the metaoutline by going to File->Verify. If no errors were found, proceed with the lab. Save the metaoutline by selecting File->Save, pressing Ctrl+S or clicking the Save icon. Name the metaoutline “TBC Metaoutline” and click “OK”

Page 60: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

60

30. Now you are ready to build the cube. Right-click on “TBC Metaoutline” and select Member and Data Load….

Type “TBC” in the Application Name box and “TBC” in the Database Name box. Under Calc Scripts, select “Use default calc script”. Click “Next”.

Page 61: Lab 1.1 Lab Environment and Installations - Essbaseessbase.ru/Uploads/EssbaseFirstSteps/025279.pdf · Lab 1.1 Lab Environment and Installations 1 Overview ... 17. If no Hyperion Essbase

61

31. Confirm “Now” is selected under Load Essbase and click “Finish”.

32. The Member and Data Load will start. A message box will appear when it is completed. Click “OK”. Click “Close” to close the Member and Data Load dialog box.