This (video) tutorial shows how to create GEO charts, starting with a simple background layer. Watch the video or continue reading to learn more about maps in instantOLAP.

This tutorial uses the beta version of instantOLAP 3. Creating Geo Charts with instantOLAP 2.6 works exactly the same way, you’ll only need to design your report with the instantOLAP Workbench, because the web query editor is a new feature of version 3.

The OLAP System uses standard ESRI Shapefiles for the maps. Because the ESRI Shapefile format is very common, nearly every kind of map is available. Various shapefiles can be found for free in the internet or purchased. The instantOLAP default installation contains the free “world_countries_shp” shapefile with the world countries borders, which will be used for this example.

First of all, you will have to create a new block inside your report and change its format into the “Geo Chart” format. After you did this, a number of new properties will appear for this block.

Maps in instantOLAP are organized in background and foreground layers. Each kind of layer can be displayed as polygons, texts or symbols.

The background layers will always be rendered, independend of the table data or anything else. You can use the background layers to display the fixed background information you need for your report, e.g. country borders and country names.

First of all, we will a add a simple background layer to the chart. Simply tell the system where to find the shapefile on the hard disk by filling the property “BG 0 Sourcefile”. Fill in the absolute path here, because shapefiles don’t need to be located inside the instantOLAP repository. Also, if your background and frontend server are located on different machines, this path should be visible for the frontend server.

For this example, the path would be “<instantOLAP>/repository/geodata/World_countries_shp.shp” – whereby <instantOLAP> is the installation path of your instantOLAP server.

After you located the shapefile, it’s time for a test. Execute the report and you should see your first map inside instantOLAP. It displays the world country borders as black borders with empty polygons.

Now you can change some properties of the background layer to change its presentation, e.g. by assigning colors to the properties “BG 0 Background” and “BG 0 Color” (which is the border color).

Now we’ll display the country names in a second background layer. Shapefiles can contain additional informations for each polygon which are stored in a simple DBase database (located in the same folder as the Shapefile itself). There are a number of tools you may use to open and view/edit this database files, including Microsoft Excel.

You max have noticed that additional properties were added to the chart property list after you edited the “BG 0 Sourcefile” property. The editor automatically adds properties for an additional layer whenever you assign a value to a layer sourcefile and this is the location where to add the second layer.

Use the same shapefile for the property “BG 1 Sourcefile” and set the “BG 1 Type” property to “Text” – this will turn the layer  into a text layer. Now you must tell the system which database information you want to display as the text. In our example Shapefile, the country names are stored in the column “NAME” – simply enter this attribute name into the property “BG 1 Text Attribute”.

Data layers are similar to background layers but they only display the fragments of the Shapefiles related to the table data. E.g. a data layer could highlight single countries in certain colors, dependend on a cube value like the turnaround for that country.

Each row of your OLAP query will be related to a single map fragment. Therefore, a data layer needs additional information to link the fragments to the rows of your query. This is realized by matching the header text of the Y-axis with a text attribute of the Shapefile database. E.g. if your query contains ISO country codes in the Y-headers, there must be a database field in the Shapefile with exactly mathing ISO codes.

Adding a data layer works the same as adding a background layer: Enter the absolute path of the shapefile in the property “Data 0 Sourcefile” to create a new layer.

Now you’ll have to match the table with the Shapefile segments: For our example, add a fact (e.g. turnaround) to the X-axis of the table and the level “COUNTRY” of the agency dimension to the Y-axis. Because the COUNTRY level contains the ISO contry codes as keys and the World_countries_shp Shapefile contains these codes as attribute, we can tell the system how to match the headers to the Shapefile. The Shapefile attribute is named “ISO_2″, therefore you’ll have to enter this name in the attribute “Data 0 Text Attribute”.

If you execute the report now you’ll see some new numbers in some countries. This is the table content, mapped to the regions identified by the Y-axis headers which are mapped to the Shapefile regions.

A number of table properties are straight forward displayed in the map, including the background and foreground color of your table cells. Therefore, color coding for maps works the same as for tables – simply change the background color of the Y-axis headers and the polygons in the map will have the same colors as the table would.

In our example, you can add a simple color coding by entering the following expression into the background expression of the Y-Axis header: “IIF( Amount() < 30000000, ‘red’, ‘green’ )”. This will turn the background color to “red” if the turnaround for a country is less than 30 million or to “green” if not.

In instantOLAP, every Cube is by default a ROLAP cube. This is because we believe creating a new cube is very productive with adhoc cubes: You can add new dimensions to cubes or modify mappings and then instantly test the new results without any aggregation process (which may take time).

After you finished the first production quality version of your cube it is time to test its performance and to improve it if neccesary. This is when Offline Stores come into sight.

Since version 2.6 building offline stores is very easy and comfortable: Use the context menu of the cube to add a new Offline Store to it. Then you must decide, which dimensions you want to add to the cube and how you want them to be loaded.

After you added the store, a new column will appear right to the mappings. In this new column you can define, which dimensions and facts you want to be added to the new Store.

Now it’s time to create the most simple form of a store: Add every dimension and fact to the store by clicking into the related cells of the column. A checkmark will show that the dimension or fact is now part of the Store.

Now you should open the Model Manager and fill the Store with data. Locate the Model in the Manager, open the Model Information dialog for “demo/demo” by double clicking the model and switch to the Cubes tab in the dialog.

Here you can see the new Store which replaced its source cube in the Cubes tab. The most important information for Stores is the “State” columns which shows if the Store is currently available (online), not available (offline) or building (online + building or offline + building).

Because our cube is not loaded yet, its state is “offline”. To load the Store, select it and use the “Rebuild” button from the toolbar at the right side. Then wait a few seconds and use the “Refresh” button from the toolbar to view the current state.

Now the store is loaded and the execution time of the demo reports will shrink from seconds to milliseconds. There are a couple of new informations in the table: The build time, the error message for the case the build process stopped with an error, the number of raised warning while loading the data and the Store size.

The Store size, the last reload timestamp and the build time are simple informations from the loading process. The build time show how long it took to load and aggregate the source data and the size shows the effective (compressed) size of the Store. This is not the number of cells the Store can deliver but the number of informations instantOLAP wrote to the local disk. In this oexample, the Store needs 73,863 records to deliver data for 151,632,000 cells, a compression of 2000:1!

The error message and the warnings are very important informations for the case your cube delivers no or wrong data or didn’t load at all.

There are two different ways how to aggregate the values for higher levels of a dimension: By doing a rollup or by querying each single level.

Rolling up means that the system will only query the lowest level and single mapped keys from the database and calculate every upper level manually. Querying the levels means the system will perform one SQL query per level.

Be careful with the query scheme, because usually your Store contains more than one dimension. E.g. if you have three dimensions with three levels, this will perform 27 queries to the database. Ten dimensions with three levels means 118.000 queries, one for each possible combination of each dimension level!

But why should you use the query scheme? There are some reasons you might need this:

• One of your facts uses a COUNT DISTINCT aggregation, and this cannot be calculate by performing a rollup in some cases
• Your hierarchy cannot be calculated by rolling up data because a key value is not the SUM, AVG or else of its children
• Sometimes it can be faster to perform many small queries than a single, large one

Also for facts you can change the aggregation scheme, but here you can change the aggregation formula the system uses. The default value is “default” – then the Store automatically determines the aggregation type from the SQL expression you mapped the fact with. But can also change it manually to one of the aggregations “SUM”, “AVG”, “MIN”, “MAX” etc. This is needed whenever the system is unable to automatically determine the aggregation from the SQL expression or simply want something different.

There are some pitfalls when loading the data of a Cube into a Store. The Store might raise an error or collect warning while its building process. Whenever an error is raised you should, of course, fixed it and reload the Store again. But even warning should always be fixed, because they can be a reason for wrong data. But why can a Store raise errors or warnings when original cube works correct?

There two main reasons and they are not always easy to understand:

• In ROLAP cubes, the cube will of course only load data for the requested dimensions and facts. Which also means it will only use the tables containing information for this dimension and facts. But if you combined, for example, two different fact tables in one cube, the Store will perform one SQL query to gather both facts – and combining two fact tables means a full permutaion of both tables, the numbers get exponentially higher. Maybe with the ROLAP version of your cube you didn’t see the error, because you always used only one of the facts, but the Store combines everything.
• Your cube may deliver data for more keys than a dimension contains. E.g. if you build a product dimension and filter the dimension to load only yellow products, you must apply the same filter to the cube. Otherwise, the cube will load facts for keys which are not part of the dimension, warn you (in fact, this is 99.99% of all warning a cube will raise are “missing keys”) and drop the row. Dropping the data itself is not the problem, because you don’t want the cube to load data for unknown keys, but your original ROLAP does it!  E.g. if the ROLAP cube is queried for the Amount of 2010 for all products, the ROLAP Cube will simply generate no WHERE statement for products, because you want all of them. But the store will calculate this value by rolling up all product data and the value will be less than the ROLAP value. This is not an error in the Store, it is originally located in the ROLAP Cube!

As you can see, the source for all problems with Stores is the ROLAP Cube itself. Therefore, you should always look for error messages and warnings and try to eliminate the problems in you cube.

Also important for warnings: You need to know how to find them, because the model information only shows the number of raised warnings but not the warnings itself. The warnings are sent to the log while building the Store, therefore you should open the log console before starting your first Cube aggregations. It is also important to switch of the session filter before building the Store, because this is a system process not related to any (or your) user session.

Our simple approach to load all dimensions into a single Store is good for small Cubes, but with a raising number of dimensions the Store size will grow exponentially (this is, because the number of cells in a Cube is the product of all dimension sizes).

Adding more and more dimensions to a MOLAP Cube will bring every OLAP system to its limit -  including instantOLAP. We have a good experience with cubes up to one billion compressed datasets (Stores of this size can hold up to 5000 billion cells), but even if this number sounds very high it can easily be reached by combining 20 or more large dimensions. And aggregating this number of cells can take many hours.

Therefore, we have a different approach for this problem: Combining of multiple Stores. In practice, there are several combinations of dimensions which are used often and other combination which are used never or very seldom. This means, you can aggregate a ROLAP Cube into more than one Store, and each Store holds a smaller number of dimensions the original Cube contains.

In this example we combined two Stores, one holding the Campaing dimension, the other the Manufacturer dimension. The system will now automatically choose the correct Store whenever a user queries the cube.

Now you might say “Okay, but what happens if the user queries all dimensions together or an unknown combination?”. This is where HOLAP comes into play: The “H” in HOLAP stands for hybrid – a mixture between offline MOLAP Stores and adhoc ROLAP Stores. You can create subset Stores and tell the system to use the orignial ROLAP Cube whenever an unknown combination of dimensions is queried. This means, you can deliver performant Stores but also a fallback solution for unmapped combinations.

How to turn an MOLAP Cube into an HOLAP Cube? There is a property for Cubes, “Keep Adhoc Cube With Stores”. Simply set the property to “true” and redisplay the Cubes in the Model Information dialog. Now you will see the original ROLAP Cube behind your Stores. And, because the order of Cubes and Stores is important in instantOLAP, the system will use the ROLAP cube only, if none of the Stores can deliver the wanted data.

You can see this in the Model Information also: When switching the property “Keep Adhoc Cube With Stores” to “true”, the original Cube appears behind the Stores. Simple but effective.

This is the last question: When will the system build or refresh my Stores? Of course, you don’t want to create the Stores manually after creating them. Therefore, there are two different ways to keep Stores up to date: Dimension triggered (automatic refresh) or time triggered (crontab refresh).

The automatic refresh will always start the build of a Store whenever it is offline or one of its source dimensions changed (in this case, the Store must be rebuild otherwise it would contain corrupted data). To turn the automatic refresh on, set the switch “Build Offline Store Immedialtey” of the configuration / model to true.

The alternative to automatic refresh is to refresh a Store triggered by a cron pattern. This cron pattern, which is a property of the Stores, you can manually control when the Store should be rebuild. Whenever a source dimension of the Store changes, the Store will fall back into the ROLAP mode and the data will be queried from the underlying database.

Usually, it is more comfortable to use automatic refresh, but there are sometimes reasons to manually controll the cron pattern. E.g. if you don’t want to stress your source database with the large SQL queries at daytime or if a source database is not available at certain times.

28.06.2010: Release 2.6.1 Update 3

• Two new properties (“First Day Of Week” and “Min Days In First Week”) allow to fine-tune the TimeKeyLoader – e.g. you can generate ISO compatible calenders now
• Instead of “= NULL”, the SQL Generator now generates “IS NULL”
• Faster communication between the server and the frontend or Workbench
• Better detection of the return type for the LOOKUP method (which is eg. important when using a LOOKUP in the “Options” property of a selector)
• Bugfix: Dimensions and offline stores with the same name could cause trouble in distributed environments

• Dynamic loading of suggestions for the SuggestSelector – the number of possible options is nearly unlimited now
• For SuggestSelectors, the correct text is now displayed when exporting a report
• Better caching-strategy for files, the browser will immediately reload changed resources from the repository
• Better performance for the ExpressionEditor, the model-tree at the left side now loads async
• Bugfix: The default of a HierarchyTreeSelector was not visually selected if it was another key than the root key

• The default Tomcat installation is now configured not to expand the WAR archives for easier updates

We cleaned up and gave instantOLAP 3 a fresher and clearer design with less buttons and tabulators but more functionality. Not much to write here, just have a look onto the following screenshots (of course, the appearance can slightly change until the final release).

instantOLAP 3 allows to interactivly change content and the look&feel of your reports while watching them. A couple of new “designers” can be opened while watching a report, including a designer for the pivot-table content, a designer for the table-layout, a designer for charts and others.

The Query Designer allows to add axes, facts and selectors to your report with single mouseclicks. You can also rearrange your reports, add Top 10 filters and do many things more inside the designer without having any knowledge of instantOLAP queries.

The Table Designer offers a large number of predefined table designs. Simply change the look & feel of your report by selecting one of them. Of course, after you selected on the designs, you can change it afterwards by changing the table properties.

The Block Designer is very similar to the Table Designer but changes the look & feel of the containing blocks. Like the Table Designer, it offers a number of predefined layouts where you can choose from.

Another very useful is the Chart Designer. It automatically turns your query into one of the predefined charts. A large number of chart layout are offered, including 3D versions of every available chart type.

First of all, we broke the fixed block structure of queries and created a new, more flexible alternative. Now you can nest as much blocks as you want and as deep as you want. E.g. it is possible now to nest complete reports in tabulator block and to build huge executive reports which contain all neccesary data in one page.

Also, the selectors are no longer limited to stay at the top of the query, they can also be placed in any other block and every block can have its own selector. You may even place the selector at the left, right or bottom border of your blocks.

Of course, the old query structure will automatically converted in the current one and every existing query will be compatible with version 3.

We also introduced two new block types, the “IFrames” and “Query-Imports”. IFrames allow to display other HTML pages within your reports and to enrich them with other content. Query-Imports display other queries inside the importing query as if they were part of it itself.

And – you can include other queries as a block by using the “Query Import” format. This allows to reuse and to build dashboards by putting multiple queries together!

Another great change is how the queries load their content: Until now, every query was executed and displayed as a monolithic block, but now every block can update its content without the need to refresh other blocks. E.g. drilldown inside a table can become much more comfortable, because only the block containing the table has to be refreshed.

Also, blocks now do not load their content until it is needed. E.g. tabbed blocks will only load the data of their visible tab and dynamically load the other tabs content when the user selects them. Additionally, blocks can be collapsed and only load their data when the user expands them. This allows to build fast dashboards which load their data only on demand.

A much requested feature was to use multiple models in a single query. In instantOALP 3, each query can use a different model and you can generate reports with data from multiple models. Even the selectors work with different models if the dimensions have the same name. The only limit is that a single table or chart may only use a single model.

This is surely one of the greatest features in instantOLAP 3: This version will contain a fully functional and powerful query editor, even more mighty than the editor included in the Workbench of previous versions.

The new editor used the same layout and look & feel like the Workbench version – including drag & drop – but contains a couple of new improvements:

• First of all, it reflects the new block structure, this means you can nest blocks as you want and create selectors everywhere. A large number of new context menus will help you to arrange blocks and to change their format.A
• Also, the new Designers from the Query Viewer are available in the editor. This means, you can also design tables or turn them into predefined charts within the editor with a few mouse clicks.
• The property editor has the same functionality as the Workbench version but now groups the properties by themes to give you a better overview.
• The query editor will use the powerful expression editor of the portal which allows a much more powerful editing of expressions, including Top 10 requests, dimension searches, saved expressions and much more. We also improved the expression editor between version 2.6 to version 3.
• A zoom function allows to keep the whole report in sight when editing large reports.

The new editor will replace the existing version in the Workbench.

instantOLAP 3 will be available at the end of 2010. A beta release is scheduled for August 2010 and existing customers are welcome to test the new version!

• Expression now accept the escape characters \\’ or \\” to use delimiters in strings
• TimeKeyloader Attributes are now also adjust the years to weeks when the owning KeyLoader has its property “Adjust Years To Weeks” set to “true”
• Better performance for list reports
• Better performance for the MATRIX function

• Large logos are scaled to fit when exporting PDF documents
• Bugfix: Interval selectors now accept two equal default values
• Bugfix: The SuggestBox selector now selects values when using the tabulator key
• Bugfix: Better screen layout for the Automation Manager when editing email automations

• Better performance when rendering configurations with many dimensions and cubes

Basically, each chart in instantOLAP is bound to a single pivot table. Overlay charts work generally in the same way, but because an overlay chart is composed from two or more charts, we will also need more than one pivot table to feed the chart with data – each table feeds a single chart. So the first step is to create a block which contains multiple tables.

To create the first table, just use the “New pivot table” button from the right toolbar of the query editor. A new block, containing a single and empty table, will appear. Now drag a fact and a data series to the table, in out example this will be the “Amount” Fact and PRODUCT level from the Product dimension of the instantOLAP demo model.

Now you can add a second pivot table to the existing block by opening the context menu of the block (use the right mouse button on the title bar of the block). Use the menu item “Add pivot table” of the menu to add a second and emtpy table.

Because we want the new table to show data for the same samples, you should use the same iteration for the x-axis of the new new table as you did in the previous table. Only the fact in the y-axis will be a different one, in our example we will use the “Quantity” fact from the demo model.

This was the basic step for each chart generation: creating the source table(s) for your chart.

It’s time to turn the table into chart: Use the context menu of the block and choose one of the overlay chart types. In out example we’ll use the “Bar / Line” chart which turns the first table into a bar chart and the second into a line chart.

If you execute the query now, you may recognize that there are really two charts, but the second one (the line chart) only displays a flat line at the bottom of the image. This is because till now both charts share the same range and the values for the fact “Amount” much bigger than for the fact “Quantity” (or its line). Therefire it’s down to the bottom. and we’ll have to add a second range to the chart and to scale the line to this new range.

First of all you’ll have to activate the second range. There is a property named “Range 2 On” which has to be set to “true”. If you execute the query now you will see a second range, but the rest of the chart will look like before, including the  flat line chart.

This is because you must assign each of the chart to the ranges. By default, both charts are assigned to the range number 1, which is the default range at the left side of the chart. To re-assign the second (the line) chart to the new range at the right side, use the property “(Overlay) Series Range” property and set it to “2″ (use “1″ for the first range and “2″ for the second). If you execute the query now you’ll recognize the line beeing scaled over the full image.

Now, you have created an overlay chart with two source tables and two ranges.

• The automatic synchronization of dependent and indirect-dependent dimensions now ignores the cron patterns of the other dimensions and always synchronizes them.
• KeyLoaders now always set the name of their target level, even if they don’t load any key from the datasource. This only works for loaders nested under the root key of the dimension structure.
• Bugfix: A possible deadlock of model data files was eliminated. This deadlock could have cause non-removable locks on models.
• Bugfix: TimeKeyLoaders with combined weeks and years in their pattern didn’t correct the year properly for end 2009 / beginning 2010.
• Bugfix: Stores using Where-Only mappings threw exceptions while building.

• The model tree of the Analyzer now offers some standard expressions like the Query Editor.
• The server now disallows the Browser to cache the startup HTML file of the Portal.
• Bugfix: Rendering-problems with overlay charts have been fixed.
• Bugfix: Reports with complex selectors did sometimes not appear before using the “Execute” button.
• Bugfix: The Expression Editor can now be closed with empty expression without displaying an error message.
• Bugfix: The dropdown fields of classic Hierarchy selectors are now expanded to the full selector size in IE now.
• Bugfix: Interval selectors did not display two equal default values correctly

• The Workbench offers a new property “Adjust Year To Weeks” for TimeKeyLoaders which allows to disable the automatic year correction for patterns combining both weeks and years.
• Bugfix: A possible deadlock while displaying properties for a currently loading model was removed.
• Bugfix: The webstart version of the Workbench killed existing named sessions even if the user denied to kill them.

Because of copyright reasons, only a few drivers are included in the instantOLAP standard distribution (an open source driver for Sybase and Microsoft SQL-Server and a second driver for HSQLDB databases). For all other database servers, you can find the driver in the internet. This is a list of the common database servers and some internet addresses where to find the driver.

If you use Apache Tomcat as your Application Server (which is the default Application Server installed together with instantOLAP), installing a new driver is very simple:

1. Download the driver from the vendors driver page
2. If neccesary, extract the driver or execute the driver installer to extract the driver files onto your hard disk.
3. Locate the driver files (they always end with .jar) and copy them into the library folder of your Tomcat server. Depending on the Tomcat version, the library folder is <tomcat>/common/lib (for Tomcat 5.5) or <tomcat>/lib (for Tomcat 6)
4. Restart Tomcat

After you installed the driver in your Application Server you can use from instantOLAP. Generally there are two different ways to access a driver or database: You can connect the server directly out of instantOLAP or you can use a predefined datasource, which has to be prepared inside the Application Server. For testing, developing or small installations, we recommend the first alternative.

To connect a database directly out of instantOLAP, simply use the “Add datasource” button when you are inside the “Datasources” section of a configuration. This will open a datasource wizard, which asks you for the name, driver, connection URL and credentials of the target database. Refer our online documentation for more details.

There are at least two good drivers for the Microsofts SQL-Server: The original Microsoft JDBC driver and the open source driver jDTS for Microsoft SQL and Sybase databases, which is included in the instantOLAP standard distribution.

The original Microsoft JDBC driver can be found and downloaded from the Microsoft page.

• Download: Microsoft SQL Server JDBC Driver 2.0
• Driver file(s): sqljdbc.jar
• Driver class: com.microsoft.sqlserver.jdbc.SQLServerDriver
• Connection-URL: jdbc:sqlserver://<server>[:<port>];databasename=<database>

Escpecially in older versions of the originial driver, it is important to know how to form the connection URL. You must include the database name in your URL, otherwise you will be able to see the tables but not to access their content.

jDTS is an open source alternative for Microsoft SQL and Sybase databases and already included in the instantOLAP standard distribution.

• Download: http://jtds.sourceforge.net
• Driver files(s):  jdts-<version>.jar
• Driver class: net.sourceforge.jtds.jdbc.Driver
• Connection-URL: jdbc:jtds:sqlserver://<server>[:<port>][/<database>]

When using MySQL databases, make sure to use the most current available driver version, because older drivers may cause problems with newer versions of the database.

• Download page: http://dev.mysql.com/downloads/#connector-j
• Driver file(s): mysql-connector-java-<version>-bin.jar
• Driver class: com.mysql.jdbc.Driver
• Connection-URL: jdbc:mysql://<server>/<database>

For Oracle databases it is imporant to use the correct version of the driver which matches the version of your database server. The drivers for all version can be downloaded from the Oracle page, but you will need to create an account before (if you don’t have already).

• Download: Oracle JDBC/UCP Download Page
• Driver file(s): ojdbc15.jar or ojdbc16.jar
• Driver class: oracle.jdbc.driver.OracleDriver
• Connection-URL: jdbc:oracle:thin:@<server>:1521:<database>

Like in the case of Microsoft SQL Server, you can use the original Sybase driver or the open source driver jDTS to connect a Sybase driver.

• Download: jConnect – Software Developer Kit
• Driver file(s): jconn3.jar
• Driver class: com.sybase.jdbc2.jdbc.SybDriver
• Connection-URL: jdbc:sybase:Tds:<server>[:<port>]/<database>

jDTS is an open source alternative for Microsoft SQL and Sybase databases and already included in the instantOLAP standard distribution.

• Download: http://jtds.sourceforge.net
• Driver file(s): jtds-<version>.jar
• Driver class: net.sourceforge.jtds.jdbc.Driver
• Connection-URL: jdbc:jtds:sybase://<server>[:<port>][/<database>]

For all current versions of DB/2 you can use the Universal Database Driver (UDB) from DB/2. However, when you wan’t to connect a DB/2 database running on a mainframe system, you’ll have to purchase an additional license from IBM.

• Download: IBM – Application Development with DB/2 (Follow the links and download the DB/2 client)
• Driver file(s): db2jcc.jar
• Driver class: com.ibm.db2.jcc.DB2Driver
• Connection-URL: jdbc:db2://<server>[:<port>]/<database>

Since IBM bought the Informix database, you can find the Informix drivers on the IBM homepage now, too:

• Download: IBM Software Downloads
• Driver file(s): ifxjdbc.jar
• Driver class: com.informix.jdbc.IfxDriver
• Connection-URL: jdbc:informix-sqli://<host>:<port>/<database>:informixserver=<dbservername>

You can download the version from our downloads page. You will also find a update of our manual, reference and online documentation on our documentation page. Read this article to learn some details about version 2.6.1 and to read its release notes.

The new version contains new and faster renderers for the HTML, Excel and PDF output. In difference to the output of the PDF renderer, which generates output equal to its previous version, the HTML renderer now generates a much more compressed result. Especially for the Internet Explorer, this reduces the load and display time for HTML reports significant.

Additionally, the new HTML renderer offers some new formatting options:

• Scrollable tables with fixed headers: Before in the only available in the analyzer, tables in normal reports can now also contain fixed headers and scrollbars. The new HTML renderer will automatically display every table as scrollable table which is placed inside a block with fixed width and height properties set.
• Free positioning of blocks: For each block you may assign a fixed X/Y position and place them everywhere on the screen you want to.
• The automatic expansion of blocsk to make them all equal with can be manually switched of now.
• Charts are now automatically expanded to the size of their owning blocks and therefore zoomed when blocks are expanded because of other and larger blocks in the report.

The Excel renderer also contains some new features. E.g. automatically generates foreground and background colors for negative numbers or exceptions are now included in the Excel export and all original datatypes of the cells are preservered when exporting a document.

The report viewer now contains a new “Print preview” button which shows the report in a printable PDF version directly inside the browser. This allows to print a report without exporting it into the PDF format before. To use this feature, your browser must have installed the Adobe PDF plugin.

A new button in the upper right corner of the portal allows to hide the explorer bar at the left side of the portal and to gain more space for the reports or other viewers.

The expression editor, which is used e.g. to edit formulas or header iterations in the Analyzer, has widely changed and offers a number of new dialogs for searching, sorting, navigating etc. in dimensions without using the keyboard and manually typing expression.

There is a detailled description of the expression editor in our also new manual for the version 2.6.1.

When creating a store you can now choose between two storage models for their data: The known “Condensed” format and the new “Indexed” format, which is much fast in building high-dimensional stores but slower in reading data out of stores. With a good combination of condensed and indexed stores, you can now create offline version of really high dimensional cubes by creating the most used combination of dimension as condensed stores and additionaly storing the “complete” view of the cube in a indexed store.

To learn more about the new storage type, read the new store property description in our new reference for version 2.6.1.

22.10.2009: Release 2.6.1

Server

• A new function ISLEAF was added
• Less logging, e.g. for unknown tables while editing configurations
• Now match filters for cubes can contain expressions of any complexity
• Imported dimensions now use less memory and CPU than before
• The limits for number keyloader have been lowered, both limits can be negative now and the start-limit has no longer to be less than the end-limit
• Unknown keys are now mapped to the root key when loading a cube into an offline store (but they still generate warnings). This brings the behavior closer to online cubes, because the root key of dimension always reflect the total of the database content, independent of all keys being mapped to the dimension.
• A new storage model for stores, the “Indexed” storage, allows to create stores for high-dimensional cubes. Though the indexed storage is slower than the previous “condensed” model, its build time does not grows exponential with the number of included dimensions.
• Line breaks in escaped SQL statements (@”…..”) are now allows and will no longer irritate the Database server.
• Unmappable keys are mapped to the root key of a dimension when loading a cube into a store. This equals the root value of the dimension to the online version of the cube.

• Bugfix: A possible deadlock while using a corrupt dimension was fixed
• Bugfix: Mappings with “mode = select” did not appear in the result sometimes
• Bugfix: Multiple mappings for the same fact now also work with DLOOKUP
• Bugfix: The GROUP BY clause was constructed wrong if a statement contained
  equal expressions and used the “Group by indices” option.

Web-Frontend

• New and faster renderers for HTML, Excel and PDF output
• A strong compression for the HTML output was added, now cells with similar styles are clustered into CSS classes
• A new “Print preview” was added to the report viewer now. The preview displays reports as PDF files inside the portal and allows to print reports without exporting them before.
• User can now hide the explorers at the left side of the portal
• Now ThinUsers can also delete their private files and snapshots
• Now negative numbers are also colored red when exported to Excel
• New placeholders for filenames in automations have been added (%USER% etc)
• Empty rows and columns are now removed from the result set and no longer displayed as rows or columns with the height or width 0
• Input fields and links became much more performant, reports with thousands of input fields are now possible
• Assertions are now also displayed in Excel and PDF exports
• The selected tab in the tabbed orientation is now highlighted
• Dialogs are movable now
• Window titles are limited to 30 characters now
• Improved drag and drop behavior which now also works if the user drags an item very fast or if the browser reacts slowly
• The table editor in the Pivot viewer does no longer disappear when changing the format to “chart”.
• The “save as” dialog now also shows where the user has no write access if one of the subfolders is accessible.
• The Excel export now preserves the data types and exports all texts as text, even if it is convertible to a number.
• There is no need to create access rules for the bookmarks or snapshots folder any more.

• Bugfix: Headers nested under spanned headers are now no longer too wide or too heigh
• Bugfix: The snapshot and automation folders no longer need manual set access rights
• Bugfix: The font-color was not exported to Excel correctly
• Bugfix: Removing sorts in the Analyzer now works
• Bugfix: Like for other formats, the XML export is now only offered after the report was displayed
• Bugfix: Long URLs caused problems in IE and are now replaced by simple numbers
• Bugfix: EMail attachments always had “.pdf” extension when send directly out of the report viewer.
• Bugfix: Sorting a row or column in the pivot viewer (using the context menu of a header) now also works with scrolled tables.
• Bugfix: The content of search selectors and input fields can now be selected.

Workbench

• The Workbench no longer locks when waiting for a model load or reload
• The ERM view became faster and uses a cached version of the database-schema when displaying the links
• Invisible keys and facts now appear in the cube editor
• Invisible dimensions now appear in the dimension preview
• A new background property was added for queries
• The column widths in the property editor are no longer reset when a new element is selected
• The previewer now also works on all Windows 64 bit systems

• Bugfix: The password for automations can now be edited and changed

Console

• A new argument now allows to kill an existing session for a named user

The tool is very useful whenever instantOLAP loads its data from a data-warehouse and you want to rebuild certain models, dimensions or cubes after the ETL tool rebuild the warehouse or added new data to it.

This article describes, how to use the tool from batch-files or other Java applications (most ETL tools can call native Java commands) and which operations are available.

The console is delivered as a simple Java archive (jar file) and is located in the folder <instantOLAP>/tools/console. You can use the archive from this location or copy it to another computer – no other resource (except a local Java installation) is needed to execute the application.

To start the console in the interactive mode, use the command:

java -jar iolapConsole.jar <server-url> <user> <password>

where <server-url> is the complete url to the backend-service of your instantOLAP-server and <user> and <password> are the credentials for your administrator account. E.g. the command for a local installation on port 8080 and with the administrator account would be:

java -jar iolapConsole.jar http://localhost:8080/iolapWS admin admin

If the jar file is not located in the current folder, you can also type its whole path (relative or absolute). After you logged successfully into the server, you will see the following welcome message:

instantOLAP console
(c) 2006-2009 Thomas Behrends Softwareentwicklung e.K.
Connecting server http://localhost:8080/iolapWS...
ok
>

Now you can use one of following commands to control the server:

This command rebuilds a single dimension of a model (and all dimensions being dependend on this). The command expects the model name and dimension name as argument.

Example:

> BUILDDIMENSION demo/demo Product
Building dimension Product of model demo/demo...

This command rebuilds all dimensions of the specified model. The only argument the command expects is the name of the model.

Example:

> BUILDDIMENSIONS demo/demo
Building dimensions of model demo/demo...

The command BUILDSTORE rebuilds a single store of the specified model, the store name has to be passed as second argument.

Example:

> BUILDSTORE demo/demo store1
Building store store1 of model demo/demo...

Rebuilds all stores of the specified model.

Example:

> BUILDSTORES demo/demo
Building stores of model demo/demo...

Use the command CLEARCACHE to empty a single cache of the model. After the execution, the cache still exists but contains no entries.

Example:

> CLEARCACHE demo/demo cache1
Clearing cache cache1 of model demo/demo...

This command clear all caches of the specified model.

Example:

> CLEARCACHES demo/demo
Clearing caches of model demo/demo...

Clears a single store of the model and brings it into the “offline” state. Dependend on the configuration settings, the model will continue using the original adhoc version of the store, otherwise the system will immediatley start to rebuild the store again.

Example:

> CLEARSTORE demo/demo store1
Clearing store store1 of model demo/demo...

This command clears all stores of the model. Like in the CLEARSTORE command, the system will immediatley rebuild all stores dependend on the configuration settings.

Example:

> CLEARSTORES demo/demo
Clearing stores of model demo/demo...

This command returns a list of all dimensions of the specified model.

Example:

> LISTDIMENSIONS demo/demo
Agency
Anim
Campaigns
Manufacturer
Product
Time

Returns a list of all models on your server, including the active and inactive ones. For each model, the current state is append as text. The following states are possible:

• ONLINE: The model is started and ready
• BUILD: The model is currently starting
• CLOSED: The model is currently not started
• CLOSING: The model is currently shutting down
• SYNC: The model is started and currently synchronizing its dimensions and / or cubes
• ERROR: The model is not started because an error ocurred while starting it

Example:

> LISTMODELS
demo/demo (ONLINE)
eventlog/eventlog (ONLINE)

This function returns the state of a specific model. The state is returned as number in this functions, the following states are possible:

• 0 = CLOSED
• 1 = BUILD
• 2 = ONLINE
• 3 = SYNC
• 4 = ERROR
• 5 = CLOSING

Example:

> MODELSTATE demo/demo
Request model-state for demo/demo...
State = 2

This command stops the console.

This function starts the synchronize process for a model, in which it is checking its cubes and dimensions if they are outaged. You must pass the timeout for the synchronize process in ms as second argument. This function is only useful if you want to synchronize the model immediatly, because the system synchronizes all its online models each minute.

Example:

> STARTSYNC demo/demo 1000
Starting model demo/demo synchronize...

This command shuts down the specified model.

Example:

> STOP demo/demo
Stopping model demo/demo...
ok

This command starts the specified model.

Example:

>START demo/demo
Starting model demo/demo asynchron...

The batch mode can be used to call the console from external batch files and to execute commands without user interaction. To execute a command, just add it and its arguments behind the standard arguments of the console, the syntax for the batch mode is:

java -jar iolapConsole.jar <server> <user> <pwd> <command> [<arg1> [<arg2> [...] ] ]

If you call the console in batch mode, it will immediatley execute the passed command and then exit. E.g. the following line

java -jar iolapConsole.jar http://localost:8080/iolapWS admin admin START demo/demo

would start the model “demo/demo” on a local server running on port 8080 and then return.

Not that all commands, also in the interactive mode, only fork the requested operation on the server and then return without waiting for the operation to be finished. However, if you send a number of commands for the same model to server, they will be queued and executed in sequential order.