MetaBoss
User Guides
Synopsis
Beginner's Guide
Configuration Guide
Design Studio Guide
Programming Model Guide
Testing Framework Guide
'How To ...' Guides
References
Synopsis
Design Model Reference
Design Model UML Profile
Test Schema Reference
MetaBoss design library
Run-time libraries API
Dev-time libraries API
HatMaker Example
Synopsis
Enterprise Model Description
Enterprise Model Reference
SystemTest Example
WebServices Example
Miscellaneous
About MetaBoss
Quality Assurance
Compatibility Notes
Acknowledgments
Glossary
Change Log
Version 1.4.0001
Built on 15 Dec 2005 22:31:47

MetaBoss Compatibility Information

This document contains information on MetaBoss compatibility and possible known compatibility issues.

Compatibility when using MetaBoss

  • UML CASE Tools Interoperability

    We have tested UML Profile For MetaBoss and HatMaker Example Model (eg. Convert to UML or Convert from UML) using Poseidon For UML 2.2.1. The tool successfully imports XMI files with MetaBoss models, so it is satisfactory for viewing of the UML model. However, we have found problems with modelling of UML DataTypes and UML Binding, so it is impossible to model Data Dictionaries using this tool. This means that Poseidon For UML 2.2.1 can not be used to enter and edit MetaBoss enterprise models.

    When investigating or testing the MetaBoss compatibility with UML CASE Tools it is worth remembering that MetaBoss Model Repository module is using MDR (Meta Data Repository) framework from NetBeans and UML 1.4 MOF Profile. MDR XMI Reader and Writer support XMI Version 1.2. In addition, please note that MDR Users Mailing List (searchable) is a good source of information on XMI compatibility issues.


  • Operating Systems

    We have tested and provided startup scripts to run Design Studio on Unix, Linux, MacOS and Windows XP/2000. We use Windows XP SP1. Examples directory structure contains directories named in mixed case, which makes them difficult to use on Linux, Unix and MacOS


  • Java J2SE Development Kit

    Should be at least 1.4.2.x. We use 1.4.2_05


  • Java J2EE Development Kit

    We use 1.3.1. (and EJB 2.0 spec) Anything else is untested at this stage. Having said that we only use j2ee.jar from it to compile generated enterprise java beans distribution layer against it. Therefore we think that any other version should work for as long as javax.ejb interfaces are compatible


  • Apache Ant

    We use Ant 1.6.1. Anything earlier than 1.6.0 is possible but requires a bit of effort in setting classpath. This is because MetaBoss examples use -lib option, which is new in Ant 1.6.x


Compatibility when using systems built with MetaBoss

  • Oracle Database

    We have tested on 8.x and 9.x with 9.0.1 JDBC driver. HatMaker example contains example of how to rename TIMESTAMP columns (new in Oracle 9.x back to DATE columns in case generated scripts must be run on Oracle 8.x. Please note that HatMaker example contains full working set of configuration files, which you may find useful.


  • MySQL Database

    We have tested on 4.1.3-beta with MySQL Connector Java 3.0.12 JDBC driver. We know that anything earlier than that will not work because subqueries were not supported at all. Even with this release a few issues still remaining:

    • There is still no support for XA Data Sorce, so HatMaker example uses Tyrex's wrapper data source (It simulates XA DataSource on top of simple DataSource). This will work 100% if transactions are not distributed (i.e. service implementation will always update only one domain in one transaction). If you require serious distributed transactions - try to influence makers of MySQL to implement it or change the database. Please note that HatMaker example contains full working set of configuration files, which you may find useful.
    • There is still no support for LIMIT and IN clauses in subqueries. This means that some complex paging queries (eg. where we want associated collection obtained from the collection subset) will produce java.sql.SQLException with text Syntax error or access violation, message from server: "This version of MySQL doesn't yet support 'LIMIT & IN/ALL/ANY/SOME subquery'". Again, if you require full freedom of the collections - try to influence makers of MySQL to fully implement subqueries or change the database. Please note that this is the reason why HatMaker example contains separate database-specific test scenarios directory with tests which can only succeed on Oracle at this stage.


  • JBoss Application Server

    We have tested on 3.0.4 with Tomcat 4.1.12 At this stage we do not know if any other version will work.


  • Web Services

    Web Services tier is built using Sun's Java Web Services Developer pack (JWSDP) Ver 1.5, which is redistributed with MetaBoss. We have tested the deployment using Tomcat 5.0.28