Today we try something different. I have a stock Ubuntu installation in Hyper-V. Microsoft has released SQL Server for Linux, I think SQL Server for Linux is a Release Candidate (RC), which we over at Tevpro have been using with some .NET Core applications. Lastly, I need a VM of 11.1.2.4 for testing some code I am working on. So... I am going to try and run EPM 11.1.2.4 on the Linux version of MS SQL Server.

What am I going to install:

• Foundation Services
• Calculation Manager
• Planning
• Essbase

Why am I not installing FDMEE, HFM, etc? I don't need them at the moment but that could change so this may turn into a multi-part post.

Why do I have the desire to try this now? Well I recently rolled off the project I have been on for close to two years and had some free time while looking for a new project (hire me).

Installing SQL Server

If you didn't know Microsoft has become really cool in the last couple years and is embracing Open Source and Linux. Having been a .NET/ASP.NET/Classic ASP/Cold Fusion developer prior to coming into the EPM community I have long loved SQL Server. A big reason for that is SQL Server Management Studio (SSMS), which in my opinion the standard by which all other SQL Tools are judged. Anyway, Microsoft has some really good documentation on getting SQL Server installed on Linux, so the process is a snap. About the only requirement for installation is that the system has at least 3.25 GB of Memory, which since this going to be an EPM server is pretty much guaranteed.

1. Import the Microsofts public GPG keys:

   crl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
   

2. Register add Microsoft SQL Server repository to APT:

   curl https://packages.microsoft.com/config/ubuntu/16.04/mssql-server.list | sudo tee /etc/apt/sources.list.d/mssql-server.list
   

3. Update APT:

    sudo apt-get update
   

4. Install SQL Server using APT

    sudo apt-get install -y mssql-server
   

5. Run the configuration utility and setup the sa (System Administrator) password.

   sudo /opt/mssql/bin/mssql-conf setup
   

6. Verify that SQL Server is running

   systemctl status mssql-server
   

   or

   sudo service mssql-server status
   

7. Open the SQL Server port (1433) on your firewall^[1]

To anyone who has installed Oracle on Linux, you will be amazed at how fast and easy this is by comparison.

Setup Databases

I already have SSMS but if you do not I would suggest you download SSMS^[2]. Open up SSMS and connect to the SQL Server.

1. Select New Database under databases to open up the new database dialog.
   

2. Define the name of the database as well as any specific settings you might want.
   

3. Repeat steps one and two until all necessary databases are created.^[3]

6. Create a user(s) that will be used to connect to your databases.
   1. Find Security then locate Logins, right click and New Login
      
   2. Specify the Login name and Password
      
   3. Select User Mapping
   4. Select the desired database you want to assign this user access to.
      
   5. Assign the user to the desired roles for the database.
      
   6. Repeat steps four and five for each database this user should have access to.

Downloading EPM 11.1.2.4

Oh, E-Delivery you are a pain. A necessary pain that I do not enjoy. E-Delivery has the option to download a wget.sh file that can be used download the installation files.

1. Login to E-Delivery

2. Locate the desired software package and set Linux x86 64
   

3. Uncheck the software you don't need (never understood why DRM, Client tools, and other non-Linux items were selected by default.)
   

4. Select WGET Options
   

5. Download the wget.sh script
   

6. Copy the file to the Linux server.

7. Edit the first line of the wget.sh script since its targeting the sh shell which does not support the -s option on the read command.

   #!/bin/sh
   

   Change this line to use bash shell.

   #!/bin/bash
   

8. Run the wget.sh command and follow the prompts.

   ./wget.sh
   

9. Go get coffee. Even though I have a 200Mbs connection its going to take a while.

Prepare for installation

1. Unzip the files into a single directory

   unzip 'V*.zip' -d InstallFiles
   

2. Create the user who will do the installation and run the applications once installed.

   sudo adduser epm
   

3. Modify /etc/security/limits.conf to increase the hard and soft file descriptor limits.

   epm    hard    nofile    131072
   epm    soft    nofile    4096
   

4. Install make, gcc, rpm, libxtst6, libxi6 and libaio(see footnote 15)

   sudo apt-get install build-essential rpm libxtst6 libaio1 libpth-dev libpthread-stubs0-dev
   

5. Link rpm to the location the EPM installer is expecting it at and x86-64-linux-gnu to /usr/lib64.

    ln -s /usr/bin/rpm /bin/rpm
    ln -s /usr/lib/x86_64-linux-gnu /usr/lib64
   

6. Set the X11 display setting (even though I am using console, something in OHS requires it)

    export DISPLAY=:0.0
   

7. Move the install files to a directory owned by that user

   sudo mv InstallFiles /home/epm/
   

8. Change the owner of the files

   sudo chown -R epm:epm /home/epm/InstallFiles
   

9. Become the new user

   sudo su - epm
   

10. Change directory to the install folder.

    cd ~/InstallFiles
    

Install Oracle EPM

So for this particular installation, I forgot to add the GUI and don't really want to install Xming. So console it is.

1. Run the install tool.

   ./installTool.sh -console
   

2. Since I want English I select 0

3. Verify prerequisite checks are successful^[4]

5. Define the EPM installation path (/home/epm/Oracle/Middleware)

6. Select a New Installation (Option 0)

7. Select components to install (this is where it gets tricky in the console.)

   1. At Oracle EPM System - 2: Expand
   2. Foundation Services - 2: Expand
   3. Foundation Components - 0: Select
      • Foundation Services Java Web Application
      • Static Content Files
      • Oracle HTTP Server
      • WebLogic Application Server
   4. Oracle Database Client 32-bit - 0: Next^[5]
   5. Oracle Database Client 64-bit - 0: Next
   6. Performance Management Architect - 1: Deselect^[6]

   7. Calculation Manager - 0: Select

   8. Essbase - 2: Expand

      1. Essbase Administration Services Java Web Application - 0: Select
      2. Provider Services Java Web Application - 0: Select
      3. Provider Services Java Web Application Samples - 1: Deselect
      4. Essbase Studio Server - 1: Deselect
      5. Essbase Studio Server Samples - 1: Deselect
      6. Essbase Server - 0: Select
      7. Essbase Server Samples - 0: Select^[7]

   9. Reporting and Analysis - 0: Select^[8]

   10. Planning - 0: Select
   11. Financial Close Managment - 1: Deselect
   12. Tax Managment - 1: Deselect
   13. Disclosure Management - 1: Deselect
   14. Financial Management - 2: Expand
       1. Financial Management SDK - 0: Select
       2. Financial Management Java Web Applications - 1: Deselect^[9]
       3. Financial Management Server - 1: Deselect
   15. Strategic Finance - 1: Deselect
   16. FDM Enterprise Edition - 0: Select^[10]
   17. Profitability and Cost Management - 1: Deselect

8. Confirm my selections

   Checking for available disk space in the /home/epm/Oracle/Middleware/EPMSystem11R1 directory.
   The selected components require 12703 MB free disk space.
   You have 91985 MB free disk space.
   
   EPM Oracle Home: /home/epm/Oracle/Middleware/EPMSystem11R1
        Common Components
        Essbase Product Common Components
        Product Common Components
        Oracle Common Files
        Tools
        OPMN
   Foundation Services
        Calculation Manager Java Web Application
        WebLogic Application Server
        Oracle HTTP Server
        Static Content Files
        Workspace Java Web Application
        Foundation Services Java Web Applications
   Essbase
        Essbase Client Samples
        Essbase Client
        Essbase Server Samples
        Essbase Server
   Provider Services Java Web Application
   Essbase Administration Services Java Web Application
   Reporting and Analysis
        Financial Reporting Java Web Application
        Framework Services and Common Libraries
        Framework Java Web Application
   Planning
        Planning Java Web Application
   Financial Management
        Financial Management SDK
   FDM Enterprise Edition
        FDM Enterprise Edition Java Web Application
        ODI
   

Configure Oracle EPM

Next, we move on to the configuration.

1. Change to configuration directory

   cd ~/Oracle/Middleware/EPMSystem11R1/common/config/11.1.2.0
   

2. Run configuration utility

   ./configtool.sh -console
   

3. Set the EPM Oracle Instance path

   /home/epm/Oracle/Middleware/user_projects
   

4. Set the Oracle EPM Instance Name

   epmsystem1
   

5. Setup Shared Services and Registry Database Connection - 1: Perform the first-time configuration of a Shared Services database

   1. Set the Database Type - 0: Oracle's MS SQL Server Driver (Type 4)
   2. Server: localhost
   3. Port: 1433
   4. Database Name: EPM^[11]
   5. User Name: epm
   6. Password: ********
   7. Launch Advanced Options - 1: No

6. Select initial items selection - 2: Uncheck All

   1. Hyperion Foundation - 0: Select
   2. FDM Enterprise Edition - 1: Deselect
   3. Essbase - 0: Select
   4. Financial Management - 0: Select
   5. Planning - 0: Select
   6. Reporting and Analysis - 0: Select

7. Use SSL - 1: No

8. Mail Server Host: None

9. Outgoing Port: 25

10. Incoming Port: 143

11. Administrator's Email Address: None

12. Use SSL for mail - 1: No

13. Enable SSL offloading - 1: No

14. Use authentication to send email - 1: No

15. LCM Export Import Location:

    /home/epm/Oracle/Middleware/user_projects/epmsystem1/import_export
    

16. Configure Database - 0: Oracle's MS SQL Server Driver (Type 4)^[12]

17. Enter the number of components you want to configure, divided by a comma: 0, 1, 2, 3. This will configure the following in my environment:

    • Essbase Administration Services
    • Planning
    • Reporting and Analysis
    • Calculation Manager
      

18. Server: localhost

19. Port: 1433

20. DB Name: EPM

21. Username: epm

22. Password: ********

23. Advanced database options for selected rows - 1: No
    

24. Repository Directory

    /home/epm/Oracle/Middleware/user_projects/epmsystem1/ReportingAnalysis/data/RM1
    

25. Port Range - 0: Default range (6800-6805)

26. Deploy to Application Server (WebLogic) - 1: Deploy to new domain

27. Domain Name: EPMSystem

28. Administration Server Port: 7001

29. Administrator User: epm_admin

30. Administrator Password: ********

31. Deploy the Java web applications to a single managed server - 1: No^[13]

32. Deploy this Java web application - 0: Yes

    1. EAS
    2. Workspace
    3. Planning
    4. APS
    5. Shared Services
    6. RA Framework
    7. Financial Reporting
    8. CALC

33. Essbase Cluster Name: EssbaseCluster-1

34. Agent Port: 1423

    1. Active: Yes

35. SSL Agent Port: 6423

    1. Active: No

36. Start Port: 32768

37. End Port: 33768

38. Full path to application location (ARBORPATH)^[14]

    /home/epm/Oracle/Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1
    

39. Set Essbase language: 0 - English
40. Binding Host Name: epm-11-1-2-4
41. Configure Reporting and Analysis Framework Agent:
    1. Agent Port: 6860
    2. Agent RMI Port: 6861
42. Financial Reporting - Configure RMI Ports Range - 0: Default (8205-8228)
43. Setup Oracle BIEE - 1: No
44. Setup Oracle BI Publisher - 1: No
45. Planning - Configure RMI Server
    1. Port: 11333
46. Web Server Type - 0: Oracle HTTP Server
47. Web Server Port: 19000
48. Set logical address for applications - 0: Yes
49. Launch Advanced Options - 1: No
50. Update the logical address for the Java web applications - 0: Set all
51. Host: epm-11-1-2-4
52. Port: 19000
53. SSL Port: 19443
54. Admin Name: admin
55. Password: ********
56. Verify the tasks and "Let 'er rip tater chip"
    

Results

Well, I would like to say it was a complete success but as with many installs, something always seems to come up. Luckily it's just OHS (Apache), but it's always something.

So now I got to go track down why OHS has decided to not play nice^[15]. On a positive note, this was by far the fastest configure/deploy I have ever seen and this is a single virtual CPU VM on my laptop, not sure if its the GUI overhead but this was like 60 - 90 seconds for configuring and deploy.

Final Thoughts

After pouring through logs and adding libraries I eventually I gave in and installed some X11 libraries, configured Xming. Once I ran the install tool again I found that the GUI was reporting that Oracle HTTP Server had not installed correctly. I made several attempts to resolve issues but as when I eventually resolved the dependencies it started to report bizarre permissions problems. I suspect the easiest solution is to clear the install and restart since it is now complaining that it can't overwrite files created by the installer.