Injecting Parameters¶

When deploying integration artifacts in different environments, it is necessary to change the synapse parameters used in the artifacts according to the environment. For example, the 'endpoint URL' will be different in each environment. If you define the synapse parameters in your artifacts as explained below, you can inject the required parameter values for each environment using system variables. Without this feature, you need to create and maintain separate artifacts for each environment. This feature is useful for container deployments.

There are two ways to inject parameters into synapse configurations: By injecting values using environment variables, or by using a file to inject the parameter values.

Using Environment Variables¶

If you want to inject parameter values as environment variables, you need to apply the following.

Configuring the synapse artifacts

Define your synapse artifacts using "$SYSTEM:parameter_key" as the parameter value. Note that parameter_key represents a place holder representing the parameter. For example, shown below is an endpoint artifact, where the endpoint URI configured for this feature:

<?xml version="1.0" encoding="UTF-8"?>
<endpoint xmlns="http://ws.apache.org/ns/synapse" name="StockQuoteEndPoint">
  <address uri="$SYSTEM:stockQuoteEP"/>
</endpoint>

Exporting the environment variable

In a VM deployment, you can export the environment variables as shown below. Here VAR is the URL you need to have set as environment property.

export stockQuoteEP=http://localhost:61616/...

Using a File¶

If you want to inject parameter values using a configuration file, you need to apply the following configurations.

Configuring the synapse artifacts

Define your synapse artifacts using "$FILE:parameter_key" as the parameter value. For example, shown below is an endpoint artifact, where the endpoint URI is configured for the purpose injecting values using a configuration file:

<?xml version="1.0" encoding="UTF-8"?>
<endpoint xmlns="http://ws.apache.org/ns/synapse" name="StockQuoteEndPoint">
  <address uri="$FILE:stockQuoteEP"/>
</endpoint>

Setting up the file

You can use a configuration file to load the parameter values for each environment. By default, the Micro Integrator is shipped with the file.properties file (stored in the <MI_HOME>/conf directory), which you can use to store the parameter values that should be injected to your synapse configuration. The parameter values should be specified as a key-value pair as shown below.

stockQuoteEP=http://localhost:9000/services/SimpleStockQuoteService

Alternatively, you can use a custom file stored in a file system instead of the default file.properties file. For example, a file named dev.properties can be used to inject parameter values to the development environment and a file named prod.properties can be used to inject parameter values to the production environment.

Tip

It is possible to use a file from a network file system mount (NFS mount) as the file path. We can then use the environment specific configurations from the file in the NFS mount and inject the parameter values to the environment.

Updating the System property

In the product startup scripts (integrator.sh and integrator.bat file), which are available in the <MI_HOME>/bin directory, a system variable is defined as shown below and the value is set to default. When the system property is set to default as shown below, the system reads the parameters from the file.properties file that is available in the MI_HOME/conf directory.

-Dproperties.file.path=default

If you are using a custom configuration file, instead of the file.properties file, you need to configure the particular file path in the product startup script as shown below.

On Linux/MacOsOn Windows

-Dproperties.file.path=/home/user/ei_configs/dev/dev.properties

-Dproperties.file.path="%CONFIG_DIR%\dev\dev.properties

Supported Parameters¶

Listed below are the synapse artifact parameters to which you can dynamically inject values. Note that there are two ways to inject parameters as discussed above.

Endpoint parameters¶

Listed below are the Endpoint parameters that can be dynamically injected.

Endpoint Type	Parameters
Address Endpoint	`uri`
HTTP Endpoint	`uri`
Loadbalance Endpoint	`hostname` and `port`
RecipientList Endpoint	`hostname` and `port`
Template Endpoint	`uri`
WSDL Endpoint	`wsdlURI`

Example¶

In the following example, the endpoint URL is configured as a dynamic value.

Using Environment VariablesUsing a File

<?xml version="1.0" encoding="UTF-8"?>
<endpoint xmlns="http://ws.apache.org/ns/synapse" name="JSON_EP">
<address uri="$SYSTEM:VAR"/>
</endpoint>

<?xml version="1.0" encoding="UTF-8"?>
<endpoint xmlns="http://ws.apache.org/ns/synapse" name="StockQuoteEndPoint">
<address uri="$FILE:stockQuoteEP"/>
</endpoint>

Data service parameters¶

Listed below are the data service parameters that can be dynamically injected.

Driver
URL
Username
Password

Example¶

In the following example, parameters are configured as dynamic values in the data service.

Inline Datasource (Using Environment Variables)External Datasource (Using Environment Variables)Inline Datasource (Using a File)External Datasource (Using a File)

<data name="DataServiceSample" serviceGroup="" serviceNamespace="">
    <description/>
    <config id="SourceSample">
        <property name="org.wso2.ws.dataservice.user">$SYSTEM:uname</property>
        <property name="org.wso2.ws.dataservice.password">$SYSTEM:pass</property>
        <property name="org.wso2.ws.dataservice.protocol">$SYSTEM:url1</property>
        <property name="org.wso2.ws.dataservice.driver">$SYSTEM:driver1</property>
    </config>
    <query>
    --------------------
    </query>
    <operation>
    --------------------
    </operation>
</data>

<datasource>
    <name>MySQLConnection</name>
    <description>MySQL Connection</description>
    <definition type="RDBMS">
        <configuration>
            <driverClassName>$SYSTEM:driver1</driverClassName>
            <url>$SYSTEM:url1</url>
            <username>$SYSTEM:uname</username>
            <password>$SYSTEM:pass</password>
        </configuration>
    </definition>
</datasource>

<data name="DataServiceSample" serviceGroup="" serviceNamespace="">
    <description/>
    <config id="SourceSample">
        <property name="org.wso2.ws.dataservice.user">$FILE:uname</property>
        <property name="org.wso2.ws.dataservice.password">$FILE:pass</property>
        <property name="org.wso2.ws.dataservice.protocol">$FILE:url1</property>
        <property name="org.wso2.ws.dataservice.driver">$FILE:driver1</property>
    </config>
    <query>
    --------------------
    </query>
    <operation>
    --------------------
    </operation>
</data>

<datasource>
    <name>MySQLConnection</name>
    <description>MySQL Connection</description>
    <definition type="RDBMS">
        <configuration>
            <driverClassName>$FILE:driver1</driverClassName>
            <url>$FILE:url1</url>
            <username>$FILE:uname</username>
            <password>$FILE:pass</password>
        </configuration>
    </definition>
</datasource>

DB Report and DB Lookup mediator parameters¶

Listed below are the DB Report and DB Lookup mediator parameters that can be dynamically injected.

Driver
URL
Username
Password

Example¶

In the following example, parameters are configured as dynamic values in the DB Report and DB Lookup mediators.

DB Report (Using Environment Variables)DB Lookup (Using Environment Variables)DB Report (Using a File)DB Lookup (Using a File)

<dbreport>
    <connection>
        <pool>
        <driver>$SYSTEM:driver1</driver>
        <url>$SYSTEM:url1</url>
        <user>$SYSTEM:uname</user>
        <password>$SYSTEM:pass</password>
        </pool>
    </connection>
</dbreport>

<dblookup>
    <connection>
        <pool>
        <driver>$SYSTEM:driver1</driver>
        <url>$SYSTEM:url1</url>
        <user>$SYSTEM:uname</user>
        <password>$SYSTEM:pass</password>
        </pool>
    </connection>
</dblookup>

<dbreport>
    <connection>
        <pool>
        <driver>$FILE:driver1</driver>
        <url>$FILE:url1</url>
        <user>$FILE:uname</user>
        <password>$FILE:pass</password>
        </pool>
    </connection>
</dbreport>

<dblookup>
    <connection>
        <pool>
        <driver>$FILE:driver1</driver>
        <url>$FILE:url1</url>
        <user>$FILE:uname</user>
        <password>$FILE:pass</password>
        </pool>
    </connection>
</dblookup>

Scheduled Task parameters¶

The pinned servers parameter can be dynamically injected to a scheduled task or proxy service. See the example given below.

Example¶

Using Environment VariablesUsing a File

<?xml version="1.0" encoding="UTF-8"?>
<task class="org.apache.synapse.startup.tasks.MessageInjector" group="synapse.simple.quartz" name="ProxytestInject" pinnedServers="$SYSTEM:pinned" xmlns="http://ws.apache.org/ns/synapse">
    <trigger count="5" interval="10"/>
    <property name="injectTo" value="proxy" xmlns:task="http://www.wso2.org/products/wso2commons/tasks"/>
    <property name="proxyName" value="testProxy" xmlns:task="http://www.wso2.org/products/wso2commons/tasks"/>
    <property name="soapAction" value="mediate" xmlns:task="http://www.wso2.org/products/wso2commons/tasks"/>
    <property name="message" xmlns:task="http://www.wso2.org/products/wso2commons/tasks">
        ----------
    </property>
</task>

<?xml version="1.0" encoding="UTF-8"?>
<task class="org.apache.synapse.startup.tasks.MessageInjector" group="synapse.simple.quartz" name="ProxytestInject" pinnedServers="$FILE:pinned" xmlns="http://ws.apache.org/ns/synapse">
    <trigger count="5" interval="10"/>
    <property name="injectTo" value="proxy" xmlns:task="http://www.wso2.org/products/wso2commons/tasks"/>
    <property name="proxyName" value="testProxy" xmlns:task="http://www.wso2.org/products/wso2commons/tasks"/>
    <property name="soapAction" value="mediate" xmlns:task="http://www.wso2.org/products/wso2commons/tasks"/>
    <property name="message" xmlns:task="http://www.wso2.org/products/wso2commons/tasks">
        ----------
    </property>
</task>

Inbound Endpoint parameters¶

See the list of inbound endpoint parameters that can be dynamically injected.

Example¶

In the following example, JMS transport parameters in an inbound endpoint are configured as dynamic values.

Using Environment VariablesUsing a File

<?xml version="1.0" encoding="UTF-8"?>
<inboundEndpoint name="jms" onError="fault" protocol="jms" sequence="LogMsgSeq" suspend="false" xmlns="http://ws.apache.org/ns/synapse">
    <parameters>
        <parameter name="interval">15000</parameter>
        <parameter name="sequential">true</parameter>
        <parameter name="coordination">true</parameter>
        <parameter name="transport.jms.Destination">myq</parameter>
        <parameter name="transport.jms.CacheLevel">3</parameter>
        <parameter name="transport.jms.ConnectionFactoryJNDIName">$SYSTEM:jmsconfac</parameter>
        <parameter name="java.naming.factory.initial">org.apache.activemq.jndi.ActiveMQInitialContextFactory</parameter>
        <parameter name="java.naming.provider.url">$SYSTEM:jmsurl</parameter>
        <parameter name="transport.jms.UserName">$SYSTEM:jmsuname</parameter>
        <parameter name="transport.jms.SessionAcknowledgement">AUTO_ACKNOWLEDGE</parameter>
        <parameter name="transport.jms.Password">$SYSTEM:jmspass</parameter>
        <parameter name="transport.jms.SessionTransacted">false</parameter>
        <parameter name="transport.jms.ConnectionFactoryType">queue</parameter>
        <parameter name="transport.jms.ContentType">application/xml</parameter>
        <parameter name="transport.jms.SharedSubscription">false</parameter>
        <parameter name="pinnedServers">$SYSTEM:pinned</parameter>
        <parameter name="transport.jms.ResetConnectionOnPollingSuspension">false</parameter>
    </parameters>
</inboundEndpoint>

<?xml version="1.0" encoding="UTF-8"?>
<inboundEndpoint name="jms" onError="fault" protocol="jms" sequence="LogMsgSeq" suspend="false" xmlns="http://ws.apache.org/ns/synapse">
    <parameters>
        <parameter name="interval">15000</parameter>
        <parameter name="sequential">true</parameter>
        <parameter name="coordination">true</parameter>
        <parameter name="transport.jms.Destination">myq</parameter>
        <parameter name="transport.jms.CacheLevel">3</parameter>
        <parameter name="transport.jms.ConnectionFactoryJNDIName">$FILE:jmsconfac</parameter>
        <parameter name="java.naming.factory.initial">org.apache.activemq.jndi.ActiveMQInitialContextFactory</parameter>
        <parameter name="java.naming.provider.url">$FILE:jmsurl</parameter>
        <parameter name="transport.jms.UserName">$FILE:jmsuname</parameter>
        <parameter name="transport.jms.SessionAcknowledgement">AUTO_ACKNOWLEDGE</parameter>
        <parameter name="transport.jms.Password">$FILE:jmspass</parameter>
        <parameter name="transport.jms.SessionTransacted">false</parameter>
        <parameter name="transport.jms.ConnectionFactoryType">queue</parameter>
        <parameter name="transport.jms.ContentType">application/xml</parameter>
        <parameter name="transport.jms.SharedSubscription">false</parameter>
        <parameter name="pinnedServers">$FILE:pinned</parameter>
        <parameter name="transport.jms.ResetConnectionOnPollingSuspension">false</parameter>
    </parameters>
</inboundEndpoint>

Proxy Service parameters¶

The pinned servers parameter as well as all the service-level transport parameters can be dynamically injected to a proxy service.

Example¶

In the following example, JMS transport parameters are dynamically injected to the proxy service.

Using Environment VariablesUsing a File

<?xml version="1.0" encoding="UTF-8"?>
<proxy name="JmsListner" pinnedServers="localhost" startOnLoad="true" transports="http https jms" xmlns="http://ws.apache.org/ns/synapse">
    <target>
        <inSequence>
            -------------
            <drop/>
        </inSequence>
        <outSequence/>
        <faultSequence/>
    </target>
    <parameter name="transport.jms.SessionAcknowledgement">AUTO_ACKNOWLEDGE</parameter>
    <parameter name="transport.jms.Destination">myq</parameter>
    <parameter name="transport.jms.ConnectionFactoryType">queue</parameter>
    <parameter name="transport.jms.ContentType">application/xml</parameter>
    <parameter name="java.naming.factory.initial">org.apache.activemq.jndi.ActiveMQInitialContextFactory</parameter>
    <parameter name="java.naming.provider.url">$SYSTEM:jmsurl</parameter>
    <parameter name="transport.jms.SessionTransacted">false</parameter>
    <parameter name="transport.jms.ConnectionFactoryJNDIName">$SYSTEM:jmsconfac</parameter>
    <parameter name="transport.jms.UserName">$SYSTEM:jmsuname</parameter>
    <parameter name="transport.jms.Password">$SYSTEM:jmspass</parameter>
</proxy>

<?xml version="1.0" encoding="UTF-8"?>
<proxy name="JmsListner" pinnedServers="localhost" startOnLoad="true" transports="http https jms" xmlns="http://ws.apache.org/ns/synapse">
    <target>
        <inSequence>
            -------------
            <drop/>
        </inSequence>
        <outSequence/>
        <faultSequence/>
    </target>
    <parameter name="transport.jms.SessionAcknowledgement">AUTO_ACKNOWLEDGE</parameter>
    <parameter name="transport.jms.Destination">myq</parameter>
    <parameter name="transport.jms.ConnectionFactoryType">queue</parameter>
    <parameter name="transport.jms.ContentType">application/xml</parameter>
    <parameter name="java.naming.factory.initial">org.apache.activemq.jndi.ActiveMQInitialContextFactory</parameter>
    <parameter name="java.naming.provider.url">$FILE:jmsurl</parameter>
    <parameter name="transport.jms.SessionTransacted">false</parameter>
    <parameter name="transport.jms.ConnectionFactoryJNDIName">$FILE:jmsconfac</parameter>
    <parameter name="transport.jms.UserName">$FILE:jmsuname</parameter>
    <parameter name="transport.jms.Password">$FILE:jmspass</parameter>
</proxy>

Message Store parameters¶

Listed below are the message store parameters that can be dynamically injected.

Message Store Type	Parameters
JMS Message Store	`store.jms.username` `store.jms.password` `store.jms.connection.factory`
WSO2 MB Message Store
RabbitMQ Message Store	`store.rabbitmq.host.name` `store.rabbitmq.host.port` `store.rabbitmq.username` `store.rabbitmq.password`
JDBC Message Store	`store.jdbc.drive` `store.jdbc.connection.url` `store.jdbc.username` `store.jdbc.password`
Resequence Message Store

Example¶

In the following example, the parameters in the RabbitMQ message store are configured as dynamic values.

Using Environment VariablesUsing a File

<?xml version="1.0" encoding="UTF-8"?>
<messageStore class="org.apache.synapse.message.store.impl.rabbitmq.RabbitMQStore" name="InboundStore" xmlns="http://ws.apache.org/ns/synapse">
    <parameter name="store.rabbitmq.host.name">$SYSTEM:rabbithost</parameter>
    <parameter name="store.producer.guaranteed.delivery.enable">false</parameter>
    <parameter name="store.rabbitmq.host.port">$SYSTEM:rabbitport</parameter>
    <parameter name="store.rabbitmq.route.key"/>
    <parameter name="store.rabbitmq.username">$SYSTEM:rabbitname</parameter>
    <parameter name="store.rabbitmq.virtual.host"/>
    <parameter name="rabbitmq.connection.ssl.enabled">false</parameter>
    <parameter name="store.rabbitmq.exchange.name">exchange3</parameter>
    <parameter name="store.rabbitmq.queue.name">queue3</parameter>
    <parameter name="store.rabbitmq.password">$SYSTEM:rabbitpass</parameter>
</messageStore>

<?xml version="1.0" encoding="UTF-8"?>
<messageStore class="org.apache.synapse.message.store.impl.rabbitmq.RabbitMQStore" name="InboundStore" xmlns="http://ws.apache.org/ns/synapse">
    <parameter name="store.rabbitmq.host.name">$FILE:rabbithost</parameter>
    <parameter name="store.producer.guaranteed.delivery.enable">false</parameter>
    <parameter name="store.rabbitmq.host.port">$FILE:rabbitport</parameter>
    <parameter name="store.rabbitmq.route.key"/>
    <parameter name="store.rabbitmq.username">$FILE:rabbitname</parameter>
    <parameter name="store.rabbitmq.virtual.host"/>
    <parameter name="rabbitmq.connection.ssl.enabled">false</parameter>
    <parameter name="store.rabbitmq.exchange.name">exchange3</parameter>
    <parameter name="store.rabbitmq.queue.name">queue3</parameter>
    <parameter name="store.rabbitmq.password">$FILE:rabbitpass</parameter>
</messageStore>