Sunday, January 31, 2016

Configuring OBIEE 12c Analytics to use Port 80

I installed OBIEE 12c on Windows 2008 server. During the installation, there is no option to specify which ports to use (remember the customports.ini file in 11g? No such luck in 12c as of Feb 28, 2016.)

The default analytics port is 9502, such as http://myserver:9702/analytics. I want to change that port to 80, so that we can just access http://myserver/analytics. Here's what worked for me:
  • Use the search tool of your choice to find all files under your BI home directory (a) have an .xml extension; and, (b) contain the string 9502.  
  • Search each file for the string '9502' to determine if it refers to a port number.  If it does, change it to port 80. 
In my system, I found these relevant files that needed to be changed:

Under c:\oracle\middleware\user_projects\domains\bi\config\
  • Config.xml
  • Backup_config2.xml
  • Backup_config3.xml
  • Backup_config4.xml
 Under C:\oracle\middleware\user_projects\domains\bi\config\fmwconfig\

  • Wsm-ccw-config.xml
    • After making the changes from 9502 to 80, sign in to Weblogic Server
    • Lock & Edit 
    • Environment > Servers > bi_server1
    • Configuration tab
    • Change the Listen Port: 80 (formerly 9502)
    • Save
    • Activate Changes
    • Test connecting to the repository in online mode with the Administration tool
    • Test connecting to OBIEE Analytics without the :9502 port
    All servers, services, and processes should be up and running.  I previously had included instructions to restart the bi_server1 server, but the most recent time I made this change (on a different system) I found that it was not necessary.

    Monday, May 26, 2014

    OBIEE Repository Sequence Numbers

    Blog Index

    We know that every time we activate a different repository in Fusion Middleware a new sequence number is appended to the repository (.rpd) file name.  Mark Rittman wrote an excellent blog entry that takes us about 95% of the way down the path to understanding the process.  This blog entry completes the journey.

    The Rittman blog is located at:

    http://www.rittmanmead.com/2011/03/so-how-does-enterprise-manager-work-within-obiee-11g/

    In his blog, Mark introduces us to the System MBean Browser, accessible via Fusion Middleware as shown here:

    Mark takes us through the why’s and wherefore’s of the entire path to the repository sequencer, and I won’t cover it here.  Instead, I’ll provide the Readers Digest version and skip to the answer in the back of the book to answer the question “Where is the sequence number stored?”

       1.        After accessing the System MBean Browser as shown above, navigate to this path:

    Application Defined MBeans + oracle.biee.local + Server: bi_server1 + DomainConfigProxy + DomainConfigProxy

     

    The notation in the Description column points us toward a file called biee-data-zip.  The file is actually biee-data.zip, located at

    {mw home}\user_projects\domains\bifoundation_domain\config\fmwconfig \biee-data.zip

       2.        Open the biee-data.zip archive file.

       3.        Drill into the folder that is traveling incognito.

       4.        Open the info.properties file with a text editor.

       5.        Here we see the next repository version number.

       6.        For a final surprise, drill into the coreapplication folder.

       7.        In this folder are two files. 

       8.        The RPD file is a backup copy of the currently active repository as it existed at the time you clicked Activate Changes.

       9.        The info.properties file contains the history of all of the repositories that have been activated.

    #Mon May 26 09:47:48 CDT 2014

    file.added.time[Retro_Prod_BI0002.rpd]=1367545948718

    file.added.time[MavProd1_BI0003.rpd]=1401115199014

    file.added.time[MavProd2_BI0004.rpd]=1401115668675

    file.added.time[SampleAppLite_BI0001.rpd]=1366982612863

     

    The large numbers at the end of each line are the number of milliseconds elapsed since the beginning of January 1, 1970.

     

    Sunday, January 5, 2014

    Pretty Radio Buttons with CSS in APEX



    Blog Index



    I occasionally work a bit in Oracle's Application Express (APEX).  I recently wanted to modify the display of a set of standard APEX radio buttons.

    By default, APEX Radio Buttons look like this when arranged horizontally:

     


    How can we modify the Radio Group object to look like this?

     

    The answer rests in the use of CSS classes in APEX.

    To begin, we will create a bit of CSS on the page.  If desired, we could then move it to the page template, or even upload it as a cascading style sheet into the APEX shared components for repeated use with any application.


    1.
    Create a Radio Group object with these characteristics:

    Display Orientation
    Horizontal
    Number of Radio Columns
    99
    List of values definition
    Select style as display_value, style as return_value from
    (Select 'Car' as style, 1 as mysort from dual union
    Select 'Pickup' as style, 2 as mysort from dual union
    Select 'MiniVan' as style, 3 as mysort from dual union
    Select 'SUV' as style, 4 as mysort from dual)
    order by mysort
    Default value
    Car



    2.
    Run the page to view the very mundane results.


     

    3.
    Edit the page, and click on any of the links in the Page zone (such as HTML Header).


    4.
    From the toolbar at the top of the screen click the CSS tab.



    5.
    Add this code into the Inline area and click Apply Changes.

    .rg {
      background: #FFFF00;
    }

    .rg label {
      background: #cccccc;
      color: green;
      font-weight: bold
    }

    When the rg class is assigned to an object, this will place a yellow background field behind all radio buttons.  The button labels will be displayed with green text on a grey background.


    6.
    Edit the radio group object created earlier.


    7.
    In the Element section, for the HTML Form Element CSS Classes field, type rg (without the leading period), and click Apply Changes.


    8.
    Run the page to see the results:


    Of course, this is a rather obnoxious combination of colors that we wouldn’t really use, but we're just experimenting with object definitions and positioning right now.

    What happens if we create and use other CSS classes with conflicting characteristics? 


    9.
    Return to the CSS for the page and add this new rg-gray class in the Inline area, after the rg class.

    .rg-gray {
      background: #0000FF;
    }

    .rg-gray label {
      color: red;
    }


    10.
    Return to the radio group and add rg-gray to the HTML Form Element CSS Classes field, with a space between the two CSS class names.



    11.
    Run the page and view the results:


    Notice that the background color behind the labels is still a light gray. Characteristcs specified in multiple CSS classes are cumulative.  A style feature will be retained unless it is specifically changed by a later CSS class reference. 

    Important Note: The order of the CSS classes in the HTML Form Element CSS Classes field (i.e. rg-gray  rg instead of rg  rg-gray) is irrelevant.  It is the order of the CSS classes in the CSS code that controls which features take precedence over others.  If the rg class was listed after the rg-gray class in the CSS code, the features specified in the rg class would override any of the same features specified in the rg-gray class.  "Last one in wins."

    This feature allows us to set up a default CSS class stored in the Shared Components, a second CSS class in the Page Template, and yet a third CSS class in the page's inline CSS as we did here, and go from more general to more specific in the implementation of CSS classes for our objects.  The CSS in the shared components is evaluated first, followed by the CSS in the page template, followed by the CSS on the page itself.

    Now that we've learned a bit about CSS classes, and have seen a couple of the basic styles that can be included, let's remove these garish colors and create something pretty.


    12.
    Return to the CSS and remove all of the class information added earlier.


    13.
    Add this new CSS class family named rgbtn in the CSS code:

    .rgbtn {
    }

    .rgbtn label {
      font-family:Arial;
      font-weight: bold;
      font-size:12px;
      background: #CCCCCC;   /* Light gray background */
      color: #000000;   /* Black font color */
    }

    .rgbtn input[type="radio"]:checked + label {
      background: #222222; /* Dark gray background */
      color:#F9F9F9;  /* Nearly white font */
    }


    14.
    Edit the radio group, remove any values in the HTML Form Element CSS Classes field, and instead refer only to the rgbtn CSS class.


    15.
    Run the page and view the results.



    16.
    Let's make the field names look like buttons by rounding the corners, and also provide a bit of padding around the text.  Add these two CSS style caracteristics to the CSS code in the .rgbtn label class, then view the results:

    padding:3px 10px;   /* 3 pixels top and bottom, 10 pixels left and right */
    border-radius:3px;


    In the sample shown at the beginning of this chapter, we saw that the circles had been removed, leaving just buttons.  Well guess what?  It is very difficult to remove those circles from a radio button.  But luckily, we don't have to remove them at all.  Instead, we can simply slide the labels a few pixels to the left and hide those circles behind their labels!

    17.
    Add this CSS code in the .rgbtn label class, then view the results:

    position: relative
    left: -21px;

     

    There is a bit too much empty space (25px) between the buttons.  Let's slide them a bit closer together.


    18.
    Add this CSS code in the .rgbtn label class, then view the results:

    margin-right: -18px;  /* Remove 18 pixels of space between each button */

     

    This concludes our "generic" version of a radio group turned into buttons.  Any radio group that refers to the rgbtn CSS class will be displayed with these characteristics.

    Now let's create a subsequent CSS class that will display these "buttons" with a specific gradient background.


    19.
    Create this new CSS class family (rgbtn-gray) in the CSS code:

    .rgbtn-gray {
    }

    .rgbtn-gray label {
      background: linear-gradient(#DDDDDD, #888888);
      color: #111111;
    }

    .rgbtn-gray input[type="radio"]:checked + label {
        background: linear-gradient(#888888, #333333);
        color:#F9F9F9;
    }


    20.
    Add the rgbtn-gray class to the HTML Form Element CSS Classes fieldfor the radio group.


    21.
    View the results:


    And now we have created a very nice looking set of gradient, clickable buttons in place of the standard radio buttons with circles.