Release 3.1.1 is the Stardust contribution to Mars.2. It is functionally identical with release 3.1.0 with the exception that it is compiled and tested against Mars.2 upstream dependencies.
The following tables list all supported micro versions for:
Note
We do not expect any problems in all micro versions covered in the following tables
of supported platforms, but we cannot strictly guarantee correct end-to-end system functionality in other platform
versions than the Reference Test Platforms, as bugs in the platform code and problems
introduced by combining different unforeseen micro-level versions of the different platform components could in
rare cases introduce incorrect system behavior that is beyond our control. Refer to section Reference
Test Platforms for a list of fine grained version information for our regression test platforms.
The Stardust portals are currently supported on the following user agents:
| User Agents | Supported Versions |
|---|---|
| Internet Explorer (except Web Modeler and Rules Management perspectives) | 10, 11 (in IE 10 mode) |
| Mozilla Firefox | 41 (note that future browser releases are not tested with Stardust yet and might cause issues) |
| Google Chrome | 46 (note that future browser releases are not tested with Stardust yet and might cause issues) |
The following database servers are currently supported by Stardust:
| Server | Supported Versions |
|---|---|
| Oracle | 11g R1 (11.1.0.6.0) (deprecated), 11g R2 (11.2.0.1.0), 12.1.1 (12c) |
| DB2 UDB | 9.7 |
| Derby | 10.9.1.0 |
| MySQL | 5.6 |
| Sybase ASE | 15.7 |
| SQL Server | 2008, 2012 |
The following application servers are currently supported by Stardust:
| Server | Supported Versions |
|---|---|
| IBM WebSphere | 8 (8.0.0.5 or later) |
| Oracle WebLogic | 10.3.6, 12c Release 1 |
| JBoss | 7.1, EAP 6.3, EAP 6.4 |
| Jakarta Tomcat | 7 |
If you don't see your favorite database or application server in this list, please send a request to us. We continuously update the list of supported databases and application servers.
| Vendor | Supported Version |
|---|---|
| Oracle, Sun | Java SE 6 |
| Oracle | 1.7.x, 1.8.x |
| IBM | 32 Bit JRE 6.0 (together with WebSphere 8) |
| Oracle | JRockit 6 (together with Oracle 11g application server) |
| Vendor | Supported Version |
|---|---|
| Spring | 3.2.4 |
| Jackrabbit | 2.6.1 |
| Hazelcast | 2.4 |
The following tables provide fine grained version information for our regression test platforms.
The following database servers are currently tested as reference:
| Server | Supported Versions |
|---|---|
| Oracle | 11g R1 (11.1.0.6.0), 11g R2 (11.2.0.1.0), 11g-XE, 12c (12.1.1) |
| DB2 UDB | 9.7.5 |
| Derby | 10.9.1.0 |
| MySQL | 5.6 |
| Sybase ASE | 15.7 |
| SQL Server | 2012 |
The following application servers are currently tested as reference:
| Server | Supported Versions |
|---|---|
| IBM WebSphere | 8.0.0.9 |
| Oracle WebLogic | 10.3.6, 12.1.2, 12.1.3 |
| JBoss | 7.1.1, EAP 6.3.0, 6.4.0 |
| Jakarta Tomcat | 7.0.63 |
The following new features and bug fixes have been introduced with this release:
The following functionality of the Business Process Modeler is still customer technology preview only. Note that these previews may not be functionally complete and are not intended for production use.
The Stardust Portal provides a configuration switch to show or hide features that are provided as technology preview.
The following main features and bug fixes have been introduced with this release:
| Bug-ID | Description |
|---|---|
| Bug 486448 | Upgrade example models to 3.1.1 |
| Bug 486449 | Upgrade Stardust to 3.1.1 - Adjust Facet versions |
| Bug 486450 | Upgrade Stardust to 3.1.1 - Adjust Product-Stardust version mapping |
No API changes have been performed in this release. The following section provides an overview on deprecated API.
The following API methods are deprecated:
| Method | Return Value | Parameter |
|---|---|---|
| getModel | DeployedModel | - |
AdministrationService
| Method | Return Value | Parameter |
|---|---|---|
| deployModel | DeploymentInfo | String model, int predecessorOID |
| overwriteModel | DeploymentInfo | String model, int modelOid |
| deployModel | DeploymentInfo | String model, String configuration, int predecessorOID, Date validFrom, Date validTo, String comment, boolean disabled, boolean ignoreWarning |
| overwriteModel | DeploymentInfo | String configuration, int modelOID, Date validFrom, Date validTo, String comment, boolean disabled, boolean ignoreWarnings |
QueryService
| Method | Return Value | Parameter |
|---|---|---|
| getAllModelDescriptions | List<DeployedModelDescription> | - |
| getAllAliveModelDescriptions | List<DeployedModelDescription> | - |
| getActiveModelDescription | DeployedModelDescription | - |
| getActiveModel | DeployedModel | - |
| findFirstDocument | Document | DocumentQuery query |
| getAllDocuments | Documents | DocumentQuery query |
UserService
| Method | Return Value | Parameter |
|---|---|---|
| isInternalAuthentified | boolean | - |
| invalidate | User | String account |
DocumentManagementService
| Method | Return Value | Parameter |
|---|---|---|
| versionDocument | Document | String documentId, String versionLabel |
| updateDocument | Document | Document document, boolean createNewRevision, String versionLabel, boolean keepLocked |
| updateDocument | Document | Document document, byte[] content, String encoding, boolean createNewRevision, String versionLabel, boolean keepLocked |
| findDocumentsByName | List<Document> | String namePattern |
| findDocuments | List<Document> | String xpathQuery |
Activity
| Method | Return Value | Parameter |
|---|---|---|
| getDefaultPerformerID | String | - |
| getDefaultPerformerName | String | - |
AttributeOrder
| Method | Return Value | Parameter |
|---|---|---|
| getAttribute | String | - |
DmsPrincipal
| Method | Return Value | Parameter |
|---|---|---|
| DmsPrincipal | constructor | String name |
ExternalUserConfiguration
| Method | Return Value | Parameter |
|---|---|---|
| getGrantedModelParticipants | Collection | - |
HistoricalState
| Method | Return Value | Parameter |
|---|---|---|
| getPerfomer | Participant | - |
| getOnBehalfOf | Participant | - |
LoginProvider - Interface is deprecated
Note
| Method | Return Value | Parameter |
|---|---|---|
| getUserOid | long | - |
Participant
| Method | Return Value | Parameter |
|---|---|---|
| getPartitionOID | short | - |
| getPartitionId | String | - |
| getModelOID | int | - |
| getElementOID | int | - |
| getAllSuperOrganizations | List | - |
| getNamespace | String | - |
ParticipantAssociationFilter
| Method | Return Value | Parameter |
|---|---|---|
| forModelParticipant | ParticipantAssociationFilter | String participantID |
| forModelParticipant | ParticipantAssociationFilter | String participantID, boolean recursively |
| inUserGroup | ParticipantAssociationFilter | String groupID |
| forUser | ParticipantAssociationFilter | String account |
| forTeamLeader | ParticipantAssociationFilter | String roleId |
PerformingInBehalfOfFilter
| Method | Return Value | Parameter |
|---|---|---|
| forModelParticpants | PerformingOnBehalfOfFilter | Set<String> participantIDs |
| forModelParticpant | PerformingOnBehalfOfFilter | String participantID, boolean recursively |
| forModelParticpant | PerformingOnBehalfOfFilter | String participantID |
| forUserGroup | PerformingOnBehalfOfFilter | String groupID |
PerformingParticipantFilter
| Method | Return Value | Parameter |
|---|---|---|
| USER_ROLES_AND_ORGANIZATIONS | static field | - |
| forModelParticipant | PerformingParticipantFilter | String participantID |
| forModelParticipant | PerformingParticipantFilter | String participantID, boolean recursively |
| forUserGroup | PerformingParticipantFilter | String groupID |
| PerformingParticipantFilter | constructor | String participantID |
| PerformingParticipantFilter | constructor | String participantID, boolean recursively |
| PerformingParticipantFilter | constructor(private) | Kind filterKind, final String participantID, boolean recursively |
ProcessInstanceQuery
| Method | Return Value | Parameter |
|---|---|---|
| STARTING_DOMAIN_OID | static field | - |
| CURRENT_DOMAIN_OID | static field | - |
UnsupportedFilterException
| Method | Return Value | Parameter |
|---|---|---|
| UnsupportedFilterException | constructor | String message |
| UnsupportedFilterException | constructor | String message, FilterCriterion filter |
User
| Method | Return Value | Parameter |
|---|---|---|
| getRealmOID | long | - |
| getRealmID | String | - |
| addGrant | void | String id |
| removeGrant | void | String id |
WorkflowExceptiom
| Method | Return Value | Parameter |
|---|---|---|
| getRootCause | PublicException | - |
The XML Data type integration is deprecated and will not be provided in the Eclipse modeler in future releases. You can use the External Reference structured data type instead, which is equivalent to the XML Data type, with the difference that it supports XSD schema exclusively (no DTD specification). Please refer to section Using External XSD Types of chapter Defining Structured Types for details.
No runtime upgrade is required for this release. For upgrading issues introduced with earlier releases, please refer to chapter Upgrading to Later Versions. There you find all upgrading steps necessary for your specific version.
If you use an audit trail database in RAD that has been created with Stardust
version earlier than 3.1, you have to deselect and select the database from the server
configuration page. Republishing the server updates the Tomcat server.xml
file with the new resource definition entry for embedded database usage.
For general known issues and restrictions, please refer to the Troubleshooting section in the online documentation.
If you add application parameters in the Web modeler using a Firefox browser, it might happen that the parameter list is not updated. Please clear your browser cache in that case. Note that the whole cache should be deleted from beginning of time.
If you run into timeouts when you are using the Benchmark daemon, this might happen
due to low batch size values. In that case increase the timeout value of the
daemon queue via the property benchmark.daemon.BatchSize in your
server-side carnot.properties file.
Additionally make sure that the default transaction timeout for your Daemon queue is at least equal to the value of property benchmark.daemon.Periodicity.
Please find details on properties benchmark.daemon.Periodicity and benchmark.daemon.BatchSize in section Daemon of chapter Server Side Properties.
If you experience partially loaded or improperly formatted pages, clear your Browser cache.
Issues occur when you use an MSSQL XA driver and you do not have enabled the usage of prepared statements. Use prepared statements in combination with a native MSSQL XA driver to avoid these issues.
Renaming an imported structured data from a referenced model in a cross-model scenario might lead to inconsistent behavior.
After creating a new project based on archetypes, a missing HttpServlet class error is displayed in the Problems view due to an issue with the m2e-wtp Eclipse plugin. The plugin enables the JavaServer Faces project facet, because it identifies JSF dependencies, and thus also applies additional files to the project. To avoid this issue, deselect the JSF Configurator option in the Maven preferences as described in section Deselecting the JSF Configurator option to avoid Missing HttpServlet class error of chapter Creating a Stardust Runtime Environment with Apache Maven.
In case you get a java.lang.NoClassDefFoundError: javax.ws.rs.NotFoundException
during server start-up with JBoss 7.1, make sure to upgrade the shipped RESTEasy
stack to version 3.x.
Upgrading to the new RESTEasy stack version prevents that the
Stardust jax-rs 2.0 is overwritten by the JBoss 1.0 jax-rs API during deployment,
which otherwise happens due to issue
https://issues.jboss.org/browse/WFLY-1304.
The MySQL 5.6 installation comes with the MySql Connector/J in version 5.1.34.
If you deploy this JAR into JBoss as a module and include it in the standalone.xml
file, you are facing a DuplicateServiceException.
This is a known issue for JBoss versions earlier than 8
(Module for MySQL JDBC driver with version 5.1.30+ needs <driver-class> in standalone.xml).
As a workaround you can define a specific driver-class in the standalone.xml
in the driver section as follows:
<driver name="mysql" module="com.mysql">
<driver-class>com.mysql.jdbc.Driver</driver-class>
<xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class>
</driver>
For details please refer to section Restrictions for a Deployment with MySQL Version 5.6 in the JBoss chapter of the Deployment Guide.
If the modifyUser API is invoked in mixed mode
(external and internal Authentication) to change the password
and user information of an existing user, no Exception is thrown.
The user information remains unchanged even though a successful response is provided.
Note that the ActiveMQ message server currently does not work with Java 8.
If you expand a repository folder having a number of child nodes that exceeds a maximum number of about 500 and you are using a JBoss server, the following Exception might occur:
JBWEB000065: HTTP Status 500 - JBWEB002004: More than the maximum number of request parameters (GET plus POST) for a single request (512) were detected. Any parameters beyond this limit have been ignored. To change this limit, set the maxParameterCount attribute on the Connector.
To resolve this issue, add the following property to your JBoss configuration:
<system-properties> <property name="org.apache.tomcat.util.http.Parameters.MAX_COUNT" value="1000"/> </system-properties>
The modern skin has the following issues in Mozilla FireFox or Google Chrome:
Note that the HTML5 color picker is not supported in the Internet Explorer for Benchmark categories. The color can be set for the category by entering the hexadecimal code for that color in the Internet Explorer.
Currently an unscoped organization is required in the model for the participant hierarchy to be synchronized to the IAF Infinity IdP correctly. Please refer to chapter Setting up WebSSO Authentication with the Stardust SSO SAML2 Artifact for details.
If you perform a standard Stardust portal WAR deployment on WebLogic, the produced log might miss some details like bootstrapping information from the Spring Framework or route tracing from the Camel Context.
To provide a proper logging, copy the slf4j-api-1.5.11.jar and
slf4j-log4j12-1.5.11.jar libraries to the lib folder of your
WebLogic domain.
Due to the synchronous operation of a relocation, spawning into multiple activities, e.g. as resulted from an AND split, might not work as expected in the following scenario:
Please refer to chapter Relocating Activities in the Programming Guide for details.
For a list of all known restrictions in the Business Process Modeler, please refer to section Restrictions in Modeler Functionality of chapter Compatibility and Analogy of Models.
Note that you need a lifecycle management environment to be able to run and test a Rule Task implementing a Rule Set. Please contact our Sales Support Team for details.
For the time being, you need to append _field to each variable in the code
editor of a technical rule in the Rules Management perspective. Refer
to chapter
Defining Technical Rules for details.
UI Mashup applications have the following restrictions:
The following modifications need to be applied in the JBoss 7.1 server:
Due to an issue, the JBoss default JSF implementation cannot be changed as
parameter WAR_BUNDLES_JSF_IMPL is not working in JBoss 7.1.1.
(WAR file using WAR_BUNDLES_JSF_IMPL embedded in an EAR file fails deployment).
This is caused by the issue:
JSF Version retrieved from deployment unit instead of top level deployment unit.
As a workaround, in com/sun/jsf-impl/main module in jsf-impl-2.1.7-jbossorg-2.jar/META-INF:
the .tld files have to be renamed to e.g. *-tmp.tld.
While deploying JBoss 7.1 for EJB 3, the following exception may occur:
org.jboss.msc.service.ServiceNotFoundException: Service
service jboss.ejb.default-resource-adapter-name-service not found
For a successful deployment, add the following under <subsystem xmlns="urn:jboss:Domain:ejb3:1.4">
in the standalone.xml file.
<mdb>
<resource-adapter-ref resource-adapter-name="hornetq-ra"/>
<bean-instance-pool-ref pool-name="mdb-strict-max-pool"/>
</mdb>
Worklist will not refresh itself automatically when the View is activated by tab switch or by clicking on it. It will refresh only when any activity was previously activated from the Worklist View. Note that this is not related to auto-refresh settings of worklist configuration. The auto-refresh settings would still refresh at specified time interval.
When audit trail import / export functionality is configured to be active, for some runtime platforms, interactions involving asynchronous engine operations may be delayed.
A runtime upgrade is not required for this release. For other upgrading issues introduced with earlier releases, please refer to chapter Upgrading to Later Versions. You will find all upgrading steps necessary for your specific version.