Professional Documents
Culture Documents
TABLE OF CONTENTS
INTRODUCTION ..................................................................................................................... 4
DISCLAIMER .................................................................................................................................................................6 RANDOM TIPS FOR SUCCESS ............................................................................................................................................6 WHERE TO GET ADDITIONAL HELP ...................................................................................................................................6
Introduction
If you work with Hyperion Planning long enough, you will eventually come to the conclusion that you need your own personal "sandbox" where you can play around with the software, install the latest versions, apply the latest patches, and generally do things you wouldn't want to do in a "real" environment. There are several approaches to creating your own personal Hyperion Planning "sandbox": 1. Setup a cloud environment. 2. Install a server operating system on your PC/laptop. 3. Install virtualization software on your PC/laptop.
So why not just go with a cloud option and be done with it? It's the fastest, least painful, and probably the cheapest way to get up and running with Hyperion Planning. Read on, as this option is not for everyone.
Jake Turrell
Page 4
Option #3 - Go Virtual
When developers install virtualization software on their laptops, they open a world of options for experimenting and learning with the Oracle EPM stack. Here are the top reasons why developers should consider skipping the cloud and install Hyperion Planning right on their laptops: Good Excuse for a New Laptop Running virtual machines on your laptop does take a bit of memory, and a CPU that supports virtualization is required. If your laptop is a dinosaur, this could be the perfect excuse to upgrade. Remember, you are investing in your career and future earning potential. Snapshots While this feature is also available in the cloud, it deserves specific mention. At any point during the installation on a virtual machine, developers can take a "snapshot" (and should do so frequently). This feature allows the developer to have a free "do-over" should something go wrong. Restoring back to a previous snapshot is quick and easy. It's so easy, that I find myself trying things that might potentially blow up my entire environment, because restoring is a piece of cake. Snapshots allow developers to experiment free from worries. Demos . . . No Internet Required So you're at a conference or a user group meeting, and you're getting ready to give your presentation. Like all good presenters, you have a live demo. Unfortunately, every member of the audience has a smart phone, tablet or laptop and they're all using the same wireless internet connection you are using. If you're using a cloud-based service, you're at the mercy of your internet connection. No matter how good it is . . . all internet connections eventually go down, and Murphy's Law clearly states that it will go down during your demo. If you have Planning installed on your laptop, you avoid this risk. No Pain . . . No Gain Installing Hyperion Planning from scratch will give you a much greater understanding of the overall toolset. Yes, it's mildly difficult. And it isn't the cheapest option. But in the end, you'll have your own test environment on your own laptop that you installed yourself. Who knows what that sense of accomplishment might lead to?
Jake Turrell
Page 5
Disclaimer
This document is intended to guide users through the process of setting up a personal Hyperion Planning sandbox environment. This document is not suitable for Production, Test or Development environments. For these types of environments, please retain the services of an experienced EPM infrastructure consultant. This White Paper is provided for informational purposes only, and is provided "as is" with no warranty of any kind, expressed or implied.
Jake Turrell
Page 6
Ingredients
Laptop running Windows. Preferably Windows 7, 64-bit. Preferably 8 GB RAM or more. VMware Workstation 8 Microsoft Windows Server 2008 R2 Microsoft SQL Server 2008 R2 Oracle EPMS 11.1.2.2 for Windows x64
Costs
The cost of the ingredients above isn't necessarily straight forward. This is because there are multiple ways to license each. As of April 17, 2012, the cost of VMware Workstation 8 was $169.17. Microsoft Windows Server R2 is expensive if purchased individually. There are inexpensive options for SQL Server Developer. Microsoft offers subscription services for developers. These licenses typically offer usage for testing scenarios only: o o o MSDN (More Expensive Approx. $1200 per year. Different packages available.) Technet (Less Expensive Approx. $200 per year. Different packages available.) Note that Microsoft has a specific definition of the testing scenarios allowed under these subscriptions, so make sure these will meet your needs.
Another option is to join the Microsoft Partner Network and purchase an "Action Pack" subscription. These are less expensive than MSDN, but generally more expensive than Technet. The primary benefit is that in addition to licenses that cover testing scenarios, there are some licenses for production use as well. This can be a good option for independent consultants as you must have a company. Total cost of VMware 8 and the least expensive Technet subscription is going to be less than $400. Keep in mind that subscription services need to be renewed each year. Your mileage may vary. Prices change. Make sure you get the licenses that are appropriate for your usage scenarios.
Jake Turrell
Page 7
Other Considerations
Not all laptop CPU's support virtualization, although most modern ones do. Check the processor compatibility list on Intels website to see if your CPU supports Intel VT-x. Changes to BIOS settings may be required to enable virtualization. If this is the case, VMware will provide a warning and a simple setting change will enable the feature.
Jake Turrell
Page 8
Jake Turrell
Page 9
Jake Turrell
Page 10
The files below represent the requirements for a typical "Planning Plus" environment.
File V31858-01 V31875-01 V31876-01 V31922-01 V31877-01 V31878-01 V31879-01 V31880-01 V31866-01 V31881-01 V29762-01 Part 1 of 2 V29672-01 Part 1 of 2 V29779-01 Contents EPM System Release 11.1.2.2.0 Installation Documents and Readmes EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Part 1 EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Part 2 EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Part 3 EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Part 4 EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Part 5 EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Part 6 EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Part 7 EPM System Release 11.1.2.2.0 Client Installers for Microsoft Windows EPM System Release 11.1.2.2.0 for Microsoft Windows (64-bit) Oracle HTTP Server Oracle Data Integrator 11g (11.1.1.6.0) for Generic (Part 1 of 2) Oracle Data Integrator 11g (11.1.1.6.0) for Generic (Part 2 of 2) Oracle Identity Management 11g Patch Set 5 (11.1.1.6.0) for Microsoft Windows x86 (64-bit)
** The files above should be downloaded directly to the host operating system (on the laptop). When the virtual machine is created in VMware, a drive will be mapped to this location.
Jake Turrell
Page 11
Jake Turrell
Page 12
Jake Turrell
Page 13
Check or uncheck the option to participate in VMware's User Experience Improvement program.
Jake Turrell
Page 14
Jake Turrell
Page 15
Select Finish.
Jake Turrell
Page 16
Jake Turrell
Page 17
At this point, the developer can decide to: Install the guest operating system now using VMware's "Easy Install" option. Create the VM with a blank disk and install the guest operating system later.
Of these two options, the first is the easiest, however it assumes that the developer has an ISO file. An ISO file for Windows Server 2008 R2 x64 can be downloaded from Microsoft's Technet library. Alternatively, the developer can create an ISO file from the operating system installation media using image creation software.
If using the Easy Install feature, enter the Windows Server license key. Next, select the version of Windows Server to install. Standard is recommended. Enter a user ID and password. Keep these simple. We aren't securing Fort Knox.
Jake Turrell
Page 18
Provide the virtual machine with a name and a location. Be aware that the selected disk will need approximately 100 GB of free space. Create a directory specifically for this VM.
Start with 40 GB allocated to the VM. This will grow after the operating system has been installed. Ensure that the option to Split virtual disk into multiple files is selected.
Jake Turrell
Page 19
Review the settings, but before clicking Finish, select the Customize Hardware button. (Don't worry if you clicked Finish, hardware settings can be modified later.)
Give the VM at least 4 GB of memory and two processor cores. Use a bridged or host-only network adapter. A bridged adapter shares the host Ethernet adapter, so make sure the host is actually connected to a network, otherwise the host may not be able to access Workspace, etc. A host-only adapter allows the guest to communicate only with the host.
Select Close. Select Finish. VMware will begin the Easy Install process. Once the main installation routine is complete, the guest VM will reboot and install VMware Tools. VMware Tools is a suite of utilities that enhance guest operating system performance and management.
Jake Turrell
Page 20
Login to the virtual machine with the user ID and password created above. To login, the developer must click on the VM window and press CNTL-ALT-INS. Note - this is control, alt, insert (not delete).
Jake Turrell
Page 21
To stop this utility from running automatically, check the Do not show this window at login check box at the bottom of the screen. If after checking this box the utility is again required, it can be displayed by running OOBE.exe. Ensure that the time and time zone are correct. Leave the network configuration set to assign an IPv4 address by DHCP. Give the guest server a meaningful name. Do not simply change the description.
Jake Turrell
Page 22
Select the button circled below in red and change the name.
Restart the virtual machine and log back in. Ensure that the Initial Configuration Tasks utility is again displayed. Review the following optional configuration steps: Optional: Add the Telnet Client using Add Features. This will allow a developer to "ping" specific ports, which can help with infrastructure related trouble shooting. Optional: Turn off Windows Firewall. Opening and closing specific ports for the EPM stack can be a nightmare for resources without strong infrastructure skills. Turning Windows Firewall off will prevent a lot of headaches. This is of course only appropriate in a demo/sandbox environment where regular backups and snapshots are taken. Close the Initial Configuration Tasks utility.
Jake Turrell
Page 23
Disabling UAC
User Account Control (UAC) is a feature in Windows that limits software to running under standard user privileges unless an administrator explicitly grants access to run as an administrator via a prompt. UAC should be disabled when installing Planning. The following steps should be completed on the guest operating system: Select Start, Control Panel. Select User Accounts. Select Change User Account Control settings. Move the slider bar on the left side of the window all the way down to Never notify. Select OK. Restart the virtual machine and log back in.
Jake Turrell
Page 24
Select OK. Test the shared drive by opening a file on the host from the guest VM.
Jake Turrell
Page 25
Jake Turrell
Page 26
Taking a Snapshot
After a significant amount of time has been spent configuring the guest operating system, it is recommended that the developer take a snapshot of the virtual machine. Should something go wrong with subsequent steps, the snapshot will establish a recovery point for the developer. From within VMware Workstation, select the menu items VM, Snapshot, Take Snapshot.
Jake Turrell
Page 27
Select the CD/DVD (IDE) setting. Under Connection, select the Use ISO image file radio button. Browse to the SQL Server ISO file. Ensure that the Connected and Connect at power on check boxes are selected.
Select OK.
Jake Turrell
Page 28
Run SQL Server's setup executable. (SETUP.EXE) A warning message may be displayed regarding the .NET framework. If prompted, select OK to enable the .NET framework core role.
Select the Installation link in the left pane. Then select New installation or add features to an existing installation. Setup Support Rules will then be displayed. Ensure that there are no errors. Select OK. Enter a product key and select Next. Accept the license terms and select Next. Select Install to begin the installation.
Jake Turrell
Page 29
Select Next. On the Setup Role screen, select SQL Server Feature Installation.
Select Next.
Jake Turrell
Page 30
Select the desired features. Note that Integration Services is not required, but may be handy in the event that ETL work is required.
Select Next. Ensure that there are no errors on the Installation Rules screen. Select Next. Provide the instance with a name. Ensure that the instance is set as the default.
Select Next.
Jake Turrell
Page 31
Confirm disk space requirements and select Next. Select the Use the same account for all SQL Server services button. Note this user ID and password.
Select Next. Specify Mixed Mode authentication and provide a password for the sa account. Add the current user as a SQL Server admin.
Select Next.
Jake Turrell
Page 32
Opt in or out of Error Reporting. Select Next. Ensure that there are no errors. Select Next. Confirm features to be installed.
Jake Turrell
Page 33
At this point, it may be a good idea to take another snapshot. This snapshot in particular is important as the next step (although optional) is to apply Windows Updates. Select the Start menu, then All Programs, then Windows Update. Next select Check for Updates. Install the desired updates and restart the virtual machine. This will likely take multiple update/restart cycles.
Jake Turrell
Page 34
Get Cooking!
Create App Repositories
Before starting the Oracle EPM application installation and configuration, the relational repositories required by the apps must be created. These are essentially new, empty databases. Developers have the option of creating one big database for all of the apps to share. A better approach (even in a sandbox environment) is to create individual databases/schemas for each app. It is much easier to explore the underlying tables for each app when they are broken out. The additional work involved in setting up discrete databases is minimal. The following databases are recommended:
Database Name SS WORK EPMA EAS PLANSYS PLANDEMOAPP CALC BIPLUS Shared Services Workspace Performance Management Architect Essbase Administration Services Planning System Repository Planning App Repository Calculation Manager Financial Reporting and Web Analysis Description Initial Size 500 MB 500 MB 500 MB 500 MB 500 MB 500 MB 500 MB 500 MB Owner HypAdmin HypAdmin HypAdmin HypAdmin HypAdmin HypAdmin HypAdmin HypAdmin
Jake Turrell
Page 35
Create the new user ID using SQL Server authentication. Do not enforce password policies. Keep the password simple, as this is a sandbox environment.
Select OK.
Jake Turrell
Page 36
Select OK. Repeat this process for each database in the previous table.
Jake Turrell
Page 37
ALTER DATABASE <Insert Database Name Here> SET SINGLE_USER WITH ROLLBACK IMMEDIATE ALTER DATABASE <Insert Database Name Here> SET ALLOW_SNAPSHOT_ISOLATION ON ALTER DATABASE <Insert Database Name Here> SET READ_COMMITTED_SNAPSHOT ON ALTER DATABASE <Insert Database Name Here> COLLATE SQL_latin1_General_CP1_CI_AS ALTER DATABASE <Insert Database Name Here> SET MULTI_USER WITH ROLLBACK IMMEDIATE
** Note - The SNAPSHOT settings above can only be executed with a single active database connection - the one executing the ALTER DATABASE command. The SINGLE_USER SQL statement essentially kills all other database connections. Without this command, the query above may not complete and will appear to run forever.
Jake Turrell
Page 38
For additional information on these commands, please refer to the Installation Start Here document. See the section titled Microsoft SQL Server Database Creation Requirements. Execute these commands on each application repository.
Jake Turrell
Page 39
Installing Planning
Within the VM, navigate to the installTool.cmd file. Use the mapped drive created earlier to access the host file system. This file will exist in the folder where the Oracle EPM software was extracted. Rightclick the installTool.cmd file and select Run as Administrator.
Ensure that each prerequisite has a green check mark. Select Next.
Jake Turrell
Page 40
Select Next.
Jake Turrell
Page 41
** Note - If additional applications are selected, additional relational repositories may be required. Select Next. Confirm the products to be installed and select Next.
Jake Turrell
Page 42
Select Finish. Taking a snapshot in VMware is recommended before beginning any product configuration.
Jake Turrell
Page 43
Configuring Planning
Within the VM, create a shortcut to the config tool. This tool will be used often. The config tool is located in: C:\Oracle\Middleware\EPMSystem11R1\common\config\11.1.2.0. In this example, products will be configured independently instead of configuring everything at once. This will allow developers to give each application its own relational repository. This is a best practice (even in a sandbox environment) because it makes the relevant tables much easier to browse. While each application will have its own relational repository, the web apps will be deployed to a single managed server (aka "compact deployment"). This will dramatically reduce memory requirements.
Confirm the home directory and EPM instance name. Select Next.
Jake Turrell
Page 44
Select Perform first time configuration. Select the SQL Server driver. Enter the database name, user ID and password.
Select Next. Uncheck all options in the config tool. This will leave several default boxes checked under Hyperion Foundation.
Select Next.
Jake Turrell
Page 45
Jake Turrell
Page 46
Set the Shared Services admin user ID and password. Make a special note of this ID and password.
Select Next.
Jake Turrell
Page 47
Confirm success.
Select Task Panel to continue the configuration process, or Finish. If Finish is selected, simply restart the config tool to continue the configuration process. This would be a good time to take a snapshot.
Jake Turrell
Page 48
Select Next. Select Perform first time configuration. Change the database name to EAS.
Select Next.
Jake Turrell
Page 49
Select Task Panel to continue the configuration process, or Finish. If Finish is selected, simply restart the config tool to continue the configuration process.
Jake Turrell
Page 50
Configuring EPMA
Within the configTool, select the following options:
Select Yes. Select Perform first time configuration. Change the database name to EPMA.
Select Next.
Jake Turrell
Page 51
Confirm selections.
Select Task Panel to continue the configuration process, or Finish. If Finish is selected, simply restart the config tool to continue the configuration process.
Jake Turrell
Page 52
Configuring Planning
Within the configTool, select the following options:
Select Next. Select Perform first time configuration. Change the database name to PLANSYS.
Jake Turrell
Page 53
Select Task Panel to continue the configuration process, or Finish. If Finish is selected, simply restart the config tool to continue the configuration process.
Jake Turrell
Page 54
Select Next. Select Perform first-time configuration. Change the database name to CALC.
Select Next.
Jake Turrell
Page 55
Select Task Panel to continue the configuration process, or Finish. If Finish is selected, simply restart the config tool to continue the configuration process.
Jake Turrell
Page 56
Select Next. Select Perform first-time configuration. Change database name to BIPLUS.
Select Next.
Confirm repository directory and ports. Select Next. Confirm RMI ports.
Select Next.
Jake Turrell
Page 57
Jake Turrell
Page 58
Select Next. Deploy the web application to a new domain. The Administrator Password must be complex.
Select Next.
Jake Turrell
Page 59
Confirm deployment settings. Make sure to select the option to Deploy the web application to a single managed server. This setting enables a compact deployment, and dramatically reduces memory requirements and startup time.
Jake Turrell
Page 60
Select Task Panel to continue the configuration process, or Finish. If Finish is selected, simply restart the config tool to continue the configuration process.
Jake Turrell
Page 61
Select Next.
Jake Turrell
Page 62
Jake Turrell
Page 63
La Pice de Rsistance!
Configuring the Services
Many of the services created by the Config Tool will be set to start automatically. I prefer setting these to start manually. They can then be started by running the pre-built startup and shutdown scripts in the Start menu.
** Note - Most infrastructure consultants will create custom start/stop scripts for the EPM apps. To edit the startup type of the services, navigate to Start, All Programs, Administrative Tools, Services within the virtual machine. Set the following services to startup manually by right-clicking the service and selecting Manual in the Startup Type list box. Hyperion EPM Server - Web Application Hyperion EPMA Server Hyperion Reporting and Analysis Framework Hyperion RMI Registry Oracle Process Manager (EPM_epmsystem1) Oracle Process Manager (ohsInstance . . . . ) Oraclec_oracle_middle~1 . . . . (very long service name)
After making the above changes, reboot the virtual machine. Give the VM a minute to startup itself, then launch the Start EPM System script from the VM's Start menu.
Jake Turrell
Page 64
Jake Turrell
Page 65
Bookmark the above site. Login with the Shared Services administrative ID. The Workspace HomePage will be displayed.
Jake Turrell
Page 66
At this point, developers may notice that menus in Hyperion Planning are not functioning as expected. To rectify this issue, navigate to Tools, Internet Options within Internet Explorer. Select the Security tab. Select the Trusted Sites check box. Select the Sites button. An Add button will be available that lists the URL to the physical computer name on the virtual machine. Select this button. Select Close then OK. Close the browser and re-login to Workspace. Menus should now function as expected.
Jake Turrell
Page 67
If the developer has been following this tutorial from the beginning, both prerequisites will already have been met. This is because the relational app schema (PLANDEMOAPP) was created when the application schemas were created. The Shared Services administrator (created during the Shared Services configuration) will have the Planning Application Creator role assigned by default. Planning applications can be created as "EPMA" apps, or as "Classic" apps. For the purposes of this tutorial, EPMA will be used. Should a "Classic" application be required, Oracle Data Integrator should be installed for loading metadata. Sign into Workspace as the Shared Services administrator. Select the menu items Navigate, Administer, Application Library. An information message will be displayed stating that no applications were found. Select OK. Select the menu items Tools, Manage Planning Data Source. Select the menu items File, New, DataSource. The following screen will be displayed.
Jake Turrell
Page 68
Enter the relevant SQL Server connection information and select the Test Connection button.
Ensure that the Connection successful message is displayed. Select Next. Enter the relevant Essbase connection information and select the Test Connection button. The Shared Services admin ID may be used, or a separate user ID may be provisioned.
Jake Turrell
Page 69
Select Finish. Return to the Application Library tab. Select the menu items File, New, Application. Enter the relevant application information. Pay special attention to this screen, as there are several options which cannot be changed later without having to recreate the application.
Select Next.
Jake Turrell
Page 70
Ensure that there are no errors. Select Finish. The dimension library will be displayed.
Jake Turrell
Page 71
Select the Application Library tab. Right-click the application and select the menu items Deploy, Application.
Verify the Shared Services Project and Data Source. Select the option to Create Outline.
** Note - Do not select Create Outline on an ongoing basis. This will drop and recreate the Essbase application and may result in data loss. This option is typically only selected during the first deploy. Select Deploy.
Jake Turrell
Page 72
Look for a Completed status of 100%. Select the menu items Navigate, Applications, Refresh. Select the menu items Navigate, Applications, Planning, Application Name.
Jake Turrell
Page 73
Congratulations!!!!!
You have created the first application in your new personal Hyperion Planning sandbox environment.
Jake Turrell
Page 74
URLs
Reference John Booths Amazon Web Services AMI Cameron Lackpours Blog Post on Johns AMI Full 360 Amazon Web Services OTN Discussion Forum: Planning and Budgeting Network54 Essbase User Forum John Goodwins Blog Intel CPU Virtualization Support Oracle E-Delivery URL http://www.metavero.com/index.php?option=com_content&view=article&id= 54:epm-test-drive-redux&catid=1:latest-news&Itemid=50 http://camerons-blog-for-essbase-hackers.blogspot.com/2011/04/yeah-yeah11121-is-here-so-what_12.html http://full360.com/ http://aws.amazon.com/what-is-aws/ https://forums.oracle.com/forums/forum.jspa?forumID=408
Jake Turrell
Page 75