com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links' is unknown.

Introduction to C-App

Carbon Applications will be renamed to Composite Applications in an upcoming release, because we will support both Carbon-based and non Carbon-based applications

A Carbon Application (C-App) is a collection of artifacts deployable on a WSO2 product instance. These artifacts are usually JAVA-based or XML configurations, designed differently for each WSO2 product in the WSO2 Carbon platform. You can deploy these artifacts to generate services.

A single WSO2 product can have numerous artifacts such as Axis2 services, data services, synapse configurations, endpoints, proxy services, mediators, registry resources, BPEL workflows etc. Usually, these artifacts are created in a development environment and then moved one by one into staging/production environments. Manually configuring artifacts to build up the entire solution this way is a time-consuming task. Instead, you can bundle configuration files and artifacts in a C-App and port Web service based solutions across environments more easily. C-Apps allow you to export your entire solution as a single archive file.

A single C-App can consist of artifacts that are deployable in various different products. Therefore, when you deploy a C-App in a particular WSO2 product, all its artifacts might not be deployed in that particular product instance. To sort out what artifact can be deployed in what product, you use the ServerRole property as explained below.

Adding the ServerRole property

A server role is a parameter that is mentioned in <PRODUCT_HOME>/repository/conf/carbon.xml file of all WSO2 products. When a C-App is being deployed, it reads the ServerRoles property from carbon.xml and deploys only the resources that match the ServerRole value in the file. Each product has a different default ServerRoles property as follows:

  • WSO2 Application Server - "ApplicationServer"
  • WSO2 Business Activity Monitor - "BusinessActivityMonitor"
  • WSO2 Business Process Server - "BusinessProcessServer"
  • WSO2 Business Rules Server - "BusinessRulesServer"
  • WSO2 Data Services Server - "DataServicesServer"
  • WSO2 Enterprise Service Bus - "EnterpriseServiceBus"
  • WSO2 Gadget Server - "GadgetServer"
  • WSO2 Governance Registry - "GovernanceRegistry"
  • WSO2 Identity Server - "IdentityServer"
  • WSO2 Mashup Server - "MashupServer"

In C-App development time, you can specify a ServerRole for each artifact in the C-App. For example, say you are developing an Axis2 service and planning to deploy all your services in a single Application Server instance in the production setup. You can set the ServerRole as appserver1.

The following methods can be used to set the ServerRole property:

Using the management console to set the ServerRole property

This is the recommended way to configure server roles because the changes done through the console cannot be overridden by the other methods. Server roles are stored in the registry when they are configured through the management console. Values in the registry are always given priority over others.

  1. Log in to the management console of your product and click Server Roles menu under the Configure menu.  

  2. Click Add New Server Role, enter the Role Name and click Add. You can add any textual name as a server role without special characters except underscore.
     
  3. The newly added server role is displayed in the server roles list. 
     You can delete the server role using the Delete icon associated with it.

    You cannot undo a deletion once performed. Users can even delete a default server role. Once deleted, the server role manager will not pick up the deleted server role from the carbon.xml file, next time the server starts.

Using carbon.xml file to set the ServerRole property

Change the ServerRoles element in <PRODUCT_HOME>/repository/conf/carbon.xml file as follows:

<ServerRoles>
     <Role>DataServicesServer</Role>
</ServerRoles>

You can also specify multiple roles for the server. For example,

<ServerRoles>
     <Role>appserver1</Role>
     <Role>dataservices1</Role>
</ServerRoles>

In the above example, before setting the two ServerRole properties, ensure that the server has capability to deploy both Axis2 services and data services. When you deploy a C-App, only the artifacts that have the above two server roles are deployed on the current instance. Others are ignored.

Using a system property to set the ServerRole property

You can use the system property ServerRoles to specify the roles of the current server. When you start the server, pass the ServerRoles as a comma separated list. For example,

sh wso2server.sh -DserverRoles=appserver1,dataservices1
com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.